nodewarden README

The project's README from github.com/shuaiplus/nodewarden. As one markdown file: README.md.

NodeWarden Logo

Bitwarden-compatible server running on Cloudflare Workers

Powered by Cloudflare License: LGPL-3.0 Latest Release

Telegram Channel | Telegram Group

中文 | Contributing | Official wiki

Disclaimer
This project is for learning and discussion purposes only. Please back up your vault regularly.
This project is not affiliated with Bitwarden. Please do not report NodeWarden issues to the official Bitwarden team.


Feature comparison with the official Bitwarden server

Feature Bitwarden Free NodeWarden Notes
Web vault ✅ ✅ Original Web Vault UI
TOTP ❌ ✅ Includes steam:// support
PWA / offline ❌ ✅ Installable, offline
Passkey login ✅ ✅ passwordless auth
API keys ✅ ✅ CLI keys; create and rotate
Login 2FA ✅ ✅ TOTP, YubiKey, Passkey
2FA recovery codes ✅ ✅ One-time 2FA disable codes
Real-time push sync ✅ ✅ All device sync
Attachments / Send ✅ ✅ Cloudflare R2 or KV
Import / export ✅ ✅ Bitwarden JSON / CSV / ZIP
Cloud backup center ❌ ✅ Scheduled WebDAV / S3 incrementals
Device management ✅ ✅ Remove devices; trust controls
Login requests ✅ ✅ Cross-device login approval/unlock
Multi-user ✅ ✅ Invite-code registration
Domain rules ✅ ✅ Equivalent domains, global exclusions
Fill-assist ✅ ✅ POST /fill-assist
Organizations / collections / roles ✅ ❌ Not implemented
SSO / SCIM / directory ✅ ❌ Not implemented

Tested clients


Visual quick deploy

  1. Fork the NodeWarden repository to your GitHub account
  2. Open Cloudflare Workers & Pages
  3. Choose Continue with GitHub and select your fork
  4. Set build command to npm run build and deploy command to npm run deploy
    • For KV mode, change the deploy command to npm run deploy:kv
  5. After deployment finishes, open the generated Workers URL

[!TIP] Default R2 vs optional KV:

Storage Card required Max single attachment / Send file Free tier
R2 Yes 100 MB (soft limit, adjustable) 10 GB
KV No 25 MiB (Cloudflare limit) 1 GB

How to update

CLI deploy

git clone https://github.com/shuaiplus/NodeWarden.git
cd NodeWarden

npm install
npx wrangler login

# Default: R2 mode
npm run deploy

# Optional: KV mode
npm run deploy:kv

# Local development
npm run dev
npm run dev:kv

License

LGPL-3.0 License


Credits


Contributors

NodeWarden contributors

Star History

Star History Chart

nodewarden (shuaiplus/nodewarden)

Searching Database…

这是什么?NodeWarden 是一个自托管、兼容 Bitwarden 的密码管理器服务器,完全运行在 Cloudflare Workers 上,让你无需租用 VPS,就能用标准 Bitwarden 客户端同步密码库、附件和 TOTP 验证码。
这是要安装的应用,还是我自己部署的服务器?它是部署进你自己 Cloudflare 账户的后端服务器(Workers 加一个 D1 数据库,用 R2 或 KV 做存储)——你的设备上不运行任何东西,只需把官方 Bitwarden 兼容客户端指向它。
怎么部署它?在 GitHub 上 fork 仓库,打开 Cloudflare Workers & Pages,选择“Continue with GitHub”并选中你的 fork,然后把构建命令设为“npm run build”,部署命令设为“npm run deploy”(KV 存储则用“npm run deploy:kv”)。
除了 GitHub fork 之外还需要什么?只需要一个启用了 Workers/D1/R2 或 KV 绑定的 Cloudflare 账户,以及一个至少 32 位随机字符的 JWTSECRET(设置为 Worker secret);Worker 会在首次请求时自动创建 D1 表结构,无需手动执行 SQL。
缺少哪些官方 Bitwarden 功能?组织/集合/角色共享以及 SSO/SCIM/目录同步尚未实现,macOS 桌面客户端支持也还未完全验证,不过 Windows、Linux、移动端和浏览器扩展客户端已确认可用。
这是 Bitwarden 官方的吗?我的密码库安全吗?不是——它是一个非官方的独立重新实现;密码库数据在到达你自己的 Cloudflare 存储之前就已完成端到端(零知识)加密,README 明确警告这是一个学习项目,与 Bitwarden 没有任何隶属关系。
用 R2 还是 KV 做存储有什么区别?R2 需要绑定支付卡,但有 10GB 免费额度,单个附件/Send 文件最大 100MB;KV 不需要绑卡,但免费存储上限 1GB,单文件限制 25MiB。
能隐藏内置的网页密码库吗?可以——在 Workers 设置里配置 HIDEWEBVAULT=1 变量后,服务器的前端页面会返回 404,而同步、登录、附件等客户端 API 仍正常工作。
它支持通行密钥或硬件安全密钥吗?支持,它支持通行密钥(无密码)登录,以及 TOTP 和基于 YubiKey 的双因素认证,这些功能通常只有 Bitwarden 付费套餐才提供。
除了基础自托管,它还提供密码库备份吗?它内置了一个云备份中心,可以定时向 WebDAV 或 S3 执行增量备份,这是 Bitwarden 官方免费版不提供的功能。
Creator
shuaiplus
Size
8.1 MB
Stars
3.9K
Age
8mo
Commits · 90 Days