密码库

所有凭据都保存在同一个加密库中。加密库必须处于解锁状态才能使用 SSH、SFTP 或运行监控。

本页介绍的是使用方法，加密相关的技术细节请见 安全模型。

三种状态

状态	含义
uninitialized（未初始化）	尚未设置主密码。应用会提示您创建加密库。
locked（已锁定）	加密库存在，但密钥不在内存中。凭据不可访问，监控暂停。
unlocked（已解锁）	正常状态，一切功能均可使用。

创建加密库

首次运行应用时，您需要设置主密码。几点提示：

• 让密码足够长，而不是追求复杂。四五个随机单词组合，远胜于 P@ssw0rd!。
• 不要重复使用您在别处用过的密码。
• 创建后立即将其保存到密码管理器中。

没有安全问题，没有邮箱找回，也没有后门。这是刻意的设计。

自动解锁

首次解锁后，应用会将数据密钥缓存到您系统的钥匙串中 （Windows 凭据管理器 / macOS 钥匙串 / Linux 上的 Secret Service）， 这样下次启动时就不需要再次输入密码。

被缓存的是数据密钥 —— 不是主密码，也不是从主密码派生出的密钥。 当您点击锁定加密库时，钥匙串中的条目会被删除，内存中的密钥也会被覆盖清除。

如果您希望每次都手动输入密码，只需在退出应用前锁定加密库即可。

锁定加密库 与 锁屏 的区别

这是两个不同的概念，经常被混淆：

锁定加密库 —— 加密密钥从内存中删除。后台监控会停止， 所有凭据都变得不可访问。这是真正的保护。

锁屏 —— 在一段时间不活动后隐藏应用窗口（默认 15 分钟，可在 设置 中调整）。密钥仍留在内存中，监控仍在运行， 已打开的 SSH 会话保持存活。

为什么要将两者分开：在一台 7×24 小时运行的机器上，如果锁定机制每 15 分钟 就中断一次监控，用户最终会把它关掉。锁屏能阻止路过工位的人看到内容， 但阻止不了能够重启这台机器的人。当您需要那种级别的保护时， 锁定加密库按钮就在锁屏界面上。

更改主密码

进入设置 → 更改主密码，输入当前密码和新密码。

这不仅仅是更改密码：它还会同时轮换数据密钥，并在同一个事务中重新加密 所有凭据。实际效果是：任何此前获取过旧密钥的人，现在都会被拒之门外。

如果过程中被中断（断电、崩溃），事务会回滚，加密库保持在原来的状态 —— 不会出现半途损坏的情况。

Argon2 参数升级

KDF 参数保存在加密库内部，而不是固定写死在源代码中。当新版本提高了 哈希计算成本时，您的旧加密库仍可用旧参数打开，并在下次解锁时自动升级到 新参数。您无需做任何操作。

忘记主密码

无法找回。您唯一的选择是删除数据库文件并重新开始：项目、VM 和凭据都会随之消失。

如果您在别处（密码管理器、~/.ssh）仍保留着密钥和密码，重建过程大部分 只是重新导入 —— 从 ~/.ssh/config 导入 能处理其中大部分工作。