故障排查

本页介绍 Mobile SSH 的常见问题，以及在更改服务器端 SSH 设置之前应先进行的检查。

无法连接

请检查：

• Android 设备已联网。
• 服务器的主机名或 IP 地址正确。
• SSH 端口正确，通常为 22。
• 防火墙、VPN、运营商网络或 Wi-Fi 网络未阻止该端口。
• SSH 服务器正在运行，并接受来自你所用网络的连接。

如果同一主机在另一台设备上可用，请逐一比较主机、端口、用户名、密钥和网络路径。

认证失败

请检查：

• 用户名拼写。
• 密码或密钥口令。
• 服务器是否允许密码登录、密钥登录或两者皆可。
• 私钥是否与服务器用户 authorized_keys 中的公钥匹配。
• 密钥文件是否完整导入，包括开头和结尾行。

对于加密的私钥，请在密码/口令字段中输入口令。

私钥导入失败

私钥导入使用 Android 文件选择器。如果导入失败：

• 确认所选文件是私钥，而非公钥 .pub 文件。
• 在受信任的文本编辑器中打开文件，确认它包含完整的密钥块。
• 尝试将密钥手动粘贴到私钥字段中。
• 确认密钥类型是应用支持的类型之一：Ed25519、RSA、ECDSA 或 DSA。

键盘输入延迟或被更改

如果你的 Android 键盘在文本到达 shell 之前对其进行了修改，请在 Mobile SSH 设置中关闭键盘建议。这对 Vim、tmux、htop、less、使用特殊组合键的 shell 以及远程密码提示很有用。

使用额外按键行输入 ESC、TAB、CTRL、方向键、HOME、END、PGUP 和 PGDN 等终端按键。

tmux 滚动与预期不符

Mobile SSH 会根据终端状态调整滚动行为。在 tmux 或其他备用屏幕程序中，滚动手势可能发送 tmux 复制模式命令，而不是滚动本地历史记录。如果启用了 tmux 鼠标模式，应用会发送鼠标滚轮转义序列。

如果滚动效果不符合预期：

• 尝试在远程服务器上启用或关闭 tmux 鼠标模式。
• 使用额外按键行中的 PGUP 和 PGDN。
• 在滚动密集输出之前，双击窗格进入全屏。
• 如果远程终端大小看起来未更新，请分离并重新挂接 tmux。

锁屏后会话断开

Mobile SSH 使用保活、前台服务、唤醒锁、Wi-Fi 锁和重连尝试来减少断线。但 Android 的电池策略仍可能停止后台工作。

请检查：

• 如果你的设备会激进地停止后台应用，请为 Mobile SSH 关闭电池优化。
• 在长时间会话期间保持 Wi-Fi 或移动数据稳定。
• 解锁后重新打开 Mobile SSH，点按 Active Sessions。
• 如果服务器已断开 SSH 会话，请从最近会话重新连接。

文件传输无法浏览手机文件

在较新的 Android 版本上，本地文件浏览可能需要存储访问权限。请在 Android 设置中为 Mobile SSH 授予存储访问权限，然后重新打开文件传输屏幕。

如果远程文件可以加载而本地文件无法加载，说明 SSH 连接很可能没有问题，问题出在本地 Android 存储访问上。

上传或下载失败

请检查：

• SSH 会话仍处于连接状态。
• 远程目录存在。
• 远程用户具有读取或写入该路径的权限。
• 本地目标路径可写。
• Android 设备上有足够的可用空间。
• 网络在大文件传输期间保持稳定。

端口转发失败

请检查：

• 本地端口在 1 到 65535 之间。
• 本地端口尚未被占用。
• 隧道字符串格式为 PORT 或 LOCAL:REMOTEHOST:REMOTE。
• 远程主机和远程端口可从 SSH 服务器访问。
• SSH 服务器允许 TCP 转发。

调试日志

起始屏幕包含 Debug 按钮。启用后，Mobile SSH 会记录终端事件、SSH 数据大小、触摸输入、窗口大小调整行为和隧道生命周期的诊断信息。停止记录后可将调试归档保存到本地。

在分享调试归档之前请先检查其内容。这些文件用于故障排查，可能包含服务器名称、时序、终端行为或其他环境详情。