群晖部署Vaultwarden：HTTPS访问、自动填充与密码迁移

原创于 2026-08-04 18:37:09 发布 · 107 阅读

4 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

cpolar

话题

#CodingPlan·八月创作之星博客挑战赛

前言：

账号越来越多之后，最常见的做法是重复使用几个熟悉的密码，或者把密码临时记在浏览器、备忘录和表格中。这样虽然方便，但只要其中一个账号或设备出现问题，其他使用相同密码的服务也可能受到影响。

Vaultwarden是一套可以自行部署的密码管理服务，并兼容Bitwarden的手机端、桌面端和浏览器扩展。将它运行在群晖NAS中后，密码库数据可以保存在自己的设备上，再通过不同客户端进行同步和自动填充。

本文将使用Docker在群晖中部署Vaultwarden，把数据目录挂载到NAS，并将服务映射到8088端口。由于密码管理器的部分浏览器功能需要HTTPS安全环境，后续会使用cpolar配置HTTPS公网入口和固定二级子域名。

完成部署后，还会创建密码库账户，连接Bitwarden浏览器扩展，配置自动填充，并把浏览器中已有的密码通过CSV文件迁移到Vaultwarden。自托管提高了数据位置的可控性，但主密码、远程入口和备份文件仍需要单独保护。

1 Vaultwarden 简介与核心优势

Vaultwarden 是一款开源的密码管理解决方案，用于安全存储和管理密码等敏感数据。

完全私有：数据全部存放在自己的设备（如 NAS）中，不上传任何第三方云端。
端到端加密：只有你自己能解密，真正做到隐私自由。
安全防护：
- 支持个人 API 密钥，强化数据访问安全。
- 支持全方位多因素认证（MFA），包括验证器 App、邮箱、FIDO2、YubiKey 等。
- 提供紧急访问功能，可设置可信联系人，特殊情况下也能调取保险库数据。
客户端兼容：完美适配 Bitwarden 官方的手机 App、电脑客户端和浏览器插件，无需换软件即可无缝切换。
密码生成器：一键生成包含大小写字母、数字、符号的超长复杂密码。
附件存储：可加密保存证书扫描件、软件许可证、照片等文件。
自动图标：保存网站账号后自动获取并显示对应网站图标，方便识别。
管理后台与 Web 客户端：自带优化版 Web 界面，无需复杂配置即可使用，适合个人或小团队。

2 部署环境说明

本教程以 群晖 Synology NAS + Docker 为例演示部署。
将密码库部署在 NAS 上可实现 24 小时挂机、超低功耗、数据本地存储并自动备份。
其他小主机或 Linux 服务器操作步骤大同小异。

3 使用 Docker 在群晖 NAS 上部署 Vaultwarden

部署步骤

通过 SSH 终端登录群晖 NAS。

执行 sudo -i 进入管理员模式。
粘贴并执行一键部署命令：

mkdir -p /volume1/Vaultwarden/data && \
docker pull vaultwarden/server:latest && \
docker run --detach \
  --name vaultwarden \
  --env DOMAIN="https://vw.domain.tld" \
  --volume /volume1/Vaultwarden/data:/data \
  --restart unless-stopped \
  --publish 8088:80 \
  vaultwarden/server:latest

该命令会自动创建数据目录、拉取镜像并启动容器。
端口映射为 8088:80，避开群晖默认 80 端口占用问题。
DOMAIN 建议填写你最终要使用的 HTTPS 域名（例如 cpolar 生成的域名）。

4 首次访问与 HTTPS 警告

安装完成后，在浏览器访问 http://<NAS_IP>:8088。
页面会弹出提示：Vaultwarden 的加密 API（Subtle Crypto API）需要在 HTTPS 安全上下文中运行，当前 HTTP 明文访问不符合要求。
这个警告说明必须通过 HTTPS 访问，下一步使用 cpolar 即可解决。