Triển khai Vaultwarden Password Manager
Quản lý mật khẩu tự lưu trữ — compatible với Bitwarden client.
Bối cảnh & Lý do triển khai
Độ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ục | Nội dung |
|---|---|
| Ứng dụng trong DN | Shared team vault, password rotation reminder, SSH key storage, API token management |
| Tác dụng chính | Browser extension (Chrome/Firefox/Edge), mobile app, organization collections, audit log truy cập |
| Nếu không triển khai | Credentials 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 đây | Sử 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ủ | IP | VLAN · Node | Vai trò trong bài này |
|---|---|---|---|
| vaultwarden (Vaultwarden) · VM243 | 10.11.25.43 | 25 (SEC) · node1 | Má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.210 | 45 (MGMT) · cluster HOATRANHUB | Node Proxmox chứa VM243; tạo VM (qm create) tại đây. |
| mailu (Mailu Mail Server) · VM246 | 10.11.35.46 | 35 (DMZ) · node2 | Relay 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) · VM242 | 10.11.25.42 | 25 (SEC) · node1 | Cấ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) · VM247 | 10.11.45.53 | 45 (MGMT) · node3 | DNS 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) · VM235 | 10.11.45.35 | 45 (MGMT) · node2 | Scrape 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.1 | Quản trị 10.100.100.0/24 · thiết bị mạng | Policy 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) · VM101 | 10.11.45.17 | 45 (MGMT) · node4 | Sao 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.
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ính | Giá trị |
|---|---|
| VMID | 243 |
| Hostname | vaultwarden |
| Node | node1 (10.11.45.210) |
| VLAN | VLAN_SEC tag=25 |
| IP | 10.11.25.43/24 |
| Gateway | 10.11.25.1 |
| DNS | 10.11.45.53 (Pi-hole) |
| vCPU | 2 |
| RAM | 2 GB |
| Disk | 20 GB (vm-ceph) |
| OS | Ubuntu 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ần | Phiên bản | Ghi chú |
|---|---|---|
| Ubuntu Server | 24.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 + Compose | Docker 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 |
| Vaultwarden | 1.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+ |
| Nginx | 1.24.0 (kho Ubuntu noble) | Dùng listen 443 ssl http2; (http2 on; cần Nginx 1.25.1 trở lên) |
| step-cli | 0.31.0 | Gói .deb từ GitHub smallstep/cli |
| node_exporter | 1.12.1 | Cài bằng script ở bài 15 |
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)
- VM ID:
243 - Name:
vaultwarden - Bỏ tick Start after created
- 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
- Machine:
q35 - SCSI Controller:
VirtIO SCSI single - BIOS:
SeaBIOS - Qemu Agent: ☑
- Bus/Device:
SCSI 0, Storage:vm-ceph - Disk size:
20 GiB, Cache:Write back, Discard: ☑
- Sockets:
1, Cores:2, Type:x86-64-v2-AES
- Memory (MiB):
2048
- Bridge:
vmbr0, VLAN Tag:25, Model:VirtIO (paravirtualized), Firewall: ☐
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ặcenp6s18trên VM q35; kiểm tra bằngip -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
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).
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).
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
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
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.
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"
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
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
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
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
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
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.
10.2 Tạo invite cho user đầu tiên
[email protected], mailbox đã tạo ở bài 16 mục 6)
SIGNUPS_ALLOWED=true trong .env, tạo user, rồi tắt lại.
10.3 Tạo Organization
https://vaultwarden.hoatranlabs.localInfrastructure, DevOps, Shared)
Cấu hình Bitwarden Extension
Trên browser của mỗi client:
https://vaultwarden.hoatranlabs.local
# 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
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.
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
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 versionchạy được) - Admin token (Argon2) generate xong, lưu vào
.env -
docker compose up -d→ containerUp - 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 -tpass, reload OK - DNS record
vaultwarden.hoatranlabs.local → 10.11.25.43trong Pi-hole - Truy cập
https://vaultwarden.hoatranlabs.localtừ 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)