文档 · 专题
主机与密钥
Moshpit 可以连接任何标准 SSH 服务器。密码和私钥都存在手机本机的 iOS 钥匙串里,没有账号体系,也不会同步到我们的服务器。
添加或编辑连接
Section titled “添加或编辑连接”在首页点 添加连接,或长按已有的主机卡片打开 编辑连接:
- 名称 与 表情:给主机起个好认的名字,还可以填一个表情符号。
- 主机、端口 与 用户:分别填域名或 IP(如
dev.example.com或192.0.2.10)、端口(默认22)和登录用户名(如dev)。 - 登录方式:可选 密码、SSH 密钥 或 粘贴 PEM。
- 终端复用器:可选 tmux、herdr 或 不使用。如果主机没装你选的那一个,Moshpit 会直接说明并打开普通 shell,不会私自换成另一个。
密码、SSH 密钥与 Face ID
Section titled “密码、SSH 密钥与 Face ID”多台主机共用的密钥在 设置 › SSH 密钥 › 添加密钥 里管理:
| 方式 | 说明 |
|---|---|
| 生成(软件密钥) | 在手机本机生成 ED25519(推荐)或 RSA-4096 密钥对并存入钥匙串。打开 需要 Face ID 后,每次签名都会先验证面容。 |
| 生成(存入 Secure Enclave) | 在安全隔区芯片内生成硬件保护的 ECDSA P-256 密钥。私钥永远不离开芯片,每次签名均经由 Face ID 确认。 |
| 导入 | 点 导入文件… 或直接粘贴 OpenSSH / PEM 私钥。如果私钥带 口令,导入时输一次即可,解开后由 iOS 钥匙串接管保护。 |
| 粘贴 PEM | 只给单条连接用一把私钥时,可在连接表单的 登录方式 里直接选 粘贴 PEM。 |
在 设置 › SSH 密钥 里点开任一密钥,点 复制公钥 或 分享公钥,把公钥那一行加进主机的 ~/.ssh/authorized_keys 即可登录。
主机密钥信任与主机头像
Section titled “主机密钥信任与主机头像”首次连上一台服务器时,Moshpit 会弹出 新主机 并显示 SHA256 指纹。与服务器上 ssh-keygen -lf /etc/ssh/ssh_host_*_key.pub 的输出核对一致后,点 信任。
如果服务器以后发来了不一样的密钥,Moshpit 会拦下连接,提示 主机密钥已变更,同时列出 已保存 和 本次收到 两条指纹。除非你确定服务器刚重装过系统并换了密钥(此时点 信任新密钥),否则请点 断开。
每台主机都会根据它受信任的主机密钥生成一张专属几何图案头像,开启 像素伙伴 后则会变成像素小生物。在连接里填上 表情 后,头像会换成你选的那个表情,多台主机摆在一起一眼就能分清。
换新 iPhone 从备份恢复
Section titled “换新 iPhone 从备份恢复”换新 iPhone 从备份恢复时,连接列表和信任过的主机密钥都会跟过来,而 iOS 钥匙串里的密码与私钥按系统安全规则留在旧手机上:
- 导入过的密钥:在 设置 › SSH 密钥 里会列在 不在这台 iPhone 上 分组下。点开后选 重新导入… 补回私钥,原有的主机绑定关系保持不变。
- Secure Enclave 密钥:生成在旧手机的安全芯片里,无法迁出。删掉旧条目后重新生成一把,再把新公钥加到服务器上。
- 密码与内联 PEM 私钥:打开那条连接的 编辑连接,按提示重新填入密码或私钥即可。