nodewarden/README.md

运行在 Cloudflare Workers 的 Bitwarden 第三方服务端，兼容官方客户端

更新日志 • 提交问题 • 最新发布

English：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，取消选择 Copy the main branch only
2. 根据对储存库的需求，二选一点击下面的按钮，修改项目名称为NodeWarden2，修改JWT_SECRET成32为随机字符串；

• R2：需绑定银行卡；单个附件/Send上限 100MB（代码限制，可自行修改）；总量 10GB 免费

  

• KV：无需绑卡；单个附件/Send 文件上限 25 MiB（cloudflare限制，不可修改）；总量 1GB 免费

  

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 部署

# 先把仓库拉到本地
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）。

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 - 原始设计和客户端
• Vaultwarden - 服务器实现参考
• Cloudflare Workers - 无服务器平台

---

Star History