跳转到内容
moshpit

文档 · 专题

主机与密钥

Moshpit 可以连接任何标准 SSH 服务器。密码和私钥都存在手机本机的 iOS 钥匙串里,没有账号体系,也不会同步到我们的服务器。

在首页点 添加连接,或长按已有的主机卡片打开 编辑连接:

  • 名称 与 表情:给主机起个好认的名字,还可以填一个表情符号。
  • 主机、端口 与 用户:分别填域名或 IP(如 dev.example.com 或 192.0.2.10)、端口(默认 22)和登录用户名(如 dev)。
  • 登录方式:可选 密码、SSH 密钥 或 粘贴 PEM。
  • 终端复用器:可选 tmux、herdr 或 不使用。如果主机没装你选的那一个,Moshpit 会直接说明并打开普通 shell,不会私自换成另一个。

多台主机共用的密钥在 设置 › SSH 密钥 › 添加密钥 里管理:

方式 说明
生成(软件密钥) 在手机本机生成 ED25519(推荐)或 RSA-4096 密钥对并存入钥匙串。打开 需要 Face ID 后,每次签名都会先验证面容。
生成(存入 Secure Enclave) 在安全隔区芯片内生成硬件保护的 ECDSA P-256 密钥。私钥永远不离开芯片,每次签名均经由 Face ID 确认。
导入 点 导入文件… 或直接粘贴 OpenSSH / PEM 私钥。如果私钥带 口令,导入时输一次即可,解开后由 iOS 钥匙串接管保护。
粘贴 PEM 只给单条连接用一把私钥时,可在连接表单的 登录方式 里直接选 粘贴 PEM。

在 设置 › SSH 密钥 里点开任一密钥,点 复制公钥 或 分享公钥,把公钥那一行加进主机的 ~/.ssh/authorized_keys 即可登录。

首次连上一台服务器时,Moshpit 会弹出 新主机 并显示 SHA256 指纹。与服务器上 ssh-keygen -lf /etc/ssh/ssh_host_*_key.pub 的输出核对一致后,点 信任。

如果服务器以后发来了不一样的密钥,Moshpit 会拦下连接,提示 主机密钥已变更,同时列出 已保存 和 本次收到 两条指纹。除非你确定服务器刚重装过系统并换了密钥(此时点 信任新密钥),否则请点 断开。

每台主机都会根据它受信任的主机密钥生成一张专属几何图案头像,开启 像素伙伴 后则会变成像素小生物。在连接里填上 表情 后,头像会换成你选的那个表情,多台主机摆在一起一眼就能分清。

换新 iPhone 从备份恢复时,连接列表和信任过的主机密钥都会跟过来,而 iOS 钥匙串里的密码与私钥按系统安全规则留在旧手机上:

  • 导入过的密钥:在 设置 › SSH 密钥 里会列在 不在这台 iPhone 上 分组下。点开后选 重新导入… 补回私钥,原有的主机绑定关系保持不变。
  • Secure Enclave 密钥:生成在旧手机的安全芯片里,无法迁出。删掉旧条目后重新生成一把,再把新公钥加到服务器上。
  • 密码与内联 PEM 私钥:打开那条连接的 编辑连接,按提示重新填入密码或私钥即可。