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 и позволяет синхронизировать хранилища, вложения и коды TOTP со стандартными клиентами Bitwarden, не арендуя VPS.
Это приложение для установки или сервер, который я разворачиваю сам?Это бэкенд-сервер, который вы разворачиваете в собственном аккаунте Cloudflare (Workers плюс база данных D1, с R2 или KV для хранения) — на вашем устройстве ничего не запускается, вы просто направляете официальные клиенты, совместимые с Bitwarden, на него.
Как его развернуть?Сделайте форк репозитория на GitHub, откройте Cloudflare Workers & Pages, выберите 'Continue with GitHub' и укажите свой форк, затем задайте команду сборки 'npm run build' и команду развёртывания 'npm run deploy' (или 'npm run deploy:kv' для хранения на KV).
Что нужно помимо форка на GitHub?Лишь аккаунт Cloudflare с привязками Workers/D1/R2-или-KV и JWTSECRET не менее 32 случайных символов, заданный как секрет Worker; Worker сам создаёт схему D1 при первом запросе, ручной SQL не нужен.
Каких официальных функций Bitwarden не хватает?Обмен на уровне организаций/коллекций/ролей и SSO/SCIM/синхронизация каталогов не реализованы, а поддержка десктопа macOS ещё полностью не проверена, хотя клиенты Windows, Linux, мобильные и браузерные расширения подтверждённо работают.
Это официально поддерживается Bitwarden и безопасно ли моё хранилище?Нет — это неофициальная, независимая реимплементация; данные хранилища шифруются сквозным (с нулевым разглашением) образом ещё до попадания в ваше собственное хранилище Cloudflare, а README прямо предупреждает, что это учебный проект, не связанный с Bitwarden.
В чём разница между хранением на R2 и на KV?R2 требует привязки платёжной карты, но даёт бесплатный тариф 10 ГБ с файлами вложений/Send до 100 МБ; для KV карта не нужна, но бесплатное хранилище ограничено 1 ГБ с лимитом 25 МиБ на файл.
Можно ли скрыть встроенное веб-хранилище?Да — установка переменной HIDEWEBVAULT=1 в настройках Workers заставит фронтенд-страницы сервера возвращать 404, при этом sync, login, attachment и другие клиентские API продолжат работать нормально.
Поддерживает ли он passkey или аппаратные ключи безопасности?Да, он поддерживает вход через passkey (без пароля) плюс двухфакторную аутентификацию на базе TOTP и YubiKey — функции, обычно зарезервированные для платных планов Bitwarden.
Предлагает ли он бэкапы хранилища сверх базового самохостинга?Он включает встроенный центр облачного бэкапа, который может запускать запланированные инкрементальные бэкапы в WebDAV или S3 — функцию, которой нет в официальном бесплатном тарифе Bitwarden.
Creator
shuaiplus
Size
8.1 MB
Stars
3.9K
Age
8mo
Commits · 90 Days