本指南涵盖的内容
PassZit 是由 MaxZit 开发的一款免费开源(AGPLv3)、自托管、端到端加密的密码管理器。它由一个带 PostgreSQL 数据库的服务器程序、网页保险库、浏览器扩展和命令行组成。本指南只介绍 PassZit——不比较其他产品的功能或价格——以便您对照自己服务器目前的功能进行核对。
概览
| 方面 | PassZit 具备 | PassZit 不具备 |
|---|---|---|
| 安装 | 虚拟机镜像(OVA、QCOW2、VHDX)、Appliance ISO、安装脚本、deb/rpm 软件包;amd64 和 arm64 | 没有 Docker 镜像 |
| 加密 | 在浏览器中使用 Argon2id,每个条目使用 AES-256-GCM,共享保险库使用 X25519 | 网页保险库的代码来自服务器(扩展自带代码) |
| 客户端 | 网页保险库(可安装为应用)、适用于 Chromium 系浏览器和 Firefox 的扩展、命令行 | 没有原生移动应用,没有 Safari 扩展,没有离线副本 |
| 导入 | 未加密的 Bitwarden JSON 或 CSV,以及浏览器、KeePass/KeePassXC、1Password、LastPass、CSV | 不支持其他程序的加密导出文件;不导入文件中的附件、通行密钥和密码历史 |
| 登录 | 强制第二因素、安全密钥和通行密钥、LDAP / Active Directory、OIDC 和 SAML | 扩展不使用单点登录 |
| 运维 | 每日加密的控制台备份并可复制到 SFTP,带回滚的签名自动更新 | — |
安装
PassZit 是一个程序 passzit-server,配合 PostgreSQL 数据库。共有四种安装方式,全部列在下载页面上:
- 虚拟机镜像——OVA(VMware、VirtualBox)、QCOW2(Proxmox VE、KVM)或 VHDX(Hyper-V 第 1 代),Debian、PostgreSQL 和 PassZit 均已就绪。在虚拟机控制台上,用户
pzadmin会看到一个菜单,用于设置网络、服务器名称、时区、设置令牌和恢复。只开放 22 和 8443 端口。 - Appliance ISO——用于新虚拟机或物理服务器;无人值守安装会清除第一块磁盘。
- 安装脚本,适用于 Debian 12+、Ubuntu 22.04+、AlmaLinux 或 Rocky Linux 9+:
curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh。它会验证版本签名、安装 PostgreSQL、创建带随机密码的数据库,并输出地址和设置令牌。--db使用现有的 PostgreSQL 数据库。 - 软件包(deb、rpm),带有加固的 systemd 服务;在
/etc/passzit/server.env中设置PASSZIT_DB,然后启动passzit-server。
README 要求 2 个 vCPU、2 GB 内存和 16 GB 磁盘。控制台监听 HTTPS 8443 端口,在您于设置 → 网络与访问中允许其他网络之前,只响应私有网络。没有 Docker 镜像;如果您的其他一切都运行在容器中,请用 Appliance 镜像建一台小型虚拟机。分步说明见自托管密码管理器。
加密模型
根据安全页面和代码仓库中 docs/ARCHITECTURE.md 的描述:
- 浏览器使用 Argon2id 从主密码派生出主密钥(默认 64 MiB、3 轮;保险库策略可以修改内存、轮数和并行度)。
- 由它得到一个认证密钥——服务器只保存它的 argon2id 哈希——以及一个永远不会离开浏览器、用于解开随机账户密钥的封装密钥。
- 每个条目——名称、用户名、密码、网站、笔记、字段、文件夹和历史——都用 AES-256-GCM 加密。附件和条目文档也在浏览器中加密。
- 共享保险库有自己的密钥,针对每位成员的 X25519 公钥分别封装。第一次与某人共享时,PassZit 会显示密钥指纹,并在已确认的密钥发生变化时发出警告;有人离开时,保险库会获得新密钥。
按 PassZit 自己的说法,它不能防范以下情况:网页保险库的 JavaScript 来自您的服务器,因此完全控制服务器的人可能提供被篡改的代码;通过组加入保险库的人获得访问时没有指纹确认;用户电脑上的恶意软件可以读取输入的内容。浏览器扩展自带代码,服务器无法修改。任何人都无法重置忘记的主密码——只有用户的恢复密钥能再次打开保险库。
浏览器扩展
PassZit 扩展已上架 Chrome Web Store(Chrome、Brave、Opera、Vivaldi)、Firefox Add-ons(Firefox 128 或更新版本)和 Microsoft Edge Add-ons;链接见下载页面。服务器也在网页保险库的浏览器扩展中提供它,包括对应当前浏览器商店的一键安装,以及供手动安装的自有软件包。
- 连接:只需输入服务器地址并点击通过网页保险库连接;您在网页保险库中登录并在那里确认。服务器可以运行在自己的端口上,例如 8443。它需要浏览器信任的证书——扩展会拒绝新服务器的自签名证书(设置 → 证书:您自己的证书或 Let's Encrypt)。
- 填充:登录信息只在其所属网站上提供(Public Suffix List),只填入顶层页面的可见字段,绝不填入其他网站的框架;为 HTTPS 保存的登录信息不会在普通 HTTP 上提供。一次性验证码在请求它的页面上填充。
- 保存:开启提示保存新的和已更改的登录信息后,PassZit 图标会显示一个数字;PassZit 从不在网页内部显示任何内容。
- 银行卡和地址用于填写付款和收货表单——只填空字段,只在 HTTPS 页面上,只在顶层页面中,卡片则会先询问。
- 一次解锁:同一服务器的网页保险库和扩展一起解锁、一起锁定。Windows Hello、Touch ID 或手机的屏幕锁可以通过通行密钥(WebAuthn PRF)解锁网页保险库。
不提供:Safari 扩展、扩展中的单点登录(扩展使用主密码和身份验证器验证码登录),以及填写位于支付服务商框架中的付款字段。
导入 Bitwarden 格式的导出文件
PassZit 的导入功能读取未加密的 Bitwarden 导出文件,格式为 .json 或 .csv。加密的导出文件会被拒绝,并提示需要未加密的文件。PassZit 根据文件内容而不是生成它的程序来识别文件:带有 items 列表的 JSON 文件会按 Bitwarden 格式读取。
- 在您当前的程序中生成未加密的导出文件。
- 在 PassZit 网页保险库中选择工具 → 导入并选取文件。文件在浏览器中读取;PassZit 会显示格式、条目和文件夹的数量,以及其中多少已在保险库中。
- 选择保留文件中的文件夹或一个新文件夹,保持跳过保险库中已有的条目开启,然后导入。
- 删除导出文件——其中所有密码都未加密。
PassZit 从 Bitwarden JSON 格式中导入登录信息及其网站、一次性验证码密钥和自定义字段(隐藏字段保持隐藏)、安全笔记、卡片、身份、SSH 密钥、文件夹和收藏。不导入的有:附件(不包含在导出文件中——请重新附加)、文件中保存的通行密钥(请用扩展重新保存)、条目的密码历史,以及文件夹以外的任何分组方式。每位用户导入到自己的保险库;供团队使用的条目随后通过条目编辑器中的保险库字段逐条移动。导入和导出会记录在审计日志中,只记录条目数量,从不记录内容。
第二因素、通行密钥和一次性验证码
- 账户登录:每个账户都必须使用双因素登录——身份验证器应用(TOTP)加十个恢复码。在我的账户 → 安全密钥和通行密钥中,安全密钥(YubiKey、Titan 等)或设备通行密钥可以在网页保险库中代替应用验证码;扩展仍使用应用验证码。管理员可以重置丢失的第二因素;保险库不受影响。
- 网站通行密钥:开启使用 PassZit 管理通行密钥后,网站创建通行密钥时扩展会提供保存到 PassZit,并将其作为加密的保险库条目保存,可在任何装有该扩展的浏览器中使用。PassZit 不发送“用户已验证”标志,因此要求验证的网站会使用浏览器自身的通行密钥。
- 网站的一次性验证码:登录信息可以保存验证器密钥(TOTP),可粘贴或从二维码读取——在网页保险库中从图片读取,在扩展中使用读取此页面上的验证器二维码。这样打开保险库的人就同时拥有两个因素;对于最重要的账户,PassZit 的指南建议使用单独的身份验证器应用。
服务器的备份和更新
设置 → 控制台备份每天以及按需(立即备份)将备份写入 /var/lib/passzit/backups:包含所有保险库的数据库、服务器的密钥和控制台证书。备份始终使用您设置的密码短语加密,每份备份都可以复制到另一台服务器上的 SFTP 文件夹。可通过 Appliance 菜单或 passzit-server -restore 恢复;恢复会一步替换整个数据库。如果您改为自行备份,请同时备份数据库和 secret.key——服务器自身的机密(例如第二因素)需要它。
设置 → 更新与服务器只安装经过签名的版本:它会备份数据库和程序、安装更新,如果服务器没有恢复运行,会自动恢复旧版本。也可以在这里设置在指定时间自动安装,以及用于候选版本的 Testing 通道。
用户也可以保留自己保险库的副本:工具 → 导出 → 加密的 PassZit 文件(推荐),用自己选择的密码保护。
LDAP 和单点登录
设置 → 企业登录用于控制谁可以登录;主密码始终保留,因为它是保险库的钥匙,而账户也仍然只能通过邀请创建。
- 通过 OpenID Connect(Microsoft Entra ID、Google、Okta、Keycloak 等)或 SAML 2.0(ADFS、Entra ID、Okta 等)为网页保险库提供单点登录。
- Active Directory / LDAP:每次登录时(包括扩展和命令行的登录),PassZit 都会用服务账户查找该地址;不存在或已禁用的账户无法登录。查找可测试设置。
- 两者都可以让 PassZit 的组与公司中同名的组保持一致,从而使共享保险库的访问跟随目录。
不支持 SCIM 预配,也不能不经邀请注册。共享保险库、组和权限如何工作,请参阅与团队共享密码。
在现有服务器旁边测试 PassZit
- 让现有服务器继续运行。将 PassZit Appliance 导入为一台有独立 DNS 名称的小型虚拟机,并在试用扩展之前为它配置受信任的证书。
- 先用测试账户。邀请两三个人,创建一个共享保险库和一个组,试试权限、指纹核对以及把某人移出保险库。
- 导入副本,而不是全部。为一个测试账户生成未加密的导出文件并导入,对比条目数量,检查几张卡片、几个身份、SSH 密钥和一次性验证码。删除导出文件。
- 只在测试的地方安装两个扩展。PassZit 的保存登录提示在您开启之前是关闭的,使用 PassZit 管理通行密钥也是如此,因此比较期间两个扩展不会同时询问。
- 测试服务器的备份。执行立即备份,把备份恢复到第二台测试虚拟机上,并在那里登录。
- 逐条过一遍下面的限制,和将要使用它的人一起,尤其是移动端使用和扩展的登录方式。
需要了解的限制
- PassZit 仍在积极开发中:首个公开版本 0.9.0 于 2026 年 11 月发布,新版本发布频繁。
- 没有原生移动应用,也没有 Safari 扩展(两者都在计划中)。网页保险库可以添加到手机主屏幕,但不会保存任何离线数据。
- 没有 Docker 镜像;请使用镜像、脚本或软件包安装。
- 导入功能只读取未加密的导出文件;文件中的附件、通行密钥和密码历史不会导入。
- 扩展需要受信任的证书,并使用主密码和身份验证器验证码登录,而不是单点登录。
- 忘记主密码且没有恢复密钥时,任何人都无法恢复。
- 界面提供 14 种语言;内置用户指南提供英文和塞尔维亚文版本。
后续步骤
下载 PassZit,了解全部功能和安全模型,或从指南自托管密码管理器和与团队共享密码开始。从托管服务迁移的团队可以在面向团队的自托管 1Password 替代方案中了解更多。欢迎在 GitHub Discussions 中提问(仅限英文);企业可以从 MaxZit 获得商业支持(仅提供英文服务)。
Bitwarden 是其所有者的商标;Vaultwarden 是一个独立项目的名称。PassZit 和 MaxZit 与两者均无隶属关系,未获其认可,也与其没有任何关联。此处使用这些名称,仅用于描述人们搜索的内容以及 PassZit 可以导入的导出格式。