클라우드웨이즈(Cloudways)에 SFTP 접속 시 오류가 발생하면서 접속이 안 되는 경우가 있습니다. 최근 들어, Cloudways에 sftp에 접속할 수 없다고 호소하는 분들이 계셔서 클라우드웨이즈에서 sftp 접속 오류가 발생하는 경우 확인할 사항을 정리해 보았습니다.
클라우드웨이즈: SFTP 접속 오류가 발생하는 경우
클라우드웨이즈에 SFTP에 접속하는 방법으로 크게 두 가지 방법이 있습니다.
- 서버의 MASTER CREDENTIALS 정보를 이용하여 sftp에 접속: 서버 내의 모든 애플리케이션에 접근이 가능하게 됩니다.
- 특정 애플리케이션의 APPLICATION CREDENTIALS 섹션에서 사용자 이름/비밀번호를 생성하여 sftp에 접속: 해당 애플리케이션(예: 워드프레스 등)에만 접근이 가능하게 됩니다.
서버 레벨의 sftp 접속 정보는 서버 관리 페이지의 MASTER CREDENTIALS 섹션에서 확인할 수 있습니다.
sftp에 접속하려면 Public IP, Username, Password 정보가 필요합니다. 자세한 방법은 다음 글을 참고해 보세요.
특정 애플리케이션에만 접속이 가능하도록 하려면 애플리케이션 관리 페이지의 Application Credentials 섹션에서 Username과 Password를 추가할 수 있습니다.
특정 애플리케이션에만 접속이 가능하도록 제한하는 자세한 방법에 대해서는 추후 별도의 글에서 다루어 보겠습니다. 여기는 서버 마스터 크레덴셜 정보를 이용하여 sftp에 접속하는 것에 대하여 살펴보겠습니다.
SFTP 접속 오류
예를 들어, sftp에 접속을 시도할 때 다음과 같은 오류 메시지가 표시될 수 있습니다.
위의 화면에서는 "Connection timed out after 20 seconds of inactivity ... fzSftp started, protocol_version=11..." 이와 같은 에러 메시지가 표시되면서 sftp에 접속이 안 되는 현상을 보여줍니다.
또한, Fatal error: Connection reset by peer 오류가 표시될 수도 있습니다.
접속 오류 해결 방법
잘못된 sftp/ftp 로그인 정보
sftp/ftp 접속 오류의 대부분은 sftp/ftp 정보가 잘못되어 발생합니다. 정보가 잘못될 경우 다음과 같은 오류 메시지가 표시됩니다.
상태: Using username "xxxxx".
상태: Access denied
오류: 인증 실패.
오류: 치명적 오류: 서버에 연결하지 못함
이 경우에는 올바른 sftp 정보를 가지고 다시 로그인을 시도해 보시기 바랍니다.
경험상 90% 이상의 ftp 접속 오류는 이 경우에 해당하는 것 같습니다. ftp 로그인 정보를 알려달라고 요청하면, ftp/sftp가 무엇인지 모르는 분들도 많고, 알려주는 정보가 잘못된 경우가 정말 많습니다.
잘못된 프로토콜 선택
클라우드웨이즈에서는 SFTP 접속을 허용합니다. 파일질라에서 프로토콜을 SFTP - SSH File Transfer Protocol을 선택하시기 바랍니다.
만약 FTP - 파일 전송 프로토콜을 선택하면 다음과 같은 에러가 발생합니다.
오류: Connection timed out after 20 seconds of inactivity
오류: 서버에 연결하지 못함
참고로 FTP만을 허용하는 웹호스팅의 경우(예: 패스트코멧 공유호스팅 등), 프로토콜로 FTP를 선택해야 정상적으로 접속이 가능합니다.
SSH/SFTP 접속 제한이 설정된 경우 ("Connection reset by peer" 오류) - 허용 목록에 내 IP 주소를 등록
"Fatal error: Connection reset by peer" 오류가 발생하는 경우 서버 관리 페이지의 보안(Security) 섹션에서 Block all IP addresses, except those on the Whitlist 옵션이 체크되어 있을 수 있습니다.
보안을 위해 Server Management » Security에서 Block all IP address, except those on the Whitelist 옵션을 선택하시기 바랍니다. 첫 번째 옵션을 선택하면 클라우드웨이즈 보안 시스템에서 차단하는 IP 주소 이외의 모든 IP 주소를 허용(Allow all IP addresses, except those blocked by the Cloudways security system)하게 됩니다. 그런 경우 보안 문제가 나타날 수 있으므로 두 번째 옵션을 선택하세요.
SFTP에 정상적으로 접속하기 위해서는 Whitelist IP 섹션에서 내 IP 주소 또는 허용 IP 주소를 입력하고 ADD 버튼을 누르고 추가한 다음, Save Changes 버튼을 눌러 저장해야 합니다.
이제 올바른 sftp 정보를 이용하여 접속을 시도하면 접속이 될 것입니다.
내 컴퓨터의 IP 주소는 구글이나 네이버에서 "내 IP 주소"로 검색하여 확인할 수 있습니다.
파일질라(FileZilla)를 최신 버전으로 업데이트
간혹 파일질라가 최신 버전이 아닌 경우에 ftp 접속 오류가 발생한다고 하시는 분들이 계십니다. FileZilla를 최신 버전으로 업데이트한 후에 접속을 시도해보시기 바랍니다.
WinSCP 클라이언트 사용
파일질라를 사용하여 접속이 안 되는 경우 WinSCP 프로그램을 사용하여 접속을 시도하면 접속이 되는 경우가 있습니다. FileZilla에 익숙한 경우 WinSCP를 쉽게 사용할 수 있을 것입니다.
참고로 알FTP 등 알 시리즈는 가급적 사용하지 않는 것이 바람직합니다. 알 시리즈는 개인에게는 무료이지만 기업의 경우 유료 버전을 사용해야 합니다(성능도 그리 좋은 편이 아닌 것으로 평가됨).
고객센터에 지원 요청
위의 모든 조치를 취해도 문제가 해결되지 않으면 클라우드웨이즈 고객센터에 연락하여 라이드 채팅으로 상담할 수 있습니다.
마치며
이상으로 클라우드웨이즈에서 SFTP 접속 오류가 발생하는 경우 대처 방법에 대하여 살펴보았습니다. 위의 사항은 다른 웹호스팅을 이용하는 경우에도 적용할 수 있습니다.
많은 경우 FTP/SFTP 정보가 잘못되어 접속 오류가 발생합니다. 올바른 FTP/SFTP 아이디와 비밀번호를 입력하였는지 먼저 체크해보시기 바랍니다. 특히 고객사로부터 정보를 받는 경우 접속 정보 전체에 오류가 있을 가능성이 높습니다(예: 숫자가 글자가 틀리거나 누락되는 경우, 이전 정보를 제공하는 경우 등 다양).
참고
https://avada.tistory.com/2970
https://avada.tistory.com/3046