파일질라 오류 사전
파일질라에서 빨간 글씨가 나오면 덜컥 겁부터 나지요. 하지만 오류 문구는 대부분 "어디서 막혔는지"를 알려 주는 표지판입니다.
💡 결론부터: 메시지 로그의 마지막 빨간 줄(오류:)과 그 바로 위 몇 줄을 보세요. 그 문구를 아래 표에서 찾으면 뜻과 해결 글로 바로 갈 수 있습니다. 어떤 오류인지 모르겠다면 → 접속이 안 될 때 10분 체크리스트
🙋 오류가 났다고 해서 파일질라나 PC가 고장 난 것은 아닙니다. 대부분 주소·포트·계정 같은 입력값이나 방화벽·공유기 같은 길목 문제이고, 설정만 바로잡으면 해결됩니다.
먼저: 메시지 로그 읽는 법
파일질라 화면 위쪽(기본 배치 기준)의 [메시지 로그](Message log)에는 파일질라와 서버가 주고받는 대화가 한 줄씩 쌓입니다. 줄마다 앞에 말머리가 붙어 있어요. → 화면 위치는 화면 구성 한눈에 보기
| 말머리 | 색 (공식 위키 기준) | 뜻 |
|---|---|---|
| 상태: | 검정 | 파일질라가 지금 하는 일 (예: "디렉터리 목록 조회 성공") |
| 명령: | 파랑 | 파일질라가 서버에 보낸 명령 (예: USER, PASV) |
| 응답: | 초록 | 서버가 돌려준 답. 세 자리 숫자로 시작 (예: 230) |
| 오류: | 빨강 | 문제가 생겼을 때 |
| 목록: · 추적: | 청록 · 보라 | 자세한 로그를 켰을 때만 나오는 원시 목록·디버그 정보 |
이렇게 읽으세요
아래는 비밀번호를 일부러 틀리게 넣어 파일질라 3.71.1 한국어판에서 실제로 받은 로그입니다(연습용 서버, IP는 문서용 주소로 바꿈).
상태: ftp.example.com 주소 해석
상태: 192.0.2.10:21에 연결...
상태: 연결 수립, 환영 메시지를 기다림...
상태: 보안되지 않은 서버입니다. TLS를 통한 FTP를 지원하지 않습니다.
명령: USER webuser
응답: 331 Password required for webuser.
명령: PASS ********
응답: 530 Login incorrect.
오류: 치명적 오류: 서버에 연결하지 못함- 위에서 아래로 읽습니다. 마지막으로 성공한 상태: 줄이 "어디까지 갔는지"를 알려 줘요.
- 응답: 줄의 숫자가 서버의 대답입니다. 위 예시에서
331은 "비밀번호를 주세요",530은 "로그인 거부"라는 뜻이에요. - 맨 끝 오류: 줄은 결과만 알려 주는 경우가 많습니다. 진짜 원인은 그 바로 윗줄에 있을 때가 많아요. 위 예시라면 원인은 "서버에 연결하지 못함"이 아니라 그 위의 530입니다.
💡 로그를 오른쪽 클릭하면 클립보드로 복사(Copy to clipboard)가 있습니다. 질문 게시판에 올릴 때는 호스트 주소와 사용자명을 가리고 올리세요. 로그가 줄여서 보인다면 오른쪽 클릭 → 상세 로그 표시(Show detailed log)로 전체를 볼 수 있습니다.
자주 보이는 응답 번호 (정상)
| 번호 | 뜻 |
|---|---|
331 | 비밀번호를 입력하라는 요청 |
230 | 로그인 성공 |
257 | 현재 경로 알림 |
250 | 폴더 이동 성공 |
227 | 수동형(패시브) 모드 진입 — 데이터 연결에 쓸 주소·포트를 알려 줌 → 액티브 vs 패시브 |
150 · 226 | 디렉터리 목록 전송 시작 · 전송 완료 |
반대로 아래 표에 나오는 421, 425, 530, 550, 553은 모두 서버가 요청을 처리하지 못했다는 응답입니다. 이런 번호가 보이면 아래 표에서 찾아보세요.
오류 사전 (전체 표)
"한국어판 문구"는 파일질라 한국어판에 실제로 나오는 문구입니다. 서버가 보내는 응답(530, 550 등)은 서버가 영어로 보내므로 영어 그대로 나옵니다.
접속 단계에서 막힐 때
| 한국어판 문구 | 한 줄 뜻 | 해결 글 |
|---|---|---|
서버에 연결하지 못함 | 서버에 접속하는 과정이 끝내 실패했다는 최종 결과 알림. 원인은 대개 바로 윗줄에 있음 | 서버에 연결하지 못함 |
연결 수립, 환영 메시지를 기다림... | 서버까지 연결은 됐고, 서버의 첫 인사(환영 메시지)를 기다리는 상태 메시지. 여기서 더 진행되지 않으면 문제 | 환영 메시지를 기다림에서 멈출 때 |
20 초간 활동이 없어 연결 시간이 만료됨 | 정해 둔 시간 동안 서버에서 아무 응답이 없어 파일질라가 기다리기를 멈춤 | 연결 시간 초과 |
ECONNREFUSED - 서버에서의 연결 거부 | 그 주소·포트로 연결을 시도했지만 거절당함. 포트·프로토콜이 맞는지부터 확인 | ECONNREFUSED |
ETIMEDOUT | 연결을 시도했지만 응답이 오지 않음(연결 시간 초과) | ETIMEDOUT |
ENETUNREACH | 네트워크에 도달할 수 없음. 공식 위키에는 보안 프로그램이 원인이었던 사례가 있음 | ENETUNREACH |
530 Login incorrect. | 서버가 로그인을 거부함. 아이디·비밀번호, 앞뒤 공백 등을 확인 | 530 로그인 오류 |
421 Too many connections | 서버가 허용하는 동시 연결 수를 넘음 | 421 Too many connections |
접속은 되는데 목록·전송이 안 될 때
| 한국어판 문구 | 한 줄 뜻 | 해결 글 |
|---|---|---|
디렉터리 목록을 조회하는 데 실패함 | 로그인은 됐지만 폴더 목록을 받아 오지 못함. 데이터 연결이 중간에서 막힌 경우가 많음 | 디렉터리 목록 조회 실패 |
425 Can't open data connection | 서버가 데이터 연결을 열지 못함. 수동형 포트가 막혀 있을 때 흔함 | 425 오류 |
550 Permission denied | 요청한 작업이 거부됨. 권한이 없거나 파일·폴더가 없는 경우 등 | 550 Permission denied |
553 Could not create file. (뒤 문구는 서버마다 다름) | 서버가 그 이름으로 파일을 만들지 못함. 한글·특수문자 이름, 막힌 확장자가 흔한 원인이고, 공식 위키는 용량·파일 수 한도 초과도 의심하라고 설명 | 553 오류 |
잘못된 문자열이 수신되었습니다. 디렉터리 목록에 일부 또는 모든 파일이 표시되지 않을 수 있습니다… | 서버와 파일질라가 쓰는 글자 인코딩(문자셋)이 서로 다름. 한글 이름 파일이 깨지거나 목록에서 아예 사라짐 | 한글 파일명 깨짐 |
| 큰 파일 전송 중 끊김 | 전송하는 동안 쉬고 있는 제어 연결을 공유기·방화벽이 알리지 않고 끊는 경우가 대표적 | 큰 파일 전송 중 끊김 |
보안 접속(FTPS·SFTP)에서 나올 때
| 한국어판 문구 | 한 줄 뜻 | 해결 글 |
|---|---|---|
알 수 없는 인증서 | FTPS 서버의 인증서를 아직 신뢰한 적이 없어서 확인을 묻는 창. 오류라기보다 확인 절차 | 알 수 없는 인증서 |
| SFTP 인증 실패·호스트 키 변경 경고 | 서버의 호스트 키가 저장해 둔 키와 다름. 관리자가 키를 바꿨거나, 다른 컴퓨터가 서버인 척하는 경우 | SFTP 호스트 키 변경 경고 |
| 3.70 업데이트 이후 SFTP 접속 문제 | 3.70.0부터 SFTP 엔진이 fzssh로 바뀐 뒤, 규격을 잘 지키지 않는 일부 서버에서 생긴 문제와 후속 패치 | 3.70 이후 SFTP 접속 문제 |
개념 글
| 주제 | 한 줄 설명 | 글 |
|---|---|---|
| 액티브(능동형) vs 패시브(수동형) | FTP가 파일을 실어 나를 두 번째 연결을 누가 먼저 거느냐의 차이. 파일질라 기본은 수동형 | 액티브 vs 패시브 모드 |
표에 없는 오류가 나왔다면
- 오류: 줄 바로 위 두세 줄을 함께 봅니다. 숫자 응답(
4xx,5xx)이나ECONN…,ETIMEDOUT같은 영어 대문자 코드가 있으면 그게 핵심이에요. - 10분 체크리스트를 순서대로 확인합니다.
- 그래도 모르겠다면 로그를 복사해 질문하세요. 공식 지원 안내는 영어로 문의할 때 파일질라 언어를 영어로, 디버그 단계를 올린 로그를 수정 없이 첨부하라고 권합니다. 디버그 단계는 편집 → 설정 → 디버그 → 메시지 로그의 디버그 정보에서 바꿉니다. 문제가 풀리면 원래대로 돌려 두세요(공식 위키 권고).
참고한 공식 문서
- FileZilla 위키 — Logs: https://wiki.filezilla-project.org/Logs
- FileZilla 위키 — Log text: https://wiki.filezilla-project.org/Log_text
- FileZilla 위키 — Network Configuration: https://wiki.filezilla-project.org/Network_Configuration
- FileZilla 위키 — FTP over TLS: https://wiki.filezilla-project.org/FTP_over_TLS
- FileZilla 위키 — ENETUNREACH with Kaspersky: https://wiki.filezilla-project.org/ENETUNREACH_with_Kaspersky
- FileZilla 지식베이스 — How to Fix "Could not Connect to Server" Critical Error: https://filezillapro.com/docs/v3/troubleshooting/critical-error-could-not-connect-to-server/
- FileZilla 지식베이스 — How to Fix the Login failure: https://filezillapro.com/docs/v3/troubleshooting/login-failure/
- FileZilla 지식베이스 — Directory Listings and File Transfers Fail: https://filezillapro.com/docs/v3/troubleshooting/directory-listings-and-file-transfers-fail/
- FileZilla 지식베이스 — Message Log: https://filezillapro.com/docs/v3/faq/message-log/
이 글의 일부는 FileZilla 위키(GFDL)를 참고해 한국어로 새로 썼습니다.
요약
한눈에 정리
- 1마지막 빨간 줄을 보기
메시지 로그의 오류: 줄과 그 위 몇 줄을 확인해요.
- 2표에서 문구 찾기
그 문구로 뜻과 해결 글을 바로 찾을 수 있어요.
- 3모르겠으면 체크리스트
10분 체크리스트를 1번부터 따라 해요.
최종 수정 2026-09-25