파일질라(FileZiall)를 사용하여 FTP에 접속할 때 "ECONNREFUSED - 서버에서의 연결 거부" (ECONNREFUSED - Connection refused by server) 오류가 발생하는 경우가 있을 수 있습니다. 저는 카페24에 설치된 워드프레스 사이트에 FTP 접속을 시도하니 이 에러가 발생하는 것을 경험했습니다.

이 글에서는 파일질라에서 ECONNREFUSED 에러가 발생하는 경우 확인할 사항에 대하여 살펴보겠습니다.
파일질라 "ECONNREFUSED - 서버에서의 연결 거부" 오류
파일질라에서 ECONNREFUSED 오류가 발생하는 경우 확인 사항
"ECONNREFUSED - Connection refused by server" 에러는 파일질라(FileZilla)와 같은 FTP 클라이언트를 사용할 때 서버가 연결 요청을 거부했음을 나타냅니다. 이 문제가 발생하는 경우 일반적으로 몇 가지 방법으로 해결을 시도해볼 수 있습니다.
- 서버 주소 확인: FTP 서버 주소가 정확한지 확인합니다. 오타가 없는지, 올바른 포트 번호를 사용하고 있는지 확인해야 합니다. 예를 들어, 카페24에서는 포트 번호가 일반적으로 21을 지원하고, 카페24 계정에서 Shell 접속을 허용하도록 설정하는 경우 22를 사용할 수 있습니다.
- 방화벽 및 안티바이러스 설정 검토: 로컬 컴퓨터의 방화벽이나 안티바이러스 프로그램이 FTP 연결을 차단하고 있을 수 있습니다. 필요한 경우 FTP 프로그램을 안전 목록(허용 목록)에 추가하도록 합니다.
- 서버 상태 확인: FTP 서버가 온라인 상태이며, 제대로 작동하고 있는지 확인합니다. 서버 관리자에게 서버 상태를 문의할 수 있습니다. 실제로 카페24에서 서버 작업을 하고 있을 때 이런 현상이 발생하는 경우가 있다고 합니다.
- 네트워크 설정 검토: 사용 중인 네트워크(집, 사무실, 공공 Wi-Fi 등)가 FTP 트래픽을 허용하는지 확인합니다. 일부 네트워크는 보안 문제로 인해 특정 포트 또는 트래픽 유형을 차단할 수 있습니다.
- 사용자 이름(아이디)과 비밀번호 확인: FTP 서버 접속 정보(사용자 이름, 비밀번호)가 정확한지 확인합니다. 실제로 FTP 접속 정보가 잘못되어 접속이 안 될 때가 많습니다.
- 패시브 모드 활성화: 파일질라에서 패시브 모드(Passive mode)를 활성화합니다. 이 설정은 FTP 서버 뒤에 방화벽이 있는 경우 유용할 수 있습니다.
이러한 조치들을 취해보고 문제가 해결되지 않는다면, 인터넷 서비스 제공자(ISP)나 네트워크 관리자에게 문의하여 도움을 받는 것도 하나의 방법일 수 있습니다.
카페24에서 "ECONNREFUSED - 서버에서의 연결 거부" 에러가 발생하는 경우
카페24에서 이 문제가 발생한다면 서버 IP 주소가 정확한지, 그리고 포트 번호가 정확한지 확인해보시기 바랍니다. 포트번호가 21로 설정되어 있지 않다면 21로 설정하여 접속이 되는지 체크해보세요(FTP: 포트번호 21, SFTP: 포트번호 22 사용).
제 경우는 조금 특이했는데요. 카페24에 연결한 커스텀 도메인(예: example.com)으로 접속하면 이 에러가 발생했습니다.

그런데 카페24에서 제공하는 기본 도메인(example.mycafe24.com 또는 example.cafe24.com 형식)으로 접속할 때에는 제대로 접속이 되었습니다.

위의 두 그림에서 차이점을 발견하셨나요? 동일 사이트에 연결되었지만 FTP 접속 시 서버 IP 주소가 다릅니다.😄 아마 커스텀 도메인의 FTP 서버 IP 주소가 잘못되어 FTP 서버에 접속이 안 된 것으로 보입니다.
"ECONNREFUSED - 서버에서의 연결 거부" 에러가 발생하는 경우 파일질라에 표시되는 서버 IP 주소가 실제 서버 IP 주소와 동일한지 체크해보시기 바랍니다.
FTP 정보를 설정할 때 호스트에 도메인을 입력하는 대신 서버 IP 주소를 입력하여 접속되는지도 체크해볼 수 있을 것 같습니다.

이외에 카페24의 경우 지역에 따라 접속 제한 설정이 되어 있을 수 있습니다. 예를 들어, 국내 사용자만 접속을 허용하고 해외 사용자는 접속하지 못하도록 설정할 수 있는데요. 그런 경우 국내 사용자도 접속이 안 될 수 있으므로 접속 제한 없음으로 설정하여 문제가 해결되는지도 체크해보세요.
블루호스트나 패스트코멧, 케미클라우드 등에서도 FTP에 접속이 안 될 경우 호스트에 도메인 이름 대신 서버 IP 주소를 입력하면 접속이 되는 경우가 있습니다.
댓글 남기기