Подключение через SFTP: FileZilla, Cyberduck и командная строка

SFTP (Secure File Transfer Protocol) дает вам прямой доступ к файлам вашего сайта на сервере. В этом руководстве рассказано все, что нужно для успешного подключения: от поиска учетных данных до устранения ошибок.

Что такое SFTP и когда его использовать

Встроенный в KPanel файловый менеджер удобен для быстрого редактирования: переименования файла, просмотра конфигурации или загрузки одного ресурса. SFTP подходит, когда требуется большее:

• Загрузка или скачивание большого количества файлов одновременно (миграция сайта, массовая загрузка изображений).
• Передача больших файлов, которые превысят время ожидания при загрузке через браузер.
• Работа в рамках рабочего процесса разработки, где вы редактируете файлы локально и отправляете изменения.
• Использование графического клиента, который позволяет синхронизировать локальную и удаленную папки.
• Доступ к логам или файлам конфигурации, которые недоступны через файловый менеджер KPanel.

SFTP шифрует все передаваемые данные, что делает его безопаснее простого FTP. KapsuleHost не предоставляет нешифрованные соединения FTP.

Предварительные требования

Перед подключением необходимо выполнить две вещи.

1. SSH-ключ, добавленный на ваш сайт в KPanel.

SFTP на KapsuleHost использует аутентификацию по SSH-ключу. Аутентификация по пароль отключена в целях безопасности. Если вы еще не добавили свой открытый SSH-ключ, следуйте руководству Добавление SSH-ключей на ваш сайт, а затем вернитесь сюда.

2. Имя пользователя вашего сайта.

Каждый сайт на KapsuleHost имеет выделенного системного пользователя. Это не адрес вашей электронной почты KPanel. Это короткое имя пользователя, привязанное именно к этому сайту.

Чтобы его найти:

1. Выполните вход в KPanel по адресу kpanel.kapsulehost.com.
2. Нажмите Websites на левой боковой панели.
3. Нажмите на сайт, к которому хотите подключиться.
4. Перейдите на страницу SSH / SFTP.
5. Имя пользователя сайта отображается в верхней части этой вкладки. Обычно это выглядит как mysite_com или myexamplesite_net.

Параметры подключения с первого взгляда:

---

Подключение через FileZilla

FileZilla - бесплатный кроссплатформенный SFTP-клиент, доступный для Windows, macOS и Linux. Загрузите его с сайта filezilla-project.org, если у вас его еще нет.

Пошаговое настройка

1. Откройте FileZilla.

2. Перейдите в File > Site Manager (или нажмите Ctrl+S на Windows / Cmd+S на Mac).

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 - бесплатный SFTP-клиент для macOS и Windows. Загрузите его с сайта 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 (или нажмите Cmd+Shift+B на Mac).
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.
• Если ваш ключ защищён парольной фразой, убедитесь, что вы вводите её правильно.
• Если у вас несколько ключей, убедитесь, что вы случайно не выбираете неправильный.

"Host key verification failed"

Ваш 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-туннель