System & Network Mailu Mail Server
Bài 16 · Giai đoạn 2 — Hạ tầng nền tảng

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.

VM246 Ubuntu 24.04 Giai đoạn: Hạ tầng nền tảng

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

Vị trí trong chuỗi bài: Bài 16 thuộc Giai đoạn 2 — Hạ tầng nền tảng, nối tiếp Bài 15. Prometheus + Grafana và đứng trước Bài 17. Wazuh SIEM.
Mức độ cần thiết: 🟡 Quan trọng — Kênh thông báo chính của toàn hạ tầng

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ụcNội dung
Ứng dụng trong DNNotification relay cho tất cả service nội bộ, mailbox @hoatranlabs.local, anti-spam gateway
Tác dụng chínhSMTP 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 khaiService 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 đâyAlertmanager/Grafana alerts, Authentik email verification, Vaultwarden 2FA email, PBS backup reports
Cụm: HOATRANHUB — PVE 9.2.20 Node: node2 (10.11.45.211) — VLAN: VLAN_DMZ tag 35 VM: 246 | IP: 10.11.35.46/24 | GW: 10.11.35.1 | DNS: 10.11.45.53 Tài nguyên: 4 vCPU · 4 GB RAM · 50 GB (vm-ceph) Domain lab: hoatranlabs.local / mailu.hoatranlabs.local (alias mail.hoatranlabs.local)

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
mailu (Mailu Mail Server) · VM24610.11.35.4635 (DMZ) · node2Má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.21145 (MGMT) · cluster HOATRANHUBNode 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.21045 (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) · VM24210.11.25.4225 (SEC) · node1Cấ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) · VM24710.11.45.5345 (MGMT) · node3Phâ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) · VM23510.11.45.3545 (MGMT) · node2Alertmanager (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) · VM23610.11.45.3645 (MGMT) · node2Grafana 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) · VM23410.11.25.4025 (SEC) · node1Cấ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) · VM24310.11.25.4325 (SEC) · node1Cấu hình SMTP trong /opt/vaultwarden/.env: cổng 587, SMTP_SECURITY=starttls, mailbox noreply@ (bài 19).
pbs01 (PBS Primary) · VM10110.11.45.1745 (MGMT) · node4PBS đặ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.1Quản trị 10.100.100.0/24 · thiết bị mạngRule 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.

01

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ầnVai 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 FlaskQuản trị domain, mailbox, alias
RedisCache, 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ầnPhiên bảnGhi chú
Hệ điều hành VM246Ubuntu 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 Compose29.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 stableGó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.
Mailunhá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-alpineGiữ như bản cũ của bài.
step-cli0.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ổngGiao thứcMô tả
25/TCPSMTPNhận thư từ Internet hoặc nội bộ
587/TCPSubmissionGửi thư có xác thực (relay cho service khác)
993/TCPIMAP SSLClient kết nối hộp thư
443/TCPHTTPSWebmail Roundcube + Admin
80/TCPHTTPChuyển hướng sang HTTPS (compose front publish cổng này)
465/TCPSMTPSSMTP 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/TCPPOP3, POP3SClient POP3 (compose front có publish; không dùng trong lab, có thể bỏ khỏi ports)
02

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)

1
Đăng nhập Proxmox Web UI → chọn Node: node2 → nhấn Create VM (góc trên phải)
2
General:
  • VM ID: 246
  • Name: mailu
  • 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 (thường là vm-ceph)
  • Disk size: 50 GiB, Cache: Write back, Discard: ☑, SSD emulation: ☑
6
CPU:
  • Sockets: 1, Cores: 4, Type: host
7
Memory:
  • Memory (MiB): 4096
  • Ballooning Device: ☐ (bỏ tick — tương đương --balloon 0)
8
Network:
  • Bridge: vmbr0, VLAN Tag: 35, 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 246 mailu trên node2, 4 core host, 4096 MiB, scsi0 vm-ceph 50G, net0 vmbr0 tag=35.
Proxmox Create VM → tab Confirm: VM 246 mailu trên node2, 4 core host, 4096 MiB, scsi0 vm-ceph 50G, net0 vmbr0 tag=35.

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
Dung lượng đĩa trong lab: dựng bằng 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)
Trên VM q35 tên NIC thường là 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
Terminal VM246: `docker --version` (Docker Engine 29.9.1 từ repo noble), `docker compose version` và qemu-guest-agent ở trạng thái active (running) sau khi cài xong.
Terminal VM246: `docker --version` (Docker Engine 29.9.1 từ repo noble), `docker compose version` và qemu-guest-agent ở trạng thái active (running) sau khi cài xong.
03

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
Terminal VM246: step ca certificate cấp xong cert.pem và key.pem cho mail.hoatranlabs.local (SAN gồm mail, mailu.hoatranlabs.local và 10.11.35.46) tại /opt/mailu/certs.
Terminal VM246: step ca certificate cấp xong cert.pem và key.pem cho mail.hoatranlabs.local (SAN gồm mail, mailu.hoatranlabs.local và 10.11.35.46) tại /opt/mailu/certs.

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
04

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
Lưu ý: Thay 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
Vì sao có service 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).
05

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
Terminal VM246: `docker compose ps` trong /opt/mailu sau `docker compose up -d`: 9 container mailu-resolver, mailu-front, mailu-redis, mailu-admin, mailu-smtp, mailu-imap, mailu-antispam, mailu-oletools, mailu-webmail đều Up.
Terminal VM246: `docker compose ps` trong /opt/mailu sau `docker compose up -d`: 9 container mailu-resolver, mailu-front, mailu-redis, mailu-admin, mailu-smtp, mailu-imap, mailu-antispam, mailu-oletools, mailu-webmail đều Up.
06

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!

Trình duyệt tại https://mail.hoatranlabs.local/admin: giao diện Admin Mailu sau khi đăng nhập admin@hoatranlabs.local.
Trình duyệt tại https://mail.hoatranlabs.local/admin: giao diện Admin Mailu sau khi đăng nhập [email protected].
07

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
Mailu Admin → Mail domains → hoatranlabs.local → details: nút Regenerate keys và các bản ghi DNS DKIM (p=...) cùng DMARC hiển thị sẵn trên trang.
Mailu Admin → Mail domains → hoatranlabs.local → details: nút Regenerate keys và các bản ghi DNS DKIM (p=...) cùng DMARC hiển thị sẵn trên trang.

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
Pi-hole Admin (http://10.11.45.53/admin) → Settings → Local DNS Records: mailu.hoatranlabs.local và mail.hoatranlabs.local cùng trỏ tới 10.11.35.46.
Pi-hole Admin (http://10.11.45.53/admin) → Settings → Local DNS Records: mailu.hoatranlabs.local và mail.hoatranlabs.local cùng trỏ tới 10.11.35.46.

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).

Pi-hole v6: mặc định FTL KHÔNG đọc các file trong /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
08

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ổng587/TCP (submission)
Mã hóaSTARTTLS (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ựcBắ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
PBS Web UI (pbs01) → Configuration → Notifications → Notification Targets: target SMTP mailu-alerts (Server mailu.hoatranlabs.local, Port 587, STARTTLS, From alerts@hoatranlabs.local, gửi tới admin@hoatranlabs.local; che mật khẩu).
PBS Web UI (pbs01) → Configuration → Notifications → Notification Targets: target SMTP mailu-alerts (Server mailu.hoatranlabs.local, Port 587, STARTTLS, From [email protected], gửi tới [email protected]; che mật khẩu).

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 PVEGiá trị
Endpoint Namemailu-pve
Servermailu.hoatranlabs.local
EncryptionSTARTTLS (mode starttls)
Port587
Username[email protected]
PasswordPveAlerts@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.

Proxmox Datacenter → Notifications → Add → SMTP: endpoint mailu-pve với Server mailu.hoatranlabs.local, Port 587, Encryption STARTTLS, Username và From Address pve-alerts@hoatranlabs.local (che mật khẩu).
Proxmox Datacenter → Notifications → Add → SMTP: endpoint mailu-pve với Server mailu.hoatranlabs.local, Port 587, Encryption STARTTLS, Username và From Address [email protected] (che mật khẩu).
09

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ộ
10

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}}"
Proxmox Datacenter → Backup: job backup VM246 lúc 04:00 hằng ngày, mode Snapshot, nén zstd, storage pbs-primary.
Proxmox Datacenter → Backup: job backup VM246 lúc 04:00 hằng ngày, mode Snapshot, nén zstd, storage pbs-primary.
11

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
12

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 (repo noble của Docker) hoạt động
  • step-CA cert cấp cho mail.hoatranlabs.local (SAN thêm mailu.hoatranlabs.local và 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ới SECRET_KEY ngẫu nhiên
  • docker-compose.yml deploy thành công, 9 containers (gồm resolver) 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.local thê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-pve trê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@)

Zalo