vaultwarden

一个用 Rust 编写的 Bitwarden 客户端 API 的替代服务器实现，兼容官方 Bitwarden 客户端 [免责声明]，非常适合在运行官方资源占用较高的服务可能并不理想的情况下进行自托管部署。

---

[!IMPORTANT] 使用此服务器时，请直接将任何错误或建议报告给我们（参见联系我们），无论您使用何种客户端（移动端、桌面端、浏览器……）。请勿使用 Bitwarden 官方支持渠道。

功能特性

提供了几乎完整的 Bitwarden 客户端 API 实现，包括：

• 个人保险库
• Send
• 附件
• 网站图标
• 个人 API 密钥
• 组织
  • 集合、 密码共享、 成员角色、 群组、 事件日志、 管理员密码重置、 目录连接器、 策略
• 多重/双因素认证
  • 身份验证器、 电子邮件、 FIDO2 WebAuthn、 YubiKey、 Duo
• 紧急访问
• Vaultwarden 管理后端
• 修改版 Web 保险库客户端（已捆绑在我们的容器中）

使用方法

[!IMPORTANT] Web 保险库需要使用 HTTPS 以及 Web Crypto API 的安全上下文。
这意味着它仅在您启用 HTTPS 时才能正常工作。
我们还建议使用反向代理。

安装和使用 Vaultwarden 的推荐方式是通过我们发布到 ghcr.io、docker.io 和 quay.io 的容器镜像。 有关所提供标签的说明，请参见应使用哪个容器镜像。

此外还有社区驱动的软件包可供使用，但它们可能落后于最新版本，或者在 Vaultwarden 的配置方式上有所偏差，具体如我们的 Wiki 所述。

或者，您也可以自行构建 Vaultwarden。

虽然 Vaultwarden 基于内置 TLS 支持的 Rocket Web 框架，但我们建议您设置反向代理（参见代理示例）。

[!TIP] 有关如何安装、使用和配置 Vaultwarden 的更详细示例，您可以查看我们的 Wiki。

Docker/Podman CLI

拉取容器镜像并从主机挂载卷以实现持久化存储。
如果您更倾向于使用 podman，可以将 docker 替换为 podman。

docker pull vaultwarden/server:latest
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

这样会保留 /vw-data/ 下的所有持久化数据，你可以根据自身需要调整该路径。

Docker Compose

要使用 Docker Compose，你需要创建一个 compose.yaml，用于保存运行 Vaultwarden 容器的配置。

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

联系我们

有问题、建议或需要帮助？加入我们的社区：Matrix、GitHub Discussions 或 Discourse 论坛。

遇到 bug 或崩溃？请先搜索我们的 issue 跟踪器和讨论区，看看是否已被报告。如果没有，请发起新讨论或创建新 issue。请确保你使用的是最新版本的 Vaultwarden，并且没有类似的未关闭或已关闭 issue！

贡献者

感谢你对本项目的贡献！