NetDrive SFTP 인증 실패 해결하기 — 키, 비밀번호, 포트

NetDrive에서 SFTP 연결을 추가하고 Connect를 클릭했는데 인증 오류가 발생하거나, 드라이브가 30초 동안 조용히 응답 없이 시간 초과된 적이 있을 것입니다. SFTP 인증 실패는 Linux 서버, NAS 장치, 공유 호스팅 계정을 마운트할 때 가장 흔히 걸리는 문제입니다. 거의 모든 경우가 세 가지 근본 원인 중 하나로 귀결됩니다. 잘못된 자격 증명이나 호스트 설정, SSH 키 형식 불일치, 또는 오래된 호스트 키 캐시 항목입니다.

모든 SFTP 서버를 네이티브 드라이브로 마운트하세요

NetDrive 는 Google Drive, OneDrive, S3, SFTP, WebDAV 등을 Windows 와 macOS 에서 일반 드라이브처럼 보이게 합니다 — 동기화도, 전체 다운로드도 없이.

• 비밀번호 인증과 SSH 키 인증을 모두 지원
• Linux 서버, Synology/QNAP NAS, 호스팅 계정과 함께 작동
• Windows와 macOS에서 사용 가능

WindowsmacOS

NetDrive 다운로드 →

무료 체험. 평생 라이선스와 구독 플랜 제공.

증상과 원인 매칭하기

설정을 건드리기 전에 어떤 증상에 해당하는지 먼저 파악하세요.

증상	가장 유력한 원인
즉시 “Authentication failed” 발생	잘못된 사용자 이름, 비밀번호, 또는 키가 허용되지 않음
30~60초 멈췄다가 시간 초과	잘못된 호스트 이름 또는 포트, 방화벽이 22번 포트를 차단
”Host key verification failed”	해당 호스트에 첫 연결이거나 서버 지문이 변경됨
잠시 마운트되었다가 끊김	서버 측 유휴 시간 초과 또는 네트워크 불안정

이 글에서는 처음 세 가지를 다룹니다. 유휴 상태 후 마운트가 끊긴다면 Fix Mount Disconnects After Sleep on macOS에 나온 킵얼라이브 패턴이 SFTP에도 동일하게 적용됩니다.

해결 1: 자격 증명과 호스트 설정 확인하기

NetDrive의 Drive Manager를 열고 SFTP 드라이브를 선택한 뒤 Edit을 클릭합니다. 각 필드를 꼼꼼히 확인하세요.

• Host — sftp:// 접두사 없이 서버의 호스트 이름 또는 IP 주소만 입력합니다. NetDrive가 프로토콜을 자동으로 추가합니다. 여기에 슬래시를 끝에 붙이면 확인(resolution)이 깨집니다.
• Port — SFTP 기본값은 22입니다. 서버 관리자가 보안 강화를 위해 SSH를 비표준 포트로 옮긴 경우(흔한 조치입니다), 해당 포트를 직접 입력하세요. 서버가 2222번 포트를 사용하는데 22번으로 연결하면 “authentication failed” 메시지가 아니라 시간 초과가 발생하므로, 이런 이유로 자주 간과됩니다.
• Username — 대소문자를 구분합니다. Linux 시스템에서 Admin과 admin은 서로 다른 계정입니다.
• Password — 필드가 이미 채워져 있는 것처럼 보이더라도 다시 입력하세요. 서버 측에서 비밀번호가 변경되면 저장된 자격 증명이 조용히 무효화될 수 있습니다.

필드를 수정한 뒤에는 저장만 하지 말고 Connect를 클릭하세요. NetDrive는 저장 시점이 아니라 실제 연결 시도 시점에만 자격 증명을 검증합니다.

해결 2: SSH 키 형식 문제

SSH 키 인증은 비밀번호보다 안전하지만, NetDrive는 개인 키가 PEM 형식이어야 합니다. RSA 키는 -----BEGIN RSA PRIVATE KEY-----로, ECDSA 키는 -----BEGIN EC PRIVATE KEY-----로 시작해야 합니다. 최신 OpenSSH 버전은 기본적으로 새로운 형식(-----BEGIN OPENSSH PRIVATE KEY-----)으로 키를 생성하는데, NetDrive는 이 형식을 지원하지 않습니다.

키를 생성한 머신에서 OpenSSH 형식 키를 PEM으로 변환하려면 다음 명령을 사용합니다.

ssh-keygen -p -m PEM -f ~/.ssh/id_rsa

이 명령은 개인 키 파일을 그 자리에서 덮어씁니다. 실행 전에 반드시 백업하세요.

NetDrive의 SFTP 드라이브 설정에서:

1. Auth type을 Password 대신 Key로 설정합니다.
2. Private key file 항목에서 로컬 머신의 .pem 개인 키 파일을 찾아 지정합니다.
3. 키에 암호(passphrase)가 있다면 Key passphrase에 입력합니다.
4. 원격 서버의 ~/.ssh/authorized_keys에 짝이 되는 공개 키가 이미 등록되어 있는지 확인합니다.

간단한 서버 측 확인 방법으로, 터미널에서 ssh -v user@hostname을 실행하면 서버가 제공하는 인증 방식과 어떤 키를 허용하는지 확인할 수 있습니다. Offering public key와 Server accepts key가 포함된 줄이 보이면 NetDrive와 무관하게 키 쌍이 올바르게 짝지어졌다는 뜻입니다.

해결 3: 오래된 호스트 키 검증

NetDrive가 SFTP 호스트에 처음 연결하거나, 하드웨어 교체·OS 재설치·IP 주소 재사용 등으로 서버의 SSH 지문이 바뀐 경우, 호스트 키 오류로 연결이 거부될 수 있습니다.

NetDrive는 승인된 호스트 키를 내부 known-hosts 캐시에 저장합니다. 오래된 항목을 지우려면:

1. Drive Manager에서 SFTP 드라이브를 선택하고 Edit을 엽니다.
2. 고급 설정 패널에서 Clear known hosts 또는 Reset host key 옵션을 찾습니다.
3. 다시 연결합니다. NetDrive가 새 지문을 승인할지 묻는 메시지를 표시합니다.

변경된 지문을 승인하기 전에, 이미 해당 서버에 SSH로 접근할 수 있는 다른 머신에서 ssh-keyscan -t rsa hostname을 실행해 독립적으로 검증하고, 그 결과를 NetDrive가 제시하는 값과 비교하세요. 운영 서버에서 예상치 못한 지문을 그대로 승인하는 것은 심각한 보안 위험입니다.

마무리

NetDrive에서 발생하는 SFTP 인증 실패는 거의 항상 NetDrive 자체가 아니라 자격 증명, 키 형식, 호스트 설정에서 비롯됩니다. 자격 증명, 키 형식, 호스트 키 캐시 순서로 세 가지 해결책을 차례로 확인하면 몇 분 안에 원인을 찾아낼 수 있습니다. 그래도 해결되지 않는다면 NetDrive 환경설정에서 상세 로깅을 켜고 로그를 support.bdrive.com에 올려 추가 진단을 받으세요.

관련 글: Fix WebDAV Synology Connection Errors, Fix S3 Access Denied Errors in NetDrive.

— Tayson, NetDrive