VsTerm 云端同步与数据加密架构全解析:AES-256-GCM、Ed25519 与 Argon2id 如何做到零知识存储
VsTerm 云端同步与数据加密架构全解析:AES-256-GCM、Ed25519 与 Argon2id 如何做到零知识存储
VsTerm 是一款 Rust 原生、跨平台的 SSH 终端,它的云端同步把会话、命令、布局、偏好与凭据全部在本地加密后再上传,服务端只保存密文。本文拆解 AES-256-GCM、Ed25519 与 Argon2id 三层加密,如何共同支撑这套零知识存储架构。
☁️ 什么是零知识存储:SSH 终端云同步的安全底线
普通云备份会把数据以明文或"服务商可见"的方式上传;VsTerm 的 Personal Cloud 走的是另一条路:
- 客户端加密:一切同步内容在本机完成加密封装,上传的只有密文包;
- 密钥不上传:解密密钥由你的主密码派生,设备身份私钥只存在系统钥匙串里;
- 服务端只存密文:即使拿到云端数据库,没有主密码也无法还原任何一条会话或密码。
这正是"零知识"(zero-knowledge)的含义——包括 VsTerm 运营方在内,任何人都读不到同步内容。官方说明见 README.zh-CN.md 的「云端同步与数据安全」。
同步范围包括会话(服务器树)、快捷命令、窗口布局、偏好设置和凭据 vault,属于 Pro 功能;版本差异可查 README.zh-CN.md 的标准版 / Pro 对比表。
🔐 VsTerm 三层加密架构:每一层各管一件事
| 层级 | 算法 / 载体 | 作用 | 密钥位置 |
|---|---|---|---|
| 设备身份 | Ed25519 密钥对 | 证明"这台设备有资格同步" | 私钥在系统钥匙串,永不上传 |
| 密钥派生 | Argon2id | 把主密码变成可用的同步密钥 | 主密码只在你脑子里 |
| 数据加密 | AES-256-GCM | 加密每一个同步对象(VSC2 密文包) | 派生密钥仅本机使用 |
Ed25519 设备密钥:私钥不出本机
登录 Personal Cloud 后,VsTerm 在本机生成一对 Ed25519 密钥:公钥注册到云端,用于识别与校验设备;私钥写入系统钥匙串(macOS Keychain / Windows 凭据管理器 / Linux Secret Service),用到时才读取,从不离开设备。
账号页的"我的设备"列表会显示每台设备最近活跃时间,并支持撤销——换新电脑或设备丢失时,直接吊销旧设备身份,它就无法再同步到你的数据。
Argon2id 密钥派生:把主密码"磨"成同步密钥
主密码本身太短、熵太低,不能直接当加密密钥用。VsTerm 用 Argon2id 做密钥派生(KDF):它是内存硬算法,单次派生要占用约 19 MiB 内存,暴力破解的成本被成倍放大。派生出的同步密钥以 VSC2 密文包形式封装保存,解锁结果会被缓存复用,连接会话不会卡在推导上(性能细节见 CHANGELOG.md)。
一句话:忘记主密码 = 云端数据永久不可读。这是零知识设计的核心,也是后文安全建议存在的原因。
AES-256-GCM:为每个同步对象加密封装
同步内容按"类型"划分(会话、命令、布局、偏好、凭据),每个对象用 AES-256-GCM 加密。GCM 模式自带完整性校验:密文被改动哪怕一个比特,解密时会直接失败报错,而不是还给你一份"看起来正常"的数据。
🗝️ 凭据 vault 同步:密文套密文
SSH 密码和私钥是最敏感的数据,VsTerm 用双层结构处理:
- 本机凭据 vault 先用主密码派生的密钥加密,密文存
vault.enc,元数据放credentials/catalog.yaml; - 云端同步上传的是密封后的
vault.enc,以及只含vault://引用的 catalog——引用不等于密钥; - 终端命令历史
cmdhist.enc同样本机加密,且从不上传云端。
也就是说,云端拿到的凭据数据仍是一块本地已加密的密文,解密钥匙从未离开你的设备。
🛡️ 零知识落地的细节:合并、备份与误覆盖保护
- 双向合并而非覆盖:两台设备改了同一类内容会逐项合并,删除也会同步;冲突时保留本机值,云端旧版自动存进本机备份(机制见 CHANGELOG.md 1.4.0 说明)。
- 本机备份可回滚:每次同步前自动备份到数据目录下的
sync-backups/,保留最近 30 次,离线也能恢复。 - 与云端比较不传数据:只按类型显示"本机改了 / 云端改了 / 两边都改了"。
- 误覆盖保护:本地服务器少于 5 台时,上传到云端会先弹确认,防止小树覆盖云端。
- 设备可撤销:结合 Ed25519 设备列表,随时吊销不活跃设备。
✅ 开启 VsTerm 云端同步:三步上手步骤与安全建议
- 登录账号:偏好设置 → 账号,用邮箱验证码登录(邮箱只收验证码,不存密码);
- 设置主密码:偏好设置 → 主密码。首次设置会默认勾选"屏幕锁",建议保持开启;
- 执行同步:偏好设置 → 云端同步 →「同步」;之后可用「与云端比较」查看差异,或从「覆盖」菜单整体上传 / 下载。
📌 安全建议:主密码使用长且唯一的短语,不要和其他网站共用;不再使用的设备记得在账号页撤销;云同步需要 Pro 权益(14 天试用不包含云端同步),SSH 连接本身则完全不依赖云账号。
🐾 结语:密文上云,密钥不出本机
Ed25519 管"你是谁",Argon2id 管"主密码怎么变密钥",AES-256-GCM 管"数据怎么加密"——三层各司其职,才让 VsTerm 的云端同步做到真正的零知识存储:会话、命令与凭据放心上云,解开的钥匙始终只在你手里。

