FTP/SFTP/SSH 접속이 안 될 때 어떻게 해야 하나요?
💡 요약 정리
- 카페24 대부분의 리눅스 웹호스팅 상품은 SFTP(포트 3822)만 지원하며, FTP(포트 21)로는 접속이 되지 않습니다.
- 파일질라에서 프로토콜을 SFTP - SSH File Transfer Protocol로 변경하고 포트를 3822로 설정해 주세요.
- node.js 호스팅은 FTP/SFTP가 모두 미지원이며 Git 배포만 가능합니다.
1. 상품별 FTP/SFTP 프로토콜 지원 현황
| 호스팅 상품 | FTP(포트 21) | SFTP(포트 3822) | SSH(포트 3822) | 비고 |
|---|---|---|---|---|
| 뉴아우토반 호스팅 | 미지원 | 지원 | 지원 | SFTP 전용 |
| 10G 광아우토반 FullSSD | 미지원 | 지원 | 지원 | SFTP 전용 |
| 64bit 광아우토반 | 미지원 | 지원 | 지원 | SFTP 전용 |
| 10G 광아우토반 FullSSD Plus | 미지원 | 지원 | 지원 | SFTP 전용 |
| 루비호스팅 | 지원 | 지원 | 지원 | FTP+SFTP 모두 |
| 이미지호스팅 | 보안 설정에 따라 다름 | 지원 | 제한적 | FTP 보안접속 설정 확인 |
| 윈도우 호스팅 | 지원(별도 포트) | 미지원 | 미지원 | FTP 전용, 포트 별도 확인 |
| node.js 호스팅 | 미지원 | 미지원 | 미지원 | Git 배포 전용 |
| VPS(가상서버) | 고객 설정 | 고객 설정 | 지원(포트 22) | 방화벽 직접 관리 |
2. 파일질라(FileZilla) SFTP 접속 설정
- 파일 → 사이트 관리자 클릭
- 프로토콜: SFTP - SSH File Transfer Protocol 선택
- 호스트: 도메인 또는 아이디.cafe24.com
- 포트: 3822
- 로그온 유형: 일반(아이디 + 비밀번호)
3. FTP 접속 실패 시 가장 흔한 원인
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| ECONNREFUSED / 연결 거부 | SFTP 전용 상품에 FTP(포트 21)로 접속 시도 | SFTP(포트 3822)로 변경 |
| "서버가 TLS를 지원하지 않습니다" | 서버가 FTPS(FTP+TLS)를 미지원 | "확인" 클릭 후 일반 FTP로 접속 가능 (SFTP 전용 상품은 SFTP 전환 필요) |
| "FTP를 지원하지 않습니다" | FTP 보안접속 설정이 활성화됨 | SFTP로 전환 또는 보안접속 해제 |
| 비밀번호 오류 | 비밀번호 변경 후 반영 대기 중 | 변경 후 5-10분 대기 |
4. 비밀번호 변경 및 접속 정보 확인
- 비밀번호 변경: 나의서비스관리 → 호스팅관리 → 서비스 접속관리 → FTP 비밀번호 변경
- 접속 정보 확인: 나의서비스관리 → 호스팅관리 → 서비스 접속관리 → 서비스 접속정보
- FTP/Shell 접속 프로토콜 ON/OFF 설정: 나의서비스관리 → 보안설정 → FTP/Shell 접속설정
비밀번호 변경 후 서버 동기화에 5-10분이 소요됩니다. 잠시 대기 후 재시도해 주세요.
5. FTP 보안접속 설정 확인/해제
- FTP 보안접속이 활성화되어 있으면 일반 FTP(포트 21) 접속이 차단됩니다.
- 확인/해제 경로: 나의서비스관리 → 호스팅관리 → 서비스 접속관리 → FTP 보안접속 설정
💡 참고
보안 강화를 위해 SFTP 사용을 유지하는 것을 권장합니다.
6. VPS(가상서버) SSH 접속 안내
- VPS는 SSH 포트 22를 사용합니다. (웹호스팅 SFTP 포트 3822와 다릅니다)
- 접속 시간 초과(timed out) 시: 나의서비스관리 → 방화벽 관리에서 현재 PC의 공인 IP를 허용 등록해 주세요.
- 현재 PC 공인 IP 확인: https://ifconfig.me
- 비밀번호 분실 시: 나의서비스관리 → 서비스 접속관리에서 root 비밀번호 초기화 가능
7. VS Code / Cursor IDE 원격 SSH 접속 오류
VS Code Remote SSH 오류: "원격 호스트가 필수 구성 요소를 충족하지 않습니다" 메시지가 나타나면, VS Code 버전이 1.86 이상인 경우 발생합니다. 카페24 서버는 CentOS 7 기반(glibc 2.17)으로, glibc 2.28 이상을 요구하는 최신 VS Code와 호환되지 않습니다.
- 해결: VS Code 1.85.x 이하 버전으로 다운그레이드
- 이전에 상위 버전으로 접속 시도한 경우: SSH로 접속 후
~/.vscode-server폴더 삭제 후 재시도
Cursor IDE SSH 오류: "flock: command not found" 메시지가 나타나면:
- Cursor 설정(Ctrl+,) → 검색: "remote.SSH.useFlock" → "Remote.SSH: Use Flock" 체크 해제
8. SSH 접속 후 바로 연결이 끊기는 경우
SSH 접속은 되지만 셸 실행 직후 "remote host closed the connection"으로 종료되는 경우:
- FTP/SFTP로 접속하여
/www/.bashrc,/www/.bash_profile내용 확인 → 오류가 있으면 삭제 또는 이름 변경 - SSH 재접속 시도
- 해결되지 않으면 1:1 문의로 계정 셸 설정 확인 요청
9. node.js 호스팅은 FTP/SFTP 미지원
- node.js 호스팅(전 요금제)은 FTP/SFTP 접속이 원천적으로 미지원됩니다.
- 파일 업로드/수정은 Git 배포로만 가능합니다.
- 나의서비스관리에 FTP 비밀번호 변경 메뉴가 없습니다.
10. 웹FTP(webftp.cafe24.com) 서비스 종료
- 카페24 웹FTP(브라우저 기반 FTP) 서비스는 IE(Internet Explorer) 종료에 따라 서비스가 종료되었습니다.
- 대안: FileZilla, WinSCP, Cyberduck 등 외부 FTP/SFTP 클라이언트를 사용해 주세요.
문제가 해결되지 않았나요?
위 방법으로 해결되지 않으면 아래 정보를 포함하여 1:1 문의게시판으로 문의해 주세요.
- 서비스 아이디:
- 접속 시 사용한 프로토콜 및 포트:
- 오류 메시지 캡처: