SFTP를 통해 연결하기: FileZilla, Cyberduck 및 명령줄

SFTP (Secure File Transfer Protocol)는 서버의 사이트 파일에 대한 직접 액세스를 제공합니다. 이 가이드는 자격 증명 찾기부터 오류 해결까지 성공적으로 연결하는 데 필요한 모든 내용을 다룹니다.

SFTP가 무엇이고 언제 사용하는가

KPanel에 내장된 파일 관리자는 빠른 편집에 편리합니다: 파일 이름 바꾸기, 설정 보기 또는 단일 자산 업로드. SFTP는 더 많은 기능이 필요할 때 적합한 도구입니다:

• 한 번에 많은 수의 파일을 업로드 또는 다운로드(사이트 마이그레이션, 대량 이미지 업로드)합니다.
• 브라우저 기반 업로드에서 시간 초과될 수 있는 대용량 파일을 전송합니다.
• 파일을 로컬에서 편집하고 변경 사항을 푸시하는 개발 워크플로우의 일부로 작업합니다.
• 로컬 및 원격 폴더를 동기화 상태로 유지할 수 있는 GUI 클라이언트를 사용합니다.
• KPanel의 파일 관리자를 통해 노출되지 않는 로그 또는 구성 파일에 액세스합니다.

SFTP는 전송 중인 모든 데이터를 암호화하므로 일반 FTP보다 더 안전합니다. KapsuleHost는 암호화되지 않은 FTP 연결을 제공하지 않습니다.

전제 조건

연결하기 전에 두 가지를 준비해야 합니다.

1. KPanel의 사이트에 추가된 SSH 키.

KapsuleHost의 SFTP는 SSH 키 인증을 사용합니다. 암호 인증은 보안상 비활성화됩니다. 아직 SSH 공개 키를 추가하지 않았다면 먼저 사이트에 SSH 키 추가 가이드를 따른 후 여기로 돌아오십시오.

2. 사이트 사용자명.

KapsuleHost의 각 사이트에는 전용 시스템 사용자가 있습니다. 이는 KPanel 이메일 주소가 아닙니다. 해당 사이트에만 특정된 짧은 사용자명입니다.

찾으려면:

1. kpanel.kapsulehost.com에서 KPanel에 로그인합니다.
2. 왼쪽 사이드바에서 Websites를 클릭합니다.
3. 연결할 사이트를 클릭합니다.
4. SSH / SFTP 페이지로 이동합니다.
5. 사이트 사용자명은 이 탭의 상단에 표시됩니다. 일반적으로 mysite_com 또는 myexamplesite_net처럼 보입니다.

한눈에 보는 연결 세부 정보:

---

FileZilla로 연결

FileZilla는 Windows, macOS 및 Linux에서 사용할 수 있는 무료 크로스 플랫폼 SFTP 클라이언트입니다. 아직 설치하지 않았다면 filezilla-project.org에서 다운로드합니다.

단계별 설정

1. FileZilla를 엽니다.

2. File > Site Manager로 이동합니다 (또는 Windows에서 Ctrl+S, Mac에서 Cmd+S을 누릅니다).

3. Add Website를 클릭하고 이름을 입력합니다 (예: "My Kapsule Site").

4. General 탭에서 다음 필드를 구성합니다:

   필드	값
   Protocol	SFTP - SSH File Transfer Protocol
   Host	cp1-kapsule.kapsulehost.com
   Port	22
   Logon Type	Key file
   User	사이트 사용자명 (예: mysite_com)
   Key file	Browse를 클릭하고 개인 키 파일로 이동합니다

5. 키 파일의 경우 KPanel에 추가한 공개 키에 해당하는 개인 키를 선택합니다. macOS 및 Linux에서 개인 키는 일반적으로 ~/.ssh/에 저장됩니다 (예: ~/.ssh/id_ed25519 또는 ~/.ssh/id_rsa). Windows에서는 종종 C:\Users\YourName\.ssh\에 있습니다.

1. Connect를 클릭하여 연결을 테스트하거나 OK를 클릭하여 저장한 후 나중에 연결합니다.

저장 및 다시 연결

Site Manager에 저장되면 File > Site Manager로 이동하여 Connect를 클릭하면 언제든지 다시 연결할 수 있습니다. FileZilla는 빠른 액세스를 위해 도구 모음의 드롭다운에도 저장된 사이트를 표시합니다.

---

Cyberduck으로 연결

Cyberduck은 macOS 및 Windows용 무료 SFTP 클라이언트입니다. cyberduck.io에서 다운로드합니다.

단계별 설정

1. Cyberduck을 엽니다.

2. Open Connection (도구 모음의 지구본 아이콘)을 클릭합니다.

3. 대화 상자 상단의 프로토콜 드롭다운에서 **SFTP (SSH File Transfer Protocol)**를 선택합니다.

4. 연결 필드를 작성합니다:

   필드	값
   Server	cp1-kapsule.kapsulehost.com
   Port	22
   Username	사이트 사용자명 (예: mysite_com)
   Password	공백으로 둡니다
   SSH Private Key	Choose를 클릭하고 개인 키 파일을 선택합니다

5. Connect를 클릭합니다.

처음 연결할 때 Cyberduck은 서버의 호스트 키 지문을 확인하도록 요청합니다. Allow를 클릭하여 진행합니다. 이후 연결에서 다른 지문이 있는 프롬프트가 표시되면 수락하지 말고 지원팀에 문의하세요. 이는 구성 변경을 나타낼 수 있습니다.

북마크로 저장

향후 사용을 위해 연결을 저장하려면:

1. 성공적으로 연결한 후 Bookmark > New Bookmark (또는 Mac에서 Cmd+Shift+B)로 이동합니다.
2. 북마크에 이름을 지정하고 대화 상자를 닫습니다. 북마크가 Cyberduck 북마크 목록에 표시됩니다.

---

터미널에서 연결 (Mac, Linux 또는 WSL)

명령줄을 선호하는 경우 sftp 명령은 macOS, Linux 및 Windows Subsystem for Linux (WSL)에서 사용할 수 있습니다.

기본 연결

sftp mysite_com@cp1-kapsule.kapsulehost.com

mysite_com을 실제 사이트 사용자명으로 바꿉니다. 개인 키가 기본 위치(~/.ssh/id_rsa 또는 ~/.ssh/id_ed25519)에 없으면 -i 플래그를 사용하여 지정합니다:

sftp -i ~/.ssh/your_private_key mysite_com@cp1-kapsule.kapsulehost.com

처음 연결할 때 서버의 호스트 지문을 확인하도록 요청됩니다. yes을 입력하고 Enter를 누릅니다. 이는 디바이스당 키당 한 번만 발생합니다.

유용한 SFTP 명령

연결되면 sftp> 프롬프트가 표시됩니다. 이 명령을 사용하여 파일을 탐색하고 전송합니다:

예: 파일 다운로드

sftp> cd htdocs/wp-content/themes
sftp> get my-theme.zip

예: 파일 업로드

sftp> lcd ~/Desktop
sftp> cd htdocs/wp-content/uploads
sftp> put my-image.jpg

---

파일이 있는 위치

연결하면 사이트 사용자의 홈 디렉토리에 도착합니다: /home/[siteuser]/.

디렉토리 구조는 다음과 같습니다:

/home/mysite_com/
├── htdocs/              ← Your web root (main location for site files)
│   ├── index.php
│   ├── wp-config.php
│   ├── wp-content/
│   │   ├── themes/
│   │   ├── plugins/
│   │   └── uploads/
│   └── ...
├── logs/                ← PHP and access logs
└── tmp/                 ← Temporary files

WordPress (또는 다른 애플리케이션)가 있는 웹 루트는 htdocs/입니다. 이것이 대부분의 시간을 보낼 디렉토리입니다. 일부 사이트 구성에서는 대신 public_html/라고 명명될 수 있습니다. 연결하여 public_html/보다 htdocs/을 보면 그것을 사용합니다.

---

연결 문제 해결

"Connection refused"

연결이 설정되기 전에 적극적으로 거부되었습니다.

확인: 호스트 cp1-kapsule.kapsulehost.com과 포트 22를 사용하고 있는지 확인합니다. 일반적인 실수는 포트 21 (FTP이지 SFTP가 아님)을 입력하거나 호스트명을 잘못 입력하는 것입니다.

"Permission denied (publickey)"

서버가 연결 시도를 수락했지만 인증을 거부했습니다.

다음의 각 항목을 확인합니다:

• SSH 공개 키가 KPanel > Websites > [site] > SSH / SFTP에 추가되어 있습니다. 목록에 없으면 서버에 기록이 없습니다.
• FileZilla/Cyberduck에서 올바른 개인 키를 선택했으며, 특히 KPanel에 추가한 공개 키와 쌍을 이루는 개인 키입니다.
• 키에 암호가 있으면 올바르게 입력하고 있는지 확인합니다.
• 여러 키가 있으면 실수로 잘못된 키를 선택하지 않았는지 확인합니다.

"호스트 키 검증 실패"

SFTP 클라이언트가 이 호스트명에 대해 이전에 다른 호스트 키를 본 것이고 불일치를 경고하고 있습니다.

처음 연결할 때: 지문을 수락하도록 요청됩니다. 이것은 정상입니다. Accept를 클릭하거나 yes을 입력합니다.

새로운 지문으로 이후 연결할 때: 이는 서버의 구성 변경을 나타낼 수 있습니다. 수락하기 전에 support@kapsulehost.com의 지원팀에 문의하고 본 내용을 언급합니다.

터미널에서 이전 호스트 키를 지우려면 ~/.ssh/known_hosts을 편집하고 cp1-kapsule.kapsulehost.com의 줄을 제거합니다.

"Could not read from remote repository" 또는 잘못된 디렉토리

사용자명으로 사이트 사용자명 대신 KPanel 이메일 주소를 사용했을 수 있습니다.

확인: 사용자명은 이메일 주소가 아닌 사이트 사용자명이어야 합니다 (예: mysite_com). 올바른 사용자명을 KPanel > Websites > [site] > SSH / SFTP에서 찾습니다.

연결 시간 초과

연결 시도가 중단되고 오류 없이 시간 초과됩니다.

가능한 원인:

• 반복된 실패한 로그인 시도로 인해 IP 주소가 Kapsule의 방화벽에 의해 일시적으로 차단되었을 수 있습니다. support@kapsulehost.com의 지원팀에 문의하고 방화벽 로그를 확인해 달라고 요청합니다.
• 로컬 방화벽 또는 네트워크의 VPN이 포트 22의 아웃바운드 연결을 차단할 수 있습니다. 다른 네트워크 (예: 모바일 핫스팟)에서 시도하여 이를 배제합니다.

---

관련 문서

• 사이트에 SSH 키 추가
• KPanel의 파일 관리자 사용
• SSH 터널을 통해 데이터베이스에 연결