System & Network Vaultwarden
Bài 19 · Giai đoạn 3 — Bảo mật & Truy cập

Triển khai Vaultwarden Password Manager

Quản lý mật khẩu tự lưu trữ — compatible với Bitwarden client.

VM243 · node1 Ubuntu Server 24.04 LTS 10.11.25.43 2 vCPU · 2 GB · 20 GB

Bối cảnh & Lý do triển khai

Vị trí trong chuỗi bài: Bài 19 thuộc Giai đoạn 3 — Bảo mật & Truy cập, nối tiếp Bài 18. privacyIDEA MFA và đứng trước Bài 20. Headscale VPN.
Mức độ cần thiết: 🟡 Quan trọng — Quản lý credentials tập trung cho team

Đội IT quản lý hàng chục credentials (server root password, API key, database password...). Nếu lưu trong Excel, file text, hoặc chat — không kiểm soát được ai đang biết gì, không có audit log, và khi nhân viên nghỉ không biết credentials nào đã bị lộ. Vaultwarden là Bitwarden self-hosted: vault mã hóa end-to-end, browser extension autofill, chia sẻ theo organization.

MụcNội dung
Ứng dụng trong DNShared team vault, password rotation reminder, SSH key storage, API token management
Tác dụng chínhBrowser extension (Chrome/Firefox/Edge), mobile app, organization collections, audit log truy cập
Nếu không triển khaiCredentials phân tán, không kiểm soát được, nguy cơ data leak khi nhân sự thay đổi
Các service phụ thuộc vào đâySử dụng bởi IT team để lưu credentials của tất cả service trong lab

Ngày cập nhật: 2026-10-15 (hệ điều hành Ubuntu Server 24.04 LTS; phiên bản phần mềm đã xác minh ngày 2026-10-15, xem bảng "Phiên bản phần mềm sử dụng" ở mục 1)
Người thực hiện: hoatv
Môi trường: HOATRANLABS – PVE 9.2.20

Danh sách máy chủ & IP liên quan

Bảng dưới liệt kê các máy chủ mà bài này tạo hoặc kết nối tới. Địa chỉ, VMID, VLAN và node lấy từ bảng quy hoạch chung của lab, dùng thống nhất cho cả bộ bài lab.

Máy chủIPVLAN · NodeVai trò trong bài này
vaultwarden (Vaultwarden) · VM24310.11.25.4325 (SEC) · node1Máy chủ của bài — chạy Vaultwarden bằng Docker Compose sau Nginx reverse proxy; web vault và /admin qua HTTPS cổng 443.
node1 (Proxmox VE)10.11.45.21045 (MGMT) · cluster HOATRANHUBNode Proxmox chứa VM243; tạo VM (qm create) tại đây.
mailu (Mailu Mail Server) · VM24610.11.35.4635 (DMZ) · node2Relay SMTP cổng 587 (STARTTLS) với mailbox noreply@ để Vaultwarden gửi email mời người dùng (bài 16).
step-ca (step-CA PKI) · VM24210.11.25.4225 (SEC) · node1Cấp chứng chỉ TLS cho Vaultwarden bằng step ca certificate, gia hạn qua systemd timer; client import root CA (bài 13).
pihole (Pi-hole DNS) · VM24710.11.45.5345 (MGMT) · node3DNS của VM và nơi thêm bản ghi vaultwarden.hoatranlabs.local về 10.11.25.43 (Admin UI, Local DNS; bài 12).
prometheus (Prometheus + Alertmanager) · VM23510.11.45.3545 (MGMT) · node2Scrape node_exporter cổng 9100 trên VM243; UFW chỉ cho phép Prometheus truy cập (bài 15).
FortiGate (firewall)10.100.100.1Quản trị 10.100.100.0/24 · thiết bị mạngPolicy từ VLAN_MGMT sang VLAN_SEC cho HTTPS 443 tới Vaultwarden khi cần truy cập từ VLAN khác (mục 9.2).
pbs01 (PBS Primary) · VM10110.11.45.1745 (MGMT) · node4Sao lưu VM243 tự động vào storage pbs-primary, không cần cấu hình thêm nếu đã có policy (bài 04).

Gateway của mỗi VLAN là địa chỉ .1. Tên DNS nội bộ do Pi-hole phân giải (bài 12). Tên in đậm là hostname; FQDN = hostname + .hoatranlabs.local.

01

Tổng quan

Vaultwarden là implementation mã nguồn mở của Bitwarden Server, viết bằng Rust. Nhẹ hơn bản gốc Bitwarden Server rất nhiều (chỉ cần ~100 MB RAM ở trạng thái idle), phù hợp với homelab và môi trường doanh nghiệp vừa và nhỏ.

Chức năng chính:

  • Lưu trữ và đồng bộ mật khẩu, 2FA TOTP codes, secure notes, thẻ tín dụng
  • Chia sẻ mật khẩu trong tổ chức qua Organizations
  • Client: Bitwarden browser extension (Chrome, Firefox, Edge) + mobile app (iOS/Android)
  • Admin panel tại /admin để quản lý user, tổ chức, audit log

Yêu cầu bắt buộc: TLS/HTTPS — Bitwarden browser extension từ chối kết nối HTTP thuần. Cert sẽ được cấp từ step-CA nội bộ (VM242).

Thông số VM:

Thuộc tínhGiá trị
VMID243
Hostnamevaultwarden
Nodenode1 (10.11.45.210)
VLANVLAN_SEC tag=25
IP10.11.25.43/24
Gateway10.11.25.1
DNS10.11.45.53 (Pi-hole)
vCPU2
RAM2 GB
Disk20 GB (vm-ceph)
OSUbuntu Server 24.04 LTS (24.04.5)

Phiên bản phần mềm sử dụng (đã xác minh ngày 2026-10-15; số bản sẽ tăng theo thời gian, bài ghi lại bản đã kiểm để các bước khớp nhau):

Thành phầnPhiên bảnGhi chú
Ubuntu Server24.04.5 LTS (noble)ISO ubuntu-24.04.5-live-server-amd64.iso (https://releases.ubuntu.com/24.04/); hỗ trợ chuẩn tới 04/2029
Docker Engine + ComposeDocker 29.9.1, Compose plugin 5.6.0 (kho download.docker.com/linux/ubuntu, suite noble)Bản stable mới nhất trong kho noble lúc kiểm; dùng lệnh docker compose
Vaultwarden1.37.4 (image vaultwarden/server:latest)Bài dùng tag latest; 1.37.4 là bản mới nhất lúc kiểm (2026-10-05). Từ 1.37.2 trở lên là bắt buộc với client Bitwarden 2026.8.0+
Nginx1.24.0 (kho Ubuntu noble)Dùng listen 443 ssl http2; (http2 on; cần Nginx 1.25.1 trở lên)
step-cli0.31.0Gói .deb từ GitHub smallstep/cli
node_exporter1.12.1Cài bằng script ở bài 15
02

Tạo VM trên Proxmox

Tạo VM trên Proxmox · Khởi động VM và cài Ubuntu · Cấu hình sau khi cài xong

2.1 Tạo VM trên Proxmox

Cách 1: Web UI Proxmox (GUI)

1
Đăng nhập Proxmox Web UI → chọn Node: node1 → nhấn Create VM (góc trên phải)
2
General:
  • VM ID: 243
  • Name: vaultwarden
  • Bỏ tick Start after created
3
OS:
  • Storage: local (hoặc nơi chứa ISO)
  • ISO Image: ubuntu-24.04.5-live-server-amd64.iso
  • Guest OS Type: Linux, Version: 6.x - 2.6 Kernel
4
System:
  • Machine: q35
  • SCSI Controller: VirtIO SCSI single
  • BIOS: SeaBIOS
  • Qemu Agent: ☑
5
Disks:
  • Bus/Device: SCSI 0, Storage: vm-ceph
  • Disk size: 20 GiB, Cache: Write back, Discard: ☑
6
CPU:
  • Sockets: 1, Cores: 2, Type: x86-64-v2-AES
7
Memory:
  • Memory (MiB): 2048
8
Network:
  • Bridge: vmbr0, VLAN Tag: 25, Model: VirtIO (paravirtualized), Firewall: ☐
9
Confirm: Xem lại → Finish → Start VM → Console để bắt đầu cài Ubuntu.
Proxmox Create VM → tab Confirm: VM 243 vaultwarden trên node1, 2 core, 2048 MiB, đĩa vm-ceph 20 GiB, VLAN tag 25.
Proxmox Create VM → tab Confirm: VM 243 vaultwarden trên node1, 2 core, 2048 MiB, đĩa vm-ceph 20 GiB, VLAN tag 25.

Cách 2: CLI (qm create)

Chạy trên node1 (trực tiếp hoặc qua SSH):

qm create 243 --name vaultwarden \
  --memory 2048 \
  --cores 2 \
  --net0 virtio,bridge=vmbr0,tag=25 \
  --scsi0 vm-ceph:20 \
  --scsihw virtio-scsi-pci \
  --ide2 local:iso/ubuntu-24.04.5-live-server-amd64.iso,media=cdrom \
  --boot "order=ide2;scsi0" \
  --ostype l26 \
  --agent enabled=1

2.2 Khởi động VM và cài Ubuntu

# Bật VM
qm start 243

# Mở console qua Proxmox Web UI (VM 243 → Console).
# (qm terminal 243 chỉ dùng được khi VM có cổng serial, --serial0 socket; lệnh qm create ở trên không tạo cổng này)

Trong quá trình cài Ubuntu Server:

  • Language: English
  • Keyboard: English (US)
  • Network: card mạng (thường ens18, hoặc enp6s18 trên VM q35; kiểm tra bằng ip -br link) → Manual → IP: 10.11.25.43/24, GW: 10.11.25.1, DNS: 10.11.45.53
  • Hostname: vaultwarden
  • Username: sysadmin
  • Bật OpenSSH server (tích chọn trong installer)
  • Không cài snap packages thêm (màn hình Featured Server Snaps để trống)

2.3 Cấu hình sau khi cài xong

# Kết nối SSH
ssh [email protected]

# Update hệ thống (Ubuntu 24.04: nếu needrestart hiện hộp thoại "Daemons using outdated libraries" thì nhấn Enter)
sudo apt update && sudo apt upgrade -y

# Cài QEMU guest agent (để Proxmox đọc IP, shutdown sạch)
sudo apt install -y qemu-guest-agent
sudo systemctl enable --now qemu-guest-agent

# Thiết lập timezone
sudo timedatectl set-timezone Asia/Ho_Chi_Minh

# Kiểm tra network
ip -br addr show        # tên card (ens18 hoặc enp6s18) và IP 10.11.25.43/24
ping -c 3 10.11.45.53
Terminal VM243: ip -br addr show hiện card mạng (ens18 hoặc enp6s18) với 10.11.25.43/24 và ping 10.11.45.53 (Pi-hole) trả lời, 0% packet loss.
Terminal VM243: ip -br addr show hiện card mạng (ens18 hoặc enp6s18) với 10.11.25.43/24 và ping 10.11.45.53 (Pi-hole) trả lời, 0% packet loss.
03

Cài đặt Docker và Docker Compose

# Gỡ gói xung đột nếu có (máy mới cài thường chưa có gói nào trong danh sách)
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc | cut -f1)

# Cài prerequisites
sudo apt update
sudo apt install -y ca-certificates curl

# Thêm Docker GPG key (dạng .asc, dùng với Signed-By; không dùng apt-key)
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Thêm Docker repo (deb822, suite noble của Ubuntu 24.04)
sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null << EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

# Cài Docker Engine
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin

# Thêm user vào group docker (tránh phải sudo mỗi lần)
sudo usermod -aG docker sysadmin
newgrp docker

# Kiểm tra (kỳ vọng Docker 29.x và Compose plugin 5.x)
docker --version
docker compose version

Kho Docker cho Ubuntu 24.04 có suite noble (https://docs.docker.com/engine/install/ubuntu/). Docker 29.9.1 và Compose plugin 5.6.0 là bản mới nhất trong kho noble lúc kiểm (2026-10-15).

04

Tạo Admin Token

Vaultwarden chỉ chấp nhận ADMIN_TOKEN dạng plain text hoặc chuỗi Argon2 (PHC) — không hỗ trợ bcrypt (chuỗi $2y$... sẽ bị coi là plain text). Nên dùng Argon2 để không lưu mật khẩu dạng rõ; tạo trước khi viết compose file (Docker đã cài ở mục 3).

# Tạo Argon2 hash bằng lệnh có sẵn trong image Vaultwarden; nhập mật khẩu admin (2 lần) khi được hỏi
docker run --rm -it vaultwarden/server /vaultwarden hash

Kết quả có dạng: $argon2id$v=19$m=65540,t=3,p=4$... — copy toàn bộ chuỗi này vào biến ADMIN_TOKEN ở bước tiếp theo (đặt trong dấu nháy đơn '...' trong file .env).

Lưu ý bảo mật: Không commit admin token vào git. Lưu vào password manager (chính Vaultwarden sau khi setup xong) hoặc Bitwarden local export.
05

Triển khai Vaultwarden bằng Docker Compose

Tạo thư mục và file compose · Tạo file .env · Tạo file docker-compose.yml

5.1 Tạo thư mục và file compose

sudo mkdir -p /opt/vaultwarden
sudo chown sysadmin:sysadmin /opt/vaultwarden
cd /opt/vaultwarden

5.2 Tạo file .env

cat > /opt/vaultwarden/.env << 'EOF'
DOMAIN=https://vaultwarden.hoatranlabs.local
SIGNUPS_ALLOWED=false
INVITATIONS_ALLOWED=true
ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$REPLACE_WITH_YOUR_ARGON2_HASH'
LOG_LEVEL=warn
# SMTP relay Mailu (bài 16, mục 8.3): mailbox noreply@ có xác thực, cổng 587 STARTTLS
SMTP_HOST=mailu.hoatranlabs.local
[email protected]
SMTP_PORT=587
SMTP_SECURITY=starttls
[email protected]
SMTP_PASSWORD=Noreply@Mailu2024!
EOF

5.3 Tạo file docker-compose.yml

cat > /opt/vaultwarden/docker-compose.yml << 'EOF'
services:
  vaultwarden:
    image: vaultwarden/server:latest
    container_name: vaultwarden
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:80"
    env_file:
      - .env
    environment:
      # Bundle CA (CA công cộng + root CA step-CA) để xác thực chứng chỉ Mailu khi gửi SMTP STARTTLS: xem 5.5
      - SSL_CERT_FILE=/etc/ssl/hoatranlabs-ca-bundle.crt
    volumes:
      - vaultwarden_data:/data
      - /etc/ssl/certs/ca-certificates.crt:/etc/ssl/hoatranlabs-ca-bundle.crt:ro
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost/"]
      interval: 30s
      timeout: 10s
      retries: 3

volumes:
  vaultwarden_data:
    driver: local
EOF
Compose v2 trở lên không còn dùng khóa version: (khai báo sẽ bị cảnh báo "attribute version is obsolete") nên file không có dòng này. Port 8080 bind vào 127.0.0.1 vì Nginx sẽ reverse proxy từ localhost. WebSocket (live sync) chạy chung cổng web này: từ Vaultwarden 1.31 cổng riêng 3012 và biến WEBSOCKET_ENABLED/WEBSOCKET_PORT không còn tác dụng (image latest), chỉ cần Nginx chuyển tiếp header Upgrade/Connection (mục 7.2).

5.4 Khởi động container

cd /opt/vaultwarden
docker compose pull
docker compose up -d
docker compose logs -f --tail=50

Kiểm tra container running:

docker compose ps
# Expected: vaultwarden   Up   127.0.0.1:8080->80/tcp
Terminal /opt/vaultwarden: docker compose ps cho thấy container vaultwarden ở trạng thái Up, cổng 127.0.0.1:8080->80/tcp.
Terminal /opt/vaultwarden: docker compose ps cho thấy container vaultwarden ở trạng thái Up, cổng 127.0.0.1:8080->80/tcp.

5.5 Tin cậy root CA step-CA trong container (SMTP STARTTLS tới Mailu)

Vaultwarden gửi email qua Mailu (mailu.hoatranlabs.local:587, STARTTLS) và kiểm tra chứng chỉ của Mailu do step-CA ký (bài 16 mục 3). Image vaultwarden/server chỉ chứa CA công cộng nên không tin root CA của lab: nếu để nguyên, việc gửi mail báo lỗi chứng chỉ (unknown issuer / certificate verify failed). Không dùng SMTP_ACCEPT_INVALID_CERTS=true để né lỗi, vì .env.template của Vaultwarden gọi đây là tùy chọn nguy hiểm (tắt xác thực chứng chỉ, mở đường cho tấn công man-in-the-middle).

Cách đúng là đặt biến SSL_CERT_FILE trỏ tới một file bundle gồm CA công cộng cộng thêm root CA step-CA; thư viện TLS của Vaultwarden (rustls-native-certs hoặc OpenSSL tùy phiên bản) đều đọc biến này. Với rustls-native-certs, khi SSL_CERT_FILE được đặt thì chứng chỉ được đọc từ file đó thay cho kho mặc định, nên file phải có đủ cả hai nhóm (https://docs.rs/rustls-native-certs/latest/rustls_native_certs/). Bundle của chính VM243, /etc/ssl/certs/ca-certificates.crt, đã đúng như vậy sau khi update-ca-certificates ở mục 6.2 thêm hoatranlabs-root.crt, nên compose ở 5.3 mount nó (chỉ đọc) vào container và đặt SSL_CERT_FILE trỏ tới. Vì update-ca-certificates ghi file mới, container phải được tạo lại sau 6.2 (lệnh docker compose up -d --force-recreate ở cuối mục 6.2) để mount lấy bản có root CA.

06

Cấp chứng chỉ TLS từ step-CA

Cài step-cli · Bootstrap CA root cert · Yêu cầu cert cho vaultwarden.hoatranlabs.local

6.1 Cài step-cli

# Download step-cli (gói .deb, cài ra /usr/bin/step)
STEP_VERSION="0.31.0"
wget https://github.com/smallstep/cli/releases/download/v${STEP_VERSION}/step-cli_${STEP_VERSION}-1_amd64.deb
sudo dpkg -i step-cli_${STEP_VERSION}-1_amd64.deb
step version
command -v step     # kỳ vọng /usr/bin/step (đường dẫn dùng trong ExecStart ở 6.4; cần kiểm lại trên máy thật)

6.2 Bootstrap CA root cert

# Fingerprint root CA (64 ký tự hex) đã ghi lại ở bài 13 Bước 5 (step certificate fingerprint /etc/step-ca/certs/root_ca.crt trên VM242).
# Phải lấy từ nguồn tin cậy, KHÔNG tính từ root vừa tải về chưa xác thực (vòng tròn, mất tác dụng kiểm tra)
CA_FINGERPRINT="<fingerprint-cua-step-CA>"

# Bootstrap từ step-CA server (VM242); step ca bootstrap/step ca root đều xác minh root CA theo --fingerprint
step ca bootstrap \
  --ca-url https://step-ca.hoatranlabs.local:9000 \
  --fingerprint "${CA_FINGERPRINT}" \
  --install

# bootstrap chỉ lưu root CA ở $(step path)/certs/root_ca.crt; đặt thêm bản sao ở đường dẫn chuẩn của lab
# (6.3 và 6.4 dùng file này qua --root)
sudo cp "$(step path)/certs/root_ca.crt" /usr/local/share/ca-certificates/hoatranlabs-root.crt
sudo update-ca-certificates

# Container Vaultwarden dùng bundle /etc/ssl/certs/ca-certificates.crt của host (5.5): tạo lại container để mount nhận bản đã có root CA
cd /opt/vaultwarden && docker compose up -d --force-recreate

# Kiểm tra bundle xác thực được chứng chỉ SMTP của Mailu; kỳ vọng: Verify return code: 0 (ok)
openssl s_client -starttls smtp -connect mailu.hoatranlabs.local:587 \
  -servername mailu.hoatranlabs.local -CAfile /etc/ssl/certs/ca-certificates.crt \
  </dev/null 2>/dev/null | grep "Verify return code"
Nếu chưa biết fingerprint, lấy từ VM242:
ssh [email protected] "cat /etc/step-ca/certs/root_ca.crt" | \
  step certificate fingerprint /dev/stdin

6.3 Yêu cầu cert cho vaultwarden.hoatranlabs.local

sudo mkdir -p /etc/ssl/vaultwarden

sudo step ca certificate "vaultwarden.hoatranlabs.local" \
  /etc/ssl/vaultwarden/vaultwarden.crt \
  /etc/ssl/vaultwarden/vaultwarden.key \
  --ca-url https://step-ca.hoatranlabs.local:9000 \
  --root /usr/local/share/ca-certificates/hoatranlabs-root.crt \
  --san "vaultwarden.hoatranlabs.local" \
  --san "10.11.25.43"

sudo chmod 640 /etc/ssl/vaultwarden/vaultwarden.key
sudo chown root:www-data /etc/ssl/vaultwarden/vaultwarden.key
Terminal VM243: step ca certificate cấp cert vaultwarden.hoatranlabs.local (SAN 10.11.25.43), lưu .crt/.key trong /etc/ssl/vaultwarden/.
Terminal VM243: step ca certificate cấp cert vaultwarden.hoatranlabs.local (SAN 10.11.25.43), lưu .crt/.key trong /etc/ssl/vaultwarden/.

6.4 Tự động renew cert (systemd timer)

sudo tee /etc/systemd/system/vaultwarden-cert-renew.service << 'EOF'
[Unit]
Description=Renew Vaultwarden TLS certificate

[Service]
Type=oneshot
ExecStart=/usr/bin/step ca renew \
  /etc/ssl/vaultwarden/vaultwarden.crt \
  /etc/ssl/vaultwarden/vaultwarden.key \
  --ca-url https://step-ca.hoatranlabs.local:9000 \
  --root /usr/local/share/ca-certificates/hoatranlabs-root.crt \
  --force
ExecStartPost=/bin/systemctl reload nginx
EOF

sudo tee /etc/systemd/system/vaultwarden-cert-renew.timer << 'EOF'
[Unit]
Description=Daily Vaultwarden cert renewal check

[Timer]
OnCalendar=daily
RandomizedDelaySec=1h
Persistent=true

[Install]
WantedBy=timers.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now vaultwarden-cert-renew.timer
07

Cấu hình Nginx Reverse Proxy

Cài Nginx · Tạo virtual host cho Vaultwarden

7.1 Cài Nginx

sudo apt install -y nginx
sudo systemctl enable nginx

7.2 Tạo virtual host cho Vaultwarden

sudo tee /etc/nginx/sites-available/vaultwarden << 'EOF'
# Cho phép nâng cấp kết nối lên WebSocket (live sync)
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      "";
}

server {
    listen 80;
    server_name vaultwarden.hoatranlabs.local;
    return 301 https://$host$request_uri;
}

server {
    # Nginx 1.24.0 của Ubuntu 24.04 (apt) dùng cú pháp "ssl http2" này. Từ Nginx 1.25.1 tham số http2 của listen bị coi là lỗi thời:
    # đổi thành "listen 443 ssl;" kèm dòng "http2 on;" (trên Nginx 1.24 dòng "http2 on;" gây lỗi unknown directive)
    listen 443 ssl http2;
    server_name vaultwarden.hoatranlabs.local;

    ssl_certificate     /etc/ssl/vaultwarden/vaultwarden.crt;
    ssl_certificate_key /etc/ssl/vaultwarden/vaultwarden.key;
    ssl_protocols       TLSv1.2 TLSv1.3;
    ssl_ciphers         HIGH:!aNULL:!MD5;
    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 10m;

    # Security headers
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    add_header X-Content-Type-Options nosniff;
    add_header X-Frame-Options SAMEORIGIN;

    client_max_body_size 128M;

    # Main app (kèm WebSocket live sync: chạy chung cổng 8080, cần chuyển tiếp header Upgrade/Connection)
    location / {
        proxy_pass         http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade           $http_upgrade;
        proxy_set_header   Connection        $connection_upgrade;
        proxy_set_header   Host              $host;
        proxy_set_header   X-Real-IP         $remote_addr;
        proxy_set_header   X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
        proxy_read_timeout 90;
    }
}
EOF

# Kích hoạt site
sudo ln -s /etc/nginx/sites-available/vaultwarden /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
Terminal VM243: nginx -t báo syntax is ok và test is successful, sau đó systemctl reload nginx chạy không lỗi.
Terminal VM243: nginx -t báo syntax is ok và test is successful, sau đó systemctl reload nginx chạy không lỗi.
08

Cấu hình DNS

Thêm bản ghi DNS vào Pi-hole (VM247). Pi-hole chạy trong Docker (bài 12), nên thêm record qua Admin UI: http://10.11.45.53/admin → Settings → Local DNS Records:

vaultwarden.hoatranlabs.local    →    10.11.25.43

Kiểm tra phân giải từ client:

nslookup vaultwarden.hoatranlabs.local 10.11.45.53
# Expected: Address: 10.11.25.43
Terminal client: nslookup vaultwarden.hoatranlabs.local 10.11.45.53 trả về Address 10.11.25.43.
Terminal client: nslookup vaultwarden.hoatranlabs.local 10.11.45.53 trả về Address 10.11.25.43.
09

Cấu hình Firewall

UFW trên VM243 · FortiGate policy (nếu cần access từ VLAN khác)

9.1 UFW trên VM243

sudo ufw allow ssh
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
# node_exporter (cài theo bài 15, Bước 5): chỉ cho Prometheus VM235 scrape
sudo ufw allow from 10.11.45.35 to any port 9100 proto tcp
sudo ufw enable
sudo ufw status

9.2 FortiGate policy (nếu cần access từ VLAN khác)

Tạo policy: VLAN_MGMT (10.11.45.0/24) → VLAN_SEC (10.11.25.43):

  • Source: VLAN_MGMT subnet
  • Destination: vaultwarden.hoatranlabs.local (10.11.25.43)
  • Service: HTTPS (443)
  • Action: ACCEPT
10

Khởi tạo Admin và Tạo User đầu tiên

Truy cập Admin Panel · Tạo invite cho user đầu tiên · Tạo Organization

10.1 Truy cập Admin Panel

https://vaultwarden.hoatranlabs.local/admin

Dùng ADMIN_TOKEN (mật khẩu plain text, không phải hash) để đăng nhập.

Trình duyệt tại https://vaultwarden.hoatranlabs.local/admin: khóa HTTPS hợp lệ (cert step-CA) và ô nhập ADMIN_TOKEN của trang đăng nhập Admin.
Trình duyệt tại https://vaultwarden.hoatranlabs.local/admin: khóa HTTPS hợp lệ (cert step-CA) và ô nhập ADMIN_TOKEN của trang đăng nhập Admin.

10.2 Tạo invite cho user đầu tiên

1
Admin Panel → Users → Invite User
2
Nhập email user (ví dụ: [email protected], mailbox đã tạo ở bài 16 mục 6)
Vaultwarden Admin Panel → Users: ô Invite User với email admin@hoatranlabs.local và user vừa mời hiện trong danh sách.
Vaultwarden Admin Panel → Users: ô Invite User với email [email protected] và user vừa mời hiện trong danh sách.
3
User nhận email từ Mailu → click link → đặt mật khẩu
Nếu chưa có Mailu, có thể tạm thời bật SIGNUPS_ALLOWED=true trong .env, tạo user, rồi tắt lại.

10.3 Tạo Organization

1
Đăng nhập web vault: https://vaultwarden.hoatranlabs.local
2
New Organization → nhập tên tổ chức
3
Invite thành viên vào Organization
4
Tạo Collections (ví dụ: Infrastructure, DevOps, Shared)
Web vault https://vaultwarden.hoatranlabs.local: Organization vừa tạo cùng các Collections Infrastructure, DevOps, Shared.
Web vault https://vaultwarden.hoatranlabs.local: Organization vừa tạo cùng các Collections Infrastructure, DevOps, Shared.
11

Cấu hình Bitwarden Extension

Trên browser của mỗi client:

1
Cài extension Bitwarden từ Chrome Web Store / Firefox Add-ons
2
Mở extension → Settings (biểu tượng cài) → Self-hosted environment
3
Server URL: https://vaultwarden.hoatranlabs.local
Bitwarden extension → Settings → Self-hosted environment: ô Server URL điền https://vaultwarden.hoatranlabs.local trước khi nhấn Save.
Bitwarden extension → Settings → Self-hosted environment: ô Server URL điền https://vaultwarden.hoatranlabs.local trước khi nhấn Save.
4
Save → đăng nhập bằng tài khoản đã tạo
Client cần tin tưởng root CA của hoatranlabs. Import cert root vào OS hoặc browser:
# Download root CA từ step-CA
step ca root root.crt --ca-url https://step-ca.hoatranlabs.local:9000 \
  --fingerprint "<fingerprint-cua-step-CA>"
# Import vào system store (Ubuntu/Debian)
sudo cp root.crt /usr/local/share/ca-certificates/hoatranlabs-root.crt
sudo update-ca-certificates
12

Backup

Backup data volume · Backup qua PBS

12.1 Backup data volume

sudo tee /opt/vaultwarden/backup.sh << 'EOF'
#!/bin/bash
BACKUP_DIR="/var/backups/vaultwarden"
DATE=$(date +%Y%m%d_%H%M%S)
mkdir -p "$BACKUP_DIR"

# Stop container để SQLite không bị corrupt
docker compose -f /opt/vaultwarden/docker-compose.yml stop vaultwarden

# Backup data volume
docker run --rm \
  -v vaultwarden_vaultwarden_data:/data:ro \
  -v "$BACKUP_DIR":/backup \
  ubuntu:24.04 tar czf "/backup/vaultwarden_${DATE}.tar.gz" /data

# Restart container
docker compose -f /opt/vaultwarden/docker-compose.yml start vaultwarden

# Xóa backup cũ hơn 7 ngày
find "$BACKUP_DIR" -name "*.tar.gz" -mtime +7 -delete

echo "Backup completed: vaultwarden_${DATE}.tar.gz"
EOF

sudo chmod +x /opt/vaultwarden/backup.sh

# Cron: backup lúc 1:00 AM mỗi ngày
# Chạy bằng root vì script ghi vào /var/backups và /var/log (sysadmin không có quyền ghi hai thư mục này)
echo "0 1 * * * root /opt/vaultwarden/backup.sh >> /var/log/vaultwarden-backup.log 2>&1" | \
  sudo tee /etc/cron.d/vaultwarden-backup

12.2 Backup qua PBS

Trên Proxmox, VM snapshot được backup tự động qua PBS (pbs01, 10.11.45.17; storage pbs-primary). Không cần cấu hình thêm nếu PBS đã có policy cho VMID 243.

13

Troubleshooting

Container không khởi động · Extension báo "Invalid SSL certificate" · WebSocket không kết nối được (live sync không hoạt động)

Container không khởi động

docker compose -f /opt/vaultwarden/docker-compose.yml logs --tail=50
# Kiểm tra ADMIN_TOKEN có đúng định dạng Argon2 ($argon2id$...) và nằm trong dấu nháy đơn trong .env không

Extension báo "Invalid SSL certificate"

# Kiểm tra cert hợp lệ
openssl s_client -connect vaultwarden.hoatranlabs.local:443 -servername vaultwarden.hoatranlabs.local
# Root CA phải được import vào client browser/OS

WebSocket không kết nối được (live sync không hoạt động)

# Kiểm tra Nginx logs
sudo tail -f /var/log/nginx/error.log
# WebSocket chạy chung cổng web (8080 trên host, 80 trong container), không còn cổng 3012:
# đảm bảo Nginx đã chuyển tiếp header Upgrade/Connection (mục 7.2)
sudo nginx -T 2>/dev/null | grep -nE "Upgrade|connection_upgrade"

Admin token bị từ chối

# Tạo lại hash đúng cách (dùng đúng password plain text khi login)
docker run --rm -it vaultwarden/server /vaultwarden hash
# Cập nhật ADMIN_TOKEN trong .env (trong dấu nháy đơn) rồi tạo lại container
cd /opt/vaultwarden && docker compose up -d

Gửi email SMTP báo lỗi chứng chỉ (Mailu)

# Container phải có biến SSL_CERT_FILE và file bundle đã mount (mục 5.5)
docker exec vaultwarden sh -c 'echo "$SSL_CERT_FILE" && ls -l "$SSL_CERT_FILE"'
# Bundle của host phải xác thực được Mailu (kỳ vọng: Verify return code: 0 (ok))
openssl s_client -starttls smtp -connect mailu.hoatranlabs.local:587 \
  -servername mailu.hoatranlabs.local -CAfile /etc/ssl/certs/ca-certificates.crt \
  </dev/null 2>/dev/null | grep "Verify return code"
# Nếu bundle mới nhưng container vẫn lỗi: tạo lại container để mount nhận file mới
cd /opt/vaultwarden && docker compose up -d --force-recreate
# Cần xem chi tiết: đặt tạm SMTP_DEBUG=true trong .env (có thể lộ user/mật khẩu trong log), chạy docker compose up -d rồi xem log
docker compose logs --tail=50
14

Checklist Triển khai

  • VM243 tạo thành công, Ubuntu Server 24.04 LTS cài xong
  • Network: IP 10.11.25.43, ping gateway và DNS OK
  • Docker và Docker Compose cài xong (kho noble, docker compose version chạy được)
  • Admin token (Argon2) generate xong, lưu vào .env
  • docker compose up -d → container Up
  • step-CA cert cấp xong tại /etc/ssl/vaultwarden/
  • Container dùng bundle CA đã gồm root CA step-CA (SSL_CERT_FILE, mục 5.5) và gửi được SMTP STARTTLS tới Mailu
  • Nginx cấu hình, nginx -t pass, reload OK
  • DNS record vaultwarden.hoatranlabs.local → 10.11.25.43 trong Pi-hole
  • Truy cập https://vaultwarden.hoatranlabs.local từ browser → load OK, cert hợp lệ
  • Admin panel https://vaultwarden.hoatranlabs.local/admin đăng nhập được
  • Tạo invite → user nhận email → đăng nhập OK
  • Bitwarden extension kết nối self-hosted server OK
  • Cert renewal timer chạy (systemctl status vaultwarden-cert-renew.timer)
  • Backup script test chạy OK
  • Firewall UFW bật, chỉ cho 22/80/443 và 9100 từ Prometheus (10.11.45.35)
Zalo