快速上手
Mobile SSH 是一款适用于 Android 和 iOS 的 SSH 客户端,用于连接你自己的 Linux、Unix、网络、IoT 或开发服务器。你提供服务器地址和凭据,应用便会打开一个交互式 SSH 终端。
要求
- Android 8.0 或更高版本,或 iOS 16 或更高版本(iPhone 或 iPad)。
- 设备可访问你的 SSH 服务器的网络。
- SSH 服务器的主机名或 IP 地址、端口、用户名,以及密码或私钥。
- 在 Android 上,如果你想使用带本地手机文件浏览器的 SFTP 文件传输,则需要存储访问权限;iOS 则改用系统的文件和照片选择器。
安装应用
- Android: Mobile SSH 目前是 Google Play 上的封闭测试。请在设备的手机浏览器中打开加入链接——不要在 Google Play 应用内打开,那里可能看不到该测试——并用你将要使用的 Google 账号加入。加入之后,它就会像其他应用一样从 Play 安装和更新。
- iOS: iOS 应用以公开测试版的形式在 TestFlight 上发布。先安装 Apple 的 TestFlight 应用,然后从本站首页打开 Mobile SSH 邀请链接,即可安装并接收更新。
连接到服务器
- 打开 Mobile SSH。
- 点按 + Add Session,搜索已保存的服务器,或在该界面中添加新服务器。
- 如果要添加新服务器,请输入主机、端口、用户名和认证信息。
- 点按服务器以打开终端会话。
- 在起始屏幕使用 Active Sessions 返回仍在运行的会话。
默认 SSH 端口为 22。如果你的服务器使用其他端口,请在服务器配置中填入该端口。
选择传输方式
添加或编辑服务器时,Transport 选择器决定 Mobile SSH 以何种方式连接:
- SSH —— 标准的 SSH 连接(默认)。
- Eternal Terminal —— 一种能在网络中断、休眠和 IP 变化后存活的会话。如果主机上没有
etserver,Mobile SSH 可以通过 SSH 为你安装一个。详见终端指南。
保存服务器
已保存的服务器会保留连接目标和可选的隧道配置。一个已保存的服务器可以包含:
- 主机名或 IP 地址。
- SSH 端口。
- 用户名。
- 密码或私钥信息。
- 可选的本地端口转发规则。
- 同一台机器的可选附加地址(见下文)。
对经常访问的主机使用已保存的服务器。如果某个已保存的服务器指向与当前活动会话不同的主机,Mobile SSH 会为所选目标启动新的连接。
多个地址(LAN/VPN 漫游)
同一台机器往往会因你所在的位置不同而在不同地址上可达——家庭 Wi-Fi IP 与 VPN IP。在服务器的编辑对话框中添加这些备用地址,必要时可为每个地址指定各自的端口。连接时,Mobile SSH 会按顺序尝试这些地址,直到其中一个响应,并记住上次成功的地址,下次优先拨号。网络变化(例如离开 VPN)会立即触发重连到当前可达的地址,而不必等待失效路由超时。
保存凭据
Credentials 屏幕保存可重复使用的用户名/密码或用户名/私钥记录。可在服务器设置对话框中选择已保存的凭据,这样就不必为每个主机重复输入相同的登录信息。
凭据记录保存在设备本地——在 iOS 上,机密信息保存在系统 Keychain 中。如果你保存密码、密钥口令或私钥,请用屏幕锁保护设备。
使用私钥
Mobile SSH 支持粘贴私钥和通过系统文件选择器导入密钥。在 Android 上,应用支持 Ed25519、ECDSA(P-256/384/521)和 RSA 密钥;在 iOS 上支持 Ed25519 和 ECDSA(P-256/384/521)密钥。DSA(ssh-dss)在两个平台上都不受支持。两个平台都能打开用密码短语加密的密钥——请在密码/口令字段中输入该口令。
使用私钥的方法:
- 打开 Credentials 或服务器编辑对话框。
- 粘贴私钥文本,或选择 从文件导入。
- 如果密钥已加密,在密码/口令字段中输入密钥口令。
- 保存凭据或服务器。
私钥导入使用系统文件选择器选取密钥文件。在 Android 上,文件传输使用单独的本地文件浏览器,在较新的 Android 版本上可能请求更广泛的存储访问权限;在 iOS 上,文件通过系统的文档和照片选择器传入。
主界面
主界面的设计目标是回答「我可以回到哪里继续」,而不是摆出一个空白的连接表单:
- Continue 列出当前正在运行的连接;如果某个连接包含多个面板,还会显示面板数量。点按一行即可回到该连接。
- Tmux sessions 列出你保存的服务器上正在运行的会话。它取自应用已经保存下来的快照,因此完全没有网络时也能立即显示——每一行都标注了快照的新旧程度,点按其中一行即可连接并附加到该会话。快照在几小时后会变暗,一周后会被丢弃。
- 在 iOS 上,这两部分下方还有一个 Recent 列表;Android 版本已经取消了它,因为事实证明「我可以回到哪里继续」比「我上次是什么时候连接的」更有用。
如果既没有活动连接、也没有缓存内容,界面会明确说明,并指引你去 Servers。
命名并搜索已保存的服务器
一台已保存的服务器可以带一个名称——「Home NAS」「Prod web」——列表中会显示这个名称而不是地址。一旦名称可能产生歧义,地址就会自动出现:例如两行同名,或者正在进行搜索时,这样你始终能分辨每一行。
在 Saved Servers 页面点按搜索框即可筛选。搜索会匹配名称、用户、主机、端口、凭据以及任意备用地址。+ Add Session 界面同样以搜索开始,让你一步找到并连接到已保存的服务器。
服务器可以归入文件夹。文件夹可以折叠、会记住自己被折叠过,也可以重新排序或重命名;删除文件夹只会把其中的服务器移到 Ungrouped,而不会删掉它们。
只导出配置的一部分
Servers 与 Credentials 界面上的 Export selected… 会把列表变成勾选框选择器,因此你可以只交出三台服务器,而不必导出全部内容。点按文件夹标题即可选中整个文件夹。如果你为导出设置了密码短语,文件就会被加密——不设置的话,文件中的密码和私钥都是明文,应用在写出之前也会明确提示这一点。
活动会话
当有会话在运行时,起始屏幕会显示带计数的 Active Sessions。点按它返回终端网格。正在运行的通知中也会列出活动主机——点按通知中的主机可直接跳转到对应终端。
返回起始屏幕不会断开活动的 SSH 会话;关闭窗格或结束终端活动才会断开它们。
首批实用设置
在起始屏幕打开 Settings(它有独立的页面):
- 决定点按终端时是否弹出键盘。两个平台的默认值正好相反:在 Android 上只有按 ⌨ 按钮才会弹出键盘,在 iOS 上点按即可弹出。
- 设置终端的字号、字体、配色方案和回滚缓冲大小,并选择应用主题(跟随系统、浅色或深色)。
- 如果你需要运行耗时的后台任务(Claude Code、Codex、shell 脚本),并希望在智能体需要你输入时收到提醒,请启用 Agent alerts。智能体如何主动上报,请参阅终端指南。
- 在 Android 上,Keep sessions running in background 默认开启,因此把应用从最近任务中划掉之后,shell 与智能体仍会继续运行。
- 在 Android 上,如果你不希望发送任何数据,可以关闭匿名使用统计。iOS 应用目前还没有这个开关。
语言
Mobile SSH 默认跟随系统语言。应用附带阿拉伯语、孟加拉语、中文(简体和繁体)、英语、法语、德语、印地语、印尼语、日语、马拉地语、葡萄牙语、俄语、西班牙语、泰米尔语、泰卢固语、土耳其语和乌尔都语的翻译——Android 上共二十种语言,另外还包含尼日利亚皮钦语与埃及阿拉伯语,iOS 上为十八种。
如果你希望应用使用与手机不同的语言,设置 → 语言 中提供了带「跟随系统」选项的语言选择器。你当然也仍然可以在 Android 的 设置 → 系统 → 语言 或 iOS 的 设置 → 通用 → 语言与地区 中更改。
安全提示
只连接你信任的服务器。当前应用将保存的连接数据存储在本地,不提供云保险库或跨设备同步。当前实现也不显示已知主机确认提示,因此当主机身份重要时,请避免通过不受信任的网络连接。