
Cách tự host kho mật khẩu tương thích BitWarden
Mật khẩu là tài sản kỹ thuật số quan trọng nhất của bạn, và giữ an toàn cho chúng đồng nghĩa với việc bạn phải tự mình kiểm soát.
Mật khẩu là tài sản kỹ thuật số quan trọng nhất của bạn, và giữ an toàn cho chúng đồng nghĩa với việc bạn phải tự mình kiểm soát. Bằng cách tự host (self-host) trình quản lý mật khẩu của mình, bạn sẽ làm chủ hoàn toàn bảo mật của bản thân.
BitWarden được đánh giá rộng rãi là một trong những giải pháp đáng tin cậy nhất trong lĩnh vực quản lý mật khẩu và mã nguồn của nó được phát hành theo giấy phép AGPL-3.0. Một máy chủ không chính thức tương thích với BitWarden là NodeWarden, được viết bằng Typescript và có thể được triển khai (deploy) miễn phí trên nền tảng Cloudflare.
So sánh tính năng với Máy chủ BitWarden Chính thức
Tính năng | BitWarden | NodeWarden | Ghi chú |
|---|---|---|---|
| Web Vault (Kho lưu trữ Web) | ✅ | ✅ | Giao diện Web Vault nguyên bản |
Đồng bộ hóa đầy đủ /api/sync | ✅ | ✅ | Tối ưu hóa tính tương thích cho các client chính thức |
| Upload / tải xuống tệp đính kèm | ✅ | ✅ | Cloudflare R2 hoặc KV |
| Send (Gửi) | ✅ | ✅ | Hỗ trợ Send cả dạng văn bản và tệp |
| Nhập / Xuất (Import/Export) | ✅ | ✅ | Hỗ trợ nhập (import) JSON / CSV / ZIP kèm tệp đính kèm của BitWarden |
| Trung tâm Sao lưu Đám mây | ❌ | ✅ | Sao lưu định kỳ lên WebDAV / S3 |
| Gợi ý mật khẩu (web) | ⚠️ Hạn chế | ✅ | Không yêu cầu email |
| TOTP / Steam TOTP | ✅ | ✅ | Bao gồm hỗ trợ steam:// |
| Nhiều người dùng (Multi-user) | ✅ | ✅ | Đăng ký theo hình thức thư mời |
| Tổ chức / Bộ sưu tập / Phân quyền | ✅ | ❌ | Chưa được triển khai |
| Đăng nhập 2FA | ✅ | ⚠️ Một phần | Hiện tại chỉ hỗ trợ TOTP cấp người dùng |
| SSO / SCIM / Danh bạ doanh nghiệp | ✅ | ❌ | Chưa được triển khai |
Những gì chúng ta cần:
- Một tài khoản GitHub
- Một tài khoản Cloudflare (Miễn phí) đã kích hoạt Cloudflare R2 Storage.
- Tùy chọn: Một tên miền tùy chỉnh (custom domain) được quản lý trong Cloudflare.
Giai đoạn 1: Chuẩn bị Code
- Fork kho lưu trữ NodeWarden từ https://github.com/Tech-Voyage-Dev/nodewarden hoặc kho lưu trữ gốc https://github.com/shuaiplus/nodewarden trên GitHub.

- Bật Workflow "Sync Upstream".

Giai đoạn 2: Triển khai (Deploy) lên Cloudflare
- Tạo một ứng dụng Worker trong Cloudflare.

- Chọn 'Continue with GitHub' để deploy ứng dụng.


- Chờ một vài phút để Cloudflare build và deploy ứng dụng của bạn. Nó sẽ cung cấp cho bạn một URL mặc định có đuôi
worker.dev.
(Tùy chọn) Thêm Tên miền Tùy chỉnh:
- Trong cài đặt Cloudflare Worker của bạn, hãy vào tab Settings.
- Nhấp vào + Add.
- Nhập tên miền bạn muốn và làm theo hướng dẫn.


Giai đoạn 3: Bảo mật Máy chủ của bạn (Khóa bảo mật JWT)
- Mở trình duyệt web và nhập tên miền tùy chỉnh của bạn hoặc tên miền 'worker.dev' vừa được tạo.
- Bạn sẽ nhận được thông báo 'JWT_SECRET is missing'.

- Sao chép secret key (khóa bí mật) được tạo ra và quay lại tab Settings trên NodeWarden Worker của bạn, sau đó nhấp vào nút '+ Add' trong phần 'Variables and Secrets'.


- Dán chuỗi bí mật vừa tạo vào và nhấp vào nút 'Deploy / Save'.
Giai đoạn 4: Tạo Tài khoản Admin của bạn
- Quay lại trình duyệt web và tải lại (refresh) trang, bạn sẽ thấy trang đăng nhập như sau.

- Nhấp vào 'Create Account' để tạo tài khoản quản trị (admin).

- Đăng nhập vào bảng điều khiển (Dashboard) bằng tài khoản admin vừa được tạo.

- Bây giờ máy chủ của chúng ta đã được deploy và đang hoạt động. Chúng ta sẽ bắt đầu thiết lập các client BitWarden.
Giai đoạn 5: Kết nối Các Thiết bị của bạn
Bạn có thể sử dụng các ứng dụng BitWarden chính thức trên tất cả thiết bị của mình.
Tiện ích mở rộng trên Chrome
- Cài đặt tiện ích mở rộng BitWarden cho Chrome.
- Mở tiện ích mở rộng lên.
- Nhấp vào đường link bên cạnh chữ 'Accessing:' ở dưới cùng của cửa sổ popup.

- Nhập tên miền của máy chủ NodeWarden của bạn vào.

- Lưu các cài đặt và đăng nhập bằng tài khoản của bạn.
Ứng dụng iOS
- Cài đặt ứng dụng BitWarden từ App Store.
- Mở ứng dụng và nhấp vào '' bên cạnh phần 'Logging in on:'.

- Nhập tên miền của máy chủ NodeWarden và nhấp vào nút '✓'.

Các Client Khác
NodeWarden đã được thử nghiệm và xác nhận tương thích với các client BitWarden chính thức sau:
- ✅ Windows desktop
- ✅ Ứng dụng di động Android/iOS
- ✅ Tiện ích mở rộng trình duyệt
- ✅ Linux desktop
- ⚠️ macOS desktop (chưa xác minh hoàn toàn)
Sao lưu Kho lưu trữ (Vault Backup)
NodeWarden cho phép bạn sao lưu vault của mình vào một máy tính cục bộ hoặc lưu trữ từ xa (remote storage hỗ trợ S3 hoặc WebDAV).
Để tự động hóa sao lưu từ xa:
- Cấu hình thông tin lưu trữ từ xa ngay trong bảng điều khiển của NodeWarden.
- Đảm bảo rằng Cron task đã được thiết lập trên cài đặt của Cloudflare Worker để tự động sao lưu từ xa.

Lưu ý Bảo mật Cuối cùng
- Bảo mật quyền truy cập vào tài khoản Cloudflare của bạn, nếu không dữ liệu có thể bị đánh cắp. Hãy kích hoạt Xác thực Hai Yếu tố (2FA) hoặc Passkey trên tài khoản Cloudflare của bạn ngay lập tức.
- Hãy host NodeWarden trên một tài khoản Cloudflare chuyên dụng. Không chia sẻ tài nguyên với các ứng dụng web khác để giảm thiểu các rủi ro về mặt an ninh.
- Bảo mật NodeWarden với Cloudflare
Tham khảo
- Hướng dẫn Bắt đầu NodeWarden Chính thức