Mobile SSH

Устранение неполадок

На этой странице рассматриваются распространённые проблемы Mobile SSH и первые проверки, которые стоит выполнить перед изменением настроек SSH на стороне сервера.

Не удаётся подключиться

Проверьте:

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

Ошибка аутентификации

Проверьте:

Для зашифрованных закрытых ключей введите парольную фразу в поле пароля/парольной фразы.

Не удалось импортировать закрытый ключ

Импорт закрытого ключа выполняется через системный файловый менеджер. Если импорт не удался:

Ввод с клавиатуры задерживается или изменяется

Mobile SSH отправляет нажатия клавиш прямо в оболочку с отключёнными автокоррекцией и предиктивными подсказками, поэтому клавиатура не должна переписывать текст до того, как он достигнет удалённой стороны. Если ваша клавиатура всё же изменяет ввод, убедитесь, что его не перехватывает системный инструмент замены текста или буфера обмена, и используйте ряд дополнительных клавиш для клавиш терминала, таких как ESC, TAB, CTRL, стрелки, HOME, END, PGUP и PGDN.

Прокрутка tmux работает не так, как ожидалось

Mobile SSH меняет поведение прокрутки в зависимости от состояния терминала. В tmux или других программах с альтернативным экраном жесты прокрутки могут отправлять команды режима копирования tmux вместо прокрутки локальной истории. Если в tmux включён режим мыши, приложение отправляет escape-последовательности колеса мыши.

Если прокрутка работает неправильно:

Сессия оборвалась после блокировки экрана

На Android Mobile SSH использует keepalive, службу переднего плана, wake lock, Wi-Fi lock и попытки переподключения, чтобы уменьшить число разрывов соединения. Политики экономии батареи Android всё равно могут останавливать фоновую работу.

Проверьте:

На iOS система приостанавливает приложения в фоне, поэтому обычное SSH-соединение нельзя держать открытым бесконечно после переключения на другое приложение или блокировки экрана. Короткий льготный период покрывает быстрые переключения между приложениями; для более длительных перерывов включите Auto-attach tmux session в профиле сервера (или используйте транспорт Eternal Terminal), чтобы при переподключении вы возвращались в ту же оболочку, где остановились.

Передача файлов не может просматривать файлы телефона

Mobile SSH не запрашивает на Android никакого разрешения на доступ к хранилищу. Вместо этого локальная панель показывает одну папку, доступ к которой вы даёте через системное средство выбора папки, — если панель пуста, выберите папку кнопкой Pick folder. Выданный доступ сохраняется, так что это разовый шаг.

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

На iOS локальная панель показывает область документов приложения, а файлы добавляются через системные средства выбора документов и фотографий. Скачанные туда файлы также видны в приложении «Файлы» в разделе На моём iPhone.

Не удалось загрузить или скачать файл

Проверьте:

Не удалось выполнить проброс порта

Проверьте:

Журналы отладки

Две платформы записывают разное, поэтому выбирайте ту, что соответствует вашей проблеме.

Android — терминал и отрисовка. Включите Settings → Debugging → Show Debug and Logs buttons, затем пользуйтесь появившейся на стартовом экране кнопкой Debug. Она фиксирует события терминала, объёмы данных SSH, сенсорный ввод, поведение при изменении размера и жизненный цикл туннелей. Перед началом записи приложение предупреждает, что в неё попадает каждое нажатие клавиши, включая пароли. По остановке записи архив сохраняется в папку «Загрузки».

iOS — подключения и переподключения. Включите Settings → Diagnostics → Record debug log. Он фиксирует каждый адрес, по которому выполнялось подключение, и причину неудачи, попытки переподключения и задержки между ними, разорванные соединения, сообщения «peer stopped answering keepalives», смену сети и команды tmux с их ошибками. В настройках виден живой счётчик строк, чтобы вы могли убедиться, что запись идёт, а Export Debug Log отправляет лог текстовым файлом. Лог хранится в памяти и охватывает только текущий запуск приложения.

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