🛡️ Vaultwarden — 一款使用 Rust 重构的 Bitwarden 服务器
🏠 Wiki 首页 · 📖 FAQ · ⚙️ 配置 · 🔒 强化指南 · 🐳 Docker
***💬 保持联系
❤️ 喜欢 Vaultwarden 吗？考虑支持上游的 Bitwarden — 没有他们的工作，这个项目就不会存在。
Vaultwarden 是一款非官方的、由社区驱动的兼容 Bitwarden 的服务器。它与 Bitwarden, Inc 无任何关联、附属，亦未获得其认可。
—「Bitwarden」是 Bitwarden, Inc 的商标。
由 @dani-garcia 和贡献者精心维护 · Wiki 内容遵循项目条款许可
*** # FAQ # 1.FAQ {% hint style="success" %} 对应的[官方页面地址](https://github.com/dani-garcia/vaultwarden/wiki/FAQs) {% endhint %} ## Vaultwarden 是否与 Bitwarden 项目或 Bitwarden, Inc 有关联？ 简短的回答，**没有**。两个项目的开发人员之间有时会有联系，但没有合作。除此之外，Vaultwarden 项目仅使用 Bitwarden, Inc 提供的 Web Vault 并打了一些[补丁](https://github.com/dani-garcia/bw_web_builds/tree/master/patches)，以使其与我们的实现兼容。 ## 我发现了一个 Vaultwarden 公共实例。它与这个项目有关吗？使用它安全吗？ 本项目不托管任何公共 Vaultwarden 实例，我们也不提倡使用任何此类网站。参见 [#3233](https://github.com/dani-garcia/vaultwarden/discussions/3233#discussioncomment-4917141) [#4142](https://github.com/dani-garcia/vaultwarden/discussions/4142) [#4367](https://github.com/dani-garcia/vaultwarden/discussions/4367#discussioncomment-8529763) ## 我的 Bitwarden 客户端有问题，我需要在哪里报告这问题？ 如果您使用 Vaultwarden 作为任何官方 Bitwarden 客户端的服务器，您将无法在 Bitwarden 报告此问题，因为他们一看到您使用 Vaultwarden 就会关闭该问题，这确实是合理的做法。 要确定问题是服务器端还是客户端，请阅读以下 wiki 页面，以帮助 Vaultwarden 和 Bitwarden 确定问题以及在哪里和如何报告问题。 [https://github.com/dani-garcia/vaultwarden/wiki/Bitwarden-clients-troubleshooting](https://github.com/dani-garcia/vaultwarden/wiki/Bitwarden-clients-troubleshootinghttps://github.com/dani-garcia/vaultwarden/wiki/Bitwarden-clients-troubleshooting) ## 我对 web-vault（或任何其他客户端）有一个功能请求 不幸的是我们不能在这里提供帮助。Vaultwarden 项目没有，也可能永远不会开发自定义客户端。我们尝试尽可能接近上游客户端的工作方式，并且由于我们只能向 web-vault 添加一些内容，这甚至可能会破坏其他客户端或导致与上游 web-vault 保持最新状态的问题。因此，我们不会向 Vaultwarden 添加任何需要在客户端处理的特殊或独特功能。 ## Vaultwarden 的下一个版本是什么时候？您能给出一个 ETA 吗？ Vaultwarden 没有发布时间表。如果维护者有时间并认为有必要发布新版本，那么可以立即发布，但鉴于这是一个由人们利用业余时间完成的项目，下一次发布可能需要几周甚至几个月的时间。 如果您「希望尽早获得最新功能、增强功能或错误修复」，您可以随时改用测试镜像，它总是基于最新的提交。参见容器镜像的选择。 > **\[译者注]**：ETA：Estimated Time of Arrival。在软件开发和日常交流中，它不再仅仅指「预计到达时间」，而是被广泛引申为「预计完成时间」或「预计发布日期」。 ## Vaultwarden 能连接到 Oracle MySQL V8.x 数据库吗？ 在使用 Oracle MySQL v8.x 时，当您试图启动 Vaultwarden，可能会出现以下警告： ``` [vaultwarden::util][WARN] Can't connect to database, retrying: DieselConError. [CAUSE] BadConnection( "Authentication plugin \'caching_sha2_password\' cannot be loaded: /usr/lib/x86_64-linux-gnu/mariadb18/plugin/caching_sha2_password.so: cannot open shared object file: No such file or directory", ) ``` 默认情况下，Oracle MySQL v8.x 使用更安全的密码散列方法，这是好事，但我们的构建目前不支持它。 您需要以一种特定的方法创建 Vaultwarden 用户，以便它能使用旧的原生密码散列： ```sql -- 在 MySQLv8 安装上使用此命令 CREATE USER 'vaultwarden'@'localhost' IDENTIFIED WITH mysql_native_password BY 'yourpassword'; ``` 如果您已经创建了用户，并且只想更改散列方法，请使用以下命令： ```sql -- 将密码类型从 caching_sha2_password 更改为 native ALTER USER 'vaultwarden'@'localhost' IDENTIFIED WITH mysql_native_password BY 'yourpassword'; ``` 另外可参阅：[使用 MariaDB - 创建数据库和用户](/configuration/database/using-the-mariadb-mysql-backend#create-database-and-user) 在版本 1.35.5 之后不再需要进行此更改，该版本支持「caching\_sha2\_password」。 ## 客户端（桌面端、移动端、网页端）无法正常工作，无法登录或提示证书无效。 Bitwarden 客户端需要一个安全的连接，才能正常工作且没有任何问题。虽然某些客户端也可以在没有安全连接的情况下工作，但我们并不推荐这样做。 大多数时候，当人们使用证书时仍然有问题，是因为他们使用的是所谓的自签名证书。虽然这些证书可以提供安全连接，但一些平台不允许或不支持它。 我们建议使用诸如 Let's Encrypt 这样的服务来提供一个有效的、被大多数设备默认接受的证书。请参阅以下页面： * [启用 HTTPS](/reverse-proxy/https/enabling-https) * [使用 Let's Encrypt 证书运行私有 Vaultwarden 实例](/reverse-proxy/https/running-a-private-vaultwarden-instance-with-lets-encrypt-certs) ## 为什么我密码库的所有项目都看不到图标？ 没有显示图标的原因有很多种。如果只是某几个密码库项目，可能是我们无法提取它。有些网站启用了一些保护措施，导致我们的实施失败。他们中的大多数需要 Javascript 才能工作。 这也可能是 Vaultwarden 服务器无法访问互联网或未解决 DNS 查询所致。您可以检查 `/admin/diagnostics` 页面（参阅[启用管理页面](/configuration/enabling-admin-page)），看看您是否能解决 DNS 查询以及是否有连接到互联网。如果都没问题，也有可能是防火墙或外发互联网代理阻止了这些请求。 ## Websocket 连接显示错误的 IP 地址。 这不是我们可以解决的问题。我们使用的库不支持任何形式的 `X-Forwarded-For` 或 `Forward` 标头。 它会始终显示所使用的反向代理的 IP，除非您在没有任何代理的情况下直接运行 Vaultwarden，或者运行透明代理，这可能会让它显示正确的 IP。这不是一个重要的日志记录部分，并且如果您使用反向代理，您可能还可以在其日志中看到此请求，该请求具有正确的 IP。 ## 为什么 Vaultwarden 会提示 `[INFO] No .env file found`。即使我已经提供了一个？ 启动时，Vaultwarden 将检查进程的当前工作目录中是否存在名为 `.env` 的文件（如果未通过环境变量 `ENV_FILE` 更改）。如果您没有提供此文件，Vaultwarden 将简单地通知您它没有找到它。此文件与您提供给 docker 的用于在创建容器时加载环境变量的 env 文件无关，也与在 [systemd .service](/alternative-deployments/creating-a-systemd-service) 中使用的环境文件无关。 ## 可以将 Vaultwarden 作为 Azure WebApp 运行吗？ 不幸的是，Azure WebApp 使用 CIFS/Samba 作为卷存储，而 CIFS/Samba 不支持锁定。这导致 Vaultwarden 不能使用 SQLite 数据库文件。 有两种解决方式： 1. 不要使用 SQLite，改为使用 MariaDB/MySQL 或 Posgresql 作为数据库后端。 2. 尝试将 `ENABLE_DB_WAL` 环境变量的值设置为 `false` 以禁用 WAL。这需要在一个新的文件上完成，所以您需要移除之前创建的 `db.sqlite3` 文件，并再次重启 Vaultwarden 应用程序。 ## 我在 FAQ 中找不到答案，下一步该怎么做？ 请尝试在我们精彩的 [Wiki](/) 中搜索和点击。如果这对您没有帮助，请尝试查看 [Github 讨论](https://github.com/dani-garcia/bitwarden_rs/discussions)或 [Vaultwarden 论坛](https://bitwardenrs.discourse.group/)。如果这也没有解决，您可以尝试搜索开放的和已关闭的[话题](https://github.com/dani-garcia/bitwarden_rs/issues)。 如果您仍然没有找到答案，您可以在 [Github 讨论](https://github.com/dani-garcia/bitwarden_rs/discussions)或 [Vaultwarden 论坛](https://bitwardenrs.discourse.group/)上发起一个主题，或者加入我们的[聊天室](https://matrix.to/#/#bitwarden_rs:matrix.org)。 # 2.审计 {% hint style="success" %} 对应的[官方页面地址](https://github.com/dani-garcia/vaultwarden/wiki/Audits) {% endhint %} ## Vaultwarden 审计 Vaultwarden 已经过安全公司的审计，这有助于确保 Vaultwarden 的安全。 有些审计是在没有公开发布任何数据的情况下完成的，因为要求这些安全公司进行审计的公司不允许这样做，但这些研究人员确实提供了审计结果。 有些审计是公开发布的，任何人都可以访问。 ## 由 BSI 进行的审计 {% hint style="info" %} 网站和报告均为德语 {% endhint %} 德国安全机构 [BSI (Bundesamt für Sicherheit in der Informationstechnik)](https://www.bsi.bund.de/EN/Home/home_node.html) 在 [CAOS (Codeanalyse von Open Source Software) 项目](https://www.bsi.bund.de/DE/Service-Navi/Publikationen/Studien/Projekt_P486/projekt_P486_node.html)下对 [Vaultwarden v1.30.3](https://github.com/dani-garcia/vaultwarden/releases/tag/1.30.3) 进行了审计。 新闻稿（包含 Vaultwarden 结果的 PDF）可在此处找到：[https: //www.bsi.bund.de/DE/Service-Navi/Presse/Alle-Meldungen-News/Meldungen/Codeanalysis-KeePass-Vaultwarden\_241014 .html](https://www.bsi.bund.de/DE/Service-Navi/Presse/Alle-Meldungen-News/Meldungen/Codeanalyse-KeePass-Vaultwarden_241014.html) 他们甚至还有一个更详细的 ZIP 文件，其中包含所有原始信息：| 使用的硬件 | 操作系统 | Docker 架构 | 使用的镜像 | 状态 | 备注 |
|---|---|---|---|---|---|
| 常规 64bit 服务器 | Ubuntu 18.04 | x86_64 | vaultwarden/server | OK | |
| Raspberry Pi Zero W | Raspbian (4.14.98+) | linux/arm (armv6l) | vaultwarden/server:armv6 | OK | |
| Raspberry Pi Zero W | Raspbian (4.19.66+) | linux/arm (armv6l) | vaultwarden/server:latest (Multiarch) | OK | 只有在使用 docker 实验性功能 "docker pull --platform=linux/arm/v6" 时，才能使用。否则会选择错误的镜像 (https://github.com/dani-garcia/vaultwarden/issues/1064) |
| Raspberry Pi 1 B | Raspbian (4.19.97+) | linux/arm (armv6l) | vaultwarden/server:armv6 | OK | |
| Raspberry Pi 3 B | Raspbian (4.14.98-v7+) | linux/arm (armv7l) | vaultwarden/server:latest | OK | |
| Raspberry Pi 4 | Raspbian (4.19.118-v7l+) | linux/arm (armv7l) | vaultwarden/server:raspberry | OK | 4go 版本, rev 1.1 |
| Raspberry Pi 5 | Raspberry Pi OS (Debian GNU/Linux 12) | linux/arm (arm64) | vaultwarden/server:latest and vaultwarden/server:testing-alpine | OK | 测试于 02/16/2024 |
| Synology | DSM (DSM 6.2.1-23824 Update 6) | Docker-x64-17.05.0-0367 | vaultwarden/server:latest | OK | |
| Synology | DSM (DSM 6.2.2-24922 Update 4) | Docker-x64-18.09.0-0506 | vaultwarden/server:1.13.0-alpine | OK | |
| Synology | DSM (DSM 7.2-64570 Update 1) | Docker-20.10.23 | vaultwarden/server:latest | OK | |
| 常规 64bit 服务器 | Unraid 6.8.0 | 19.03.5 | vaultwarden/server:latest | OK | |
| QNAP TS-451DEU (Intel Celeron J4025) | QTS 5.0.0.1891 | x86_64 | vaultwarden/server:latest | OK | |
| 常规 64bit 服务器 | OpenMediaVault 6 (Debian Bullseye) | x86_64 | vaultwarden/server:alpine | OK | |
| Oracle 云基础设施 (OCI) Ampere Altra | Ubuntu 24.04 LTS | linux/arm (arm64) | vaultwarden/server:latest | OK | |
| 常规 64bit 服务器 | Debian GNU/Linux 12 (bookworm) | x86_64 | vaultwarden/server:latest | OK | v1.33.1 |
# proxy_protocol 相关:
set_real_ip_from ::1; # 要信任哪个下游代理，请在前面输入您的代理地址
real_ip_header proxy_protocol; # 可选。如果您希望 nginx 使用来自 proxy_protocol 的信息覆盖 remote_addr。 取决于您在日志模板和服务器或流块中使用的关于远程地址的变量。
# 以下基于 blackdex 的示例:
# 'upstream' 指令确保您有一个 http/1.1 连接
# 这里启用了 keepalive 选项以拥有更好的性能
#
# 这里定义服务器 IP 和端口
upstream vaultwarden-default {
zone vaultwarden-default 64k;
server 127.0.0.1:8000;
keepalive 2;
}
# 需要这些以支持 websocket 连接
# 参阅：https://nginx.org/en/docs/http/websocket.html
# 我们发送的是空值，而不是上述链接中的 "close"
# 否则所有 keepalive 连接都将失效
map $http_upgrade $connection_upgrade {
default upgrade;
'' "";
}
# HTTP 重定向到 HTTPS
server {
listen 80 proxy_protocol; # <---
listen [::]:80 proxy_protocol; # <---
server_name shared.example.tld;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl proxy_protocol; # <---
listen [::]:443 ssl proxy_protocol; # <---
http2 on;
server_name shared.example.tld;
# 需要时指定 SSL Config
#ssl_certificate /path/to/certificate/letsencrypt/live/shared.example.tld/fullchain.pem;
#ssl_certificate_key /path/to/certificate/letsencrypt/live/shared.example.tld/privkey.pem;
#ssl_trusted_certificate /path/to/certificate/letsencrypt/live/shared.example.tld/fullchain.pem;
client_max_body_size 525M;
## 使用子路径配置
# 您的安装的 root 目录的路径
# 请务必添加尾部的 /，否则您可能会遇到问题
# 但仅限于这个位置，所有其他位置不应添加这些内容
location /vault/ {
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_pass http://vaultwarden-default;
}
}
| Server | Web-Vault |
|---|---|
 |  |