运行在 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 官方反馈 NodeWarden 的问题。 --- ## 与 Bitwarden 官方服务端能力对比 | 能力 | Bitwarden | NodeWarden | 说明 | |---|---|---|---| | 网页密码库 | ✅ | ✅ | **原创Web Vault界面** | | 全量同步 `/api/sync` | ✅ | ✅ | 已针对官方客户端做兼容优化 | | 附件上传 / 下载 | ✅ | ✅ | Cloudflare R2 或 KV | | Send | ✅ | ✅ | 支持文本与文件 Send | | 导入 / 导出 | ✅ | ✅ | 支持 Bitwarden JSON / CSV / **ZIP 导入（包括附件）** | | **云端备份中心** | ❌ | ✅ | **支持 WebDAV / E3 定时备份** | | 密码提示（网页端） | ⚠️ 有限 | ✅ | **无需发送邮件** | | TOTP / Steam TOTP | ✅ | ✅ | 含 `steam://` 支持 | | 多用户 | ✅ | ✅ | 支持邀请码注册 | | 组织 / 集合 / 成员权限 | ✅ | ❌ | 未实现 | | 登录 2FA | ✅ | ⚠️ 部分支持 | 当前仅支持用户级 TOTP | | SSO / SCIM / 企业目录 | ✅ | ❌ | 未实现 | --- ## 已测试客户端 - ✅ Windows 桌面端 - ✅ 手机 App - ✅ 浏览器扩展 - ✅ Linux 桌面端 - ⚠️ macOS 桌面端尚未完整验证 --- ## 网页部署 1. Fork 本仓库。若本项目对你有帮助，欢迎点个 Star。 2. 打开 [Workers](https://dash.cloudflare.com/?to=/:account/workers-and-pages/create) ➜ `Continue with GitHub` ➜ 选择你 Fork 后的仓库（`NodeWarden`）➜ 下一步 ➜ （默认使用 R2 存储；若未开通，可用 KV 来代替，将**部署命令**改为 `npm run deploy:kv`）➜ 部署 ➜ 打开生成的链接 | 储存 | 是否需绑卡 | 单个附件/Send文件上限 | 免费额度 | |---|---|---|---| | R2 | 需要 | 100 MB（软限制可更改） | 10 GB | | KV | 不需要 | 25 MiB（Cloudflare限制） | 1 GB | > [!TIP] > 同步方法（更新仓库）： >- 手动：打开你 Fork 的 GitHub 仓库，看到顶部同步提示后，点击 `Sync fork` ➜ `Update branch` >- 自动：进入你的 Fork 仓库 ➜ `Actions` ➜ `Sync upstream` ➜ `Enable workflow`，会在每天凌晨 3 点自动同步上游。 ## CLI 部署 ```powershell git clone https://github.com/shuaiplus/NodeWarden.git cd NodeWarden npm install npx wrangler login # 默认：R2 模式 npm run deploy # 可选：KV 模式 npm run deploy:kv # 本地开发 npm run dev npm run dev:kv ``` --- ## 云端备份说明 - 远程备份支持 **WebDAV** 与 **E3** - 勾选“包含附件”后： - ZIP 内仍只包含 `db.json` 与 `manifest.json` - 真实附件单独存放在 `attachments/` - 后续备份会按稳定 blob 名复用已有附件，不会每次全量重传 - 远程还原时： - 会从 `attachments/` 目录按需读取附件 - 缺失的附件会被安全跳过 - 被跳过的附件不会在恢复后的数据库中留下脏记录 --- ## 导入 / 导出 当前支持的导入来源包括： - Bitwarden JSON - Bitwarden CSV - Bitwarden 密码库 + 附件 ZIP - NodeWarden JSON - 网页导入器里可见的多种浏览器 / 密码管理器格式 当前支持的导出方式包括： - Bitwarden JSON - Bitwarden 加密 JSON - 带附件的 ZIP 导出 - NodeWarden JSON 系列 - 备份中心中的实例级完整手动导出 --- ## 开源协议 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)