---
title: "Cách tự host kho mật khẩu tương thích BitWarden"
description: "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."
canonical_url: "https://techvoyage.dev/vi/article/self-hosting-nodewarden-at-cloudflare"
last_updated: "2026-06-14T11:05:30.310Z"
---

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

<table>
<thead>
  <tr>
    <th>
      <strong>
        <br />
        
        <br />
        
        Tính năng<br />
        
        <br />
      </strong>
    </th>
    
    <th>
      <strong>
        <br />
        
        <br />
        
        BitWarden<br />
        
        <br />
      </strong>
    </th>
    
    <th>
      <strong>
        <br />
        
        <br />
        
        NodeWarden<br />
        
        <br />
      </strong>
    </th>
    
    <th>
      <strong>
        <br />
        
        <br />
        
        Ghi chú<br />
        
        <br />
      </strong>
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Web Vault (Kho lưu trữ Web)
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      <strong>
        Giao diện Web Vault nguyên bản
      </strong>
      
      ​
    </td>
  </tr>
  
  <tr>
    <td>
      Đồng bộ hóa đầy đủ <code>
        /api/sync
      </code>
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      Tối ưu hóa tính tương thích cho các client chính thức
    </td>
  </tr>
  
  <tr>
    <td>
      Upload / tải xuống tệp đính kèm
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      Cloudflare R2 hoặc KV
    </td>
  </tr>
  
  <tr>
    <td>
      Send (Gửi)
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      Hỗ trợ Send cả dạng văn bản và tệp
    </td>
  </tr>
  
  <tr>
    <td>
      Nhập / Xuất (Import/Export)
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      Hỗ trợ nhập (import) JSON / CSV / <strong>
        ZIP kèm tệp đính kèm
      </strong>
      
      ​ của BitWarden
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Trung tâm Sao lưu Đám mây
      </strong>
      
      ​
    </td>
    
    <td>
      ❌
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      <strong>
        Sao lưu định kỳ lên WebDAV / S3
      </strong>
      
      ​
    </td>
  </tr>
  
  <tr>
    <td>
      Gợi ý mật khẩu (web)
    </td>
    
    <td>
      ⚠️ Hạn chế
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      <strong>
        Không yêu cầu email
      </strong>
      
      ​
    </td>
  </tr>
  
  <tr>
    <td>
      TOTP / Steam TOTP
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      Bao gồm hỗ trợ <code>
        steam://
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Nhiều người dùng (Multi-user)
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      Đăng ký theo hình thức thư mời
    </td>
  </tr>
  
  <tr>
    <td>
      Tổ chức / Bộ sưu tập / Phân quyền
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ❌
    </td>
    
    <td>
      Chưa được triển khai
    </td>
  </tr>
  
  <tr>
    <td>
      Đăng nhập 2FA
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ⚠️ Một phần
    </td>
    
    <td>
      Hiện tại chỉ hỗ trợ TOTP cấp người dùng
    </td>
  </tr>
  
  <tr>
    <td>
      SSO / SCIM / Danh bạ doanh nghiệp
    </td>
    
    <td>
      ✅
    </td>
    
    <td>
      ❌
    </td>
    
    <td>
      Chưa được triển khai
    </td>
  </tr>
</tbody>
</table>

### Những gì chúng ta cần:

1. **Một tài khoản GitHub**
2. **Một tài khoản Cloudflare** (Miễn phí) đã kích hoạt Cloudflare R2 Storage.
3. *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

1. Fork kho lưu trữ NodeWarden từ [https://github.com/Tech-Voyage-Dev/nodewarden](https://github.com/Tech-Voyage-Dev/nodewarden) hoặc kho lưu trữ gốc [https://github.com/shuaiplus/nodewarden](https://github.com/shuaiplus/nodewarden) trên GitHub.
![Fork kho lưu trữ NodeWarden trên GitHub](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/fork-nodewarden-repo.webp)
2. Bật Workflow "Sync Upstream".
![Bật quy trình Sync Upstream trong GitHub Actions](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/enable-sync-upstream.webp)

### Giai đoạn 2: Triển khai (Deploy) lên Cloudflare

1. Tạo một ứng dụng Worker trong Cloudflare.<br />

![Tạo ứng dụng Worker mới trong bảng điều khiển Cloudflare](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/create-cloudflare-worker.webp)
2. Chọn 'Continue with GitHub' để deploy ứng dụng.<br />

![Triển khai ứng dụng NodeWarden bằng cách kết nối với GitHub](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/deploy-github-repo.webp)![Tiến trình xây dựng và triển khai Cloudflare Worker](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/cloudflare-deploy-status.webp)
3. 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.<br />

![Điều hướng đến cài đặt tên miền tùy chỉnh trong Cloudflare Worker](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/worker-settings-custom-domain.webp)![Thêm tên miền tùy chỉnh vào Cloudflare Worker](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/add-custom-domain.webp)

### Giai đoạn 3: Bảo mật Máy chủ của bạn (Khóa bảo mật JWT)

1. 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.
2. Bạn sẽ nhận được thông báo '**JWT_SECRET is missing'**.<br />

![Thông báo lỗi JWT_SECRET is missing trên máy chủ NodeWarden](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/jwt-secret-missing-error.webp)
3. 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**'.<br />

![Phần Biến và Bí mật trong cài đặt Cloudflare Worker](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/worker-variables-secrets.webp)![Thêm bí mật JWT đã tạo vào các biến Cloudflare Worker](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/add-jwt-secret.webp)
4. 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

1. 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.<br />

![Trang đăng nhập máy chủ NodeWarden](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/nodewarden-login.webp)
2. Nhấp vào '**Create Account**' để tạo tài khoản quản trị (admin).<br />

![Nhấp vào nút Create Account trên trang đăng nhập NodeWarden](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/create-account-button.webp)
3. Đăng nhập vào bảng điều khiển (Dashboard) bằng tài khoản admin vừa được tạo.<br />

![Tổng quan về bảng điều khiển quản trị NodeWarden](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/nodewarden-dashboard.webp)
4. 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

1. Cài đặt tiện ích mở rộng BitWarden cho Chrome.
2. Mở tiện ích mở rộng lên.
3. Nhấp vào đường link bên cạnh chữ 'Accessing:' ở dưới cùng của cửa sổ popup.<br />

![Chọn tùy chọn tự lưu trữ trong tiện ích mở rộng Bitwarden Chrome](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/bitwarden-extension-self-hosted.webp)
4. Nhập tên miền của máy chủ NodeWarden của bạn vào.<br />

![Nhập URL máy chủ trong tiện ích mở rộng Bitwarden Chrome](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/bitwarden-extension-domain.webp)
5. 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

1. Cài đặt ứng dụng BitWarden từ App Store.
2. Mở ứng dụng và nhấp vào '' bên cạnh phần 'Logging in on:'.<br />

![Truy cập cài đặt tự lưu trữ trong ứng dụng Bitwarden iOS](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/bitwarden-ios-self-hosted.webp)
3. Nhập tên miền của máy chủ NodeWarden và nhấp vào nút '✓'.<br />

![Cấu hình URL máy chủ trong ứng dụng Bitwarden iOS](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/bitwarden-ios-domain.webp)

### 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.<br />

![Cấu hình trình kích hoạt Cron để sao lưu kho tiền tự động trong Cloudflare](https://inimages.techvoyage.dev/articles/Self%20hosting%20NodeWarden%20at%20Cloudflare/cloudflare-worker-cron.webp)

# 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](/article/how-to-secure-nodewarden-at-cloudflare)

# Tham khảo

- Hướng dẫn Bắt đầu NodeWarden Chính thức
