저는 2026년 8월 16일 밤부터 17일 새벽까지, 월 4만4천원의 Cloudways 요금을 아끼려고 워드프레스 블로그 2개를 케미클라우드로 이전하는 대장정을 펼쳤습니다. 그런데 갑자기 SSH가 막혀버린 거예요. 22, 2222, 21098, 7822번 포트 모두 열리지 않아 식은땀을 흘렸지만, 다행히 cPanel API가 열려 있어 이 난관을 극복하고 워드프레스 서버 이전을 무사히 마칠 수 있었습니다.
한눈에 보는 핵심
- SSH가 막혀도 cPanel API로 워드프레스 서버 이전이 가능합니다.
- 옛 서버에서 새 서버로 FTP 직접 전송 후 API로 압축 해제했습니다.
- 대용량 DB는 cPanel ‘원격 MySQL’ 기능으로 간편하게 옮겼습니다.
- 불필요한 캐시 폴더는 제외하고 용량을 줄여 전송 시간을 단축했습니다.
목차
SSH 막힘, 워드프레스 서버 이전 시 예상치 못한 난관
워드프레스 서버 이전을 시도하면서 가장 큰 문제는 SSH 포트가 막혀있다는 점이었어요. 사실 서버 이전 시 SSH는 거의 필수나 다름없는데, 22, 2222, 21098, 7822번 포트 모두 열리지 않으니 처음에는 정말 막막했죠. SSH가 막히면 파일 압축 해제, 대용량 DB 업로드, 그리고 mysqldump나 wp-cli 같은 유용한 도구들을 사용할 수 없게 됩니다. cPanel Transfer Tool도 SSH 접속을 전제로 동작한다고 하니, 저처럼 SSH가 막혀있는 상황에서는 난감할 수밖에 없죠.
하지만 저는 포기하지 않았습니다. cPanel API가 열려있다는 사실을 확인하고, 이 문제를 해결할 방법을 찾기 시작했어요. cPanel 지원 문서에서는 SSH 연결 문제가 발생했을 때 passwordauthentication, permitrootlogin, allowusers, denyusers 같은 SSH 설정과 방화벽 필터링을 확인하라고 안내하고 있었지만, 저는 직접 서버 설정을 건드릴 수 없는 상황이었거든요. 그래서 API를 활용하는 쪽으로 방향을 틀었습니다.
SSH 포트 문제, 무엇이 원인일까?
cPanel 공식 문서에 따르면, Transfer Tool 사용 시 SSH 포트 연결이 거부되는 주요 원인 중 하나는 방화벽 설정 때문이라고 해요. 양쪽 서버 모두에서 서로의 SSH 연결을 허용하고, 양쪽 방화벽에서 SSH 포트를 열어야 문제가 해결될 때가 많다고 하더라고요. 저처럼 여러 포트를 시도해도 안 되는 경우는 방화벽에서 아예 막혀있을 가능성이 컸던 거죠. cPanel용 방화벽 구성 스크립트도 따로 있을 정도니, 방화벽이 얼마나 중요한지 알 수 있습니다.
CHECK POINT
서버 이전 전 SSH 포트가 열려 있는지, 양쪽 서버 방화벽에서 서로의 SSH 연결을 허용하고 있는지 꼭 확인하세요.
cPanel API로 워드프레스 파일과 DB 옮기기
SSH가 막혀있었지만, cPanel API 덕분에 파일과 DB를 안전하게 옮길 수 있었습니다. 저는 옛 서버에서 새 서버 FTP로 직접 파일을 전송하는 방법을 택했어요. 제 컴퓨터를 거치지 않고 curl 명령 하나로 옛 서버에서 새 서버 FTP로 직접 전송했는데, 529MB 용량의 파일이 몇 분 만에 옮겨지더라고요. 이때 보안을 위해 FTP 접속 정보는 .netrc 파일에 따로 적어두고 –netrc-file 옵션으로 참조하게 했습니다.
특히 파일 전송 전에 tar로 묶으면서 wp-content/cache와 같은 불필요한 캐시 폴더는 제외했습니다. 덕분에 큰 사이트는 1.7GB에서 529MB로, 작은 사이트는 369MB에서 106MB로 용량을 확 줄일 수 있었죠. 이렇게 용량을 줄이니 전송 시간도 단축되고 훨씬 효율적이었습니다.
대용량 DB, 원격 MySQL로 한 방에 해결
DB 이전은 cPanel의 ‘원격 MySQL’ 기능을 활용했습니다. 옛 서버에서 새 서버 DB로 직접 밀어 넣는 방식인데, 이게 정말 신의 한 수였어요. SSH가 막혀 mysqldump도 못 쓰던 상황에서 이 기능 덕분에 대용량 DB를 손쉽게 옮길 수 있었죠. 이후에는 API로 DB 생성, 사용자 권한 설정, 애드온 도메인 추가, SSL 발급까지 모든 작업을 처리했습니다. cPanel API 2의 SSH::authkey를 호출하면 일반 사용자 계정의 SSH 키도 승인할 수 있다고 하니, API의 활용도가 정말 높다는 걸 다시 한번 느꼈습니다. API 토큰 생성 시 만료일도 설정할 수 있어 보안 관리에도 용이합니다.
CHECK POINT
대용량 DB 이전 시 cPanel의 ‘원격 MySQL’ 기능을 적극 활용해보세요. SSH 없이도 간편하게 DB를 옮길 수 있습니다.
cPanel API, SSH 없이도 강력한 서버 관리 도구
cPanel API는 SSH가 막힌 상황에서도 서버 관리의 거의 모든 작업을 가능하게 해주는 강력한 도구였습니다. 파일 압축 해제, DB 생성 및 권한 설정, 애드온 도메인 추가, SSL 발급 등 제가 필요했던 모든 기능을 API로 처리할 수 있었죠. SSH 키 관련 기능 중 WHM의 /authorizesshkey를 통해 공개 SSH 키를 서버에 승인하고 /root/.ssh/authorized_keys에 추가하는 기능도 있는데, 저처럼 SSH가 아예 막힌 경우는 이런 API 기능을 활용하는 게 더 효과적일 수 있습니다.
저는 이번 경험을 통해 cPanel API의 진가를 깨달았습니다. 단순히 웹 호스팅 제어판을 넘어서, SSH 같은 직접적인 서버 접근이 어려울 때도 서버를 유연하게 관리할 수 있는 대안이 되어주었으니까요. 특히 웹사이트 이전에 필요한 주요 포트인 2083(cPanel SSL), 2087(WHM SSL), 80/443(웹) 등이 정상적으로 동작하는지 확인하는 것도 중요합니다. API를 활용하면 이러한 포트 관련 설정도 간접적으로 관리할 수 있습니다.
API 활용 시 보안 유의사항
cPanel API를 사용할 때는 보안에 각별히 유의해야 합니다. 저는 FTP 접속 정보를 .netrc 파일에 저장하고 –netrc-file 옵션으로 참조했지만, API 키나 비밀번호 같은 민감한 정보는 더욱 철저히 관리해야 합니다. cPanel은 API 토큰 생성 시 만료일을 설정할 수 있는 기능을 제공하니, 임시로 사용할 토큰이라면 만료일을 지정하여 보안을 강화하는 것이 좋습니다.
마무리
SSH가 막히는 예상치 못한 상황에서도 cPanel API를 활용하면 워드프레스 서버 이전을 성공적으로 완료할 수 있습니다. FTP 직접 전송과 원격 MySQL 기능으로 파일과 DB를 옮기고, API로 나머지 설정을 마무리하면 됩니다. 덕분에 저는 월 4만4천원이라는 적지 않은 돈을 절약할 수 있었어요.
자주 묻는 질문
SSH 없이 워드프레스 서버 이전이 정말 가능한가요?
네, cPanel API와 FTP 기능을 활용하면 SSH 없이도 워드프레스 서버 이전이 충분히 가능합니다.
cPanel API는 어떤 작업을 대신할 수 있나요?
파일 압축 해제, DB 생성 및 사용자 권한 설정, 애드온 도메인 추가, SSL 발급 등 다양한 서버 관리 작업을 API로 처리할 수 있습니다.
대용량 DB는 어떻게 이전해야 하나요?
cPanel의 ‘원격 MySQL’ 기능을 사용하면 옛 서버에서 새 서버 DB로 직접 데이터를 밀어 넣어 대용량 DB도 쉽게 이전할 수 있습니다.
파일 용량을 줄이는 팁이 있나요?
파일 전송 전에 tar로 묶으면서 wp-content/cache와 같은 불필요한 캐시 폴더를 제외하면 파일 용량을 크게 줄일 수 있습니다.
cPanel API 사용 시 보안에 유의할 점은 무엇인가요?
API 키나 비밀번호 같은 민감한 정보는 .netrc 파일에 저장하거나, API 토큰 생성 시 만료일을 설정하여 보안을 강화하는 것이 좋습니다.
본 글은 일반적인 정보 제공을 목적으로 하며, 개별 상황에 대한 판단이나 진단을 대신할 수 없습니다. 정확한 내용은 전문가와 상담해 결정하시기 바랍니다.