重建丢失的 vault.cryptomator —— 保险库配置文件丢了怎么办
vault.cryptomator 是什么
vault.cryptomator 是 Vault Format 8 引入的独立配置文件（JWT 格式），内容包括：
- Vault Format 版本（当前是 8）
- 加密文件名短名阈值（默认 220）
- 保险库唯一 UUID（jti）
- 加密算法模式（SIV_GCM / SIV_CTRMAC）
- kid（指向 masterkey 文件或 Cryptomator Hub 实例）
这是一个配置文件，不是加密密钥文件。它的丢失不会直接导致主密钥无法恢复——只是 Cryptomator 无法"识别这个目录是一个保险库"。
丢了 vault.cryptomator 的表现
- 主界面列表里保险库旁边会有一个感叹号标记
- 详情面板显示 "Vault config is missing."
- Unlock 按钮点不下去（因为 Cryptomator 不知道该用哪个加密算法模式、哪个 kid 去解 masterkey）
恢复方式
有两个入口：
方式 1：从保险库详情面板恢复
- 选中有感叹号的保险库 → 右侧详情面板
- 看到 "Vault config is missing." 之后有一个 Restore vault config 按钮
- 点击 → 弹出恢复对话框
- 你可以选择：
- 用旧密码恢复（如果你还记得密码）
- 用 Recovery Key 恢复（如果密码忘了）
- 恢复完成 → 感叹号消失 → 可以正常 Unlock 了
方式 2：从 Recover Existing Vault 入口
保险库还没被添加到列表时（整个保险库目录只有密文文件、没有 vault.cryptomator）：
- 主界面加号 + → Recover Existing Vault…
- 选中保险库密文目录
- Cryptomator 自动检测到 vault.cryptomator 缺失 → 弹恢复对话框
- 输入密码或 Recovery Key → 恢复 → 保险库被添加回列表
和恢复 masterkey 的区别
| 恢复 vault.cryptomator | 恢复 masterkey.cryptomator | |
|---|---|---|
| 能用密码吗 | ✅ 可以 | ❌ 不行 |
| 能用 Recovery Key 吗 | ✅ 可以 | ✅ 可以 |
| 恢复难度 | 更容易（配置文件重建简单） | 较难（需要完整恢复主密钥） |
| 1.18.0 之前能做吗 | ✅ 可以 | ⚠️ 部分可以 |
vault.cryptomator 丢了比 masterkey 丢了好处理得多——Cryptomator 可以从 masterkey 里反推出大部分 Vault 配置（因为 vault.cryptomator 是用 masterkey 签名的 JWT），所以只需要知道密码（或 Recovery Key 拿到 masterkey）就能重建。
如果 vault.cryptomator 还在但损坏了
也有可能 vault.cryptomator 文件还在但内容损坏了（比如云盘同步时截到了一半写入状态）。这种情况下 Cryptomator 也会标记感叹号。恢复方式和丢了时一样——用密码或 Recovery Key 重建。
恢复后立刻做什么
恢复 vault.cryptomator 和恢复 masterkey 一样，做完之后：
- 解锁保险库确认完整
- 锁定保险库
- 强制云盘同步（等云盘把新 vault.cryptomator 同步上去）
- 清空云盘版本历史（防止旧的损坏版本被恢复回去）
- 可以考虑给 vault.cryptomator 单独留一份备份（非常小的文件）