PassZit

团队使用 KeePass:从共享 .kdbx 文件到密码服务器

写给目前共享同一个 KeePass 或 KeePassXC 数据库文件、想要一套专为多人设计的方案的团队:密码迁移到 PassZit 服务器后有哪些变化,账户、组和权限如何工作,KeePass 导出文件如何导入,没有服务器时会怎样,备份如何工作——以及 PassZit 不做什么。

本指南涵盖的内容

PassZit 是一款免费开源(AGPLv3)的密码管理器,面向个人和团队,运行在您自己的服务器上,保险库采用端到端加密。它免费且不限用户数量;开发它的公司 MaxZit 提供可选的付费支持和上线服务(仅提供英文服务)。KeePass 和 KeePassXC 是独立的开源项目,许多团队通过一个共享文件来使用它们;搜索“团队使用 KeePass”的人,往往是在寻找一台服务器。本指南只介绍 PassZit——不对其他程序作任何陈述——以便您判断它是否适合您的团队。

有了服务器后有哪些变化

主题在 PassZit 中
密码存放在哪里存放在您运行的一台 PassZit 服务器上(虚拟机镜像、ISO、安装脚本或 deb/rpm 软件包);客户端从服务器获取更改
谁能打开什么每个人都有自己的账户和主密码;团队保险库决定谁能看到哪些密码
有人离开立即禁用该账户;当此人被移出保险库或账户被删除时,保险库会获得新密钥
谁做了什么服务器的审计日志,以及团队保险库条目的谁使用过此项目
您需要运维的内容服务器本身:证书、可访问性、更新和备份(控制台中的设置)

安装见自托管密码管理器:README 要求 2 个 vCPU、2 GB 内存和 16 GB 磁盘;没有 Docker 镜像。

每人一个账户

  • 仅限邀请:管理员使用用户 → 邀请用户;链接只能使用一次,默认有效期 7 天。
  • 各自的主密码和强制的第二因素(身份验证器应用,如有需要还可加上安全密钥或设备通行密钥)。任何管理员都无法查看或重置主密码。
  • 恢复密钥:每个人在我的账户中生成一个;忘记主密码后,这是唯一的退路。用户列表会显示谁已经有了恢复密钥。
  • 企业登录(设置 → 企业登录):Active Directory / LDAP 和单点登录(OpenID Connect、SAML 2.0)决定谁可以登录,并可以让 PassZit 的组与公司的组保持一致。主密码始终保留。
  • 两种账户角色:用户和管理员。管理员管理用户和设置,但和其他人一样,无法读取自己不是成员的保险库。

保险库、组和权限

每位用户都有我的保险库;共享保险库位于团队保险库下。不要用一个文件存放所有内容,而是按每个实际用途——网络设备、某个客户、财务——各建一个团队保险库,并为人员或组授予四种权限之一,每一项都包含前面的各项:连接和填充、查看密码、添加和修改、管理。

  • 文件夹属于某个保险库,可以嵌套,并有客户、站点或数据中心等类型。
  • 访问可以设置结束日期;工具 → 访问请求在管理者批准后提供 1 小时到 30 天的更多权限。
  • 组在组中创建;保险库始终保留至少一名长期管理者。

包括密钥指纹核对在内的步骤,见与团队共享密码。

端到端加密

如安全页面所述:浏览器使用 Argon2id 从主密码派生密钥,用 AES-256-GCM 加密每个条目——名称、用户名、密码、网站、笔记、文件——并且只发送密文。服务器保存一个独立认证密钥的 argon2id 哈希,永远不会收到主密码。每个共享保险库都有自己的密钥,针对每位成员的 X25519 公钥分别封装。

PassZit 自己说明的限制:网页保险库的 JavaScript 来自您的服务器,因此完全控制服务器的人可能提供被篡改的代码(浏览器扩展自带代码);用户电脑上的恶意软件可以读取输入的内容。

导入 KeePass 或 KeePassXC 导出文件

PassZit 不能打开 .kdbx 文件。它读取的是未加密的导出文件:它的用户指南列出 KeePass 2 使用 File → Export → KeePass XML (2.x),KeePassXC 使用 Database → Export → CSV file (or XML)(不同版本的菜单可能不同)。

  1. 在受信任的电脑上生成导出文件。
  2. 在网页保险库中选择工具 → 导入并选取文件。文件在浏览器中读取;PassZit 会显示找到多少条目和文件夹,以及其中多少已在保险库中。
  3. 选择保留文件中的文件夹或全部放入新文件夹,保持跳过保险库中已有的条目开启,然后导入。
  4. 删除导出文件——其中所有密码都未加密。

从 XML 格式中,PassZit 导入标题、用户名、密码、URL 和笔记,把嵌套的组导入为嵌套的文件夹,把其他字段导入为自定义字段(受保护的字段保持隐藏),并导入保存在名为 otp 或 TOTP Seed 的字段中的一次性验证码密钥;只有笔记的条目会成为安全笔记,回收站不会导入。从 CSV 中,它导入能识别的列,例如标题、用户名、密码、URL、笔记、组和 TOTP。不导入的有:附件(请重新附加)、条目的旧版本,以及这些字段以外的任何内容。

导入的内容进入执行导入的人的我的保险库。要填充团队保险库,由一个人导入,然后通过条目编辑器中的保险库字段逐条移动条目——文件很大时请为此预留时间。导入会记录在审计日志中,只记录条目数量,从不记录内容。

浏览器扩展和日常使用

  • 扩展适用于 Chrome、Edge、Firefox(128 或更新版本)、Opera、Brave 和 Vivaldi,可从 Chrome Web Store、Firefox Add-ons 和 Microsoft Edge Add-ons 获取,也可从服务器的浏览器扩展页面获取。它们只在匹配的网站上填充登录信息和一次性验证码,在您开启相应选项后提示保存新的登录信息,还能填写银行卡和地址。
  • 网页保险库可在任何现代浏览器中使用,并可安装为应用;网页保险库和扩展只需解锁一次。
  • 远程连接:RDP、SSH、WinSCP、WinBox、VNC 和 Telnet 条目可通过扩展打开,在 Windows 上借助 MaxZit Launcher,在 Linux 上借助 passzit-helper——参见服务器和设备凭据。
  • 命令行:passzit 在 Linux、Windows 和 macOS 上的脚本中读取登录信息和一次性验证码。

目前还没有原生移动应用,也没有 Safari 扩展(两者都在计划中)。

没有服务器时

PassZit 没有离线模式。网页保险库不会保存任何离线数据——没有服务器时,它会显示一个简短的“离线”页面——扩展也不会在磁盘上保存保险库的副本。办公室以外的人需要能够访问服务器:在您于设置 → 网络与访问中允许更多网络之前,控制台只响应私有网络,因此通常使用 VPN。如果您的团队在服务器停机时也需要密码,请提前规划:例如从备份恢复的第二台服务器,或每位用户各自保存在安全地方的加密导出文件。

备份

  • 设置 → 控制台备份:每天以及按需备份整个服务器,始终使用您设置的密码短语加密,并可选择复制到另一台服务器上的 SFTP 文件夹。可通过 Appliance 菜单或 passzit-server -restore 恢复。
  • 工具 → 导出 → 加密的 PassZit 文件(推荐):每位用户都可以保留一份自己可导出内容的加密副本,用自己选择的密码保护;它可以再次导入 PassZit。
  • 设置 → 更新与服务器只安装经过签名的版本,如果服务器没有恢复运行,会自动恢复旧版本。

在依赖备份之前,请先测试把它恢复到第二台虚拟机上。

在现有文件旁边测试

  1. 测试期间继续使用现有文件。
  2. 用 Appliance 镜像搭建一台小型服务器,配置 DNS 名称、受信任的证书(设置 → 证书;扩展会拒绝自签名证书)、SMTP 和控制台备份。
  3. 导入一份副本:把数据库以 XML 格式导入一个测试账户,对比条目和文件夹的数量,并检查几个带有自定义字段和一次性验证码的条目。删除导出文件。
  4. 建立您实际要用的团队保险库,邀请两三位拥有不同权限的同事,并在他们的浏览器中试用扩展。
  5. 演练难熬的日子:用恢复密钥找回忘记的主密码、手机丢失、有人离开,以及把备份恢复到测试虚拟机上。
  6. 逐个保险库切换,然后停用共享文件及其副本。

需要了解的限制

  • PassZit 仍在积极开发中:首个公开版本 0.9.0 于 2026 年 11 月发布,新版本发布频繁。
  • 它需要一台正在运行的服务器;没有离线模式,也没有可以放在 U 盘里随身携带的文件。
  • 不支持导入 .kdbx:只支持未加密的 XML 或 CSV 导出文件;附件和条目的旧版本不会导入。
  • 导入的内容进入个人保险库;条目需逐条移入团队保险库。
  • 导出格式为加密的 PassZit 文件或未加密的 CSV 文件。
  • 没有原生移动应用,也没有 Safari 扩展(两者都在计划中);浏览器扩展不使用单点登录。
  • 忘记主密码且没有恢复密钥时,任何人都无法恢复。
  • MaxZit 的付费支持仅提供英文服务。

后续步骤

下载 PassZit,查看全部功能和安全模型,并按照自托管密码管理器和与团队共享密码操作。如果您在比较自托管服务器,自托管 Bitwarden 替代方案会更详细地介绍安装和加密。欢迎在 GitHub Discussions 中提问(仅限英文);MaxZit 提供支持计划和上线服务(仅提供英文服务)。

KeePass 和 KeePassXC 是独立开源项目的名称,归其各自的所有者所有。PassZit 和 MaxZit 与两者均无隶属关系,未获其认可,也与其没有任何关联。此处使用这些名称,仅用于描述人们搜索的内容以及 PassZit 用户指南中列出可供导入的导出方式。