dani-garcia/vaultwarden

GitHub: dani-garcia/vaultwarden

用 Rust 编写的轻量级 Bitwarden 兼容服务器,适合资源受限环境下的密码管理自托管部署。

Stars: 56146 | Forks: 2591

![Vaultwarden Logo](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/8d1494c983154229.svg) 这是 Bitwarden Client API 的另一种服务器实现,使用 Rust 编写,并兼容 [官方 Bitwarden 客户端](https://bitwarden.com/download/) [[免责声明](#disclaimer)],非常适合在运行官方资源密集型服务可能不理想的情况下进行自托管部署。 [![GitHub Release](https://img.shields.io/github/release/dani-garcia/vaultwarden.svg?style=for-the-badge&logo=vaultwarden&color=005AA4)](https://github.com/dani-garcia/vaultwarden/releases/latest) [![ghcr.io Pulls](https://img.shields.io/badge/dynamic/json?style=for-the-badge&logo=github&logoColor=fff&color=005AA4&url=https%3A%2F%2Fipitio.github.io%2Fbackage%2Fdani-garcia%2Fvaultwarden%2Fvaultwarden.json&query=%24.downloads&label=ghcr.io%20pulls&cacheSeconds=14400)](https://github.com/dani-garcia/vaultwarden/pkgs/container/vaultwarden) [![Docker Pulls](https://img.shields.io/docker/pulls/vaultwarden/server.svg?style=for-the-badge&logo=docker&logoColor=fff&color=005AA4&label=docker.io%20pulls)](https://hub.docker.com/r/vaultwarden/server) [![Quay.io](https://img.shields.io/badge/quay.io-download-005AA4?style=for-the-badge&logo=redhat&cacheSeconds=14400)](https://quay.io/repository/vaultwarden/server)
[![Contributors](https://img.shields.io/github/contributors-anon/dani-garcia/vaultwarden.svg?style=flat-square&logo=vaultwarden&color=005AA4)](https://github.com/dani-garcia/vaultwarden/graphs/contributors) [![Forks](https://img.shields.io/github/forks/dani-garcia/vaultwarden.svg?style=flat-square&logo=github&logoColor=fff&color=005AA4)](https://github.com/dani-garcia/vaultwarden/network/members) [![Stars](https://img.shields.io/github/stars/dani-garcia/vaultwarden.svg?style=flat-square&logo=github&logoColor=fff&color=005AA4)](https://github.com/dani-garcia/vaultwarden/stargazers) [![Issues Open](https://img.shields.io/github/issues/dani-garcia/vaultwarden.svg?style=flat-square&logo=github&logoColor=fff&color=005AA4&cacheSeconds=300)](https://github.com/dani-garcia/vaultwarden/issues) [![Issues Closed](https://img.shields.io/github/issues-closed/dani-garcia/vaultwarden.svg?style=flat-square&logo=github&logoColor=fff&color=005AA4&cacheSeconds=300)](https://github.com/dani-garcia/vaultwarden/issues?q=is%3Aissue+is%3Aclosed) [![AGPL-3.0 Licensed](https://img.shields.io/github/license/dani-garcia/vaultwarden.svg?style=flat-square&logo=vaultwarden&color=944000&cacheSeconds=14400)](https://github.com/dani-garcia/vaultwarden/blob/main/LICENSE.txt)
[![Dependency Status](https://img.shields.io/badge/dynamic/xml?url=https%3A%2F%2Fdeps.rs%2Frepo%2Fgithub%2Fdani-garcia%2Fvaultwarden%2Fstatus.svg&query=%2F*%5Blocal-name()%3D'svg'%5D%2F*%5Blocal-name()%3D'g'%5D%5B2%5D%2F*%5Blocal-name()%3D'text'%5D%5B4%5D&style=flat-square&logo=rust&label=dependencies&color=005AA4)](https://deps.rs/repo/github/dani-garcia/vaultwarden) [![GHA Release](https://img.shields.io/github/actions/workflow/status/dani-garcia/vaultwarden/release.yml?style=flat-square&logo=github&logoColor=fff&label=Release%20Workflow)](https://github.com/dani-garcia/vaultwarden/actions/workflows/release.yml) [![GHA Build](https://img.shields.io/github/actions/workflow/status/dani-garcia/vaultwarden/build.yml?style=flat-square&logo=github&logoColor=fff&label=Build%20Workflow)](https://github.com/dani-garcia/vaultwarden/actions/workflows/build.yml)
[![Matrix Chat](https://img.shields.io/matrix/vaultwarden:matrix.org.svg?style=flat-square&logo=matrix&logoColor=fff&color=953B00&cacheSeconds=14400)](https://matrix.to/#/#vaultwarden:matrix.org) [![GitHub Discussions](https://img.shields.io/github/discussions/dani-garcia/vaultwarden?style=flat-square&logo=github&logoColor=fff&color=953B00&cacheSeconds=300)](https://github.com/dani-garcia/vaultwarden/discussions) [![Discourse Discussions](https://img.shields.io/discourse/topics?server=https%3A%2F%2Fvaultwarden.discourse.group%2F&style=flat-square&logo=discourse&color=953B00)](https://vaultwarden.discourse.group/)
## 功能 提供了几乎完整的 Bitwarden Client API 实现,包括: * [个人密码库](https://bitwarden.com/help/managing-items/) * [Send](https://bitwarden.com/help/about-send/) * [附件](https://bitwarden.com/help/attachments/) * [网站图标](https://bitwarden.com/help/website-icons/) * [个人 API 密钥](https://bitwarden.com/help/personal-api-key/) * [组织](https://bitwarden.com/help/getting-started-organizations/) - [集合](https://bitwarden.com/help/about-collections/), [密码共享](https://bitwarden.com/help/sharing/), [成员角色](https://bitwarden.com/help/user-types-access-control/), [群组](https://bitwarden.com/help/about-groups/), [事件日志](https://bitwarden.com/help/event-logs/), [管理员密码重置](https://bitwarden.com/help/admin-reset/), [目录连接器](https://bitwarden.com/help/directory-sync/), [策略](https://bitwarden.com/help/policies/) * [多因素/双因素认证](https://bitwarden.com/help/bitwarden-field-guide-two-step-login/) - [验证器](https://bitwarden.com/help/setup-two-step-login-authenticator/), [邮箱](https://bitwarden.com/help/setup-two-step-login-email/), [FIDO2 WebAuthn](https://bitwarden.com/help/setup-two-step-login-fido/), [YubiKey](https://bitwarden.com/help/setup-two-step-login-yubikey/), [Duo](https://bitwarden.com/help/setup-two-step-login-duo/) * [紧急访问](https://bitwarden.com/help/emergency-access/) * [Vaultwarden 管理后台](https://github.com/dani-garcia/vaultwarden/wiki/Enabling-admin-page) * [修改版 Web Vault 客户端](https://github.com/dani-garcia/bw_web_builds)(打包在我们的容器中)
## 用法 安装和使用 Vaultwarden 的推荐方式是通过我们发布到 [ghcr.io](https://github.com/dani-garcia/vaultwarden/pkgs/container/vaultwarden)、[docker.io](https://hub.docker.com/r/vaultwarden/server) 和 [quay.io](https://quay.io/repository/vaultwarden/server) 的容器镜像。 请参阅 [使用哪个容器镜像](https://github.com/dani-garcia/vaultwarden/wiki/Which-container-image-to-use) 以获取关于所提供标签的说明。 还有 [社区维护的软件包](https://github.com/dani-garcia/vaultwarden/wiki/Third-party-packages) 可供使用,但这些版本可能落后于最新版本,或者在 Vaultwarden 的配置方式上有所偏离,正如我们的 [Wiki](https://github.com/dani-garcia/vaultwarden/wiki) 中所述。 或者,您也可以 [自行构建 Vaultwarden](https://github.com/dani-garcia/vaultwarden/wiki/Building-binary)。 虽然 Vaultwarden 基于内置 TLS 支持的 [Rocket web 框架](https://rocket.rs),但我们建议您设置反向代理(参见 [代理示例](https://github.com/dani-garcia/vaultwarden/wiki/Proxy-examples))。 ### 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 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](https://matrix.to/#/#vaultwarden:matrix.org)、[GitHub Discussions](https://github.com/dani-garcia/vaultwarden/discussions) 或 [Discourse 论坛](https://vaultwarden.discourse.group/) 的社区。 遇到错误或崩溃?请搜索我们的 issue 追踪器和讨论区,看看是否已经被报告。如果没有,请 [发起新讨论](https://github.com/dani-garcia/vaultwarden/discussions) 或 [创建新 issue](https://github.com/dani-garcia/vaultwarden/issues/)。确保您使用的是最新版本的 Vaultwarden,并且没有类似的已开启或已关闭的 issue!
## 免责声明 **本项目与 [Bitwarden](https://bitwarden.com/) 或 Bitwarden, Inc. 没有关联。** 不过,Vaultwarden 的一位活跃维护者受雇于 Bitwarden,并被允许在自己的时间参与该项目。这些贡献独立于 Bitwarden,并由其他维护者审查。 维护者共同设定项目的方向,专注于服务自托管社区,包括个人、家庭和小型组织,同时确保项目的可持续性。 **请注意:** 对于使用 Vaultwarden 期间可能发生的任何数据丢失,我们不承担责任。这包括密码、附件和由应用程序处理的其他信息。我们强烈建议您定期备份文件和数据库。但是,如果您遇到数据丢失,我们鼓励您立即联系我们。
## Bitwarden_RS 该项目曾被称为 Bitwarden_RS,为了将其与官方 Bitwarden 服务器区分开来,希望能避免混淆以及商标/品牌问题,因此进行了更名。
请参阅 [#1642 - v1.21.0 release and project rename to Vaultwarden](https://github.com/dani-garcia/vaultwarden/discussions/1642) 以获取更多解释。
标签:API兼容, Bitwarden, Docker, LangChain, Rust, StruQ, Vaultwarden, Vaultwarden_rs, Web服务, 凭据管理, 单机部署, 可视化界面, 安全防御评估, 开源, 服务器, 网络安全, 网络安全, 网络流量审计, 自托管, 请求拦截, 资源高效, 轻量级, 通知系统, 通知系统, 隐私保护, 隐私保护, 非官方实现