Termius 批量导入与主机迁移 | 从 PuTTY / Xshell / SecureCRT / SSH Config 迁移

支持的导入来源

Termius 内置了多种导入适配器，可以直接从常见 SSH 客户端的配置文件导入主机列表：

从 OpenSSH Config 导入

这是最通用的导入方式——几乎所有 SSH 客户端都能导出或兼容 OpenSSH config 格式。

步骤：

1. 桌面端打开 Termius 设置 → 找到「Import Hosts」或类似入口
2. 选择「OpenSSH Config」
3. 指定 config 文件路径（Windows 上通常是 C:\Users\<你>\.ssh\config，macOS / Linux 是 ~/.ssh/config）
4. 选择导入到哪个 Vault
5. 预览将要导入的主机列表，确认无误后点击导入

注意事项：

• OpenSSH config 里的 IdentityFile 路径要在当前机器上真实存在（Termius 需要找到私钥文件）
• ProxyJump / ProxyCommand 配置会被识别并转换成 Termius 的 Jump Host 设置
• 复杂的 Match / Host 块不会完全转换，需要手动补

从 PuTTY 迁移

PuTTY 的配置存在 Windows 注册表里。迁移步骤：

1. 在旧机器上导出 PuTTY 注册表项：打开 regedit → HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\Sessions → 导出为 .reg 文件
2. 或直接用 PuTTY 的导出功能（命令行 putty -session -save <名称>）
3. Termius 设置里选择「PuTTY (.reg)」，指定导出的文件
4. 导入时 Termius 会把 PPK 密钥转换成自己的格式（如果密钥密码正确的话）

PPK 密钥转换： Termius 原生支持 PPK v2 和 v3 格式，直接读取使用。不需要手动转成 OpenSSH 格式。

从 Xshell / SecureCRT 迁移

这两款都是商业 SSH 客户端，有自己的会话文件格式：

• Xshell：File → Export Sessions → 导出 .xsh 文件
• SecureCRT：File → Export → Session → 导出 .ini 文件

在 Termius 的导入入口选择对应格式，指定文件路径就行。

从 JSON / CSV 手动导入

如果以上都不适合，Termius 支持：

JSON 格式（完整）

{
  "hosts": [
    {
      "alias": "web-01",
      "address": "10.0.1.100",
      "port": 22,
      "username": "root",
      "protocol": "ssh",
      "group": "生产环境"
    }
  ]
}

完整的 JSON 格式可以包含 Jump Host、密钥路径、端口转发规则等。最简单的方式是先从一台已配置好的主机导出 JSON，照着那个格式写。

CSV 格式（基础）

CSV 只导入基础连接信息，高级配置需要导入后手动补。

迁移后的注意事项

导入完成后，建议检查：

1. 密钥路径——跨机器导出导入的，密钥文件在新机器上是否真实存在
2. Jump Host 配置——ProxyJump 是否正确转成了 Jump Host 链式配置
3. 端口转发规则——有些复杂规则可能转不全，手动补
4. Group / Tags——如果源格式没这些，导入后会平铺，需要手动组织

从 Termius 导出备份

Termius 也能把当前 Vault 的所有主机导出成 JSON：

• Vault 标签右键 → Export → 选择导出格式和路径
• 导出的 JSON 可以在另一台机器上重新导入（只要加密密码一致）
• 也可以用来做备份

注意：导出的 JSON 里不包含加密密码（本来也没有存储），也不包含明文密码（密码存在 Keychain 里）。密钥对里的私钥部分会被加密存储。