中文文档：README.md
A Bitwarden-compatible server that runs on Cloudflare Workers.
Disclaimer
- This project is for learning and communication only.
- We are not responsible for any data loss. Regular vault backups are strongly recommended.
- This project is not affiliated with Bitwarden. Please do not report issues to the official Bitwarden team.
| Capability | Bitwarden | NodeWarden | Notes |
|---|---|---|---|
| Single-user vault (logins/notes/cards/identities) | ✅ | ✅ | Core vault model supported |
| Folders / Favorites | ✅ | ✅ | Common vault organization supported |
Full sync /api/sync |
✅ | ✅ | Compatibility-focused implementation |
| Attachment upload/download | ✅ | ✅ | Backed by Cloudflare R2 |
| Import flow (common clients) | ✅ | ✅ | Common import paths covered |
| Website icon proxy | ✅ | ✅ | Via /icons/{hostname}/icon.png |
| passkey、TOTP | ❌ | ✅ | Official service requires premium; NodeWarden does not |
| Multi-user | ✅ | ❌ | NodeWarden is single-user by design |
| Organizations / Collections / Member roles | ✅ | ❌ | Not necessary to implement |
| Login 2FA (TOTP/WebAuthn/Duo/Email) | ✅ | TOTP-only via TOTP_SECRET |
|
| SSO / SCIM / Enterprise directory | ✅ | ❌ | Not necessary to implement |
| Send | ✅ | ❌ | Not necessary to implement |
| Emergency access | ✅ | ❌ | Not necessary to implement |
| Admin console / Billing & subscription | ✅ | ❌ | Free only |
| Full push notification pipeline | ✅ | ❌ | Not necessary to implement |
- ✅ Windows desktop client (v2026.1.0)
- ✅ Android app (v2026.1.0)
- ✅ Browser extension (v2026.1.0)
- ⬜ macOS desktop client (not tested)
- ⬜ Linux desktop client (not tested)
Deploy steps:
- Fork this project (you don't need to fork it if you don't need to update it later).
- Open the generated service URL and follow the on-page instructions.
This repo is a Cloudflare Workers TypeScript project (Wrangler).
npm install
npm run dev- Add Workers Secret
TOTP_SECRET(Base32) to enable login TOTP. - Remove
TOTP_SECRETto disable login TOTP. - Client flow: password -> TOTP code.
- "Remember this device" is supported for 30 days.
Q: How do I back up my data?
A: Use Export vault in your client and save the JSON file.
Q: What if I forget the master password?
A: It can’t be recovered (end-to-end encryption). Keep it safe.
Q: Can multiple people use it?
A: Not recommended. This project is designed for single-user usage. For multi-user usage, choose Vaultwarden.
LGPL-3.0 License
- Bitwarden - original design and clients
- Vaultwarden - server implementation reference
- Cloudflare Workers - serverless platform