Bitwarden 客户端 API 的替代服务器实现，使用 Rust 编写，并与 官方 Bitwarden 客户端 兼容 [免责声明]，非常适合自托管部署，在自托管部署中，运行官方的资源密集型服务可能不太理想。

---

Important

当使用此服务器时，请直接向我们报告任何错误或建议（请参阅 联系方式），无论您使用的是什么客户端（移动端、桌面端、浏览器端...）。请勿使用官方 Bitwarden 支持渠道。

功能特性

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

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

使用方法

Important

大多数现代 Web 浏览器不允许在不安全的环境中使用 Web Crypto API。 在这种情况下，您可能会收到类似 Cannot read property 'importKey' 的错误。 要解决此问题，您需要通过 HTTPS 或 localhost 访问 Web Vault。

这可以在 Vaultwarden 中直接配置，或者使用第三方反向代理（一些示例）。

如果您有可用的域名，则可以使用 Let's Encrypt 获取 HTTPS 证书，也可以使用 mkcert 等实用程序生成自签名证书。 一些代理会自动执行此步骤，例如 Caddy 或 Traefik（请参阅上面链接的示例）。

Tip

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

使用 Vaultwarden 的主要方式是通过我们的容器镜像，这些镜像发布到 ghcr.io、docker.io 和 quay.io。

还有一些 社区驱动的软件包 可以使用，但这些软件包可能会落后于最新版本，或者在 Vaultwarden 的配置方式上有所不同，如我们的 Wiki 中所述。

Docker/Podman CLI

拉取容器镜像并从主机挂载卷以进行持久存储。
如果您喜欢使用 podman，可以用 podman 替换 docker。

docker pull vaultwarden/server:latest
docker run --detach --name vaultwarden \
  --env DOMAIN="https://vw.domain.tld" \
  --volume /vw-data/:/data/ \
  --restart unless-stopped \
  --publish 80: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:
      - 80:80

联系方式

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

遇到错误或崩溃？ 请搜索我们的问题跟踪器和讨论，看看是否已经有人报告了。 如果没有，请发起新的讨论 或创建新的问题。 确保您使用的是最新版本的 Vaultwarden，并且没有类似的未解决或已关闭的问题！

贡献者

感谢您对项目的贡献！

免责声明

此项目与 Bitwarden 或 Bitwarden, Inc. 无关。

但是，Vaultwarden 的一位活跃维护者受雇于 Bitwarden，并被允许在自己的时间为该项目做出贡献。 这些贡献独立于 Bitwarden，并由其他维护者审查。

维护人员共同努力，为项目设定方向，专注于为自托管社区（包括个人、家庭和小型组织）提供服务，同时确保项目的可持续性。

请注意： 对于因使用 Vaultwarden 而可能发生的任何数据丢失，我们概不负责。 这包括密码、附件和应用程序处理的其他信息。 我们强烈建议定期备份您的文件和数据库。 但是，如果您遇到数据丢失，我们鼓励您立即与我们联系。

Bitwarden_RS

该项目以前称为 Bitwarden_RS，现已更名，以便与官方 Bitwarden 服务器分开，以避免混淆和商标/品牌问题。
请参阅 #1642 - v1.21.0 版本和项目重命名为 Vaultwarden 以获取更多说明。