FTP

Последнее изменение: 12 ноября 2024

FTP

Для работы протокола FTP используется два соединения:

• управляющее соединение — по нему передаются команды и ответы, это текстовые строки;
• соединение для передачи данных.

Объектное хранилище использует только пассивный режим передачи данных. Процесс установления соединения и передачи данных инициируется исключительно со стороны клиента.

Запись в конец файла не поддерживается — при попытке сделать это вернется код ответа 426.

Подключение по FTP доступно только для контейнеров в пуле ru-1.

Данные для подключения⁠

Для подключения к объектному хранилищу по FTP используется:

• хост FTP;
• порт 21.

Аутентификация происходит с помощью S3-ключа — Владелец аккаунта или Администратор пользователей выдает ключ сервисному пользователю. При подключении по FTP поля Access key и Secret key из ключа используются в качестве логина и пароля соответственно.

Настроить FTP⁠

1. Настройте доступ.
2. Подключитесь по FTP.

1. Настроить доступ⁠

Настроить доступ может пользователь с ролью Владелец аккаунта или Администратор пользователей.

1. Создайте сервисного пользователя с ролью с доступом в объектное хранилище. Если вы используете пользователя с ролью Пользователь объектного хранилища, в контейнере должна быть настроена политика доступа.
2. Выдайте пользователю S3-ключ.

2. Подключиться по FTP⁠

Подключиться на Windows⁠

Total Commander

1. Откройте Total Commander.
2. В меню Сеть выберите Соединиться с FTP-сервером.
3. Нажмите Добавить.
4. На вкладке Общие в поле Имя соединения введите любое имя (например, Selectel).
5. В поле Сервер введите хост FTP.
6. В поле Учетная запись введите значение поля Access key из S3-ключа.
7. В поле Пароль введите значение поля Secret key из S3-ключа.
8. Отметьте чекбокс Пассивный режим обмена (как Web-браузер).
9. Откройте вкладку Расширенные.
10. В поле Кодировка имен файлов выберите UTF-8.
11. Нажмите OK. Профиль будет сохранен.
12. Нажмите Соединиться.

Midnight Commander

1. Откройте Midnight Commander.

2. Нажмите F9. Откроется главное меню.

3. В меню панели Left (для левой панели) или Right (для правой панели) выберите FTP Link.

4. Введите строку в формате [<access_key>]@<ftp_host>. Укажите:

   • <access_key> — значение поля Access key из S3-ключа;
   • <ftp_host> — хост FTP.

5. Нажмите Enter.

6. Введите пароль — значение поля Secret key из S3-ключа. Если все данные были введены правильно, в панели отобразится содержимое объектного хранилища.

FAR Manager

1. Откройте FAR Manager.
2. Чтобы открыть меню перехода, нажмите Alt + F1 (для левой панели) либо Alt + F2 (для правой панели).
3. В меню перехода выберите NetBox.
4. Нажмите Enter.
5. Нажмите Shift + F4. Откроется экран создания нового соединения.
6. В поле File Protocol выберите FTP.
7. В поле Host name введите хост FTP.
8. В поле User name введите значение поля Access key из S3-ключа.
9. В поле Password введите значение поля Secret key из S3-ключа.
10. Нажмите OK.
11. Для подключения по FTP выберите созданный профиль и нажмите Enter.

WinSCP

1. Откройте WinSCP.
2. В поле Протокол передачи выберите FTP.
3. Введите имя хоста — хост FTP.
4. Введите имя пользователя — значение поля Access key из S3-ключа.
5. Введите пароль — значение поля Secret key из S3-ключа.
6. Нажмите Еще.
7. Выберите раздел Среда.
8. В поле Кодировка UTF-8 для имён файлов выберите Вкл.
9. Нажмите OK → Сохранить.
10. Введите название подключения (например, Selectel).
11. Если вы хотите сохранить пароль, отметьте чекбокс Запомнить пароль.
12. Опционально: отметьте чекбокс Создать ярлык на “Рабочем столе”.
13. Нажмите OK.
14. Для подключения по FTP нажмите Войти.

FileZilla

1. Откройте FileZilla.
2. В меню Файл выберите Менеджер Сайтов.
3. Нажмите Новый сайт.
4. На вкладке Общие в поле Хост введите хост FTP.
5. В поле Тип входа выберите Нормальный.
6. В поле Пользователь введите значение поля Access key из S3-ключа.
7. В поле Пароль введите значение поля Secret key из S3-ключа.
8. Откройте вкладку Настройки передачи.
9. В поле Режим передачи выберите Пассивный.
10. Откройте вкладку Кодировка.
11. Выберите кодировку UTF-8 принудительно.
12. Нажмите ОК.
13. В меню Передача выберите Режим передачи → Двоичный.
14. В меню Файл выберите Менеджер Сайтов.
15. Для подключения по FTP выберите созданный сайт и нажмите Соединиться.

Проводник Windows

1. Откройте Проводник Windows.
2. Нажмите правой кнопкой мыши на пункт Этот компьютер и выберите Подключить сетевой диск.
3. Нажмите Подключение к веб-сайту, на котором вы можете хранить документы и изображения.
4. Нажмите Далее.
5. Выберите Выберите другое сетевое расположение.
6. Нажмите Далее.
7. Введите адрес объектного хранилища — хост FTP.
8. Нажмите Далее.
9. Снимите чекбокс Анонимный вход.
10. В качестве имени пользователя введите значение поля Access key из S3-ключа.
11. Нажмите Далее.
12. Опционально: измените имя соединения.
13. Нажмите Готово.
14. Введите пароль — значение поля Secret key из S3-ключа.
15. Отметьте чекбокс Сохранить пароль.
16. Нажмите Вход. Подключение отобразится в списке локальных и сетевых дисков.

Подключиться на Linux⁠

Nautilus

1. С помощью Nautilus откройте любую директорию.
2. В меню Файл выберите Подключение к серверу.
3. В поле Адрес сервера введите хост FTP.
4. Нажмите Подключиться.
5. Выберите пункт Зарегистрированный пользователь.
6. Введите логин — значение поля Access key из S3-ключа.
7. Введите пароль — значение поля Secret key из S3-ключа.
8. Опционально: отметьте чекбокс Запомнить навсегда.
9. Нажмите Подключиться.

Работа с FTP⁠

Авторизация⁠

Команда	Аргументы	Обозначение
USER	Access key из S3-ключа	Передать логин
PASS	Secret key из S3-ключа	Передать пароль

Защита⁠

Команда	Аргументы	Обозначение
AUTH	Не требуются	Установить защищенное TLS-соединение. Аргументы будут проигнорированы
PROT	P / C	Установить режим защиты. P for Private, C for Clean. По умолчанию P будет использовать TLS
PBSZ	Размер буфера	Установить размер буфера защиты. Сервер ответит 200 OK

Разное⁠

Команда	Аргументы	Обозначение
FEAT	Не требуются	Отобразить список поддерживаемых дополнительных функций
SYST	Не требуются	Отобразить операционную систему сервера
NOOP	Не требуется	Пустая операция, сервер в ответ передаст 200 ОК
OPTS	Согласно RFC2389	Передать серверу дополнительные опции

Доступ к файлам⁠

Команда	Аргументы	Обозначение
SIZE	Имя файла	Получить размер файла
STAT	Не требуются	Получить статистику соединения
MDTM	Путь	Получить дату и время изменения файла
RETR	Имя файла	Скачать файл. Сработает только после перехода в пассивный режим командой PASV. Поддерживается докачка
STOR	Имя файла	Загрузить файл в пассивном режиме
APPE	Имя файла	Сообщить серверу принять удаленный файл. Команда сработает только если такого файла еще не существует в хранилище. Если файл существует, то будет возвращена ошибка
DELE	Имя файла	Удалить файл
RNFR	Имя файла	Выбрать файл для переименования
RNTO	Новое имя файла	Задать новое имя файла. Только после того как был выбран командой RNFR
ALLO	Размер в байтах	Вернуть ответ о наличии доступного места. Вне зависимости от аргумента ответ будет 202 OK
REST	Смещение в байтах	Команда «перемотки» к определенной позиции в файле. Требуется для докачки с помощью RETR

Работа с контейнерами⁠

Команда	Аргументы	Обозначение
CWD	Имя директории	Перейти в указанную директорию
PWD	Не требуются	Показать текущий рабочий каталог
CDUP	Не требуются	Перейти в родительскую директорию
NLST	Не требуются	Возвратить список файлов директории в более кратком формате чем LIST. Только в режиме пассивного соединения
LIST	Путь	Вывести содержимое текущей или предоставленной директории. Поддерживается как относительный, так и абсолютный путь
MLSD	Путь	Вывести содержимое текущей директории. Главное отличие от LIST — метки времени с точностью до секунды, время указывается в UTC
MKD	Имя директории	Создать директорию
RMD	Имя директории	Удалить директорию

Установление соединения⁠

Команда	Аргументы	Обозначение
TYPE	A / I	Сменить режим передачи данных. Имеется два варианта — ASCII(A) или Binary(I). Любой аргумент игнорируется, команда используется для обратной совместимости. Поддерживается только Binary-режим
PASV	Не требуются	Перейти в пассивный режим передачи данных
EPSV	Не требуются	Инициировать соединение для передачи данных в пассивном режиме. В ответ сервер передаст номер порта для соединения
EPRT	Версия протокола / адрес / порт	Инициировать соединение для передачи данных. Команда исключительно для активного режима передачи данных, поэтому на эту команду сервер сообщит, что активный режим не поддерживается
PORT	Не требуются	Перейти в активный режим передачи данных. Команда исключительно для активного режима передачи данных, поэтому на эту команду сервер сообщит, что активный режим не поддерживается
QUIT	Не требуются	Отключиться от сервера