Hướng dẫn triển khai Vaultwarden cho doanh nghiệp bảo mật tối đa với HTTPS đầu cuối qua Let's Encrypt
Đây là hướng dẫn chi tiết triển khai Vaultwarden, một dịch vụ quản lý mật khẩu mã nguồn mở tương thích với Bitwarden, trên môi trường doanh nghiệp với bảo mật tối đa thông qua HTTPS...
Nguồn ảnh: Tumisu · Pixabay Content License
Đây là hướng dẫn chi tiết triển khai Vaultwarden, một dịch vụ quản lý mật khẩu mã nguồn mở tương thích với Bitwarden, trên môi trường doanh nghiệp với bảo mật tối đa thông qua HTTPS đầu cuối sử dụng chứng chỉ Let's Encrypt. Hướng dẫn bao gồm thiết lập VPS, cấu hình reverse proxy, tự động cấp phát và gia hạn chứng chỉ, và bảo vệ toàn bộ hệ thống bằng các biện pháp an toàn như tường lửa, cập nhật định kỳ và phân quyền truy cập. Vaultwarden giúp doanh nghiệp lưu trữ mật khẩu, thông tin đăng nhập và dữ liệu nhạy cảm một cách an toàn, với khả năng truy cập từ mọi nơi qua giao diện web hoặc ứng dụng di động, đồng thời đảm bảo tính bảo mật cao nhờ vào giao thức HTTPS và xác thực đầu cuối.
Yêu cầu và chuẩn bị môi trường
Để triển khai Vaultwarden, bạn cần một máy chủ VPS có sẵn (khuyến nghị sử dụng Cloud VPS tại DPTCloud với khả năng chống DDoS L3/L4/L7 và SLA 99.98% như trong hệ thống phòng thủ mạng), hệ điều hành Linux (Ubuntu 20.04+ hoặc Debian 11+), và quyền truy cập root. Ngoài ra, cần một tên miền chính thức (ví dụ: vaultwarden.yourcompany.com) được trỏ đến địa chỉ IP của VPS. Trước khi bắt đầu, hãy đảm bảo rằng bạn đã cập nhật hệ thống và cài đặt các công cụ cần thiết:
sudo apt update && sudo apt upgrade -y
sudo apt install docker.io docker-compose -y
Chứng chỉ Let's Encrypt sẽ được cấp qua Let's Encrypt ACME và được quản lý tự động bằng Traefik hoặc Nginx với plugin acme.sh. Việc triển khai này đảm bảo HTTPS đầu cuối được thiết lập mà không cần cấu hình tay, giảm rủi ro sai sót và bảo vệ dữ liệu trong quá trình truyền tải.
Triển khai Vaultwarden với Traefik và Let's Encrypt
Để triển khai Vaultwarden an toàn, chúng ta sử dụng Docker Compose kết hợp với Traefik làm reverse proxy, cho phép tự động cấp phát và gia hạn chứng chỉ Let's Encrypt. Tạo tệp docker-compose.yml với nội dung sau:
version: '3.8'
services:
vaultwarden:
image: vaultwarden/server:latest
container_name: vaultwarden
restart: unless-stopped
environment:
- ROCKET_ADDRESS=0.0.0.0
- ROCKET_PORT=80
- DOMAIN=https://vaultwarden.yourcompany.com
- SIGNUPS_ALLOWED=false
- ADMIN_TOKEN=your_admin_token
- LOG_LEVEL=info
volumes:
- ./data:/data
networks:
- vaultwarden-net
labels:
- "traefik.enable=true"
- "traefik.http.routers.vaultwarden.rule=Host(`vaultwarden.yourcompany.com`)"
- "traefik.http.routers.vaultwarden.entrypoints=websecure"
- "traefik.http.routers.vaultwarden.tls=true"
- "traefik.http.routers.vaultwarden.tls.certresolver=letsencrypt"
- "traefik.http.routers.vaultwarden.service=vaultwarden"
- "traefik.http.services.vaultwarden.loadbalancer.server.port=80"
traefik:
image: traefik:latest
container_name: traefik
restart: unless-stopped
ports:
- "80:80"
- "443:443"
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
- ./traefik:/etc/traefik
command:
- "--providers.docker=true"
- "--providers.docker.exposedbydefault=false"
- "--entrypoints.web.address=:80"
- "--entrypoints.websecure.address=:443"
- "--certificatesresolvers.letsencrypt.acme.email=your-email@example.com"
- "--certificatesresolvers.letsencrypt.acme.storage=/etc/traefik/acme.json"
- "--certificatesresolvers.letsencrypt.acme.httpchallenge=true"
- "--certificatesresolvers.letsencrypt.acme.httpchallenge.entrypoint=web"
networks:
- vaultwarden-net
networks:
vaultwarden-net:
driver: bridge
Thay thế [email protected] bằng địa chỉ email hợp lệ để nhận thông báo từ Let's Encrypt. Tên miền vaultwarden.yourcompany.com phải được trỏ đến IP VPS. Tệp traefik/traefik.yml cần được tạo với cấu hình tương ứng để kích hoạt ACME HTTP challenge. Sau khi khởi động, Traefik sẽ tự động cấp phát chứng chỉ Let's Encrypt và gia hạn tự động mỗi 60 ngày.
Thiết lập bảo mật bổ sung
Để tăng cường bảo mật, hãy thực hiện các bước sau:
- Tường lửa: Cài đặt
ufwvà mở các cổng cần thiết (80, 443, 22). Ví dụ:sudo ufw allow 80,443/tcp. - Phân quyền truy cập: Đặt
SIGNUPS_ALLOWED=falseđể chỉ người quản trị có thể tạo tài khoản mới. Sử dụngADMIN_TOKENđể truy cập giao diện quản trị. - Cập nhật định kỳ: Theo dõi phiên bản Vaultwarden mới nhất và cập nhật thường xuyên bằng lệnh
docker-compose pullvàdocker-compose up -d. - Backup dữ liệu: Sao lưu thư mục
/datađịnh kỳ. Có thể kết hợp với giải pháp sao lưu tự động từ VPS về NAS gia đình như trong bài viết về Kopia và SFTP.
Xác minh và kiểm tra
Sau khi triển khai, kiểm tra tính năng bằng cách truy cập https://vaultwarden.yourcompany.com qua trình duyệt. Giao diện quản trị sẽ hiển thị nếu ADMIN_TOKEN đúng. Kiểm tra chứng chỉ HTTPS bằng công cụ như SSL Labs để đảm bảo chứng chỉ Let's Encrypt được cấp và không có lỗi bảo mật.
Để kiểm tra việc gia hạn chứng chỉ, bạn có thể chạy lệnh sau trên VPS:
sudo docker-compose logs traefik | grep "Certificates managed"
Chứng chỉ sẽ được gia hạn tự động nếu còn dưới 30 ngày. Nếu có lỗi, kiểm tra log của Traefik và đảm bảo tên miền được trỏ đúng.
Giải quyết sự cố
Nếu không thể truy cập, hãy kiểm tra:
- Tên miền có được trỏ đến đúng IP VPS không (sử dụng
nslookup vaultwarden.yourcompany.com). - Traefik có chạy và ghi nhận dịch vụ Vaultwarden không (xem log bằng
docker-compose logs traefik). - Chứng chỉ Let's Encrypt có bị từ chối do lỗi HTTP challenge không (kiểm tra cổng 80 có mở và không bị chặn bởi tường lửa).
- Phiên bản Docker và Docker Compose có hỗ trợ đầy đủ các tính năng không (nên dùng phiên bản mới nhất).
Đối với lỗi liên quan đến chứng chỉ, xóa tệp acme.json trong thư mục traefik và khởi động lại Traefik để cấp phát lại.
Tài liệu tham khảo
Cấu hình Cloud VPS NVMe khuyến nghị để triển khai
SSD NVMe Enterprise RAID 10, đường truyền CMC & FPT Quận 9 chống DDoS Anycast, Uptime SLA 99.99%.
VPS-3E
Đã gồm VAT 10%
- CPU: 2 vCPU
- RAM: 4 GB
- SSD: 50 GB NVMe
