nodewarden/README_ZH.md

运行在 Cloudflare Workers 上的 Bitwarden 兼容服务端

Telegram 频道 | Telegram 群组

English | 贡献指南 | 官方wiki

免责声明
本项目仅供学习与交流使用，请定期备份你的密码库。
本项目与 Bitwarden 官方无关，请不要向 Bitwarden 官方反馈 NodeWarden 的问题。

---

与 Bitwarden 官方服务端能力对比

能力	Bitwarden免费版	NodeWarden	说明
网页密码库	✅	✅	原创Web Vault界面
TOTP	❌	✅	包括 steam:// 支持
PWA / 离线使用	❌	✅	可安装、离线使用、App快捷方式
Passkey 登录	✅	✅	支持WebAuthn/FIDO2无密码登录
API 密钥	✅	✅	供bitwarden cli使用，支持获取和轮换
登录 2FA	✅	✅	支持 TOTP、YubiKey、Passkey
2FA 恢复码	✅	✅	一次性恢复码用于禁用 2FA
实时推送同步	✅	✅	网页端、浏览器扩展、电脑端和手机端实时同步
附件 / Send	✅	✅	Cloudflare R2 或 KV
导入 / 导出	✅	✅	支持 Bitwarden JSON / CSV / ZIP 导入（包括附件）
云端备份中心	❌	✅	支持 WebDAV / S3 定时增量备份
设备管理	✅	✅	删除设备、撤销信任、永久信任
登录请求	✅	✅	多端免密登录审批、跨设备解锁请求
多用户使用	✅	✅	支持邀请码注册
域名规则	✅	✅	自定义等效域名、全局域名排除
Fill-assist	✅	✅	POST /fill-assist 辅助客户端自动填充；不能绕过保险库解锁
组织 / 集合 / 成员权限	✅	❌	未实现
SSO / SCIM / 企业目录	✅	❌	未实现

---

已测试客户端

• ✅ Windows 桌面端
• ✅ 手机 App
• ✅ 浏览器扩展
• ✅ Linux 桌面端
• ⚠️ macOS 桌面端尚未完整验证

---

可视化快速部署

1. Fork NodeWarden 仓库到自己的 GitHub 账号
2. 进入 Cloudflare Workers & Pages
3. 选择 Continue with GitHub 并选择你的仓库
4. 构建命令填 npm run build，部署命令填 npm run deploy

• 如果你打算用 KV 模式，把部署命令改成 npm run deploy:kv

5. 等部署完成后，打开生成的 Workers 域名

• Workers 默认域名在部分网络环境不可直连。如需自定义域名，到 Workers 设置里添加。

• 页面提示缺少 JWT_SECRET 时，到 Workers 设置里添加 Secret。正式环境至少使用 32 个字符以上的随机字符串，不要使用临时值或示例值。

• 这套流程里，用户实际做的是把代码交给 Cloudflare 构建并部署。代码里的 wrangler.toml 或 wrangler.kv.toml 决定绑定名，Worker 第一次处理请求时会自动初始化 D1 schema，不需要用户上传 SQL。

Tip

默认R2与可选KV的区别：

储存	是否需绑卡	单个附件/Send文件上限	免费额度
R2	需要	100 MB（软限制可更改）	10 GB
KV	不需要	25 MiB（Cloudflare限制）	1 GB

更新方法：

• 手动：打开你 Fork 的 GitHub 仓库，看到顶部同步提示后，点击 Sync fork ➜ Update branch

CLI 部署

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

---

开源协议

LGPL-3.0 License

---

致谢

• Bitwarden - 原始设计与客户端
• Vaultwarden - 服务端实现参考
• Cloudflare Workers - 无服务器平台

---

Star History