워드프레스 ‘잠시 점검 중’ 해결법: 클라우드웨이즈에서 .maintenance 파일 삭제로 복구하기

워드프레스 “잠시 점검 중”에서 멈출 때, 클라우드웨이즈로 해결하는 방법

워드프레스를 운영하다 보면 테마나 플러그인 업데이트 중 사이트 전체가 갑자기 “Briefly unavailable for scheduled maintenance. Check back in a minute” 상태로 멈춰버리는 경우가 있다. 평소에는 금세 사라지는 문구지만, 업데이트 과정에서 오류가 발생하면 해당 메시지가 장시간 유지되며 관리자 페이지와 메인 화면 모두 접속이 막힌다. 특히 Cloudways(클라우드웨이즈) 환경에서는 서버 리소스나 업데이트 충돌로 인해 이 문제가 비교적 자주 발생하기도 한다. 다행히 해결 방법은 단순하며, 몇 가지 경로만 정확히 찾으면 누구나 직접 해결할 수 있다.

이 글에서는 Cloudways에서 .maintenance 파일을 삭제해 워드프레스 유지관리 모드에서 벗어나는 법을 단계별로 안내한다. 실제로 동일한 상황을 경험하는 사용자들이 매우 많으며, 해결 과정 자체도 1분이면 끝나는 수준이다.

---

왜 “잠시 점검 중” 메시지가 사라지지 않을까?

워드프레스는 업데이트 시작과 동시에 사이트 루트에 .maintenance 파일을 자동 생성한다. 이 파일은 유지관리 모드 진입 신호이며, 업데이트가 정상적으로 끝나면 자동 삭제된다. 하지만 서버 응답 지연, 인터넷 끊김, 업데이트 중단, 플러그인 충돌, PHP 메모리 부족 등의 사유로 업데이트 과정이 완전히 종료되지 못하면 .maintenance 파일이 그대로 남아버린다. 문제는 이 파일 하나 때문에 사이트 전체가 무기한 유지관리 모드에 머무는 것이다.

Cloudways 같은 클라우드 호스팅에서는 프로젝트·애드온이 많고 캐시 구조가 복잡하기 때문에 업데이트 타임아웃이 가끔 발생할 수 있다. 이런 상황에서는 관리자 페이지 접속도 막히므로 파일 시스템에서 직접 문제 파일을 삭제해야 한다.

---

클라우드웨이즈에서 .maintenance 파일 삭제하는 방법

1. Cloudways 로그인 → Applications 선택

로그인 후 상단 메뉴에서 Applications로 이동한다. 여기에는 연결된 모든 워드프레스 사이트가 나열된다.

2. 문제 발생한 사이트 선택

유지관리 모드에서 벗어나지 않는 해당 워드프레스 앱을 클릭한다.

3. Access Details에서 SFTP 접속 정보 확인

왼쪽 메뉴 중 Access Details로 이동하면 아래 정보가 보인다.

• Server Public IP
• Application Username
• Application Password

이 정보는 SFTP 접속 시 그대로 사용된다.

4. Launch SFTP 실행

Cloudways는 웹 기반으로 바로 파일을 열 수 있는 Launch SFTP 버튼을 제공한다. 이것을 클릭하면 별도의 프로그램 없이 바로 파일 관리자 환경을 사용할 수 있다.

5. 워드프레스 설치 경로로 이동

SFTP가 열리면 다음 경로를 순서대로 따라가면 된다.

 

applications └── (앱ID)/public_html

이 public_html 폴더가 바로 워드프레스가 설치된 공간이다.

여기에서 모든 핵심 파일(wp-admin, wp-content, wp-config.php 등)이 보일 것이다.

6. .maintenance 파일 삭제

public_html 최상단 루트에서 .maintenance 파일을 찾아 삭제한다.

만약 보이지 않는다면 다음 기능을 켜야 한다.

• Show Hidden Files
  숨김 파일 보기 옵션을 활성화하면 .maintenance가 나타난다.

이 파일은 유지관리 모드를 나타내는 신호 파일이므로 삭제해도 문제가 되지 않는다.

7. 사이트 새로고침

파일을 삭제한 후 워드프레스 관리자 페이지와 메인 페이지를 새로고침하면 바로 정상적으로 돌아온다.

---

삭제해도 해결되지 않을 때 점검해야 할 부분

1. 테마 업데이트 중단으로 파일이 일부만 설치된 경우

테마 폴더가 비어 있거나 손상되어 사이트가 깨질 수 있다.
/wp-content/themes 경로에서 해당 테마가 완전한지 확인하고 필요하면 재설치한다.

2. 플러그인 충돌

업데이트 직후 충돌이 발생하면 사이트가 비정상 작동할 수 있다.
plugins 폴더 이름을 plugins_old로 일시 변경해 플러그인을 전체 비활성화하는 방식으로 테스트해볼 수 있다.

3. PHP 버전 호환 문제

최근 테마 업데이트가 PHP 8.0 이상을 요구하는데 서버가 낮은 버전을 사용 중이면 오류가 발생할 수 있다. Cloudways에서 PHP 버전 관리를 통해 조정하면 정상화되기도 한다.

---

마무리

워드프레스가 “잠시 점검 중”에서 멈춘 상황은 당황스러울 수 있지만, 실제로는 아주 단순한 .maintenance 파일 문제인 경우가 대부분이다. Cloudways는 파일 접근이 쉽기 때문에 이 파일만 삭제해도 사이트가 즉시 정상화된다. 앞으로 업데이트 진행 시에는 인터넷 연결과 서버 리소스를 충분히 확보한 상태에서 실행하면 이런 문제를 예방할 수 있다.