TeaHost
панельфайлы3 мин. чтения

Подключение к серверу по SFTP

Как подключиться к игровому серверу по SFTP через FileZilla или WinSCP

Кратко

Данные для SFTP — хост, порт, логин и пароль — находятся в панели во вкладке Settings (SFTP Details); порт SFTP отдельный, не игровой, а пароль совпадает с паролем от панели. В FileZilla выберите протокол SFTP в менеджере сайтов, в WinSCP — SFTP в окне входа; самые частые ошибки — игровой порт вместо SFTP-порта и протокол FTP вместо SFTP.

SFTP — это безопасный протокол передачи файлов. Через него можно управлять файлами сервера в привычном файловом менеджере на компьютере, а не через веб-интерфейс. В этой статье разобрано, где взять данные для подключения и как настроить FileZilla и WinSCP.

Подключение к серверу по SFTP

Зачем SFTP, если есть веб-менеджер

В панели уже есть файловый менеджер, и для мелких правок его достаточно. Но у SFTP-клиента на компьютере есть преимущества:

  • Массовая загрузка — можно перетащить сотни файлов сборки модов одной операцией.
  • Большие файлы — заливка тяжёлых архивов идёт стабильнее, чем через браузер.
  • Прямое редактирование — файл открывается в вашем редакторе и сохраняется обратно на сервер автоматически.
  • Синхронизация папок — клиент сравнивает локальную и серверную папки и заливает только изменённое.

Для разовой правки конфига удобнее веб-менеджер, для работы со сборкой — SFTP.

Где взять данные для подключения

Все реквизиты доступа находятся в панели. Откройте ваш сервер и перейдите во вкладку Settings — блок SFTP Details. Там будут четыре значения:

ПолеЧто этоНа что обратить внимание
ХостДомен или IP-адрес для SFTPБерите из панели, он может отличаться от адреса для игроков
ПортНомер SFTP-портаЭто не игровой порт: в Pterodactyl по умолчанию 2022, но точное число смотрите в панели
ЛогинИмя пользователя для файловВ Pterodactyl он вида ваш_логин.идентификатор_сервера — копируйте целиком
ПарольПароль доступаСовпадает с паролем от панели управления

Скопируйте эти четыре значения — они понадобятся при настройке клиента.

Настройка FileZilla

FileZilla — бесплатный кроссплатформенный клиент.

  1. Скачайте и установите FileZilla с официального сайта.
  2. Откройте Файл → Менеджер сайтов → Новый сайт.
  3. В поле Протокол выберите SFTP — SSH File Transfer Protocol.
  4. Впишите Хост и Порт из панели.
  5. В поле Тип входа выберите Запросить пароль, укажите логин.
  6. Нажмите Соединиться и введите пароль.

После подключения слева будут ваши локальные файлы, справа — файлы сервера. Перетаскивайте файлы между панелями мышью.

Настройка WinSCP

WinSCP — популярный клиент для Windows.

  1. Скачайте и установите WinSCP с официального сайта.
  2. В окне входа выберите протокол SFTP.
  3. Заполните поля Имя хоста, Порт, Имя пользователя и Пароль.
  4. Нажмите Сохранить, затем Войти.

WinSCP предложит два вида интерфейса — «Проводник» с одной панелью или «Commander» с двумя. Для перетаскивания файлов удобнее двухпанельный режим.

Типичные ошибки

Большинство проблем с подключением сводится к нескольким причинам.

  • Неверный порт — самая частая ошибка. Убедитесь, что вписали SFTP-порт из панели, а не игровой 25565. При неправильном порте соединение просто не устанавливается.
  • Ошибка авторизации — проверьте логин и пароль. Пароль обычно от панели; если недавно меняли его, используйте новый.
  • Выбран не тот протокол — должен быть именно SFTP, а не FTP или FTPS. Обычный FTP на серверах не используется.
  • Логин без суффикса — в логин нужно вписать всё значение из панели, включая часть после точки.

SFTP обслуживает сама панель, а не игровой процесс, поэтому подключаться можно и к остановленному серверу. Если соединение всё равно не устанавливается, сверьте все четыре реквизита с панелью ещё раз или напишите в поддержку TeaHost в Telegram — @suphost_bot.

Безопасность при работе по SFTP

SFTP шифрует передачу, но пароль всё равно стоит беречь. Несколько правил:

  • Не сохраняйте пароль в клиенте на чужом или общем компьютере — выбирайте вариант «Запросить пароль».
  • Не передавайте реквизиты доступа посторонним: доступ к файлам сервера равнозначен полному контролю над ним.
  • После работы с публичного компьютера удаляйте сохранённый сайт из менеджера подключений.

При редактировании конфигов через SFTP сохраняйте файлы в кодировке UTF-8 без BOM — иначе сервер может не прочитать значения с кириллицей.

Для разовых правок без клиента подойдёт файловый менеджер в панели, другие инструкции собраны в базе знаний.