카페24 FTP를 통해 이미지 전송 시 실패하는 경우

며칠 전 카페24에 설치된 워드프레스 사이트를 다른 카페24 계정으로 이전하는 작업을 맡았습니다. PHP 업그레이드나 상품 변경 시 기존 사이트를 그대로 두고 새로 상품을 만들어 이전하면 사이트 중단 시간을 최소화할 수 있습니다.

기존 사이트에서 데이터 백업을 받기 위해 FTP를 통해 파일들을 다운로드를 시도하니 일부 이미지 파일들이 다운로드가 되지 않고 전송에 실패했습니다. 이 경우 해결 방법에 대하여 살펴보겠습니다.

📍 클라우드웨이즈 할인 프로모 코드 & 가입 방법 (+45% 쿠폰)

FTP에서 이미지 전송 실패 원인

파일을 FTP를 통해 업로드할 때 실패한다면 서버 디스크 용량 부족이나 파일/폴더 퍼미션 문제일 가능성이 큽니다.

• 서버 디스크 용량 부족 (호스팅 HDD 용량 초과, 계정 저장 한도 초과)
• FTP 계정 권한/퍼미션 문제 (디렉터리 쓰기 권한 없음, 550 Permission denied 등)
• 파일 크기 제한 또는 개수 제한 (서버 설정에서 업로드 가능한 최대 크기/동시 파일 수 제한)
• 네트워크 불안정, 끊김 (전송 중 연결이 자주 끊기거나 타임아웃 발생)
• 방화벽·보안 설정으로 FTP 포트/패시브 포트가 차단된 경우
• FTP 서버 주소, 포트, 프로토콜(FTP/SFTP/FTPS) 설정 오류
• 파일이 다른 프로그램에서 열려 있거나 잠금 상태인 경우
• 서버 측 FTP 서비스나 호스팅사 정책으로 특정 경로나 명령이 제한된 경우
• 문자 인코딩 문제나 특수문자·너무 긴 파일명/경로로 인한 오류
• 서버 파일 시스템 오류나 손상된 파일 등 파일 자체에 문제가 있는 경우

특히 카페24는 저가 상품의 경우 빠르게 웹 용량이 소진될 수 있습니다. 웹 용량이 부족하면 워드프레스 테마, 플러그인 설치 실패, 업데이트 실패 등 다양한 사이트 문제가 발생할 수 있습니다.

다운로드에 실패하는 경우에는 경험상 몇 가지를 의심해 볼 수 있는 것 같습니다. 우리나라에서는 특히 파일 이름에 한글이 포함될 경우 다운로드에 실패하거나 다운로드하더라도 이미지 파일 이름이 깨지거나 자모가 분리될 수 있습니다. 또한, 서버 공간이 부족한 상태에서 이미지 파일이 손상되는 경우도 있습니다. 그런 경우 FTP를 통해 접속하면 이지가 있는 것처럼 보이지만, 다운로드하려고 시도하면 다운로드에 실패할 수 있습니다.

특히 이미지 파일 이름에 한글을 포함하지 않는 것이 좋습니다. 한글을 포함할 때 마이그레이션 시에 문제가 발생할 가능성이 높습니다. 또한, 이름에 한글이 포함된 이미지 파일을 대표 이미지(특성 이미지)로 지정할 경우 페이스북, 스레드 등에 공유할 때 이미지가 깨질 수 있습니다.

스레드에서 워드프레스 썸네일이 표시되지 않는 문제 해결 방법 - 워드프레스 정보꾸러미

맥(Mac)에서 FTP를 통해 이름에 한글이 포함된 이미지 파일을 업로드할 경우 한글 자모가 분리되어 보일 수 있습니다.

워드프레스 이미지 파일명에 한글이 포함되는 경우 주의사항 - 워드프레스 정보꾸러미

카페24에서 이미지 파일이 다운로드가 안 되는 문제가 발생하는 경우

카페24에서 워드프레스 사이트를 다른 계정이나 다른 호스팅으로 이전하기 위해 파일들을 다운로드할 때 이미지 파일 전송이 실패하는 경우에는 다음과 같은 방법을 시도해 볼 수 있습니다.

1) 카페24 홈페이지에 로그인하여 백업 파일을 생성하여, 백업 파일을 이용하여 이전을 시도합니다.

데이터 백업 파일을 다운로드한 후에, 백업 파일을 이전할 사이트로 업로드하고, SSH에 접속하여 백업 파일의 압축을 해제할 수 있습니다. 이후에 백업한 파일들을 적절한 위치로 이동시키도록 합니다. 경우에 따라 파일/폴더 권한 설정을 해주어야 할 수도 있습니다.

이 방법을 이용하려면 이전하려는 서버에 충분한 공간이 있고 SSH 접근을 허용해야 합니다.

2) 워드프레스 백업 플러그인을 사용하여 이전을 시도합니다. 

이 방법을 이용하려면 현재 사이트와 이전할 사이트 모두에 충분한 공간이 있어야 합니다.

[참고*위의 조치에도 이미지 파일들이 서버에서 원래 손상된 상태였다면 이전해도 손상되어 제대로 표시가 안 될 것입니다.*]

카페24의 경우 (권한이 제한되어 있지만) SSH 접속을 허용합니다. SSH 접속을 위해서는 카페24 홈페이지에서 쉘 접속을 허용하도록 설정해야 합니다.

클라우드웨이즈(Cloudways)에서도 (root 권한이 아니지만) SSH 접속을 허용합니다. 클라우드웨이즈에서도 웹호스팅 컨트롤 패널에서 SSH 접속을 허용/금지를 설정할 수 있습니다.

VPS 호스팅이나 서버 호스팅이 아닌 대부분의 다른 웹호스팅에서는 SSH 접속을 허용하지 않습니다.

👉 워드프레스 이전, 카페24 PHP 변경 등을 비롯한 워드프레스 또는 웹호스팅 관련 문제로 해결에 어려움을 겪는 경우 여기에서 서비스(유료)를 의뢰할 수 있습니다.

마치며

웹에 이미지를 업로드할 때에는 이미지 파일 이름에 한글을 사용하지 않는 것이 좋습니다. 이것은 워드프레스뿐만 아니라 그누보드 등 다른 CMS에서도 마찬가지로 주의해야 할 사항입니다. (만약 이미지 업로드 시 이미지 파일 이름을 숫자 등으로 임의로 바뀌어 업로드된다면 한글로 인한 문제가 발생하지 않을 것입니다.)

이미지 파일에 한글이 포함될 경우 마이그레이션 작업 시 이미지 파일 이름이 깨지거나 자모가 분리되어 이전 후에 이미지가 엑박으로 표시될 수 있습니다.

카페24의 경우 간혹 공간 부족으로 인해 일부 파일이 깨지는 경우가 발생할 수 있습니다. 공간이 부족하면 불필요한 파일을 삭제하거나 상품을 상위 상품으로 업그레이드해야 합니다. 많은 공간이 필요한 경우 케미클라우드나 패스트코멧 등과 같은 가성비 좋은 해외호스팅을 대안으로 고려할 수 있습니다. 특히 케미클라우드는 재작년 서울 서버를 도입하여 우리나라에서도 속도가 빠릅니다.

💚서울 서버를 제공하는 ChemiCloud 워드프레스 호스팅 가입 방법 및 워드프레스 설치

참고

https://avada.tistory.com/3851

카페24 워드프레스 치명적인 오류, 낮은 PHP 버전, 웹용량 부족 문제 대응하기

https://avada.tistory.com/3848

제미나이 3.0 나노 바나나 프로 - 한글 철자 오류 없이 완벽해진 이미지 생성