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. 打开 GitHub 仓库，进入 Actions 页面，运行 Switch to KV mode（自动将 wrangler.toml 切换为 KV 配置。）

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

   

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

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

6. GitHub 仓库 NodeWarden2 可以删除。

Tip

同步上游（更新仓库）：

• 手动：打开你 Fork 的 GitHub 仓库，看到顶部同步提示后，点击 Sync fork。
• 自动：进入你的 Fork 仓库 -> Actions，点击 I understand my workflows, go ahead and enable them，启用后，Sync upstream 会在每天凌晨 3 点自动同步上游 main，并保留你当前的 wrangler.toml 配置不被覆盖。

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