FTP 연결은 실패할 수 있습니다. 처음 설정할 때 실패하기도 하고, 몇 달간 잘 작동하다가 갑자기 실패하기도 합니다. 그리고 알아보기 힘든 오류 메시지가 뜨는 경우도 있습니다. 이 가이드는 Mac에서 가장 흔한 FTP 및 SFTP 연결 오류와 각각의 해결 방법을 설명합니다.
연결 타임아웃
연결을 시도해도 아무것도 일어나지 않고, 30~60초 후에 타임아웃 오류가 표시됩니다.
일반적인 원인:
- 방화벽이 연결을 차단하고 있습니다 (Mac의 방화벽, 라우터, 또는 서버 방화벽).
- 패시브 모드가 필요한데 액티브 FTP 모드를 사용하고 있습니다. 액티브 모드는 서버가 Mac에 다시 연결해야 하는데, 대부분의 NAT 라우터와 방화벽이 이를 차단합니다.
- 서버 호스트명 또는 IP 주소가 틀렸습니다.
- 서버의 FTP 서비스가 실행 중이 아닙니다.
해결 방법:
- 패시브 FTP 모드로 전환합니다. 거의 모든 현대적인 연결에서 올바른 설정입니다.
- Mac의 방화벽을 확인합니다: 시스템 설정 > 네트워크 > 방화벽. FTP 앱이 허용되어 있는지 확인합니다.
- 터미널에서 ping으로 호스트명을 확인합니다:
ping ftp.example.com - 다른 앱(터미널의
sftp명령 등)으로 연결을 시도해 앱별 문제인지 확인합니다.
연결 거부
기다림 없이 즉시 연결이 거부됩니다.
일반적인 원인:
- 포트 번호가 틀렸습니다. FTP는 포트 21, SFTP는 포트 22, Implicit FTPS는 포트 990을 사용합니다.
- 서버에서 FTP/SFTP 서비스가 실행 중이 아닙니다.
- 서버 방화벽이 내 IP를 명시적으로 차단하고 있습니다.
해결 방법:
- 포트 번호를 다시 확인합니다. 이것이 가장 흔한 원인입니다.
- 서버 제공업체에 FTP/SFTP가 활성화되어 있는지 확인합니다.
- IP가 화이트리스트에 등록되어야 하는지 문의합니다.
530 로그인 오류
연결은 성공하지만 로그인이 거부됩니다.
일반적인 원인:
- 사용자명 또는 비밀번호가 틀렸습니다. 복사-붙여넣기로 보이지 않는 공백이나 줄바꿈이 추가될 수 있습니다.
- 계정은 있지만 FTP 접근이 활성화되어 있지 않습니다 (일부 호스팅 패널에서는 FTP를 별도로 활성화해야 합니다).
- 대소문자 구분. 일부 서버는 사용자명의 대소문자를 구분합니다.
해결 방법:
- 붙여넣기 대신 인증 정보를 직접 입력합니다.
- 호스팅 제어판에 로그인해 FTP 계정이 활성화되어 있는지 확인합니다.
- 터미널로 연결해 정확한 서버 응답을 확인합니다:
ftp ftp.example.com
425 데이터 연결을 열 수 없음
로그인은 성공하지만 파일 목록 조회나 전송이 425 오류로 실패합니다.
일반적인 원인:
- 액티브/패시브 모드 불일치. 서버가 데이터 채널을 열 수 없습니다.
- FTPS의 경우: 제어 연결과 데이터 연결 간 TLS 세션 재사용 실패.
해결 방법:
- 패시브 모드로 전환합니다.
- FTPS의 경우, 포트 990의 Implicit 모드 대신 포트 21의 Explicit 모드를 시도하거나 반대로 해봅니다.
- 일부 서버는 특정 TLS 버전을 요구합니다. 클라이언트 설정에서 TLS 1.2로 제한을 시도해봅니다.
SSL/TLS 핸드셰이크 실패
FTPS 연결에서 발생합니다. 암호화 협상이 실패합니다.
일반적인 원인:
- 서버의 SSL 인증서가 만료되었습니다.
- FTPS를 요구하는 포트에 일반 FTP로 연결하거나 반대의 경우.
- TLS 버전 불일치. 서버는 TLS 1.2를 요구하는데 클라이언트가 TLS 1.0으로 시도합니다.
- 클라이언트가 신뢰하지 않는 자체 서명 인증서.
해결 방법:
- 연결 설정에서 FTPS(일반 FTP가 아닌)를 선택했는지 확인합니다.
- Explicit과 Implicit FTPS 모드를 모두 시도해봅니다.
- 서버가 자체 서명 인증서를 사용한다면 클라이언트에 수락 옵션이 있는지 확인합니다.
- 서버 관리자에게 인증서가 유효하고 TLS 버전이 올바르게 설정되어 있는지 확인합니다.
호스트 키 검증 실패 (SFTP)
SFTP에서 발생합니다. 서버의 SSH 키가 예상과 다르기 때문에 Mac이 연결을 거부합니다.
일반적인 원인:
- 서버가 재설치되었거나 SSH 키가 재생성되었습니다.
- 처음 연결할 때 엄격한 호스트 검사가 활성화되어 있습니다.
- 중간자 공격 가능성 (드물지만 이 경고의 목적이 그것입니다).
해결 방법:
- 서버가 재설치된 것을 알고 있다면 이전 키를 삭제합니다:
ssh-keygen -R hostname - 다시 연결하고 프롬프트가 표시될 때 새 키를 수락합니다.
- 키 변경을 예상하지 못했다면 수락하기 전에 서버 관리자에게 확인합니다.
권한 거부
연결과 로그인은 성공하지만 파일을 읽거나 쓸 수 없거나 특정 디렉토리에 접근할 수 없습니다.
일반적인 원인:
- FTP 사용자가 대상 디렉토리에 읽기/쓰기 권한이 없습니다.
- 서버의 디렉토리 소유자가 FTP 사용자와 일치하지 않습니다.
- Chroot/jail 제한으로 홈 디렉토리 밖으로의 이동이 금지되어 있습니다.
해결 방법:
- 서버 관리자에게 계정의 권한을 확인합니다.
- FTP 클라이언트의 원격 경로가 올바르고 해당 사용자가 접근 가능한지 확인합니다.
- 관리 권한이 있는 서버라면 디렉토리 권한을 확인합니다:
ls -la /path/to/directory
Mac 특유의 문제
macOS에 특유한 몇 가지:
- macOS는 High Sierra(10.13)부터 내장 FTP 서버를 제거했습니다. Mac에서 FTP 서버가 필요하다면 타사 소프트웨어가 필요합니다.
- macOS 업데이트로 SFTP가 작동하지 않을 수 있습니다. 특히 Monterey 같은 주요 업그레이드 후 Cyberduck, Transmit 등의 앱에서 SFTP 연결이 끊겼다는 보고가 있습니다. Mac을 재시작하거나 SSH 설정을 초기화하면 보통 해결됩니다.
- Gatekeeper 경고로 인해 새로 다운로드한 FTP 앱이 열리지 않을 수 있습니다. 앱을 오른쪽 클릭하고 열기를 선택하거나, 시스템 설정 > 개인 정보 보호 및 보안에서 허용하세요.