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 客户端（未测试）

---

快速开始

一键部署

若你只是想快速体验，直接点击第 2 步的一键部署按钮即可；以下步骤主要为了后续长期更新。

1. 先 Fork 本仓库，并命名为 NodeWarden。

2. 点击下面的按钮，在打开的页面中将项目名称改为 NodeWarden2，并将 JWT_SECRET 设置为 32 位随机字符串。

   

3. 部署完成后，在同一页面打开 Workers 设置，将 Git 存储库 断开连接。

4. 在同一位置重新连接到第 1 步 Fork 的仓库，并在页面底部将名称 改回 NodeWarden。

5. GitHub 仓库 NodeWarden2 可以删除。

📦 若未绑定银行卡、无法启用 R2 对象存储，可改用 KV 模式

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

1. 先 Fork 本仓库，并命名为 NodeWarden（默认自动填写）

2. 进入新仓库，进入 Actions 页面，点击 I understand my workflows, go ahead and enable them，点击 Switch to KV mode，点击Run Workflow

3. 成功后在你自己的仓库中点击下面的按钮，在打开的页面中将项目名称改为 NodeWarden2，并将 JWT_SECRET 设置为 32 位随机字符串。（不能选创建专用 Git 存储库）

   

4. 在同一页面打开 Workers 设置，将 Git 存储库 断开连接。

5. 返回Github进入Fork后的仓库（NodeWarden），进入 Actions 页面，运行Import KV ID from NodeWarden2

6. 返回cloudflare，Git 存储库连接到Fork后的仓库（NodeWarden），并在页面底部将名称改回 NodeWarden。

7. GitHub 仓库 NodeWarden2 可以删除了。

Tip

同步方法（更新仓库）：

• 手动：打开你 Fork 的 GitHub 仓库，看到顶部同步提示后，点击 Sync fork，点击Update branch
• 自动：进入你的 Fork 仓库 -> Actions->Sync upstream->Enable workflow，会在每天凌晨 3 点自动同步上游。

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 中 `id = "placeholder"` 里的 placeholder（保留双引号）
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