Vaultwarden 密码管理器

环境要求

• 已安装 Docker（或 Podman）并可执行 docker 命令
• 一个已解析到你服务器的域名，且能配置 HTTPS（Web Crypto API 要求安全上下文）
• 建议准备反向代理（如 Nginx/Caddy）用于 HTTPS 转发
• 宿主机上可持久化保存数据的目录，例如 /vw-data/

安装与启动步骤

1. 1拉取官方镜像

   Vaultwarden 推荐用容器镜像部署，镜像发布在 ghcr.io、docker.io、quay.io。这里从 Docker Hub 拉取最新版。

   docker pull vaultwarden/server:latest

   复制

2. 2启动容器

   挂载宿主机目录到容器 /data/ 做持久化，设置 DOMAIN 为你的 HTTPS 域名，端口只映射到本机 127.0.0.1:8000 交给反向代理。

   docker run --detach --name vaultwarden 
     --env DOMAIN="https://vw.domain.tld" 
     --volume /vw-data/:/data/ 
     --restart unless-stopped 
     --publish 127.0.0.1:8000:80 
     vaultwarden/server:latest

   复制

3. 3改用 Compose 部署

   把上面的配置写成 compose.yaml，适合长期维护；保存后即可用 Compose 启动服务，效果与 docker run 一致。

   services:
     vaultwarden:
       image: vaultwarden/server:latest
       container_name: vaultwarden
       restart: unless-stopped
       environment:
         DOMAIN: "https://vw.domain.tld"
       volumes:
         - ./vw-data/:/data/
       ports:
         - 127.0.0.1:8000:80

   复制

4. 4启用 HTTPS

   web 界面依赖 Web Crypto API，必须 HTTPS 才能工作。README 建议配置反向代理，并按 Wiki 的 Enabling HTTPS 说明操作。

5. 5用客户端连接

   在官方 Bitwarden 客户端（手机/桌面/浏览器扩展）的登录页切换到自托管，填入你的域名即可使用个人保险库、Send、附件等功能。

关键配置

如何确认成功

浏览器访问你的 HTTPS 域名（如 https://vw.domain.tld），能看到网页保险库登录页；用官方 Bitwarden 客户端登录自托管账号成功即部署完成。

常见问题

注意事项

• Vaultwarden 是 Bitwarden 客户端 API 的第三方服务端实现，并非官方产品。
• README 强烈建议使用反向代理处理 TLS，而不是直接依赖内置 TLS 支持。
• 示例中的域名 https://vw.domain.tld 和路径 /vw-data/ 需替换成你自己的实际值。
• 更详细的安装、使用与配置示例请查阅项目 Wiki。