Уже находитесь в удалённом каталоге и нужно загрузить файл конфигурации или вернуть журнал на своё устройство? Встроенная реализация ZMODEM в NeoServer позволяет передавать файлы прямо в SSH-терминале: выполните rz для загрузки или sz для скачивания. Панель передачи берёт на себя выбор файлов, отслеживание прогресса, подтверждение приёма и отмену.
Поддержка в iOS и macOS
Описанный ниже рабочий процесс использует терминал NeoServer для iOS, включая приложение для macOS на базе iOS. Отдельный нативный терминал для macOS в текущей реализации ещё не получил этой интеграции с ZMODEM. На Mac проверьте, какое издание вы используете, прежде чем пробовать эти команды.
Здесь нативный ZMODEM означает, что протокол передачи реализован напрямую на Swift, включая кадрирование, проверку CRC и повторную передачу. Не нужны ни браузерное расширение, ни JavaScript-мост для передачи.
Подготовка удалённого сервера
Используйте подключение через SSH-терминал и убедитесь, что на удалённой машине есть rz и sz. Проект lrzsz предоставляет реализации протоколов передачи для командной строки. Проверьте команды в удалённой оболочке:
command -v rz
command -v sz
Если какой-то из команд нет, установите пакет lrzsz из репозитория вашего серверного дистрибутива или попросите администратора сервера добавить его. NeoServer отвечает за сторону клиента; на удалённой машине всё равно должен быть соответствующий отправитель или получатель.
Начните с прямого SSH-подключения. Соединения Mosh не передают «сырой» поток байтов терминала, необходимый для этой интеграции. Если вы используете tmux, screen или zellij, этот промежуточный слой тоже должен корректно пропускать трафик ZMODEM.
Загрузка файлов с помощью rz
rz означает, что удалённая машина принимает файлы. С точки зрения вашего устройства это загрузка.
- В удалённом терминале перейдите в целевой каталог и проверьте его командой
pwd. - Выполните
rz. - NeoServer открывает панель ZMODEM. Нажмите Choose Files и выберите один или несколько локальных файлов.
- Следите за прогрессом и дождитесь завершения, прежде чем вернуться к обычной работе в терминале.
cd ~/uploads
pwd
rz
Целевой каталог должен уже существовать и быть доступным для записи под вашей учётной записью SSH. Файлы отправляются получателю, запущенному в этом каталоге. Если файл с таким именем уже существует на удалённой машине, поведение при конфликте определяется настройками удалённого получателя.
NeoServer подготавливает локальные копии выбранных для загрузки файлов и передаёт их по частям. Временные копии удаляются после завершения передачи, её отмены или разрыва соединения.
Скачивание файлов с помощью sz
sz заставляет удалённую машину отправить файлы в NeoServer. Передайте один или несколько путей к удалённым файлам:
sz server.log
Чтобы передать несколько файлов, перечислите их вместе. Пути с пробелами заключайте в кавычки:
sz server.log report.json "build output.txt"
NeoServer запрашивает подтверждение для каждого входящего файла. Нажмите Receive File, чтобы принять его, или Skip File, чтобы исключить его из партии. Принятые файлы появятся в разделе Received Files панели; с помощью Save to Files можно экспортировать завершённые файлы в выбранное место.
На iOS завершённые загрузки также доступны в папке ZMODEM NeoServer в приложении «Файлы». Каждый принятый файл хранится в собственном каталоге, поэтому отдельные загрузки не перезаписывают друг друга в локальном хранилище.
Проверки CRC и незавершённые файлы
ZMODEM добавляет проверки целостности в свои кадры передачи и блоки данных. Подробное описание на уровне протокола см. в документации ZMODEM проекта Tera Term.
NeoServer принимает входящие кадры Hex, Binary16 и Binary32 с проверкой CRC16 или CRC32 в зависимости от типа. Для загрузок используется CRC16. Ошибка контрольной суммы может вызвать повторную попытку или возобновление передачи с определённого смещения в рамках текущей сессии.
Загрузки записываются во временный файл .partial. NeoServer переносит загруженный файл под его итоговое имя только после успешных проверок передачи, включая ожидаемую длину, если отправитель её передал. Отменённые, неудавшиеся или прерванные передачи удаляют незавершённые файлы; уже завершённые файлы остаются доступными.
CRC обнаруживает повреждения при передаче; он не подтверждает, кто создал файл. Если нужна независимая сквозная проверка, сравните криптографический хеш исходного и полученного файла с помощью инструментов, доступных на обеих машинах.
Отмена, повторные попытки и ограничения передачи
Во время передачи NeoServer блокирует обычный ввод с клавиатуры терминала, чтобы нажатия не смешивались с данными протокола. Чтобы остановить передачу, используйте Cancel в панели ZMODEM.
Учитывайте эти ограничения:
- Только файлы. Передача каталогов не поддерживается. Сначала упакуйте каталог в архив, затем отправьте архив как файл.
- Максимальный размер файла: не более 4 294 967 295 байт, то есть 4 ГиБ минус один байт.
- Повторные попытки действуют в рамках текущей сессии. NeoServer не сохраняет состояние возобновления между разорванными соединениями. Если связь потеряна, переподключитесь и начните новую передачу.
- Используйте SSH. Эта интеграция не работает через терминальный путь Mosh или 7-битный транспорт.
Если rz или sz не открывает панель передачи
Сначала убедитесь, что команда существует на удалённой машине и что вы используете поддерживаемое издание терминала NeoServer. Затем выполните ту же команду в прямом SSH-подключении, вне любого терминального мультиплексора.
Для загрузок проверьте удалённый целевой каталог и права учётной записи. Для скачиваний проверьте исходный путь и право на чтение. Если передача начинается, но не может завершиться, обратитесь к сообщению об ошибке в панели и повторите попытку после проверки соединения, размера файла и свободного места в локальном хранилище.
ZMODEM удобен, когда нужно передать файлы из каталога, в котором вы уже работаете. Инструменты SFTP в NeoServer по-прежнему полезны для просмотра удалённых папок и визуального управления файлами. О первичном подключении по SSH читайте в кратком руководстве NeoServer.
Готовы попробовать?
NeoServer · SSH, Mosh, Docker & SFTP client for iPhone, iPad and Mac
Бесплатно в App Store