Giới thiệu về Passbolt và Docker Swarm

Trong môi trường doanh nghiệp hiện đại, việc quản lý và chia sẻ mật khẩu nội bộ một cách an toàn là bài toán sống còn đối với bộ phận IT và DevOps. Các giải pháp Cloud công cộng thường đi kèm rủi ro rò rỉ dữ liệu hoặc chi phí bản quyền tăng cao theo số lượng người dùng. Chính vì vậy, xu hướng tự làm chủ hạ tầng (Self-hosting) các giải pháp mã nguồn mở đang trở nên mạnh mẽ hơn bao giờ hết.

Passbolt nổi lên như một giải pháp thay thế xuất sắc, được thiết kế chuyên biệt cho các đội ngũ (teams). Khác với các trình quản lý cá nhân, Passbolt xây dựng trên kiến trúc mã hóa bất đối xứng OpenPGP nghiêm ngặt, đảm bảo rằng ngay cả quản trị viên hệ thống (Server Admin) cũng không thể đọc được mật khẩu dạng plain-text của người dùng nếu không có private key tương ứng.

Khi kết hợp Passbolt với Docker Swarm, chúng ta không chỉ có được một hệ thống bảo mật, mà còn sở hữu một hạ tầng có khả năng chịu lỗi cao (High Availability), tự động phục hồi (Self-healing) và dễ dàng mở rộng quy mô (Scaling) chỉ với vài câu lệnh đơn giản.

---

Tại sao nên lựa chọn Passbolt cho Doanh nghiệp?

Passbolt mang lại nhiều lợi thế vượt trội so với các đối thủ thương mại nhờ vào các đặc tính cốt lõi sau:

Mã hóa đầu cuối (E2EE) thực thụ: Quá trình mã hóa và giải mã hoàn toàn diễn ra ở phía Client (thông qua Browser Extension hoặc Mobile App). Dữ liệu truyền lên server luôn là các khối block đã được mã hóa bằng cặp khóa GPG cá nhân.
Mã nguồn mở 100%: Phiên bản Passbolt Community Edition (CE) hoàn toàn miễn phí, không giới hạn tính năng cốt lõi, không giới hạn số lượng user và minh bạch về mặt mã nguồn để kiểm thử bảo mật (Audit).
Cơ chế phân quyền tinh tế: Cho phép chia sẻ mật khẩu theo từng cá nhân, theo nhóm (Groups) hoặc thư mục lồng nhau với các quyền hạn cụ thể (Read, Update, Share).

Lưu ý quan trọng: Do Passbolt phụ thuộc chặt chẽ vào cơ chế mã hóa GPG, việc cấu hình chính xác dịch vụ đồng bộ thời gian (NTP) trên các node thuộc cụm Docker Swarm là bắt buộc để tránh lỗi xác thực khóa.

---

Chuẩn bị Hạ tầng trước khi Triển khai

Để đảm bảo quá trình triển khai hệ thống Passbolt CE diễn ra suôn sẻ trên Docker Swarm, hệ thống của bạn cần đáp ứng các tiêu chuẩn kỹ thuật tối thiểu sau:

Một cụm Docker Swarm đã được khởi tạo (tối thiểu 1 Manager Node và khuyên dùng thêm các Worker Node để phân tán tải).
Hệ thống lưu trữ dùng chung (Shared Storage) như NFS, GlusterFS hoặc Ceph để lưu các volume dữ liệu GPG và JWT giữa các node.
Một tên miền (Domain Name) hợp lệ trỏ về IP Public hoặc IP của bộ cân bằng tải (Load Balancer).
Một máy chủ SMTP (như SendGrid, Mailgun, hoặc Mail Server nội bộ) đang hoạt động ổn định. Passbolt bắt buộc phải có SMTP để gửi link kích hoạt và thiết lập tài khoản cho user.

---

Xây dựng file Cấu hình Docker Swarm Stack

Dưới đây là file cấu hình docker-compose-swarm.yml chuẩn hóa dành cho môi trường Production trên Docker Swarm. File này sử dụng cơ chế lưu trữ Persistent Volume và cấu hình mạng Overlay biệt lập.

version: '3.8'

services:
  db:
    image: mariadb:10.11
    environment:
      MYSQL_RANDOM_ROOT_PASSWORD: "true"
      MYSQL_DATABASE: "passbolt_db"
      MYSQL_USER: "passbolt_user"
      MYSQL_PASSWORD: "Your_Super_Strong_Password_123"
    volumes:
      - db_data:/var/lib/mysql
    networks:
      - passbolt-net
    deploy:
      replicas: 1
      placement:
        constraints:
          - node.role == manager
      restart_policy:
        condition: on-failure

  passbolt:
    image: passbolt/passbolt:latest-ce
    depends_on:
      - db
    environment:
      APP_FULL_BASE_URL: "[https://passbolt.yourdomain.com](https://passbolt.yourdomain.com)"
      DATASOURCES_DEFAULT_HOST: "db"
      DATASOURCES_DEFAULT_USERNAME: "passbolt_user"
      DATASOURCES_DEFAULT_PASSWORD: "Your_Super_Strong_Password_123"
      DATASOURCES_DEFAULT_DATABASE: "passbolt_db"
      # Cấu hình SMTP bắt buộc
      EMAIL_TRANSPORT_DEFAULT_HOST: "smtp.mailgun.org"
      EMAIL_TRANSPORT_DEFAULT_PORT: 587
      EMAIL_TRANSPORT_DEFAULT_TLS: "true"
      EMAIL_TRANSPORT_DEFAULT_USERNAME: "postmaster@yourdomain.com"
      EMAIL_TRANSPORT_DEFAULT_PASSWORD: "your_smtp_password"
      EMAIL_DEFAULT_FROM: "passbolt@yourdomain.com"
      EMAIL_DEFAULT_FROM_NAME: "Passbolt Security System"
    volumes:
      - gpg_volume:/etc/passbolt/gpg
      - jwt_volume:/etc/passbolt/jwt
    ports:
      - "8080:80"
    networks:
      - passbolt-net
    deploy:
      replicas: 1
      restart_policy:
        condition: on-failure

volumes:
  db_data:
    driver: local
  gpg_volume:
    driver: local
  jwt_volume:
    driver: local

etworks:
  passbolt-net:
    driver: overlay

Trong cấu hình trên, dịch vụ MariaDB được ràng buộc chạy cố định trên Node Manager để đảm bảo tính nhất quán dữ liệu nếu bạn sử dụng Local Storage Driver, trong khi dịch vụ Passbolt có thể linh hoạt chuyển đổi giữa các node. Cổng 8080 được ánh xạ ra ngoài để sẵn sàng đứng sau một Reverse Proxy như Nginx, Traefik hoặc HAProxy nhằm xử lý chứng chỉ SSL/TLS.

---

Các bước Triển khai Chi tiết

Bước 1: Khởi tạo Stack trên Swarm

Truy cập vào máy chủ Manager Node thông qua SSH, di chuyển đến thư mục chứa file cấu hình và thực hiện lệnh deploy stack:

docker stack deploy -c docker-compose-swarm.yml passbolt_stack

Kiểm tra trạng thái khởi tạo của các container bằng câu lệnh:

docker stack ps passbolt_stack

Quá trình khởi tạo ban đầu có thể mất từ 1 đến 2 phút do hệ thống cần tạo lập cấu trúc database ban đầu, đồng thời tự động sinh cặp khóa GPG máy chủ nội bộ trong thư mục volume được gắn kết.

Bước 2: Cấu hình Reverse Proxy & SSL

Để đảm bảo an toàn tối đa cho dữ liệu mật khẩu chạy qua môi trường Internet, việc thiết lập giao thức HTTPS là bắt buộc. Bạn nên cấu hình một dịch vụ Reverse Proxy (ví dụ như Traefik hoặc Nginx Proxy Manager) trên cụm Swarm để trỏ tên miền [https://passbolt.yourdomain.com](https://passbolt.yourdomain.com) về cổng 8080 của Stack Passbolt vừa tạo, kèm theo chứng chỉ mã hóa miễn phí từ Let's Encrypt.

Bước 3: Khởi tạo Tài khoản Quản trị viên đầu tiên

Sau khi dịch vụ hiển thị trạng thái Running ổn định, bạn cần thực thi một câu lệnh CLI trực tiếp bên trong container để đăng ký tài khoản Admin tối cao. Trước tiên, tìm ID hoặc tên chính xác của container Passbolt đang chạy bằng lệnh docker ps, sau đó thực hiện lệnh sau:

docker exec su -m -c "/usr/share/php/passbolt/bin/cake passbolt register_user -u admin@yourdomain.com -f "Admin" -l "Sovereign" -r admin" -s /bin/sh www-data

Nếu cấu hình SMTP chính xác, hệ thống sẽ gửi một email kích hoạt. Đồng thời, trên màn hình Terminal cũng sẽ xuất hiện một đường link có định dạng duy nhất như sau:

[https://passbolt.yourdomain.com/setup/install/1eafab88-a17d-4ad8-97af-77a97f5ff552/f097be64-3703-41e2-8ea2-d59cbe1c15bc](https://passbolt.yourdomain.com/setup/install/1eafab88-a17d-4ad8-97af-77a97f5ff552/f097be64-3703-41e2-8ea2-d59cbe1c15bc)

---

Hoàn tất Thiết lập phía Client

Sao chép đường link cài đặt được sinh ra ở bước trước và dán vào trình duyệt web của bạn. Hệ thống sẽ hướng dẫn bạn thực hiện quy trình bảo mật 3 bước bắt buộc:

Cài đặt Tiện ích mở rộng Passbolt (Browser Extension): Có sẵn trên Chrome, Firefox, Edge. Tiện ích này đóng vai trò xử lý các tác vụ mã hóa/giải mã cục bộ nhằm đảm bảo an toàn tuyệt đối.
Tạo Mật khẩu chủ (Passphrase): Đây là mật khẩu dùng để bảo vệ khóa cá nhân của bạn. Hãy lưu giữ thật kỹ, vì Passbolt thiết kế theo kiến trúc Zero-Knowledge nên không một ai, kể cả hệ thống, có thể khôi phục lại mật khẩu chủ này cho bạn.
Tải xuống và Lưu trữ Khóa cá nhân (Private Key): Trình duyệt sẽ tự động tải về một file có đuôi .asc. Đây chính là tấm vé duy nhất giúp bạn đăng nhập tài khoản trên các thiết bị mới hoặc khôi phục dữ liệu khi cài lại máy.

---

Chiến lược Sao lưu và Khôi phục (Backup Strategy)

Đối với một hệ thống lưu trữ tài sản nhạy cảm như Passbolt, việc xây dựng một kịch bản sao lưu tự động là điều tiên quyết. Để đảm bảo khôi phục thành công 100% hệ thống khi có sự cố phần cứng, bạn cần sao lưu định kỳ 3 thành phần cốt lõi sau:

Cơ sở dữ liệu MariaDB: Sử dụng lệnh sao lưu tiêu chuẩn mysqldump trích xuất ra file định dạng .sql định kỳ hàng ngày.
Thư mục Khóa máy chủ (GPG Keys): Bản sao lưu toàn bộ nội dung trong volume gpg_volume (chứa các file khóa của server dùng để xác thực hệ thống).
Cấu hình JWT (JSON Web Tokens): Bản sao lưu thư mục jwt_volume phục vụ cho việc duy trì các phiên đăng nhập bảo mật giữa ứng dụng và API.

---

Lời kết

Triển khai Passbolt trên Docker Swarm là giải pháp tối ưu giúp doanh nghiệp của bạn sở hữu một nền tảng quản lý mật khẩu cấp độ doanh nghiệp (Enterprise-grade) cực kỳ an toàn, có khả năng mở rộng tốt mà vẫn tiết kiệm chi phí tối đa. Bằng cách tự host hệ thống này, bạn đã tiến một bước dài trong việc bảo vệ tài sản số cốt lõi và củng cố vững chắc chính sách an toàn thông tin nội bộ cho tổ chức của mình.

Tự Host Nền Tảng Chia Sẻ Mật Khẩu An Toàn Passbolt Bản Mã Nguồn Mở Trên Docker Swarm