Vaultwarden | Docker自托管密码管理 – 兼容Bitwarden

Vaultwarden 是使用 Rust 编写的 Bitwarden 兼容密码库服务端,可以配合官方浏览器扩展、桌面、移动端和 CLI 客户端,把服务端部署在自己的 NAS、服务器或 VPS 上。它由独立社区维护,与 Bitwarden, Inc. 没有隶属关系;服务端问题应交给 Vaultwarden 社区处理。

Vaultwarden 自托管密码库封面

它适合明确需要掌握数据位置、且能长期维护实例的个人、家庭和小团队。项目采用 AGPL-3.0 许可,推荐容器部署。部署前先想清楚服务器故障后怎样恢复密码库。数据放在自己机器上,意味着可用性、更新和恢复也需要自己负责。

沿用客户端后,能怎样管理密码

已有 Bitwarden 使用习惯的人,主要需要在客户端设置自托管服务器地址。个人保险库、附件和 Send 等能力让条目与资料可以跨设备使用;家庭或团队共享则通过组织、集合、成员角色和群组划分范围,不必把所有账号都放进一个共同账户。

项目还提供验证器、邮件、FIDO2 WebAuthn、YubiKey、Duo 等二次验证方式,以及紧急访问。应先为自己选定的方式准备恢复路径,再考虑扩大到其他成员。兼容实现可能与官方服务存在版本差异,服务端与客户端升级时要一起关注;要求厂商 SLA、正式支持或合规证明的组织,需要另行评估支持责任。

Docker 配置中,域名与数据目录最先确定

以下 Compose 起步示例以同一宿主机上配置 HTTPS 反向代理为前提。先把域名改成自己的实际地址,创建可靠的数据目录;当前示例使用 latest 便于展示,长期实例可按 Release 选择并固定镜像标签。

services:
  vaultwarden:
    image: vaultwarden/server:latest
    restart: unless-stopped
    environment:
      DOMAIN: "https://vault.example.com"
    volumes:
      - ./vw-data:/data
    ports:
      - "127.0.0.1:8000:80"

保存为 compose.yaml 后,在同一目录运行 docker compose up -d。其中 DOMAIN 只是声明访问地址,不会替你申请证书或启用 HTTPS;反向代理要把实际域名转发到本机的 8000 端口。若代理位于另一台机器或独立容器网络,需按自己的网络拓扑调整连接方式。

  • /data 是容器的持久化位置。将它映射到宿主机目录,容器重建后才能继续使用已有数据库、附件与配置;数据目录应限制权限。
  • Web Vault 依赖 Web Crypto API 的安全上下文。正式域名访问必须开启 HTTPS,若只配通 HTTP 访问,即使网页能打开也无法完成密码库的加密验证。
  • 按使用范围限制新用户注册,并保护管理入口。仓库 .env.template 列出 SIGNUPS_ALLOWED 和 ADMIN_TOKEN 等配置项;正式部署时切忌沿用示例令牌字符,须生成高强度随机密钥。

可通过 GHCR、Docker Hub 或 Quay.io 获取项目提供的镜像。第三方 NAS 打包的路径和更新节奏可能不同,采用时先确认数据存在哪里,再制定恢复方案。

备份要能恢复条目,也要能恢复附件

默认 SQLite 部署把重要数据放在数据目录,但数据库与附件是不同文件。下面按恢复用途列出常见对象,采用外部 PostgreSQL 或 MySQL 时,还要另外备份对应数据库。

对象恢复时的作用
db.sqlite3密码条目及用户、组织等数据库状态
attachments/条目附带文件;只备份数据库不会带上这些文件
config.json、部署配置和 rsa_key*实例设置与签名密钥;配置及私钥可能含敏感信息,应保护备份
sends/若需要恢复现有文件 Send,一并纳入;网站图标缓存则通常可重新获取

拷贝运行中的 SQLite 数据库切忌只拉取单一数据文件:Wiki 建议使用 SQLite 在线备份命令,若停机复制也须连带打包同目录下的 WAL 日志文件。Wiki 推荐 SQLite 的在线备份方式;停机复制时还要处理可能存在的 WAL 文件。无论选择哪种方法,都应按对应恢复流程验证一致性,备份保留版本并存一份到其他设备。

导入真实密码之前,走一次恢复流程

  1. 在测试实例创建少量可丢弃条目,确认网页与常用客户端可以登录、同步,且所选二次验证方式可用。
  2. 按实际数据目录和数据库类型生成备份,同时纳入测试附件及必要配置。
  3. 在隔离环境恢复这份备份,确认条目内容、附件和客户端连接都正常;保留原测试数据,避免恢复失败后没有对照。
  4. 确认恢复路径可重复执行,再逐步迁移真实密码,并建立证书、磁盘、备份结果与安全更新的维护安排。

升级前读目标版本说明,先备份,再更新镜像。若升级包含数据库变化,回滚镜像未必就能回滚数据,因此可恢复的旧数据副本比只记住旧标签更重要。无法持续完成这些维护时,选择有人维护的托管方案通常更合适。

  • 项目仓库与容器示例:https://github.com/dani-garcia/vaultwarden
  • 配置与部署 Wiki:https://github.com/dani-garcia/vaultwarden/wiki
  • 备份与恢复说明:https://github.com/dani-garcia/vaultwarden/wiki/Backing-up-your-vault
  • 版本说明:https://github.com/dani-garcia/vaultwarden/releases
Vaultwarden | Docker自托管密码管理 - 兼容Bitwarden - 杂货喵
Vaultwarden | Docker自托管密码管理 – 兼容Bitwarden
此内容为免费资源,请登录后查看
0积分
发布平台GitHub
编码语言Rust
支持语言中文等多语言
项目版本1.36.0
开源许可AGPL-3.0
运行方式Docker
免费资源
© 版权声明
THE END
喜欢就支持一下吧
点赞9 分享
评论 共2条

请登录后发表评论

    • 头像 - 杂货喵ExoWatts0