SFTP
Передача файлов по SFTP (SSH File Transfer Protocol)
SFTP (SSH File Transfer Protocol — безопасная передача файлов поверх SSH) — загрузка, скачивание и управление файлами на удалённом сервере. Вход по паролю или закрытому ключу OpenSSH.
С SFTP в Pailot вы можете:
- Загружать файлы или текст в каталог на сервере
- Скачивать файл (текст или base64)
- Смотреть содержимое каталога
- Удалять файл или каталог и создавать каталоги
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Учётные данные — в переменных окружения рабочего пространства.
Загрузить файлы на удалённый сервер SFTP.
| Параметр | Тип | Обязательный | Описание |
|---|
host | string | Да | Хост или IP сервера SFTP |
port | number | Да | Порт (по умолчанию 22) |
username | string | Да | Имя пользователя SFTP |
password | string | Нет | Пароль (если не используете ключ) |
privateKey | string | Нет | Закрытый ключ (формат OpenSSH) |
passphrase | string | Нет | Парольная фраза к зашифрованному ключу |
remotePath | string | Да | Каталог назначения на сервере |
files | file[] | Нет | Файлы для загрузки |
fileContent | string | Нет | Текст файла (для текстовых файлов) |
fileName | string | Нет | Имя файла при загрузке из текста |
overwrite | boolean | Нет | Перезаписывать существующие (по умолчанию true) |
permissions | string | Нет | Права файла (например 0644) |
| Параметр | Тип | Описание |
|---|
success | boolean | Загрузка успешна |
uploadedFiles | json | Массив загруженных файлов (name, remotePath, size) |
message | string | Статус операции |
Скачать файл с удалённого сервера SFTP.
| Параметр | Тип | Обязательный | Описание |
|---|
host | string | Да | Хост или IP сервера SFTP |
port | number | Да | Порт (по умолчанию 22) |
username | string | Да | Имя пользователя SFTP |
password | string | Нет | Пароль (если не используете ключ) |
privateKey | string | Нет | Закрытый ключ (формат OpenSSH) |
passphrase | string | Нет | Парольная фраза к зашифрованному ключу |
remotePath | string | Да | Путь к файлу на сервере |
encoding | string | Нет | Кодировка: utf-8 для текста, base64 для двоичных (по умолчанию utf-8) |
| Параметр | Тип | Описание |
|---|
success | boolean | Скачивание успешно |
fileName | string | Имя скачанного файла |
content | string | Содержимое (текст или base64) |
size | number | Размер в байтах |
encoding | string | Кодировка содержимого (utf-8 или base64) |
message | string | Статус операции |
Список файлов и каталогов на удалённом сервере SFTP.
| Параметр | Тип | Обязательный | Описание |
|---|
host | string | Да | Хост или IP сервера SFTP |
port | number | Да | Порт (по умолчанию 22) |
username | string | Да | Имя пользователя SFTP |
password | string | Нет | Пароль (если не используете ключ) |
privateKey | string | Нет | Закрытый ключ (формат OpenSSH) |
passphrase | string | Нет | Парольная фраза к зашифрованному ключу |
remotePath | string | Да | Путь каталога на сервере |
detailed | boolean | Нет | Подробности: размер, права, дата изменения |
| Параметр | Тип | Описание |
|---|
success | boolean | Операция успешна |
path | string | Каталог, который просматривали |
entries | json | Записи: name, type, size, permissions, modifiedAt |
count | number | Число записей |
message | string | Статус операции |
Удалить файл или каталог на удалённом сервере SFTP.
| Параметр | Тип | Обязательный | Описание |
|---|
host | string | Да | Хост или IP сервера SFTP |
port | number | Да | Порт (по умолчанию 22) |
username | string | Да | Имя пользователя SFTP |
password | string | Нет | Пароль (если не используете ключ) |
privateKey | string | Нет | Закрытый ключ (формат OpenSSH) |
passphrase | string | Нет | Парольная фраза к зашифрованному ключу |
remotePath | string | Да | Путь к файлу или каталогу |
recursive | boolean | Нет | Удалять каталоги рекурсивно |
| Параметр | Тип | Описание |
|---|
success | boolean | Удаление успешно |
deletedPath | string | Удалённый путь |
message | string | Статус операции |
Создать каталог на удалённом сервере SFTP.
| Параметр | Тип | Обязательный | Описание |
|---|
host | string | Да | Хост или IP сервера SFTP |
port | number | Да | Порт (по умолчанию 22) |
username | string | Да | Имя пользователя SFTP |
password | string | Нет | Пароль (если не используете ключ) |
privateKey | string | Нет | Закрытый ключ (формат OpenSSH) |
passphrase | string | Нет | Парольная фраза к зашифрованному ключу |
remotePath | string | Да | Путь нового каталога |
recursive | boolean | Нет | Создать родительские каталоги, если их нет |
| Параметр | Тип | Описание |
|---|
success | boolean | Каталог успешно создан |
createdPath | string | Путь созданного каталога |
message | string | Статус операции |
