cloudfare-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 / 企业目录	✅	❌	未实现

准备工作

一个 Cloudflare 账户
一个 Github 账户
一个没有被阻断的域名（可选）

网页部署

第一步

fork 项目仓库到你的账户。

第二步

打开 cloudfare Workers ➜ 创建应用程序 ➜ 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 部署

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/ 目录按需读取附件
- 缺失的附件会被安全跳过
- 被跳过的附件不会在恢复后的数据库中留下脏记录