PassZit

为团队安装自托管密码管理器

从一台空虚拟机到团队在浏览器中自动填写登录信息的分步指南:安装 PassZit、创建首位管理员、邀请同事、连接浏览器扩展、迁移旧密码,并让服务器保持备份和更新。

本指南涵盖的内容

PassZit 是一款免费开源(AGPLv3)的密码管理器,运行在您自己的服务器上。每位用户都有一个端到端加密的保险库,用于保存登录信息、一次性验证码、安全笔记、卡片、SSH 密钥和文件;团队可以按人员分配权限共享保险库。服务器只保存密文。如果您因为搜索“自托管 Bitwarden 替代方案”而在比较工具,本指南将展示 PassZit 的安装和推广在实践中是什么样子。

准备工作

  • VMware、VirtualBox、Proxmox VE/KVM 或 Hyper-V 上的一台虚拟机,或一台物理服务器,配置 2 个 vCPU、2 GB 内存和 16 GB 磁盘——或一台现有的 64 位 Debian 12+、Ubuntu 22.04+、AlmaLinux 或 Rocky Linux 9+ 服务器(x86-64 或 ARM64)。
  • 浏览器通过 TCP 8443 访问服务器。PostgreSQL 由安装脚本和镜像自动配置。
  • 用于浏览器扩展:服务器的 DNS 名称和浏览器信任的证书(见下文)。
  • 可选:一台 SMTP 服务器,以便 PassZit 通过电子邮件发送邀请和通知。

安装服务器

共有四种方式,全部列在下载页面上,每个版本都经过签名。

方式最适合
虚拟机镜像:OVA(VMware、VirtualBox)、QCOW2(Proxmox VE、KVM)、VHDX(Hyper-V 第 1 代)导入、启动、登录——Debian、PostgreSQL 和 PassZit 均已就绪
Appliance ISO新虚拟机或物理服务器;无人值守安装会清除第一块磁盘
安装脚本现有的 Debian、Ubuntu、AlmaLinux 或 Rocky Linux 服务器
软件包(deb、rpm;amd64、arm64)使用自己的 PostgreSQL 和配置管理

虚拟机镜像或 ISO:启动虚拟机。屏幕上会显示控制台地址和设置令牌。在虚拟机控制台上可以用 pzadmin 登录(初始密码 passzit,首次登录时修改):菜单可设置网络、服务器名称和时区,再次显示令牌并恢复备份。只开放 22(SSH)和 8443 端口。

安装脚本:在服务器上以 root 身份运行:

curl -fsSL https://github.com/Max-Zit/passzit/releases/latest/download/install.sh | sudo sh

脚本会安装 PostgreSQL、下载最新版本、验证其签名、创建带随机密码的数据库、启动服务,并输出地址和设置令牌。--version、--db(现有的 PostgreSQL 数据库)或 --no-auto-updates 等选项通过 sh -s -- 传入。

软件包:安装 deb 或 rpm,在 /etc/passzit/server.env 中设置 PASSZIT_DB,然后运行 systemctl start passzit-server。设置令牌位于 /var/lib/passzit/setup-token.txt。

首次登录和首位管理员

  1. 打开 https://<服务器>:8443。新服务器使用自签名证书,浏览器会警告一次——接受即可。
  2. 输入设置令牌、您的电子邮件地址和主密码。浏览器随即生成您的密钥,只需一秒钟。这第一个账户就是管理员。
  3. 用身份验证器应用(Microsoft Authenticator、Google Authenticator、Authy、2FAS 等)扫描二维码。所有账户都必须使用双因素登录。请保存十个恢复码,每个可代替应用使用一次。
  4. 生成恢复密钥(见下文),并通过新建条目添加第一条登录信息。

之后可以在我的账户中添加安全密钥(YubiKey 等)或设备的通行密钥作为第二因素。

浏览器信任的证书

浏览器扩展会拒绝自签名证书,因此在推广扩展之前,请为服务器配置真正的证书。在设置 → 证书中上传证书(来自公司 CA 或购买的;PEM 格式,含中间证书和私钥),或选择 Let's Encrypt。Let's Encrypt 需要一个公共 DNS 名称,并通过服务器的 80 端口或 Cloudflare 上的 DNS 记录进行验证——后者也适用于只能在您内网访问的服务器。证书立即生效,无需重启;您网络的 DNS 必须将该名称指向服务器。

邀请团队成员

账户只能通过邀请创建。在用户 → 邀请用户中输入电子邮件地址和角色(用户或管理员)。PassZit 只显示一次邀请链接,请将其发送给对方。该链接只能使用一次,默认有效期 7 天。如果已在设置 → 电子邮件中配置 SMTP 服务器,勾选同时通过电子邮件发送邀请,PassZit 就会替您发送。

受邀者和您一样,选择主密码并设置双因素登录。管理员可以停用用户、重置丢失的第二因素以及撤回未使用的邀请。要共享密码,请创建共享保险库,并向人员或组授予访问权限。

公司账户可在设置 → 企业登录中连接:通过 OpenID Connect 或 SAML 2.0 单点登录,以及 Active Directory / LDAP。主密码始终保留,因为它是保险库的钥匙。

主密码和恢复密钥

主密码永远不会离开用户的浏览器。这正是端到端加密的意义所在,同时也带来一个后果:没有主密码或恢复密钥,任何人——无论是管理员还是 MaxZit——都无法打开保险库。管理员无法查看或重置主密码。

  • 由四到六个随机单词组成的密码短语易记难猜。保险库策略规定了最小长度(默认 12 个字符)。
  • 在我的账户中,生成恢复密钥会显示一个由 32 个字母和数字组成的密钥,只显示一次。请打印或抄下并离线保存——不要放在保险库里,也不要放在手机旁边。
  • 忘记主密码的用户可以凭恢复密钥和身份验证器应用的验证码,在登录页面设置新的主密码。没有恢复密钥,保险库就会丢失;管理员只能删除该账户,并以空保险库重新邀请此人。用户列表会显示谁已生成恢复密钥。

请让每个人在第一天就生成恢复密钥。

安装浏览器扩展

扩展只在登录信息和一次性验证码所属的网站上填写它们,会提示保存新的和已更改的登录信息,会在付款和收货表单中填写银行卡和地址,并能生成密码。请从浏览器的应用商店安装,商店会自动更新它:

  • Chrome Web Store——Chrome、Brave、Opera 和 Vivaldi
  • Firefox Add-ons——Firefox 128 或更新版本
  • Microsoft Edge Add-ons——Microsoft Edge

链接见下载页面。PassZit 服务器也提供同样的入口:网页保险库菜单中的浏览器扩展会显示对应您所用浏览器商店的一键安装,以及其自身版本的手动安装包。

  1. 点击 PassZit 图标,只输入服务器地址(例如 https://vault.example.com),然后点击通过网页保险库连接。允许浏览器让 PassZit 与该服务器通信。地址中带端口(如 :8443)在所有浏览器中都可用,包括 Firefox。
  2. 网页保险库随即打开;如果尚未登录,请在其中登录。
  3. 保险库会询问是否在此浏览器中连接扩展——点击连接。无需在扩展中输入任何密码或验证码。

网页保险库和扩展共用一次解锁:解锁其中一个,另一个也会打开;锁定其中一个,两者都会锁定。

从其他程序导入密码

每位用户导入到自己的保险库。先从旧程序导出,然后在保险库中选择工具 → 导入并选取文件。PassZit 会识别格式,显示找到多少条目和文件夹、其中多少已在保险库中,并允许保留文件中的文件夹、跳过重复项。

来源在那里导出
Chrome、Edge、Brave、Opera、VivaldiPassword manager → Settings → Export passwords (CSV)
Firefoxabout:logins → … → Export passwords (CSV)
SafariFile → Export → Passwords (CSV)
BitwardenTools → Export vault → .json 或 .csv,不要选加密格式
KeePass 2 / KeePassXCKeePass XML (2.x) / CSV 或 XML
1PasswordFile → Export → CSV
LastPassAdvanced options → Export (CSV)

文件在浏览器中读取;服务器只接收加密后的条目。登录信息、笔记、网站、自定义字段、文件夹、收藏和 TOTP 密钥都会导入(从 Bitwarden 还会导入卡片、身份和 SSH 密钥)。附件不包含在这些导出文件中。导入后请删除导出文件——其中的密码未加密。

加密如何工作

浏览器使用 Argon2id(64 MiB,3 轮)从主密码派生出主密钥。由它再得到两个密钥:登录时发送的认证密钥——服务器只保存它的 argon2id 哈希——以及用于解开用户随机账户密钥的封装密钥。每个条目,包括名称、用户名、网站和笔记,都用其所在保险库的密钥以 AES-256-GCM 加密;共享保险库有自己的密钥,并针对每位成员的 X25519 密钥分别封装。服务器只能看到密文、ID、大小和时间戳,永远看不到主密码或任何可用的密钥。详情见安全页面以及代码仓库中的 docs/ARCHITECTURE.md。

备份服务器

设置 → 控制台备份每天(也可通过立即备份随时)将备份写入 /var/lib/passzit/backups:包含所有保险库的数据库、服务器的密钥和控制台证书——新服务器所需的一切。备份始终使用您设置的密码短语加密;请将该密码短语保存在别处。每份备份还可以复制到另一台服务器上的 SFTP 文件夹。恢复时可使用 appliance 菜单,或者停止服务后按控制台内置指南运行 passzit-server -restore。

更新

设置 → 更新与服务器显示正在运行的版本和最新版本。安装时会再次验证签名、备份数据库和程序、安装更新并检查服务器是否恢复运行——如果没有,它会自动恢复旧版本和数据库。也可以在这里开启在指定时间自动安装。稳定版通道接收正式版本;Testing 通道还提供候选版本,适用于测试服务器。通过脚本安装时,再次运行安装脚本同样会更新 PassZit 并保留所有数据。

需要了解的限制

  • PassZit 仍在积极开发中:首个公开版本 0.9.0 于 2026 年 11 月发布,新版本发布频繁。
  • 没有原生移动应用。在手机上可以把网页保险库添加到主屏幕,并在独立窗口中打开,但不会保存任何离线数据——没有服务器时只会看到“offline”页面。
  • 忘记主密码且没有恢复密钥时,任何人都无法恢复。
  • 浏览器扩展需要受信任的证书,并使用主密码和身份验证器验证码登录——不支持单点登录。
  • 与所有网页保险库一样,网页保险库的 JavaScript 来自服务器,因此被完全攻破的服务器可能提供被篡改的代码;扩展则自带代码。
  • 没有 Docker 镜像;请使用镜像、脚本或软件包安装。控制台内置指南提供英文和塞尔维亚文版本。

后续步骤

下载 PassZit,查看全部功能——共享保险库、秘密链接、紧急访问、远程连接、命令行——或阅读控制台内置指南(文档)。如何为团队设置共享保险库,请参阅指南与团队共享密码。欢迎在 GitHub Discussions 中提问。企业可以从 MaxZit 获得商业支持(仅提供英文服务)。