증상: 클라우드웨이즈 서버에서
wp --path=... 로 부르면 Failed opening required 'wp-salt.php' 로 PHP Fatal 이 납니다.원인: wp-config.php 가 소금값 파일 wp-salt.php 를 상대 경로로 불러서, 사이트 폴더 밖에서 실행하면 그 파일을 엉뚱한 곳에서 찾습니다.
해결: 사이트의 public_html 폴더로
cd 한 뒤에 wp 를 부릅니다.클라우드웨이즈에 올려 둔 워드프레스를 wp-cli 로 다루다가 같은 오류를 몇 번이나 만났습니다. 명령 자체는 맞는데 부르는 위치가 문제였습니다. 그 서버에서 함께 막혔던 접속 문제 네 가지도 같이 적습니다.
버전은 읽히는데 DB 명령만 죽었다
다른 서버에서 사이트 폴더 경로를 --path 로 넘겨 wp-cli 를 불렀더니 아래 오류가 났습니다.
PHP Fatal error: Failed opening required 'wp-salt.php'
헷갈린 점은 워드프레스 버전을 묻는 명령은 멀쩡히 답했다는 것입니다. DB 를 쓰는 명령만 전부 실패해서 처음에는 DB 접속 정보가 틀린 줄 알았습니다. 다른 날에는 오류 문구 없이 글 목록이 빈 결과로 나와서, 글이 없는 줄 알고 넘어갈 뻔했습니다.
가장 크게 헷갈린 것은 복원 검증이었습니다. 같은 날 --path 방식으로 돌린 검증이 8건 실패했습니다. 사이트가 깨진 것이 아니라 검사하는 방법이 틀린 것이었습니다.
소금값 파일을 상대 경로로 부른다
클라우드웨이즈의 wp-config.php 는 인증 키와 salt 값을 본문에 적지 않고 옆 파일 wp-salt.php 로 빼 두었습니다. 그리고 그 파일을 require('wp-salt.php') 처럼 상대 경로로 부릅니다.
사이트 폴더 안에서 실행하면 이 파일이 바로 찾아집니다. 사이트 폴더 밖, 예를 들어 홈 폴더에서 --path 만 주고 부르면 그 바깥 폴더에서 wp-salt.php 를 찾다가 실패했습니다. 파일 자체는 서버를 옮길 때 rsync 로 잘 따라오므로, 파일이 없어진 것으로 오해하지 않아도 됩니다.
왜 wp-config.php 가 있는 폴더가 아니라 현재 폴더가 기준이 되는지는 wp-cli 가 wp-config.php 를 읽어 들이는 방식과 관련이 있어 보이지만, 여기까지는 확인하지 못했습니다. 실제로 확인한 것은 "cd 하면 된다, 안 하면 안 된다" 두 가지입니다.
같은 서버에서 함께 막혔던 네 가지
wp-cli 까지 가기 전에 접속 단계에서도 여러 번 막혔습니다. 겪은 순서대로 표로 정리합니다.
| 보인 것 | 원인 | 푼 방법 |
|---|---|---|
scp 업로드가 dest open No such file |
sftp 서브시스템이 제한돼 있음 | ssh 로 표준입력을 흘려 보냄 |
홈 폴더의 .ssh/authorized_keys 에 공개키를 넣었는데 Permission denied (publickey) |
sshd_config 의 AuthorizedKeysFile 이 %h/.openssh/authorized_keys |
.openssh 폴더 아래 authorized_keys 에 넣음 |
앱 사용자로 접속하면 Shell access is disabled |
앱 사용자는 셸 접속이 기본으로 꺼져 있음 | Master 사용자에 공개키를 등록해 접속 |
| 허용 IP 를 어디에 넣는지 못 찾음 | Firewall 메뉴는 일반 트래픽용 | Server, Security, Shell Access 의 SSH/SFTP 탭과 MySQL 탭에 각각 추가 |
접속하고 나서 보니 서버 안에는 wp-cli, mysql, mysqldump 가 모두 설치돼 있었습니다. 진짜로 막힌 것은 PHP 안에서 부르는 exec 와 sudo 뿐이었습니다. 처음에 SSH 가 안 되는 줄 알고 PHP 로 사이트를 꺼냈던 이야기는 SSH 없이 클라우드웨이즈 워드프레스를 꺼낸 방법에 따로 적었습니다.
cd 한 줄 뒤에 13건이 모두 통과했다
해결은 단순합니다. 앱 폴더의 public_html 로 들어간 뒤에 wp 를 부릅니다. 원격에서 한 줄로 부를 때도 cd 를 같은 명령 안에 넣습니다.
cd /home/master/applications/앱폴더/public_html && wp option get blogname
ssh 마스터사용자@서버A "cd /home/master/applications/앱폴더/public_html && wp post list --post_status=publish --format=count"
파일을 올릴 때는 scp 대신 원격의 cat 이 표준입력을 받아 쓰게 합니다.
ssh 마스터사용자@서버A "cat > /home/master/applications/앱폴더/public_html/wp-content/mu-plugins/x.php" < x.php
8건이 실패했던 복원 검증을 cd 뒤에 다시 돌리자 13건 모두 통과했습니다. 확인할 때는 아래 두 가지를 봅니다.
wp option get blogname이 사이트 이름을 돌려주는지 봅니다. 오류 없이 이름이 나오면 wp-config.php 를 끝까지 읽은 것입니다.- 글 수나 목록이 0 이나 빈 칸으로 나오면 성공으로 읽지 말고, cd 를 먼저 했는지부터 봅니다.
wp-cli 가 성공이라고 했는데 실제로는 안 바뀐 다른 경우들은 wp-cli 가 Success 라는데 안 바뀌었을 때에 모아 두었습니다.
같은 호스팅에서 글을 고쳤는데 화면이 그대로라면 바니시 캐시가 wp-cli 퍼지로 안 비워질 때를 보세요.
확인한 환경
| 항목 | 내용 |
|---|---|
| 호스팅 | 클라우드웨이즈 관리형 서버, Master 사용자 SSH |
| 프로그램 | 워드프레스, wp-cli(/usr/local/bin/wp) |
| 확인한 날짜 | 2026년 6월 24일(빈 결과), 8월 22일(오류 문구와 접속 문제), 8월 31일(복원 검증 13건) |
이 글의 내용은 2026년 10월 13일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.