运行在 Cloudflare Workers 的 Bitwarden 第三方服务端，兼容官方客户端
[](https://workers.cloudflare.com/) [](./LICENSE) [](https://github.com/shuaiplus/NodeWarden/releases/latest) [](https://github.com/shuaiplus/NodeWarden/actions/workflows/sync-upstream.yml) [更新日志](./RELEASE_NOTES.md) • [提交问题](https://github.com/shuaiplus/NodeWarden/issues/new/choose) • [最新发布](https://github.com/shuaiplus/NodeWarden/releases/latest) English：[`README_EN.md`](./README_EN.md) > **免责声明** > 本项目仅供学习交流使用。我们不对任何数据丢失负责，强烈建议定期备份您的密码库。 > 本项目与 Bitwarden 官方无关，请勿向 Bitwarden 官方反馈问题。 --- ## 与 Bitwarden 官方服务端能力对比 | 能力项 | Bitwarden | NodeWarden | 说明 | |---|---|---|---| | Web Vault（登录/笔记/卡片/身份） | ✅ | ✅ | 网页端密码库管理页面 | | 文件夹 / 收藏 | ✅ | ✅ | 常用管理能力可用 | | 全量同步 `/api/sync` | ✅ | ✅ | 已做兼容与性能优化 | | 附件上传/下载 | ✅ | ✅ | Cloudflare R2 和 KV 二选一 | | 导入导出功能 | ✅ | ✅ | 完整实现，含 Bitwarden 密码库+附件 ZIP 导入 | | 网站图标代理 | ✅ | ✅ | 通过 `/icons/{hostname}/icon.png` | | passkey、TOTP字段 | ✅ | ✅ |完全支持，无需高级版 | | Send | ✅ | ✅ | Cloudflare R2 和 KV 二选一 | | 多用户 | ✅ | ✅ | 完整的用户管理，邀请机制 | | 组织/集合/成员权限 | ✅ | ❌ | 没必要实现 | | 登录 2FA（TOTP/WebAuthn/Duo/Email） | ✅ | ⚠️ 部分支持 | 仅支持用户级 TOTP | | SSO / SCIM / 企业目录 | ✅ | ❌ | 没必要实现 | | 紧急访问 | ✅ | ❌ | 没必要实现 | | 管理后台 / 计费订阅 | ✅ | ❌ | 纯免费 | | 推送通知完整链路 | ✅ | ❌ | 没必要实现 | ## 测试情况： - ✅ Windows 客户端（v2026.1.0） - ✅ 手机 App（v2026.1.0） - ✅ 浏览器扩展（v2026.1.0） - ✅ Linux 客户端（v2026.1.0） - ⬜ macOS 客户端（未测试） --- # 快速开始 ### 一键部署 **部署步骤：** 1. 首先Fork本仓库，命名为**NodeWarden** 2. 根据对储存库的需求，**二选一**点击下面的按钮，修改项目名称为**NodeWarden2**，修改**JWT_SECRET**成32为随机字符串； - **R2**：需绑定银行卡；**单个附件/Send上限 100MB**（代码限制，可自行修改）；**总量 10GB 免费** [-Cloudflare%20Workers-F38020?logo=cloudflare&logoColor=white)](https://deploy.workers.cloudflare.com/?url=https://github.com/shuaiplus/NodeWarden) - **KV**：无需绑卡；**单个附件/Send 文件上限 25 MiB**（cloudflare限制，不可修改）；**总量 1GB 免费** [-Cloudflare%20Workers-2ea44f?logo=cloudflare&logoColor=white)](https://deploy.workers.cloudflare.com/?url=https://github.com/shuaiplus/NodeWarden/tree/kv) 3. 部署完成后，同一页面打开workers设置，将**Git存储库**断开连接 4. 同一位置，**Git存储库**链接至第一步Fork的仓库（仓库名NodeWarden），**R2选择main分支，KV选择kv分支**（必须选对！！！） 5. 仓库**NodeWarden2**可以删除 > [!TIP] > 同步上游（更新仓库）： >- 手动：Github打开你Fork的私人仓库，看到顶部同步提示时，点击 “Sync fork”。 >- 自动：进入你的 Fork 仓库 → Actions，点击 “I understand my workflows, go ahead and enable them”，每天凌晨三点自动同步至上游 ### CLI 部署 ```powershell # 先把仓库拉到本地 git clone https://github.com/shuaiplus/NodeWarden.git cd NodeWarden # 安装依赖 npm install # Cloudflare CLI 登录 npx wrangler login # 创建云资源（D1 + R2） npx wrangler d1 create nodewarden-db npx wrangler r2 bucket create nodewarden-attachments # 部署 npm run deploy # （可选）KV 模式（无 R2 / 无信用卡） npx wrangler kv namespace create ATTACHMENTS_KV # 将返回的 namespace id 填入 wrangler.kv.toml 的 [[kv_namespaces]].id npm run deploy:kv # 需更新时重新拉取仓库，重新部署即可，无需创建云资源 git clone https://github.com/shuaiplus/NodeWarden.git cd NodeWarden npm run deploy ``` --- ## 本地开发 这是一个 Cloudflare Workers 的 TypeScript 项目（Wrangler）。 ```bash npm install npm run dev ``` --- ## 常见问题 **Q: 如何备份数据？** A: 在客户端中选择「导出密码库」，保存 JSON 文件。 **Q: 导入导出支持哪些格式？** A: 支持 Bitwarden `json/csv/密码库+附件 zip` 和 NodeWarden `密码库+附件 json`（均含加密模式），且导入下拉中看到的格式都可直接导入。 A: 另外支持直接导入 Bitwarden `密码库+附件 zip`，这条路径官方 Bitwarden Web 不支持。 **Q: 忘记主密码怎么办？** A: 无法恢复，这是端到端加密的特性。建议妥善保管主密码。 **Q: 可以多人使用吗？** A: 支持。第一个注册的用户自动成为管理员，管理员可在管理页面生成邀请码，其他用户凭邀请码注册。 --- ## 开源协议 LGPL-3.0 License --- ## 致谢 - [Bitwarden](https://bitwarden.com/) - 原始设计和客户端 - [Vaultwarden](https://github.com/dani-garcia/vaultwarden) - 服务器实现参考 - [Cloudflare Workers](https://workers.cloudflare.com/) - 无服务器平台 --- ## Star History [](https://www.star-history.com/#shuaiplus/NodeWarden&type=timeline&legend=top-left)