Mobile SSH

Передача файлов

Mobile SSH включает экран передачи файлов по SFTP, привязанный к активному SSH-подключению. Он предназначен для быстрого обслуживания сервера с телефона или планшета: загрузить конфигурацию, скачать журнал, переименовать удалённый файл или проверить права доступа, не выходя из приложения.

Открытие передачи файлов

  1. Подключитесь к SSH-серверу.
  2. Выберите подключённую панель терминала.
  3. Откройте Transfer на панели инструментов терминала или нажмите и удерживайте заголовок панели, если это поддерживается текущим экраном.
  4. Откроется экран передачи файлов с локальной и удалённой панелями.

Если активной SSH-сессии нет, передача файлов открыться не может.

Локальная и удалённая панели

Экран передачи файлов имеет две панели браузера:

Приложение запоминает недавние удалённые пути и сортировку для каждого хоста. Откройте недавние пути из заголовка удалённой панели на Android или кнопкой с часами на iOS. Локальная панель показывает выбранную папку; iOS использует папку Documents приложения, пока вы не выберете другую.

Экран передачи файлов следует системной светлой или тёмной теме, поэтому выглядит так же, как остальной Mobile SSH.

Где открывается каждая сессия

На обеих платформах открытие передачи файлов из tmux восстанавливает удалённую папку, сохранённую для этой сессии и сокета. Для новой сессии сначала проверяются часто используемые папки хоста, затем другие запомненные папки или папка входа.

Если запомненная папка отсутствует или недоступна, браузер пробует следующее пригодное расположение. Ошибка соединения сообщается как ошибка, а не принимается за отсутствие папки. Обновление списка не считается новым посещением каталога.

Доступ к хранилищу

Mobile SSH не запрашивает сплошного доступа к хранилищу ни на одной из платформ.

На Android вы даёте доступ к одной папке через системное средство выбора папки, и скачанные файлы записываются туда — в место, которое все остальные приложения и так могут читать. Выданный доступ сохраняется между запусками.

На iOS Мой телефон → Выбрать локальную папку предоставляет доступ к папке в приложении «Файлы», включая поддерживаемые папки iCloud Drive и других провайдеров. Выбор сохраняется после перезапуска. Использовать папку приложения возвращает к Documents в Mobile SSH. Если выбранная папка недоступна, выберите её заново или явно переключитесь на папку приложения; загрузки не перенаправляются незаметно. Доступ к папке на этом устройстве не включается в резервные копии.

Системные средства выбора документов и фото на iOS также импортируют несколько объектов. При совпадении имён предлагаются Заменить, Сохранить оба или Отмена. Импорт файла, который уже находится в целевой папке, оставляет его неизменным.

Импорт закрытого ключа отделён от передачи файлов и использует системное средство выбора файлов.

Загрузка файлов

  1. Откройте локальную панель.
  2. Перейдите к файлу, который хотите загрузить.
  3. Выберите загрузку.
  4. Подтвердите удалённое назначение.
  5. Следите за очередью передачи для отображения прогресса и завершения.

Отправка файлов следует SSH-маршруту выбранного сервера, включая сохранённые промежуточные хосты. Если соединение оборвалось, повторите передачу после подключения.

Скачивание файлов

  1. Откройте удалённую панель.
  2. Перейдите к файлу, который хотите скачать.
  3. Выберите скачивание.
  4. Подтвердите локальное назначение.
  5. Следите за очередью передачи для отображения прогресса и завершения.

Большие скачивания по возможности выполняйте в стабильной сети.

Копирование папок целиком

Загрузка и скачивание не ограничиваются отдельными файлами. Выберите папку, и Mobile SSH скопирует всё поддерево в обоих направлениях — с телефона на удалённый хост и обратно, — сначала создавая папки назначения, а затем ставя каждый файл в очередь. Недоступная для чтения подпапка не прерывает остальное копирование: на Android о ней сообщается строкой с ошибкой «Can’t list directory», а iOS продолжает работу, не перечисляя пропущенное.

Действия с удалёнными файлами

В зависимости от выбранного удалённого элемента Mobile SSH может показать следующие действия:

Сведения об удалённом файле могут включать биты прав доступа, владельца, группу и восьмеричные значения прав. Используйте эти сведения перед изменением файлов сервера, которыми управляет другой процесс или инструмент развёртывания.

Размеры файлов показываются в двоичных единицах, поэтому совпадают с тем, что печатает ls -h в терминале на соседней вкладке.

Сортировка и недавние пути

Каждую панель можно сортировать по имени или дате по возрастанию или убыванию. Mobile SSH хранит выбранные режимы сортировки локальной и удалённой панелей для каждого хоста вместе с недавними путями, поэтому повторные передачи на тот же сервер начинаются со знакомых мест.

Очередь передачи

Передачи ставятся в очередь и отображаются по статусу: на Android это «В очереди / Ошибки / Успешные», на iOS — «Активные / Ошибки / Готово». При неудаче показывается доступная причина ошибки. На iOS текущая передача находится вверху активных и может быть отменена.

На iOS передачи в очереди сохраняют исходную папку, даже если вы перейдёте в другую. Скачивание сначала завершается во временном хранилище и лишь затем заменяет целевой файл; отмена или ошибка сохраняет существующий файл. Если файл изменился после подтверждения перезаписи, приложение останавливается, не заменяя изменённые данные.

Как достать файлы из приложения

Отправка файла в сессию

Обе платформы принимают файлы из других приложений и предлагают кнопку 📎 Прикрепить файл в терминале. Файлы загружаются в ~/.cache/mobile-ssh на выбранном хосте, а их пути можно вставить в командную строку без нажатия Enter. Поддерживается несколько файлов.

На Android отправка направляется в работающую сессию. На iOS скрепка предлагает Медиатека или Файлы. Расширение отправки iOS также может загружать файлы на сохранённый SSH-сервер, пока Mobile SSH закрыт; профили Eternal Terminal не предлагаются. Сначала подтвердите незнакомый сервер в основном приложении.

После загрузки через расширение отправки iOS пути копируются в буфер обмена и ожидают вставки в приложении, когда появится подключённая панель этого сервера. В панель другого хоста они не вставляются.

Практические советы