Termius 跨设备同步机制 | Vaults 云同步如何在手机、桌面、平板间保持一致

同步架构

Termius 的跨设备同步围绕 Vaults 展开。整体架构很简单：

1. 每台设备本地维护 Vaults 数据的加密副本
2. 任意一端修改后用加密密钥重新加密，上传到 Termius Cloud
3. 其他设备收到变更通知，拉取更新，本地解密应用

同步是增量的——只传输变化的部分，不是每次传全量。所以即使你只改了一台主机的备注，也只会同步那一小段数据。

冲突解决

当你在两台设备上同时修改同一条数据（比如同一台主机的端口）时，Termius 用 last-writer-wins 策略自动解决：

• 时间戳较新的版本覆盖时间戳较旧的版本
• 冲突不会导致数据损坏或丢失
• 冲突解决过程对你完全透明

这种策略对 SSH 客户端场景是合理的——不会出现文档协作那种需要手动合并的复杂冲突。

支持同步的数据类型

所有 Vaults 内的数据都会同步：

• ✅ 主机连接配置（IP、端口、用户名、认证方式）
• ✅ 分组结构
• ✅ SSH 密钥对（加密存储）
• ✅ 凭证条目（如果不用密钥，密码存在哪里）
• ✅ Snippets（命令片段）
• ✅ 端口转发规则
• ✅ Known Hosts 指纹
• ✅ 终端命令历史

不同步的数据（纯本地）：

• ❌ 终端输出历史（太占空间，也包含敏感信息）
• ❌ 本地终端会话（Local Terminal）
• ❌ 应用界面偏好（字体大小、主题等——这些是设备级的）

Starter 版的同步限制

Starter 免费版不支持云同步。 Personal Vault 数据只存在当前设备本地。如果你换电脑，只能手动导出配置文件再导入（Termius 提供了 JSON 格式的导出功能）。

升级到 Pro 或以上版本后，云同步自动启用——只要你在新设备上登录同一账号并输入加密密码，所有数据自动出现。

同步状态查看

桌面端顶部工具栏或右下角状态栏会显示当前同步状态：

• ✅ 绿色勾：已同步，无挂起变更
• ⏳ 蓝色转圈：正在同步
• ❌ 红色叉：同步失败（网络问题、服务器问题等）

点击状态图标可以打开同步日志，查看最近的同步操作和失败原因。

网络要求

同步走标准 HTTPS（443 端口），不需要额外开端口。但要注意 Termius 云服务的域名：

• 同步 API 走 api.termius.com 和 grpc.termius.com
• 公司内网如果有严格的出口防火墙，需要确保这两个域名放行
• iOS / Android 的同步会走 Google Play / App Store 的推送通道

如果同步不工作，先检查：

1. 网络是否能访问外网
2. 防火墙是否放行 api.termius.com
3. grpc.termius.com 是否使用 HTTP/2（Termius 要求）

选择性同步

目前 Termius 没有细粒度的选择性同步开关——Vault 内所有数据一起同步，不支持「只同步主机不同步 Snippets」。

但可以通过 Vault 划分来间接实现选择性同步：比如把不想上云的主机留在本地 Starter 里，把需要云同步的放进 Personal Vault。升级 Pro 后 Personal Vault 自动启用同步。

离线使用

网络断开时 Termius 完全可用——所有数据的本地副本都在。SSH 连接本身不依赖 Termius 云，只要你能通服务器就能连。恢复网络后自动继续同步。

这个设计在移动场景下特别重要：地铁、电梯里信号不好，你照样可以用 Termius 连服务器排查问题，出来有信号了数据自动同步回去。