AD JB Toolbox 01

에디트플러스 / FTP, SFTP로 원격 서버 접속하는 방법

에디트플러스(EditPlus)에서 원격 서버의 파일을 편집하려면 [파일] → [FTP] → [FTP 설정]에서 접속 계정을 등록한 뒤 [원격 열기] 또는 [디렉토리 창]으로 파일을 엽니다. SFTP 서버는 [고급 옵션]에서 암호화 방식을 sftp로 선택하고, 서버 관리자가 알려 준 포트와 인증 정보를 사용해야 합니다.

EditPlus는 별도 확장 기능 없이 FTP·FTPS·SFTP 원격 편집을 지원합니다. 지원 기능은 EditPlus 공식 기능 안내에서 확인할 수 있습니다. 아래 이미지는 기존 글에 사용한 한국어 화면이며, 설치 버전과 언어에 따라 메뉴 이름이나 배치가 조금 다를 수 있습니다.

접속 전에 준비할 정보

웹사이트 관리자 계정이 있다고 파일 전송 서버에도 접속할 수 있는 것은 아닙니다. 호스팅 관리 화면이나 서버 관리자에게 파일 전송용 접속 정보를 확인하세요. 최소한 다음 항목이 필요합니다.

  • 서버 주소: 파일 전송 서버의 호스트 이름 또는 IP 주소입니다. 웹사이트 주소와 다를 수 있으며 https://로 시작하는 웹페이지 주소를 그대로 넣지 않습니다.
  • 접속 방식과 포트: FTP, SFTP, FTPS 중 서버가 제공하는 방식을 확인합니다. 사용자 지정 포트가 있으면 기본값 대신 그 번호를 사용합니다.
  • 사용자 이름과 인증 정보: 비밀번호 인증인지 개인 키 인증인지, 추가 인증 절차가 있는지 확인합니다.
  • 시작 디렉토리: 로그인 후 열 폴더입니다. 호스팅이 계정별 루트 경로를 제한하면 보이는 경로가 운영체제의 실제 경로와 다를 수 있습니다.
  • 접근 권한: 파일 읽기와 폴더 목록 조회가 되는지, 수정하려는 경로에 쓰기 권한도 있는지 확인합니다. 파일을 열 수 있다는 사실만으로 저장 권한까지 확인되는 것은 아닙니다.

운영 파일을 수정한다면 먼저 원본을 따로 보관하고, 여러 사람이 같은 파일을 편집 중인지 확인합니다. 원격 편집은 저장 결과가 서버에 반영되므로 테스트용 파일에서 접속과 저장을 먼저 확인하는 편이 좋습니다.

FTP, SFTP, FTPS의 차이와 포트

FTP(File Transfer Protocol)는 파일 전송 프로토콜입니다. SFTP(SSH File Transfer Protocol)는 SSH(Secure Shell) 연결을 이용하는 별도 프로토콜이며, FTP의 암호화 옵션과 같은 프로토콜이 아닙니다. FTPS는 FTP에 TLS(Transport Layer Security) 암호화를 적용하는 방식입니다.

방식 전송 보호 방식 설정할 때 확인할 점
일반 FTP 기본 FTP는 암호화하지 않음 통상 제어 연결 포트는 21이며, 데이터 연결 설정도 확인
SFTP SSH 연결을 이용해 전송 통상 SSH 포트는 22이며, 계정·인증 방식과 호스트 키 확인
FTPS TLS로 FTP 연결을 보호 명시적·암시적 방식과 포트, 인증서, 데이터 연결 보호 설정 확인

기본 FTP는 비밀번호와 데이터를 암호화하지 않는다는 점이 FTP 보안 고려 사항(RFC 2577)에 설명되어 있습니다. 서버가 SFTP를 제공한다면 암호화된 접속 방식을 우선 검토하세요. SFTP의 동작은 OpenSSH sftp 설명, FTPS는 FTP에 TLS를 적용하는 표준(RFC 4217)에서 확인할 수 있습니다.

FTP 포트 21은 IANA 서비스 포트 등록부에, SSH의 기본 포트 22는 OpenSSH 서버의 Port 설정에 명시되어 있습니다. 다만 서버는 다른 포트를 사용할 수 있습니다. 포트 번호만 바꾸면 접속 방식도 바뀌는 것은 아니므로, 암호화 방식과 포트를 함께 맞춰야 합니다.

접속 계정 등록과 FTP·SFTP 설정

  1. [파일] → [FTP] → [FTP 설정]을 엽니다. 메뉴 이름은 FTP이지만 이곳에서 SFTP 접속 계정도 관리합니다.

EditPlus 파일 메뉴의 FTP 하위 메뉴에서 FTP 설정을 선택하는 화면

  1. FTP 설정 창에서 사용할 그룹을 고른 뒤 [추가]를 누릅니다. 여러 서버를 관리할 때는 개발용과 운영용처럼 구분하기 쉬운 그룹과 설명을 사용합니다.

FTP 설정 창에서 새 접속 계정을 등록하는 추가 버튼

  1. [설명], [FTP 서버], [Username]과 필요한 인증 정보를 입력합니다. 시작 폴더를 알고 있다면 [디렉토리]에 넣고, 모른다면 비워 둔 상태로 접속해 허용된 경로부터 확인합니다. 다음으로 [고급 옵션]을 엽니다.

서버 주소와 사용자 정보를 입력한 뒤 고급 옵션을 여는 FTP 계정 설정 화면

설정 항목 입력 기준
설명 개발 서버, 운영 서버처럼 접속 대상을 구분할 이름
FTP 서버 예: files.example.com — 실제 서버 주소로 바꾸어 입력
Username / Password 서버에서 발급받은 파일 전송 계정과 비밀번호 인증 정보
디렉토리 해당 계정이 접근할 수 있는 시작 폴더; 모르면 우선 생략
암호화 / 포트 서버의 프로토콜과 실제 접속 포트에 맞게 지정

표의 files.example.com은 설명용 주소입니다. 실제로 연결할 서버 주소와 계정 정보를 사용하세요. 비밀번호 입력만으로 접속되는 서버인지, 키 인증만 허용하는 서버인지도 구분해야 합니다.

  1. SFTP를 사용한다면 [고급 FTP 설정]의 [암호화]에서 sftp를 선택하고 [포트]를 서버의 SSH 포트로 맞춥니다. 일반 FTP나 FTPS라면 관리자가 안내한 방식을 선택합니다. 값을 확인한 뒤 고급 설정과 계정 설정을 차례로 저장합니다.

고급 FTP 설정의 암호화 목록에서 sftp를 선택하고 포트를 지정하는 화면

이미지의 [Passive FTP 모드]는 FTP 계열의 데이터 연결과 관련된 설정입니다. SFTP 접속 실패를 해결하기 위해 이 항목을 바꾸는 것은 적절하지 않습니다. 파일 목록이나 전송이 멈추는 FTP 문제에서 서버의 수동 모드 포트와 방화벽 설정을 확인할 때 검토합니다.

개인 키로 인증하는 서버라면 현재 EditPlus와 서버가 지원하는 키 인증 방법을 확인해야 합니다. 기존 화면에는 [Pageant 사용] 항목이 있지만, 키를 사용하는 모든 환경에서 비밀번호 입력만으로 접속할 수 있는 것은 아닙니다. 인증 및 암호 알고리즘 호환성 문제는 EditPlus 공식 변경 이력도 확인하세요. 연결을 위해 서버의 보안 설정을 무작정 낮추지 않습니다.

원격 파일 여는 두 가지 방법

파일 메뉴에서 원격 열기

  1. [파일] → [FTP] → [원격 열기]를 선택합니다.

EditPlus 파일 메뉴에서 FTP의 원격 열기를 선택하는 화면

  1. 원격 파일 창에서 등록한 접속 계정을 선택하고 연결합니다. 사용할 파일이 있는 폴더로 이동한 뒤 파일을 선택해 엽니다.
  2. 현재 문서가 의도한 서버와 원격 경로에서 열린 파일인지 확인합니다. 비슷한 이름의 로컬 파일이나 다른 서버 파일과 혼동하지 않도록 합니다.

파일 하나를 바로 열 때 사용할 수 있는 방법입니다. 처음 SFTP 서버에 접속하면서 호스트 키 확인 창이 나온다면 서버 관리자가 제공한 지문과 일치하는지 확인합니다. 이전과 다른 키가 표시되면 서버 재설치나 키 변경 여부를 확인한 뒤 진행하세요.

디렉토리 창에서 서버 선택

  1. 디렉토리 창의 위치 목록을 열고 등록한 FTP 또는 SFTP 접속 계정을 선택합니다.

디렉토리 창의 위치 목록에서 등록한 원격 서버 계정을 선택하는 화면

  1. 연결된 서버의 폴더를 펼치고 수정할 파일을 엽니다. 목록에는 로그인한 계정에 허용된 폴더와 파일이 표시됩니다.

원격 서버에 연결한 디렉토리 창에서 폴더와 파일 목록을 탐색하는 화면

여러 폴더의 파일을 번갈아 열 때 디렉토리 창이 편리합니다. 화면에 표시된 /가 서버 전체 파일 시스템의 루트라고 단정하면 안 됩니다. 계정이나 서버 설정에 따라 제한된 디렉토리가 루트처럼 표시될 수 있습니다.

디렉토리 창이 보이지 않을 때

[보기] → [도구모음/창] → [디렉토리 창]을 선택합니다. 기존 화면에서는 이 항목에 Alt+Shift+3 단축키가 표시되지만, 사용자 지정 단축키나 버전에 따라 달라질 수 있으므로 메뉴의 표시를 기준으로 확인하세요.

보기 메뉴의 도구모음 및 창 하위 메뉴에서 디렉토리 창을 표시하는 항목

창이 있어도 로컬 드라이브가 선택되어 있다면 원격 파일 목록이 나오지 않습니다. 디렉토리 창의 위치 목록에서 등록한 서버를 다시 선택합니다. 여러 계정이 있는 경우 설명과 그룹을 확인해 작업 대상을 구분하세요.

저장 후 서버에 반영되었는지 확인하기

원격 파일로 연 문서를 수정한 뒤 Ctrl+S로 저장하면 원격 저장 작업을 수행할 수 있습니다. 다만 저장 명령을 눌렀다는 사실만으로 업로드 성공이 확인되는 것은 아닙니다. 연결 상태와 쓰기 권한에 따라 실패할 수 있고, 로컬 파일을 편집 중이라면 로컬 저장이 이루어집니다.

  1. 수정 전 원본을 보관합니다. 별도 로컬 복사본이나 서버의 백업·버전 관리 자료처럼 원격 덮어쓰기와 독립적인 복원 수단을 마련합니다.
  2. 원격 경로를 확인하고 저장합니다. 테스트 파일로 작은 변경을 한 뒤 전송 오류나 추가 저장 창이 나타나는지 확인합니다. 다른 사용자가 같은 파일을 바꾸고 있다면 최신 내용을 다시 비교합니다.
  3. 서버 파일을 다시 읽어 확인합니다. 저장이 끝난 뒤 파일 목록을 새로 고치고, 필요하면 별도 문서로 다시 열어 변경한 내용이 실제 서버 파일에 있는지 확인합니다. 아직 저장하지 않은 문서를 무작정 닫아 확인하려고 하지 않습니다.
  4. 실제 적용 결과를 확인합니다. 웹페이지나 설정 파일이라면 해당 서비스의 반영 결과도 확인합니다. 캐시, 다른 배포 경로 또는 서비스 재시작 필요 여부는 서비스 구성에 따라 다릅니다.

로컬 [다른 이름으로 저장] 창이 나온다면 현재 문서가 어떤 위치에서 열린 것인지와 사용한 저장 명령부터 확인하세요. 이를 곧바로 “서버에서 파일을 잘못 열었다”는 한 가지 원인으로 단정하지 않습니다. 수정 내용이 사라지지 않도록 로컬 복사본을 먼저 보관한 뒤 원격 파일을 다시 열어 비교하고, 의도한 위치에만 반영합니다.

되돌릴 때는 보관한 원본과 현재 서버 파일을 비교한 뒤 해당 파일을 복원하고 다시 읽어 확인합니다. 복원 직전에 다른 사람이 수정한 내용이 있는지도 확인해야 합니다. 계정 설정이 잘못된 경우에는 [FTP 설정]에서 해당 계정의 값만 수정하거나 불필요한 접속 항목을 제거하며, 서버 파일 삭제와 혼동하지 않습니다.

연결이나 저장이 안 될 때 확인할 항목

증상 먼저 확인할 항목
연결 시간 초과 또는 연결 거부 서버 주소, 프로토콜, 실제 포트, 접속 서비스 상태와 네트워크 접근 제한
인증 실패 사용자 이름, 비밀번호·키 인증 방식, 계정 상태와 추가 인증 요구
SFTP 호스트 키 경고 관리자가 제공한 지문과 비교하고 키 변경 사유 확인
FTP 로그인 후 목록 조회나 전송이 멈춤 Passive FTP 모드, 서버의 데이터 포트 범위와 방화벽·공유기 설정
파일은 열리지만 저장 실패 파일·부모 폴더 쓰기 권한, 디스크 여유 공간, 연결 끊김과 읽기 전용 상태
한글 이름이나 본문이 깨짐 파일 이름용 UTF-8 설정과 문서 내용 인코딩을 구분하여 확인
저장해도 웹페이지가 바뀌지 않음 실제 서버 파일 내용, 수정한 배포 경로, 서비스 반영 방식과 캐시

파일 이름에 쓰는 문자 인코딩과 파일 내용의 인코딩은 별개의 문제입니다. [UTF-8 파일명 사용]은 서버의 파일 이름 처리 방식과 맞출 때 검토하며, 본문의 한글이 깨진다면 문서가 어떤 인코딩으로 열렸는지 확인합니다. 깨진 상태로 덮어쓰지 말고 원본 복사본을 남긴 뒤 올바른 인코딩으로 다시 열어야 합니다.

오류 메시지를 기준으로 주소·포트 → 인증 → 목록 조회 → 파일 읽기 → 저장 순서로 문제 지점을 좁혀 보세요. 다른 클라이언트에서도 같은 계정이 실패하면 서버 측 조건을 함께 확인하고, EditPlus에서만 실패한다면 설치 버전과 지원하는 인증 방식, SFTP 관련 수정 내역을 검토합니다. 접속을 해결하기 위해 관리자 계정 사용이나 폴더 전체 쓰기 권한 부여부터 시도하지 않습니다.

같은 카테고리의 다른 글
에디트플러스 / FTP, SFTP로 원격 서버 접속하는 방법

에디트플러스 / FTP, SFTP로 원격 서버 접속하는 방법

에디트플러스에서 FTP·SFTP 접속 계정을 등록하고 원격 파일을 여는 과정을 화면과 함께 설명합니다. 프로토콜·포트 선택, 원격 저장 확인과 연결·인증·권한 오류의 점검 방법을 정리합니다.