项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-22 · 当前星标 ★ 71128
使用教程
环境要求
- 已安装 Docker(或 Podman)并可执行 docker 命令
- 一个已解析到你服务器的域名,且能配置 HTTPS(Web Crypto API 要求安全上下文)
- 建议准备反向代理(如 Nginx/Caddy)用于 HTTPS 转发
- 宿主机上可持久化保存数据的目录,例如 /vw-data/
安装与启动步骤
-
1拉取官方镜像
Vaultwarden 推荐用容器镜像部署,镜像发布在 ghcr.io、docker.io、quay.io。这里从 Docker Hub 拉取最新版。
docker pull vaultwarden/server:latest -
2启动容器
挂载宿主机目录到容器 /data/ 做持久化,设置 DOMAIN 为你的 HTTPS 域名,端口只映射到本机 127.0.0.1:8000 交给反向代理。
docker run --detach --name vaultwarden \n --env DOMAIN="https://vw.domain.tld" \n --volume /vw-data/:/data/ \n --restart unless-stopped \n --publish 127.0.0.1:8000:80 \n vaultwarden/server:latest -
3改用 Compose 部署
把上面的配置写成 compose.yaml,适合长期维护;保存后即可用 Compose 启动服务,效果与 docker run 一致。
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 -
4启用 HTTPS
web 界面依赖 Web Crypto API,必须 HTTPS 才能工作。README 建议配置反向代理,并按 Wiki 的 Enabling HTTPS 说明操作。
-
5用客户端连接
在官方 Bitwarden 客户端(手机/桌面/浏览器扩展)的登录页切换到自托管,填入你的域名即可使用个人保险库、Send、附件等功能。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
DOMAIN | 是 | 服务器对外访问地址,必须是 HTTPS 域名,影响客户端与网页保险库 | https://vw.domain.tld |
--volume /vw-data/:/data/ | 是 | 把宿主机目录挂到容器 /data/,所有持久化数据存于此 | /vw-data/:/data/ |
--publish 127.0.0.1:8000:80 | 否 | 容器 80 端口映射到本机 8000,仅本机可访问,外部由反向代理转发 | 127.0.0.1:8000:80 |
--restart unless-stopped | 否 | 容器异常退出或重启主机后自动拉起,保证服务常驻 | unless-stopped |
image | 是 | 容器镜像及标签,可选 ghcr.io、docker.io、quay.io 三个来源 | vaultwarden/server:latest |
如何确认成功
浏览器访问你的 HTTPS 域名(如 https://vw.domain.tld),能看到网页保险库登录页;用官方 Bitwarden 客户端登录自托管账号成功即部署完成。
常见问题
Q:网页保险库打不开或提示不安全怎么办?
A:web 端依赖 Web Crypto API,必须使用 HTTPS 和安全上下文。请按 Wiki 的 Enabling HTTPS 配置证书,并建议搭配反向代理使用。
Q:数据存在哪里?容器删了会丢吗?
A:所有持久化数据都保存在挂载的目录(示例为宿主机 /vw-data/ 对应容器 /data/)。只要该目录保留,重建容器数据不会丢。
Q:应该选哪个镜像仓库和标签?
A:镜像同时发布在 ghcr.io、docker.io、quay.io,任选其一即可。具体标签含义见 Wiki 的 Which container image to use。
Q:遇到 bug 该去哪里反馈?
A:无论使用哪种客户端,都请直接向 Vaultwarden 项目反馈,不要使用官方 Bitwarden 的支持渠道。
Q:可以不用 Docker 吗?
A:可以自行编译二进制,或使用社区维护的第三方安装包,但它们可能版本滞后或配置方式不同。
注意事项
- Vaultwarden 是 Bitwarden 客户端 API 的第三方服务端实现,并非官方产品。
- README 强烈建议使用反向代理处理 TLS,而不是直接依赖内置 TLS 支持。
- 示例中的域名 https://vw.domain.tld 和路径 /vw-data/ 需替换成你自己的实际值。
- 更详细的安装、使用与配置示例请查阅项目 Wiki。
核心亮点
- 密码数据 100% 自托管,隐私可控
- 兼容 Bitwarden 全部官方客户端
- 内存占用极低,老旧设备也能跑
不足之处
- 生产环境建议配合 HTTPS 域名使用
- 备份需自行维护(数据卷备份)
适用场景
- 家庭/个人密码库,摆脱商业密码管理器
- 小团队共享账号与密钥
- 内网环境的安全凭据管理
替代项目
Bitwarden(官方)、KeePass、Passbolt
上一篇:Stirling PDF
下一篇:KillerPDF
同类项目推荐
widgets
开源
桌面一键唤起 AI 与效率小工具,告别频繁切换应用
Desktop widgets for windows. built with react
natively-cluely-ai-assistant
开源
本地运行,免费开源,一键搞定会议记录与面试复盘
Natively — Free open-source AI meeting assistant, interview copilot, and note taker···
cpdown
开源
一键把网页和油管字幕变成干净 Markdown
cpdown - Copy to clipboard any webpage content/youtube subtitle as clean markdown wi···
pymupdf4llm
开源
把 PDF 一键转成 LLM 爱读的 Markdown
PyMuPDF4LLM
video-devour
开源
丢个视频进去,自动吐出图文笔记报告
基于 ASR + VLM 技术的智能视频笔记工具,能够将任何视频"吞噬"并生成包含图文内容和视频剪···
guizang-ppt-skill
开源
丢个主题给 AI,马上还你一套杂志级 PPT
AI-agent Skill for generating polished HTML slide decks: editorial magazine and Swis···
clipboardline
开源
复制过的文字截图自动归档,随时搜回
ClipBoardLine: macOS and Windows clipboard shelves and local library, inspired by Te···
univer
开源
让 AI 像操作对象一样读写表格文档幻灯片
Build your own AI office with Univer Office SDK. Bring editing, calculation, collabo···
resume_render_from_job_descripti···
开源
贴个职位链接,AI 自动改好简历
jevos: an open-source alternative to Jev and Microsoft-Decision-1. Yes/no decisions,···
