Triển khai Mailu Mail Server
Hệ thống máy chủ email toàn diện, nhẹ và dễ triển khai qua Docker.
Bối cảnh & Lý do triển khai
Grafana alert, Authentik security event, Vaultwarden password expiry, PBS backup failure... tất cả cần một kênh gửi thông báo tin cậy. Dùng Gmail/SMTP bên ngoài phụ thuộc vào bên thứ ba, giới hạn rate, và có thể bị block. Mailu là mail server hoàn chỉnh tự quản lý, đảm bảo tất cả alert đều đến đúng người đúng lúc.
| Mục | Nội dung |
|---|---|
| Ứng dụng trong DN | Notification relay cho tất cả service nội bộ, mailbox @hoatranlabs.local, anti-spam gateway |
| Tác dụng chính | SMTP relay cho Alertmanager (bài 15)/Grafana/Authentik/Vaultwarden/PBS/Proxmox VE (bài 10); IMAP/webmail; DKIM/SPF/DMARC chống spam |
| Nếu không triển khai | Service alerts không có kênh email, phải phụ thuộc SMTP bên ngoài với rate limit và downtime risk |
| Các service phụ thuộc vào đây | Alertmanager/Grafana alerts, Authentik email verification, Vaultwarden 2FA email, PBS backup reports |
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 |
|---|---|---|---|
| mailu (Mailu Mail Server) · VM246 | 10.11.35.46 | 35 (DMZ) · node2 | Máy chủ của bài — chạy Mailu (Postfix, Dovecot, Rspamd, Roundcube) bằng Docker Compose; SMTP 25/587, IMAPS 993, webmail HTTPS 443. |
| node2 (Proxmox VE) | 10.11.45.211 | 45 (MGMT) · cluster HOATRANHUB | Node Proxmox chứa VM246; tạo VM tại đây và đặt job backup (pvesh create /cluster/backup, 04:00 hằng ngày) vào storage pbs-primary. |
| node1 (Proxmox VE) | 10.11.45.210 | 45 (MGMT) · cluster HOATRANHUB | Đại diện cụm PVE node1–node4: gửi thông báo Proxmox qua Mailu cổng 587 STARTTLS bằng mailbox pve-alerts@ (bài 10); cần tin cậy root CA step-CA. |
| step-ca (step-CA PKI) · VM242 | 10.11.25.42 | 25 (SEC) · node1 | Cấp chứng chỉ TLS cho Mailu qua step ca certificate (SAN mail, mailu, IP), gia hạn bằng step ca renew + systemd timer 02:30 (bài 13). |
| pihole (Pi-hole DNS) · VM247 | 10.11.45.53 | 45 (MGMT) · node3 | Phân giải mailu và mail về Mailu (bản ghi A tạo ở bài 12); thêm MX, SPF, DKIM, DMARC bằng dnsmasq custom.conf rồi chạy pihole reloaddns. |
| prometheus (Prometheus + Alertmanager) · VM235 | 10.11.45.35 | 45 (MGMT) · node2 | Alertmanager (container alertmanager) gửi email cảnh báo qua relay Mailu cổng 587 STARTTLS, đăng nhập bằng mailbox alerts@ (bài 15). |
| grafana (Grafana + Uptime Kuma + Gotify) · VM236 | 10.11.45.36 | 45 (MGMT) · node2 | Grafana gửi email qua relay Mailu: biến GF_SMTP_* cổng 587 STARTTLS, mailbox noreply@, from_name Grafana Lab (bài 15). |
| authentik (Authentik SSO) · VM234 | 10.11.25.40 | 25 (SEC) · node1 | Cấu hình AUTHENTIK_EMAIL__* trỏ tới Mailu cổng 587, bật TLS, mailbox noreply@ để gửi email xác minh (bài 14). |
| vaultwarden (Vaultwarden) · VM243 | 10.11.25.43 | 25 (SEC) · node1 | Cấu hình SMTP trong /opt/vaultwarden/.env: cổng 587, SMTP_SECURITY=starttls, mailbox noreply@ (bài 19). |
| pbs01 (PBS Primary) · VM101 | 10.11.45.17 | 45 (MGMT) · node4 | PBS đặt notification target SMTP tới Mailu cổng 587 (mailfrom alerts@, gửi tới admin@); cũng nhận backup VM246 qua storage pbs-primary. |
| FortiGate (firewall) | 10.100.100.1 | Quản trị 10.100.100.0/24 · thiết bị mạng | Rule nội bộ cho VLAN 45, 25, 65 vào cổng 587 và VLAN 45 vào 443; VIP WAN vào Mailu (25, 465, 993) chỉ mở khi nhận thư từ Internet. |
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
Phiên bản phần mềm sử dụng
Mailu là bộ mail server hoàn chỉnh chạy trên Docker Compose, bao gồm:
| Thành phần | Vai trò |
|---|---|
| Postfix (front) | SMTP relay, nhận / gửi thư |
| Dovecot (imap) | IMAP/S, lưu trữ hộp thư |
| Rspamd (antispam) | Lọc spam, ký DKIM |
| Roundcube (webmail) | Giao diện web cho người dùng |
| Admin Flask | Quản trị domain, mailbox, alias |
| Redis | Cache, hàng đợi nội bộ |
| Unbound (resolver) | DNS resolver có kiểm tra DNSSEC, bắt buộc với Mailu (mục 4.2) |
| ClamAV (tùy chọn) | Quét virus đính kèm |
Phiên bản phần mềm sử dụng
Đã xác minh 2026-10-15 (số phiên bản ứng dụng giữ như bản cũ của bài):
| Thành phần | Phiên bản | Ghi chú |
|---|---|---|
| Hệ điều hành VM246 | Ubuntu Server 24.04 LTS "Noble Numbat" (ISO ubuntu-24.04.5-live-server-amd64.iso) | Kernel 6.8, systemd 255, netplan 1.0, APT 2.7, hỗ trợ chuẩn tới 04/2029. Bản point mới nhất thấy trên releases.ubuntu.com/24.04 là 24.04.5 (cần kiểm lại khi tải ISO). |
| Docker Engine + plugin Compose | 29.9.1 (docker-ce, đăng lên repo ngày 2026-10-14) + plugin Compose 5.6.0, từ repo download.docker.com/linux/ubuntu noble stable | Gói docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin, lệnh docker compose. Số bản đọc từ thư mục dists/noble/pool/stable/amd64/ của repo ngày 2026-10-15 (containerd.io 2.4.2-2, buildx 0.38.0-1); apt sẽ lấy bản mới nhất trong repo lúc cài nên có thể cao hơn. Docker rootful nên không bị giới hạn user namespace của AppArmor 4. |
| Mailu | nhánh stable 2024.06 (image ghcr.io/mailu/*:2024.06) | Tag 2024.06 luôn trỏ bản vá mới nhất của nhánh: GitHub Releases ghi 2024.06.64 (2026-10-15); nhánh chưa thấy bản 2025.x/2026.x. Nên docker compose pull định kỳ để nhận bản vá (Roundcube, bảo mật). |
| Redis (container của Mailu) | redis:7-alpine | Giữ như bản cũ của bài. |
| step-cli | 0.31.0 (step-cli_0.31.0-1_amd64.deb, 2026-09-25) | Giá trị dùng chung của series; trước đây bài ghim 0.27.4. |
Mục đích trong lab: nhận cảnh báo Grafana/Prometheus, thông báo PBS backup và thông báo của cụm Proxmox VE (mailbox pve-alerts@, mục 8.5), thư mời Vaultwarden, xác minh email Authentik. Không gửi thư ra Internet (không cần PTR/SPF thực), chỉ relay nội bộ giữa các service trong VLAN.
Cổng mở:
| Cổng | Giao thức | Mô tả |
|---|---|---|
| 25/TCP | SMTP | Nhận thư từ Internet hoặc nội bộ |
| 587/TCP | Submission | Gửi thư có xác thực (relay cho service khác) |
| 993/TCP | IMAP SSL | Client kết nối hộp thư |
| 443/TCP | HTTPS | Webmail Roundcube + Admin |
| 80/TCP | HTTP | Chuyển hướng sang HTTPS (compose front publish cổng này) |
| 465/TCP | SMTPS | SMTP over TLS ngầm; service nội bộ không dùng, chỉ mở ra ngoài khi cần nhận thư Internet (mục 9.2) |
| 110/TCP, 995/TCP | POP3, POP3S | Client POP3 (compose front có publish; không dùng trong lab, có thể bỏ khỏi ports) |
Tạo VM246 Trên PVE
Tạo VM · Cài Ubuntu Server 24.04 LTS · Cấu Hình Sau Cài Đặt
2.1 Tạo VM
Cách 1: Web UI Proxmox (GUI)
- VM ID:
246 - Name:
mailu - 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(thường làvm-ceph) - Disk size:
50 GiB, Cache:Write back, Discard: ☑, SSD emulation: ☑
- Sockets:
1, Cores:4, Type:host
- Memory (MiB):
4096 - Ballooning Device: ☐ (bỏ tick — tương đương
--balloon 0)
- Bridge:
vmbr0, VLAN Tag:35, Model:VirtIO (paravirtualized), Firewall: ☐
Cách 2: CLI (qm create)
qm create 246 \
--name mailu \
--memory 4096 \
--balloon 0 \
--cores 4 \
--cpu host \
--net0 virtio,bridge=vmbr0,tag=35 \
--scsi0 vm-ceph:50,discard=on,ssd=1 \
--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 \
--onboot 1 \
--startup order=5,up=60
create-lab-vms.sh (bài 07) thì VM246 có scsi0 = 40 GB trên SSD vm-ceph (thin provisioning) và không có đĩa dữ liệu scsi1 (xdisk = 0), nên hộp thư /opt/mailu/mail nằm chung đĩa hệ điều hành. Số 50 GB ở bài này là trần danh nghĩa/khuyến nghị cho môi trường thật; ước tính ở bài 07 (mục 8.6) cho thấy Mailu chỉ dùng khoảng 13 GB thật (hệ điều hành + Docker ≈ 7 GB, image ≈ 5 GB, hộp thư ≈ 1 GB vì lab chỉ nhận thư cảnh báo), nên 40 GB là đủ.
2.2 Cài Ubuntu Server 24.04 LTS
Cài đặt Ubuntu Server 24.04 LTS (minimal) qua console PVE. Các giá trị cần thiết:
Hostname: mailu
Username: sysadmin
Password: <đặt mật khẩu mạnh>
IP: 10.11.35.46/24
Gateway: 10.11.35.1
DNS: 10.11.45.53
Disk: toàn bộ 50 GB, ext4, /
Packages: OpenSSH server (bắt buộc)
ens18 hoặc enp6s18: kiểm bằng ip -br link. Ubuntu 24.04 (netplan 1.0) có thể được cloud-init ghi cấu hình mạng vào /etc/netplan/50-cloud-init.yaml; nếu cần sửa IP sau cài, sửa đúng file đó (quyền 600) rồi dùng sudo netplan try.
2.3 Cấu Hình Sau Cài Đặt
Chạy bằng sudo -i (root). Docker cài từ repo chính thức của Docker cho Ubuntu 24.04 "noble", nguồn dạng deb822 docker.sources (docs.docker.com/engine/install/ubuntu):
# Ubuntu 24.04 có needrestart: tránh hộp thoại hỏi khi apt chạy trong script
export NEEDRESTART_MODE=a DEBIAN_FRONTEND=noninteractive
# Cập nhật hệ thống
apt update && apt upgrade -y
# Gỡ gói Docker không chính thức nếu có (bỏ qua lỗi nếu chưa cài)
apt remove -y docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc || true
# Cài Docker + Docker Compose từ repo chính thức
apt install -y ca-certificates curl gnupg
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
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
apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
systemctl enable --now docker
# Xác nhận
docker --version
docker compose version
# Bật qemu-guest-agent
apt install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent
# Tắt swap (tùy chọn nhưng nên làm); trình cài đặt Ubuntu 24.04 thường tạo /swap.img
swapoff -a
sed -i '/swap/d' /etc/fstab
rm -f /swap.img
Cấu Hình TLS Từ step-CA (VM242)
Tự Động Gia Hạn Cert (systemd timer)
# Cài step CLI 0.31.0 trên VM246 (gói .deb của bản phát hành smallstep/cli; binary nằm ở /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"
dpkg -i "step-cli_${STEP_VERSION}-1_amd64.deb"
rm -f "step-cli_${STEP_VERSION}-1_amd64.deb"
step version
# Khởi tạo trust step-CA
step ca bootstrap \
--ca-url https://step-ca.hoatranlabs.local:9000 \
--fingerprint <fingerprint-cua-step-CA>
# Lấy fingerprint: ssh vào VM242 → step certificate fingerprint /etc/step-ca/certs/root_ca.crt
# Tạo thư mục certs
mkdir -p /opt/mailu/certs
# Cấp certificate cho mail.hoatranlabs.local
step ca certificate "mail.hoatranlabs.local" \
/opt/mailu/certs/cert.pem \
/opt/mailu/certs/key.pem \
--ca-url https://step-ca.hoatranlabs.local:9000 \
--provisioner [email protected] \
--san mail.hoatranlabs.local \
--san mailu.hoatranlabs.local \
--san 10.11.35.46
# SAN mailu.hoatranlabs.local là tên SMTP chuẩn mà các service nội bộ dùng (mục 8): phải có trong cert để STARTTLS xác thực được
chmod 640 /opt/mailu/certs/key.pem
3.1 Tự Động Gia Hạn Cert (systemd timer)
Gói .deb đặt step ở /usr/bin/step (xác nhận bằng command -v step; đường dẫn trong ExecStart phải khớp). Bài 13 dùng step-cli 0.31.0 và step-ca 0.30.2 (đọc lại bài 13 khi nâng cấp); việc cấp/gia hạn cert bằng CLI này với step-ca của bài 13 cần kiểm lại trên máy thật.
cat > /etc/systemd/system/mailu-cert-renew.service << 'EOF'
[Unit]
Description=Renew Mailu TLS certificate from step-CA
After=network-online.target
[Service]
Type=oneshot
ExecStart=/usr/bin/step ca renew \
/opt/mailu/certs/cert.pem \
/opt/mailu/certs/key.pem \
--force \
--ca-url https://step-ca.hoatranlabs.local:9000
ExecStartPost=/usr/bin/docker compose -f /opt/mailu/docker-compose.yml restart front
EOF
cat > /etc/systemd/system/mailu-cert-renew.timer << 'EOF'
[Unit]
Description=Renew Mailu TLS certificate daily
[Timer]
OnCalendar=*-*-* 02:30:00
RandomizedDelaySec=1800
Persistent=true
[Install]
WantedBy=timers.target
EOF
systemctl daemon-reload
systemctl enable --now mailu-cert-renew.timer
Tạo File Cấu Hình Mailu
File mailu.env · File docker-compose.yml
mkdir -p /opt/mailu
cd /opt/mailu
4.1 File mailu.env
cat > /opt/mailu/mailu.env << 'EOF'
# ====================================================
# Mailu Configuration — hoatranlabs.local lab
# Version: 2024.06
# ====================================================
MAILU_VERSION=2024.06
# Tạo secret key ngẫu nhiên 32 ký tự (chỉ set 1 lần)
SECRET_KEY=Ch4ng3Th1sT0R4nd0mStr1ngN0w00000
# Domain chính
DOMAIN=hoatranlabs.local
HOSTNAMES=mail.hoatranlabs.local
# Postmaster (admin) username (không bao gồm @domain)
POSTMASTER=admin
# TLS: dùng cert từ bên ngoài (step-CA)
TLS_FLAVOR=cert
# Rate limiting
AUTH_RATELIMIT_IP=60/hour
AUTH_RATELIMIT_USER=100/day
# Subnet của Docker network mailu_net (phải trùng ipam.subnet trong docker-compose.yml bên dưới, KHÔNG phải VLAN DMZ 10.11.35.0/24)
SUBNET=172.28.0.0/24
# Không dùng IPv6 trong lab: KHÔNG khai báo SUBNET6 (Mailu 2024.06 chỉ sinh SUBNET6 khi bật IPv6)
# Spam threshold (0-15, mặc định 80 → scale khác với Rspamd score)
DEFAULT_SPAM_THRESHOLD=80
# Kích thước tối đa message: 50 MB
MESSAGE_SIZE_LIMIT=52428800
# DKIM (DKIM_PATH là mẫu đường dẫn tới từng file key; giá trị mặc định của Mailu)
DKIM_PATH=/dkim/{domain}.{selector}.key
# Webmail
WEBMAIL=roundcube
ROUNDCUBE_DB_FLAVOR=sqlite
# Log
LOG_LEVEL=WARNING
# Ports (để mặc định)
BIND_ADDRESS4=0.0.0.0
BIND_ADDRESS6=::1
EOF
SECRET_KEY bằng giá trị ngẫu nhiên thực sự trước khi chạy:
openssl rand -hex 16
4.2 File docker-compose.yml
# Không khai báo `version:` (thuộc tính obsolete, Docker Compose v2+ chỉ in cảnh báo)
services:
# ─── Resolver (Unbound, DNSSEC) ─────────────────────────────────────────────
# Mailu yêu cầu DNS resolver có kiểm tra DNSSEC (FAQ Mailu, từ v1.9); nếu không admin
# từ chối khởi động. Pi-hole của lab không bật DNSSEC nên dùng unbound của Mailu.
# IP cố định = địa chỉ áp chót của SUBNET (172.28.0.254), đúng cách trình tạo compose của Mailu đặt.
resolver:
image: ghcr.io/mailu/unbound:2024.06
container_name: mailu-resolver
restart: always
env_file: mailu.env
logging:
driver: journald
options:
tag: mailu-resolver
networks:
mailu_net:
ipv4_address: 172.28.0.254
# ─── Front (Nginx + SSL termination) ───────────────────────────────────────
front:
image: ghcr.io/mailu/nginx:2024.06
container_name: mailu-front
restart: always
env_file: mailu.env
dns:
- 172.28.0.254
depends_on:
- resolver
logging:
driver: journald
options:
tag: mailu-front
ports:
- "80:80"
- "443:443"
- "25:25"
- "587:587"
- "993:993"
- "465:465"
- "110:110"
- "995:995"
volumes:
- "/opt/mailu/certs:/certs:ro"
- "mailu_data:/data"
networks:
- mailu_net
# front chỉ depends_on resolver, KHÔNG depends_on smtp/imap/webmail/antispam: các service này đã
# depends_on front, thêm chiều ngược lại sẽ tạo vòng phụ thuộc và docker compose báo lỗi "dependency cycle detected".
# ─── Redis ─────────────────────────────────────────────────────────────────
redis:
image: redis:7-alpine
container_name: mailu-redis
restart: always
dns:
- 172.28.0.254
depends_on:
- resolver
volumes:
- "mailu_redis:/data"
networks:
- mailu_net
# ─── Admin (Flask web UI) ───────────────────────────────────────────────────
admin:
image: ghcr.io/mailu/admin:2024.06
container_name: mailu-admin
restart: always
env_file: mailu.env
dns:
- 172.28.0.254
volumes:
- "mailu_data:/data"
- "mailu_dkim:/dkim"
networks:
- mailu_net
depends_on:
- redis
- resolver
logging:
driver: journald
options:
tag: mailu-admin
# ─── SMTP (Postfix) ─────────────────────────────────────────────────────────
smtp:
image: ghcr.io/mailu/postfix:2024.06
container_name: mailu-smtp
restart: always
env_file: mailu.env
dns:
- 172.28.0.254
volumes:
- "mailu_data:/data"
- "mailu_dkim:/dkim"
networks:
- mailu_net
depends_on:
- front
- redis
- resolver
logging:
driver: journald
options:
tag: mailu-smtp
# ─── IMAP (Dovecot) ─────────────────────────────────────────────────────────
imap:
image: ghcr.io/mailu/dovecot:2024.06
container_name: mailu-imap
restart: always
env_file: mailu.env
dns:
- 172.28.0.254
volumes:
- "mailu_data:/data"
- "mailu_mail:/mail"
networks:
- mailu_net
depends_on:
- front
- resolver
logging:
driver: journald
options:
tag: mailu-imap
# ─── Antispam (Rspamd) ──────────────────────────────────────────────────────
antispam:
image: ghcr.io/mailu/rspamd:2024.06
container_name: mailu-antispam
restart: always
env_file: mailu.env
dns:
- 172.28.0.254
volumes:
- "mailu_data:/data"
- "mailu_dkim:/dkim"
- "mailu_filter:/var/lib/rspamd"
networks:
- mailu_net
depends_on:
- front
- redis
- resolver
logging:
driver: journald
options:
tag: mailu-antispam
# ─── Oletools (macro analysis) ──────────────────────────────────────────────
oletools:
image: ghcr.io/mailu/oletools:2024.06
container_name: mailu-oletools
restart: always
dns:
- 172.28.0.254
depends_on:
- resolver
networks:
- mailu_net
# ─── Webmail (Roundcube) ────────────────────────────────────────────────────
webmail:
image: ghcr.io/mailu/roundcube:2024.06
container_name: mailu-webmail
restart: always
env_file: mailu.env
volumes:
- "mailu_webmail:/data"
networks:
- mailu_net
depends_on:
- imap
logging:
driver: journald
options:
tag: mailu-webmail
volumes:
mailu_data:
driver: local
driver_opts:
type: none
o: bind
device: /opt/mailu/data
mailu_mail:
driver: local
driver_opts:
type: none
o: bind
device: /opt/mailu/mail
mailu_dkim:
driver: local
driver_opts:
type: none
o: bind
device: /opt/mailu/dkim
mailu_filter:
driver: local
driver_opts:
type: none
o: bind
device: /opt/mailu/filter
mailu_redis:
driver: local
driver_opts:
type: none
o: bind
device: /opt/mailu/redis
mailu_webmail:
driver: local
driver_opts:
type: none
o: bind
device: /opt/mailu/webmail
networks:
mailu_net:
driver: bridge
ipam:
config:
- subnet: 172.28.0.0/24
resolver (Unbound): theo FAQ chính thức của Mailu, từ v1.9 Mailu yêu cầu DNS resolver có kiểm tra DNSSEC; nếu không, container admin từ chối khởi động (log "your DNS resolver isn't doing DNSSEC validation"). Pi-hole (10.11.45.53) mặc định không bật DNSSEC nên không dùng làm DNS cho các container Mailu. Unbound của Mailu cũng tránh việc RBL mà Rspamd tra cứu (ví dụ multi.uribl.com) chặn hoặc giới hạn tốc độ resolver công cộng. Các container có dns: 172.28.0.254 (địa chỉ áp chót của SUBNET, đúng quy ước trình tạo compose của Mailu); tên container nội bộ (admin, redis...) vẫn được Docker phân giải bình thường. Unbound tự truy vấn từ root nên VLAN DMZ (35) cần cho phép ra Internet cổng 53 (UDP/TCP) ở FortiGate. Domain nội bộ hoatranlabs.local là domain cục bộ của Mailu nên không cần resolver phân giải; các service khác vẫn dùng Pi-hole như cũ.mailu.env ở trên không có SUBNET6, REWRITE_EMAIL, WEB_ROOT, DISABLE_IPV6: các biến này không tồn tại trong cấu hình Mailu 2024.06 (IPv6 chỉ bật khi trình tạo compose sinh SUBNET6 và ipv6_enabled; lab không dùng IPv6).Khởi Động Mailu Lần Đầu
# Tạo các thư mục bind mount
mkdir -p /opt/mailu/{data,mail,dkim,filter,redis,webmail}
# Cấp quyền (Mailu chạy với uid 8 bên trong container)
chown -R 8:8 /opt/mailu/mail
chown -R 8:8 /opt/mailu/dkim
cd /opt/mailu
# Pull images
docker compose pull
# Khởi động lần đầu
docker compose up -d
# Kiểm tra logs
docker compose logs -f --tail=50
Tạo Admin Account Và Mailbox Đầu Tiên
# Đợi admin container sẵn sàng (~30 giây sau khi up)
docker compose exec admin flask mailu admin \
admin hoatranlabs.local 'Admin@Mailu2024!'
# Tạo mailbox dùng cho alerts
docker compose exec admin flask mailu user \
alerts hoatranlabs.local 'Alerts@Mailu2024!'
# Tạo mailbox noreply (dùng cho service notifications)
docker compose exec admin flask mailu user \
noreply hoatranlabs.local 'Noreply@Mailu2024!'
# Tạo mailbox cho thông báo của Proxmox VE (bài 10): from-address phải trùng mailbox xác thực
docker compose exec admin flask mailu user \
pve-alerts hoatranlabs.local 'PveAlerts@Mailu2024!'
# Tạo alias: monitoring → alerts
docker compose exec admin flask mailu alias \
monitoring hoatranlabs.local [email protected]
Truy cập Admin UI: https://mail.hoatranlabs.local/admin
Đăng nhập: [email protected] / Admin@Mailu2024!
Lấy DKIM Key Và Cấu Hình DNS
Tạo DKIM Key · Thêm DNS Records Vào Pi-hole (VM247)
7.1 Tạo DKIM Key
# Trong Admin UI: Mail domains → hoatranlabs.local → biểu tượng "details" (đầu tiên bên trái)
# → nút "Regenerate keys" ở góc trên bên phải.
# (Mailu không có lệnh `flask mailu dkim`.) Trang details hiển thị sẵn bản ghi DNS DKIM và DMARC:
# lấy giá trị p=... của bản ghi DKIM để thêm vào DNS.
# Kiểm tra file private key đã được tạo (selector mặc định là "dkim")
ls -la /opt/mailu/dkim/hoatranlabs.local.dkim.key
7.2 Thêm DNS Records Vào Pi-hole (VM247)
Đăng nhập Pi-hole Admin: http://10.11.45.53/admin
Vào Settings → Local DNS Records và thêm (bài 12 đã tạo sẵn cả hai bản ghi A này; chỉ thêm nếu còn thiếu):
# A record
mailu.hoatranlabs.local → 10.11.35.46
mail.hoatranlabs.local → 10.11.35.46
# CNAME webmail (tùy chọn; bài 12 mục 3.3 đã tạo sẵn, thêm ở Settings → Local DNS Records)
webmail.hoatranlabs.local → mail.hoatranlabs.local
Các bản ghi còn lại (MX, TXT) không có trong giao diện Settings → Local DNS Records nên khai báo bằng file cấu hình dnsmasq (hoặc dùng PTR/custom DNS).
/etc/dnsmasq.d/ nên mx-host/txt-record bên dưới sẽ bị bỏ qua. Bật bằng FTLCONF_misc_etc_dnsmasq_d: 'true' trong environment của compose bài 12 (rồi docker compose up -d), hoặc chạy docker exec pihole pihole-FTL --config misc.etc_dnsmasq_d true. Pi-hole v5 không cần bước này. (Với vài dòng, có thể dùng FTLCONF_misc_dnsmasq_lines thay cho file, các dòng cách nhau bằng ;.)
# MX record — Pi-hole không hỗ trợ MX trực tiếp
# Thêm vào /etc/dnsmasq.d/custom.conf trong container pihole (volume pihole_dnsmasq, bài 12):
mx-host=hoatranlabs.local,mail.hoatranlabs.local,10
# SPF TXT (nếu cần xác minh nội bộ)
txt-record=hoatranlabs.local,"v=spf1 a:mail.hoatranlabs.local ~all"
# DKIM TXT (thay <public_key> bằng nội dung từ bước trên)
txt-record=dkim._domainkey.hoatranlabs.local,"v=DKIM1; k=rsa; p=<public_key>"
# DMARC TXT
txt-record=_dmarc.hoatranlabs.local,"v=DMARC1; p=quarantine; rua=mailto:[email protected]"
# Khởi động lại dnsmasq trên Pi-hole
ssh [email protected]
docker exec pihole pihole reloaddns
Cấu Hình SMTP Relay Cho Các Service Khác
Grafana (VM236) · Authentik (VM234) · Vaultwarden
Các service sau sử dụng Mailu làm SMTP relay qua port 587.
Thông số SMTP chuẩn của lab (Mailu là nguồn chuẩn; mọi bài khác phải dùng đúng các giá trị này):
| Thông số | Giá trị |
|---|---|
| Máy chủ SMTP (host) | mailu.hoatranlabs.local (10.11.35.46, VM246; bản ghi A ở Pi-hole bài 12, alias mail.hoatranlabs.local cùng IP) |
| Cổng | 587/TCP (submission) |
| Mã hóa | STARTTLS (bắt buộc), không dùng SSL/TLS ngầm cổng 465, không dùng cổng 25 cho service nội bộ |
| Xác thực | Bắt buộc (user + password); Mailu dùng tài khoản nội bộ tạo ở mục 6, KHÔNG dùng LDAP của Authentik |
| Chứng chỉ | step-CA, SAN gồm mailu.hoatranlabs.local, mail.hoatranlabs.local, 10.11.35.46; client phải tin cậy root CA (/usr/local/share/ca-certificates/hoatranlabs-root.crt, bài 13) |
| Tài khoản cho service (Grafana, Authentik, Vaultwarden, Gitea...) | user [email protected], mật khẩu Noreply@Mailu2024!, from [email protected] |
| Tài khoản cho cảnh báo (Alertmanager bài 15, PBS) | user [email protected], mật khẩu Alerts@Mailu2024!, from [email protected] (alias monitoring@ → alerts@) |
| Tài khoản cho thông báo Proxmox VE (cụm node1–node4, bài 10) | user [email protected], mật khẩu PveAlerts@Mailu2024!, from [email protected], cổng 587 STARTTLS (mục 8.5) |
| Địa chỉ nhận mặc định | [email protected] |
8.1 Grafana (VM236)
Grafana chạy Docker (bài 15): cấu hình SMTP đã nằm sẵn trong /opt/grafana-stack/docker-compose.yml dưới dạng biến môi trường GF_SMTP_* (đúng các giá trị dưới đây). Dạng grafana.ini tương đương:
# /etc/grafana/grafana.ini hoặc grafana.ini trong Docker
[smtp]
enabled = true
host = mailu.hoatranlabs.local:587
user = [email protected]
password = Noreply@Mailu2024!
from_address = [email protected]
from_name = Grafana Lab
startTLS_policy = MandatoryStartTLS
skip_verify = false
cert_file =
key_file =
8.2 Authentik (VM234)
# trong authentik docker-compose.yml → environment:
- AUTHENTIK_EMAIL__HOST=mailu.hoatranlabs.local
- AUTHENTIK_EMAIL__PORT=587
- [email protected]
- AUTHENTIK_EMAIL__PASSWORD=Noreply@Mailu2024!
- AUTHENTIK_EMAIL__USE_TLS=true
- [email protected]
8.3 Vaultwarden
# /opt/vaultwarden/.env
SMTP_HOST=mailu.hoatranlabs.local
[email protected]
SMTP_PORT=587
SMTP_SECURITY=starttls
[email protected]
SMTP_PASSWORD=Noreply@Mailu2024!
8.4 PBS (Proxmox Backup Server)
# Trên PBS Web UI (pbs01): Configuration → Notifications → Notification Targets → Add → SMTP
# Hoặc qua CLI trên pbs01 (hệ thống notification target/matcher có từ PBS 3.2):
# 1) Tạo SMTP target: relay Mailu, STARTTLS cổng 587, đăng nhập bằng mailbox alerts@
proxmox-backup-manager notification endpoint smtp create mailu-alerts \
--server mailu.hoatranlabs.local \
--port 587 \
--mode starttls \
--username [email protected] \
--password 'Alerts@Mailu2024!' \
--from-address [email protected] \
--mailto [email protected]
# 2) Tạo matcher: chuyển thông báo của PBS (backup, GC, verify, sync...) tới target trên
# (matcher không có rule nào thì khớp mọi thông báo)
proxmox-backup-manager notification matcher create mailu-alerts \
--target mailu-alerts
pbs01 xác thực chứng chỉ TLS của Mailu nên cần tin cậy root CA step-CA (xem dòng "Chứng chỉ" trong bảng thông số ở đầu mục 8).
Alertmanager (bài 15, VM235, container alertmanager) dùng cùng relay với mailbox [email protected]: cấu hình trong /opt/prometheus/alertmanager/alertmanager.yml (smtp_smarthost: 'mailu.hoatranlabs.local:587').
8.5 Proxmox VE (cụm node1–node4, bài 10)
Hệ thống thông báo của PVE 9 (backup, replication, fencing, cập nhật gói, SMART...) gửi qua một SMTP target tại Datacenter → Notifications → Add → SMTP. Dùng mailbox riêng [email protected] (mục 6) để tách nguồn cảnh báo của Proxmox khỏi Alertmanager; chi tiết target, matcher và nội dung cảnh báo nằm ở bài 10, mục này chỉ cung cấp giá trị SMTP:
| Trường trên PVE | Giá trị |
|---|---|
| Endpoint Name | mailu-pve |
| Server | mailu.hoatranlabs.local |
| Encryption | STARTTLS (mode starttls) |
| Port | 587 |
| Username | [email protected] |
| Password | PveAlerts@Mailu2024! |
| From Address | [email protected] (docs PVE lưu ý relay có thể yêu cầu from thuộc user xác thực) |
| Recipient(s) | [email protected] (hoặc người dùng PVE ở trường mailto-user) |
Tương đương trong /etc/pve/notifications.cfg (mật khẩu nằm riêng ở /etc/pve/priv/notifications.cfg, chỉ root đọc được):
smtp: mailu-pve
server mailu.hoatranlabs.local
port 587
mode starttls
username [email protected]
from-address [email protected]
mailto [email protected]
Mỗi node PVE xác thực chứng chỉ TLS của Mailu nên cần tin cậy root CA step-CA (/usr/local/share/ca-certificates/hoatranlabs-root.crt rồi update-ca-certificates trên từng node, xem dòng "Chứng chỉ" ở bảng thông số đầu mục 8). SMTP target của PVE không có hàng đợi/thử lại khi gửi lỗi (theo docs PVE), nên kiểm tra bằng nút Test trên giao diện. Việc dùng CLI pvesh create /cluster/notifications/endpoints/smtp với các tham số cùng tên như trên cần kiểm lại trên máy thật.
Cấu Hình Firewall
Quy Tắc Tường Lửa Nội Bộ (FortiGate / PVE Firewall) · FortiGate (Nếu Cần Nhận Mail Từ Internet)
9.1 Quy Tắc Tường Lửa Nội Bộ (FortiGate / PVE Firewall)
# VLAN_MGMT (10.11.45.0/24) → Mailu SMTP relay (gồm node1–node4 gửi thông báo PVE, bài 10)
ALLOW TCP 10.11.45.0/24 10.11.35.46 587 # Submission có xác thực
# VLAN_SEC (10.11.25.0/24) → Mailu SMTP relay
ALLOW TCP 10.11.25.0/24 10.11.35.46 587
# VLAN_SRV (10.11.65.0/24) → Mailu SMTP relay
ALLOW TCP 10.11.65.0/24 10.11.35.46 587
# Admin access webmail từ VLAN_MGMT
ALLOW TCP 10.11.45.0/24 10.11.35.46 443
# Unbound (resolver trong compose, mục 4.2) truy vấn DNS từ root → cho Mailu ra Internet cổng 53
ALLOW TCP/UDP 10.11.35.46 any 53
# Chặn tất cả truy cập trực tiếp SMTP (port 25) nội bộ → chỉ front nhận
DENY TCP any 10.11.35.46 25 (trừ khi cần nhận từ Internet)
9.2 FortiGate (Nếu Cần Nhận Mail Từ Internet)
# Virtual IP: WAN → 10.11.35.46
# Policy: WAN_IN → VLAN_DMZ, service: SMTP (25), SMTPS (465), IMAP-SSL (993)
# Chỉ mở khi có domain thực, không cần cho lab nội bộ
Backup Mailu
PBS Snapshot
# Script backup volumes Mailu
cat > /opt/mailu/backup-mailu.sh << 'SCRIPT'
#!/bin/bash
set -e
BACKUP_DIR="/backup/mailu"
DATE=$(date +%Y%m%d-%H%M)
mkdir -p "$BACKUP_DIR"
echo "[$(date)] Stopping Mailu for backup..."
cd /opt/mailu
docker compose stop
echo "[$(date)] Backing up data directories..."
tar czf "$BACKUP_DIR/mailu-data-$DATE.tar.gz" \
/opt/mailu/data \
/opt/mailu/mail \
/opt/mailu/dkim \
/opt/mailu/mailu.env
echo "[$(date)] Starting Mailu..."
docker compose start
# Giữ 7 bản backup gần nhất
find "$BACKUP_DIR" -name "mailu-data-*.tar.gz" -mtime +7 -delete
echo "[$(date)] Backup completed: mailu-data-$DATE.tar.gz"
SCRIPT
chmod +x /opt/mailu/backup-mailu.sh
# Cron job: backup 3:00 sáng mỗi ngày
(crontab -l 2>/dev/null; echo "0 3 * * * /opt/mailu/backup-mailu.sh >> /var/log/mailu-backup.log 2>&1") \
| crontab -
10.2 PBS Snapshot
# Trên PVE node2, tạo backup job cho VM246
pvesh create /cluster/backup \
--storage pbs-primary \
--vmid 246 \
--schedule "04:00" \
--mode snapshot \
--compress zstd \
--notes-template "{{guestname}} - {{node}} - {{vmid}}"
Troubleshooting
DKIM Không Ký Thư · Spam Filter Quá Nhạy · Certificate Hết Hạn / Không Renew
11.1 DKIM Không Ký Thư
# Kiểm tra Rspamd có đang chạy không
docker compose ps antispam
docker compose logs antispam | grep -i dkim
# Kiểm tra DKIM key đã được tạo chưa
ls -la /opt/mailu/dkim/
# Test ký DKIM thủ công
docker compose exec antispam rspamadm dkim_keygen \
-d hoatranlabs.local \
-s dkim \
-k /dkim/hoatranlabs.local.dkim.key
# Kiểm tra DNS TXT record
dig TXT dkim._domainkey.hoatranlabs.local @10.11.45.53
11.2 Spam Filter Quá Nhạy
# Xem Rspamd dashboard
# https://mail.hoatranlabs.local/rspamd (user: admin, pass từ mailu.env)
# Whitelist IP nội bộ trong Rspamd
cat >> /opt/mailu/data/conf/rspamd/override.d/ip_whitelist.map << 'EOF'
10.11.0.0/16
172.28.0.0/16
EOF
# Reload Rspamd
docker compose exec antispam rspamadm control reload
11.3 Certificate Hết Hạn / Không Renew
# Kiểm tra hạn cert
openssl x509 -in /opt/mailu/certs/cert.pem -noout -dates
# Gia hạn thủ công
step ca renew \
/opt/mailu/certs/cert.pem \
/opt/mailu/certs/key.pem \
--force \
--ca-url https://step-ca.hoatranlabs.local:9000
# Reload Nginx front
docker compose restart front
11.4 Container Không Khởi Động
# Kiểm tra tất cả containers
docker compose ps
docker compose logs --tail=100
# Kiểm tra port đã bị chiếm chưa
ss -tlnp | grep -E '25|587|993|443'
# Reset và khởi động lại
docker compose down
docker compose up -d
docker compose logs -f
11.5 Không Gửi Được Relay Từ Service Khác
# Test từ VLAN_MGMT đến SMTP relay
telnet mailu.hoatranlabs.local 587
# Kiểm tra log SMTP submission
docker compose logs smtp | grep -i "submission\|auth\|reject"
# Xác minh credentials của mailbox noreply@
docker compose exec admin flask mailu user list
11.6 Admin Không Khởi Động Vì Resolver Không Có DNSSEC
# Log admin báo "your DNS resolver isn't doing DNSSEC validation"
docker compose logs admin | grep -i dnssec
# Kiểm tra container resolver chạy và DNSSEC hợp lệ (phải thấy cờ "ad" trong phần flags)
docker compose ps resolver
dig @172.28.0.254 +adflag example.org A
# Nếu không có cờ "ad": kiểm tra VLAN DMZ đã cho phép ra Internet cổng 53 chưa
docker compose logs resolver --tail=50
Checklist Hoàn Thành
- VM246 tạo trên node2, tag VLAN 35, IP 10.11.35.46
- Ubuntu Server 24.04 LTS cài đặt xong, Docker Engine + plugin
docker compose(reponoblecủa Docker) hoạt động - step-CA cert cấp cho
mail.hoatranlabs.local(SAN thêmmailu.hoatranlabs.localvà 10.11.35.46), lưu tại/opt/mailu/certs/ - systemd timer tự động gia hạn cert hoạt động
-
mailu.envđã được cấu hình vớiSECRET_KEYngẫu nhiên -
docker-compose.ymldeploy thành công, 9 containers (gồmresolver) healthy - Admin account
[email protected]tạo thành công - Mailbox
alerts@,noreply@vàpve-alerts@tạo thành công - DKIM key được tạo và thêm vào Pi-hole DNS
- MX record
hoatranlabs.local → mail.hoatranlabs.localthêm vào Pi-hole - Gửi test mail qua Roundcube thành công
- Alertmanager (bài 15)/Grafana/Authentik/Vaultwarden cấu hình SMTP relay → mailu.hoatranlabs.local:587 (STARTTLS, có xác thực)
- PBS notification target cấu hình thành công
- SMTP target
mailu-pvetrên Proxmox VE (mục 8.5, bài 10) gửi thử thành công bằng[email protected] - Firewall rules: VLAN_MGMT/SEC/SRV → port 587 allowed
- Backup job PBS cho VM246 đã tạo
- Cron backup volumes
/opt/mailu/hàng ngày
Tài liệu: HOATRANLABS Infrastructure — Mailu Mail Server v2024.06
Cập nhật: 2026-10-15 (Ubuntu Server 24.04 LTS, Docker repo noble, step-cli 0.31.0, mailbox pve-alerts@)