Triển khai Pi-hole + DNS Sinkhole
DNS server nội bộ, lọc quảng cáo và bảo vệ toàn mạng.
Bối cảnh & Lý do triển khai
ops01 = 290 ở bài 07; template 9000–9002 cũng ở bài 07). Chạy lệnh sau trên mỗi node Proxmox để lấy danh sách VMID đang dùng — nếu có xung đột, điều chỉnh VMID trong file tương ứng trước khi qm create:
# Chạy trên node Proxmox (ví dụ node1):
pvesh get /nodes/node1/qemu --output-format json | python3 -c \
"import sys,json; [print(v['vmid']) for v in json.load(sys.stdin)]" | sort -n
# Hoặc đơn giản hơn:
qm list | awk '{print $1}' | sort -n
Không có DNS nội bộ, tất cả service phải giao tiếp với nhau qua IP thuần (10.11.45.35, 10.11.25.40...) — cứng nhắc, khó nhớ, và ngay khi đổi IP là phải sửa config khắp nơi. Pi-hole cung cấp DNS resolution cho domain hoatranlabs.local, đồng thời chặn quảng cáo và tracking cho toàn mạng.
| Mục | Nội dung |
|---|---|
| Ứng dụng trong DN | Internal service discovery (hostname thay IP), DNS filtering/blocking cho toàn mạng, network-level ad blocking |
| Tác dụng chính | Resolve tất cả .hoatranlabs.local hostname; block 100K+ domain quảng cáo/malware; DNS-over-HTTPS upstream |
| Nếu không triển khai | Không service nào gọi được tên nhau — mọi config phải dùng IP hardcode, đổi IP là hỏng tất cả |
| Các service phụ thuộc vào đây | Tất cả 30 VM và 4 node PVE đều dùng Pi-hole làm DNS server chính |
Ngày cập nhật: 2026-10-15
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 |
|---|---|---|---|
| pihole (Pi-hole DNS) · VM247 | 10.11.45.53 | 45 (MGMT) · node3 | Máy chủ của bài — Ubuntu 24.04 + Docker Compose (network host), Pi-hole v6; DNS cổng 53, Admin UI cổng 80, upstream 1.1.1.1 và 8.8.8.8. |
| node3 (Proxmox VE) | 10.11.45.212 | 45 (MGMT) · cluster HOATRANHUB | Node Proxmox chứa VM247; tạo VM tại đây (storage vm-ceph, VLAN tag 45) và đổi /etc/resolv.conf của node về Pi-hole. |
| FortiGate (firewall) | 10.100.100.1 | Quản trị 10.100.100.0/24 · thiết bị mạng | Đẩy DNS 10.11.45.53 cho 5 VLAN qua DHCP (dns-server2 8.8.8.8) và tạo policy Allow-DNS-to-Pihole cho các VLAN gọi DNS về Pi-hole. |
| node1 (Proxmox VE) | 10.11.45.210 | 45 (MGMT) · cluster HOATRANHUB | Node PVE đổi /etc/resolv.conf về nameserver Pi-hole, khóa bằng chattr +i, kiểm tra bằng host pbs01.hoatranlabs.local (làm trên node1–node4). |
| node2 (Proxmox VE) | 10.11.45.211 | 45 (MGMT) · cluster HOATRANHUB | Node PVE đổi /etc/resolv.conf về nameserver Pi-hole và khóa bằng chattr +i, tương tự node1. |
| node4 (Proxmox VE) | 10.11.45.213 | 45 (MGMT) · cluster HOATRANHUB | Node PVE đổi /etc/resolv.conf về nameserver Pi-hole như node1; là node gợi ý đặt Pi-hole secondary tùy chọn. |
| pbs01 (PBS Primary) · VM101 | 10.11.45.17 | 45 (MGMT) · node4 | Sao lưu snapshot VM247 (mục checklist) và là tên dùng để thử phân giải trên node PVE: host pbs01.hoatranlabs.local (bài 04). |
| prometheus (Prometheus + Alertmanager) · VM235 | 10.11.45.35 | 45 (MGMT) · node2 | Scrape node_exporter cổng 9100 của VM247 để giám sát Pi-hole; bản ghi prometheus và loki trỏ về máy này (bài 15). |
| grafana (Grafana + Uptime Kuma + Gotify) · VM236 | 10.11.45.36 | 45 (MGMT) · node2 | Hiển thị metrics Pi-hole bằng dashboard cộng đồng #10176; bản ghi grafana, kuma, gotify và CNAME monitoring trỏ về máy này (bài 15). |
| authentik (Authentik SSO) · VM234 | 10.11.25.40 | 25 (SEC) · node1 | Máy dùng để kiểm thử phân giải: nslookup authentik.hoatranlabs.local phải ra 10.11.25.40; CNAME sso và www trỏ về máy này (bài 14). |
| wifi-dc01 (Windows Server 2022: AD DS, DNS, NPS, AD CS) · VM281 | 10.11.65.52 | 65 (SRV) · node2 | Đích conditional forward: Pi-hole chuyển truy vấn *.wifilab.local tới DNS của DC này bằng misc.dnsmasq_lines (mục 3.4, bài 39). |
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. Bảng bản ghi DNS đầy đủ của lab nằm ở Phần 3 (mục 3.1); bảng này chỉ liệt kê các máy mà bài cấu hình hoặc dùng để kiểm tra.
Tổng Quan
Pi-hole là DNS sinkhole + recursive resolver mã nguồn mở. Trong HOATRANLABS, Pi-hole VM247 phục vụ DNS cho toàn bộ 5 VLAN (MGMT, SEC, DMZ, SRV, STORAGE), cung cấp:
- DNS resolution nội bộ: Tất cả hostname
*.hoatranlabs.localđều được resolve qua Pi-hole; riêng zone AD của domainhoatranlabs.localdo dc1 (Samba AD DC, bài 25) phục vụ nên các máy join domain dùng DNS =10.11.65.50(dc1 chuyển tiếp tên ngoài zone về Pi-hole10.11.45.53) - Ad/tracking blocking: Chặn các domain quảng cáo và tracking
- Upstream forwarding: Chuyển tiếp query không có trong blocklist lên 1.1.1.1 / 8.8.8.8
- Reverse DNS: Resolve ngược IP → hostname trong toàn bộ subnet 10.11.0.0/16
- Chuyển tiếp có điều kiện (conditional forwarding): tên miền
wifilab.local(domain WiFi RADIUS độc lập, bài 39/40) được chuyển tiếp tới DNS của domain đó (wifi-dc0110.11.65.52) để mọi máy trong lab phân giải được tên của domain WiFi (xem mục 3.4)
- Cấu hình DNS fallback 8.8.8.8 trong FortiGate DHCP cho từng VLAN
- Cân nhắc cài Pi-hole thứ hai (secondary) trên node khác
Thông tin VM:
| Thuộc tính | Giá trị |
|---|---|
| VMID | 247 |
| Hostname | pihole |
| Node | node3 (10.11.45.212) |
| IP | 10.11.45.53/24 |
| Gateway | 10.11.45.1 |
| VLAN | VLAN_MGMT (tag 45) |
| vCPU | 2 |
| RAM | 2 GB |
| Disk | 20 GB (Ceph) |
| OS | Ubuntu Server 24.04 LTS (Noble Numbat) |
| Ports | 53/TCP+UDP (DNS), 80/TCP (Admin UI), 443/TCP |
Phiên bản phần mềm sử dụng (đã xác minh 2026-10-15):
| Thành phần | Phiên bản | Ghi chú |
|---|---|---|
| Ubuntu Server | 24.04.5 LTS (ISO ubuntu-24.04.5-live-server-amd64.iso) | Hỗ trợ chuẩn tới 04/2029; kernel 6.8, systemd 255, netplan 1.0 |
| Docker Engine + Compose plugin | Bản stable mới nhất trong repo download.docker.com/linux/ubuntu noble (29.9.1 ngày 2026-10-14) | Cài docker-ce + docker-compose-plugin (lệnh docker compose), không dùng gói docker.io của Ubuntu |
Pi-hole (Docker image pihole/pihole) | latest = 2026.09.0 (FTL v6.7.1) | Pi-hole v6: cấu hình bằng biến FTLCONF_*; ghim tag 2026.09.0 nếu cần tái lập chính xác |
| node_exporter | 1.12.1 | Cổng 9100, cài bằng tarball + systemd |
Tạo VM247 trên Proxmox
Tạo VM trên Proxmox (node3) · Cài đặt Ubuntu Server 24.04 LTS · Cấu hình netplan
1.1 Tạo VM trên Proxmox (node3)
Cách 1: Web UI Proxmox (GUI)
- VM ID:
247 - Name:
pihole - Bỏ tick Start after created
- Storage:
local(hoặc nơi chứa ISO) - ISO Image:
ubuntu-24.04.5-live-server-amd64.iso(tải từ https://releases.ubuntu.com/24.04/) - 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:45, Model:VirtIO (paravirtualized), Firewall: ☐
Cách 2: CLI (qm create)
qm create 247 --name pihole \
--memory 2048 \
--cores 2 \
--net0 virtio,bridge=vmbr0,tag=45 \
--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 \
--onboot 1
1.2 Cài đặt Ubuntu Server 24.04 LTS
Khởi động VM và cài qua console Proxmox (bộ cài Ubuntu Server 24.04 LTS, chọn Ubuntu Server — không chọn minimized). Trong quá trình cài:
- Hostname:
pihole - Username:
sysadmin - IP tĩnh:
10.11.45.53/24 - Gateway:
10.11.45.1 - DNS (lúc cài):
8.8.8.8← dùng tạm, chưa có Pi-hole
127.0.0.1 để VM dùng Pi-hole local.
1.3 Cấu hình netplan
Tên card mạng (NIC) phụ thuộc kiểu máy ảo: VM tạo bằng Web UI ở mục 1.1 (machine q35) thường có NIC tên enp6s18, VM tạo bằng qm create (mặc định i440fx) thường là ens18. Kiểm tra tên thật trước khi sửa netplan:
ip -br link
# Cột đầu tiên là tên NIC (bỏ qua lo), ví dụ: enp6s18 UP bc:24:11:xx:xx:xx
Thay ens18 trong file bên dưới (và trong FTLCONF_dns_interface ở mục 2.1) bằng đúng tên NIC vừa xem; sai tên thì netplan không gán IP cho NIC và Pi-hole không nhận query.
Trên Ubuntu 24.04 file netplan do bộ cài/cloud-init sinh ra thường là /etc/netplan/50-cloud-init.yaml (bộ cài đời trước dùng 00-installer-config.yaml). Chạy ls /etc/netplan/ và sửa đúng file đang có (đừng tạo thêm file thứ hai chứa cùng NIC, netplan sẽ gộp cả hai). Để cloud-init không ghi đè cấu hình mạng sau khi khởi động lại, tắt phần mạng của cloud-init:
echo 'network: {config: disabled}' | sudo tee /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg
# /etc/netplan/50-cloud-init.yaml (tên file: xem kết quả ls /etc/netplan/)
network:
version: 2
ethernets:
ens18:
addresses:
- 10.11.45.53/24
routes:
- to: default
via: 10.11.45.1
nameservers:
addresses:
- 127.0.0.1
- 8.8.8.8
search:
- hoatranlabs.local
sudo chmod 600 /etc/netplan/*.yaml # netplan 1.0 (Ubuntu 24.04) cảnh báo nếu file cấu hình đọc được bởi user khác
sudo netplan apply
sudo (ghi file hệ thống, chattr, ufw...): đăng nhập sysadmin rồi chạy sudo -i để làm việc bằng root, hoặc thêm sudo vào từng lệnh.
1.4 Giải quyết xung đột port 53 với systemd-resolved
Đây là bẫy phổ biến nhất khi cài Pi-hole trên Ubuntu Server 24.04 (cũng như các bản Ubuntu trước). systemd-resolved chiếm port 53 → Pi-hole container không bind được.
# Kiểm tra xem port 53 có đang bị chiếm không
ss -tlnup | grep ':53'
# Nếu có systemd-resolved đang dùng port 53, tắt stub listener
sudo mkdir -p /etc/systemd/resolved.conf.d/
cat > /etc/systemd/resolved.conf.d/no-stub.conf << 'EOF'
[Resolve]
DNSStubListener=no
DNS=8.8.8.8
EOF
# Xóa symlink /etc/resolv.conf và tạo file tĩnh
rm /etc/resolv.conf
cat > /etc/resolv.conf << 'EOF'
nameserver 127.0.0.1
nameserver 8.8.8.8
EOF
chattr +i /etc/resolv.conf # Khóa để cloud-init không ghi đè
systemctl restart systemd-resolved
# Verify port 53 đã free
ss -tlnup | grep ':53'
# Phải không còn dòng nào từ systemd-resolved
1.5 Cài Docker
Dùng repo chính thức của Docker cho Ubuntu 24.04 (suite noble, dạng deb822 + Signed-By, không dùng apt-key) thay cho các gói docker.io/docker-compose-v2 của Ubuntu:
# Tránh hộp thoại needrestart (Ubuntu 24.04) dừng lại hỏi khi apt cập nhật thư viện
export NEEDRESTART_MODE=a
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 2>/dev/null || true
# Thêm repo Docker (suite noble)
apt install -y ca-certificates curl
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
usermod -aG docker sysadmin
docker --version && docker compose version
grep Suites /etc/apt/sources.list.d/docker.sources # phải ra: Suites: noble
# Docker Engine mới nhất đã xác minh 2026-10-15: 29.9.1
Cài Đặt Pi-hole via Docker Compose
Tạo thư mục và docker-compose.yml · Khởi động Pi-hole · Kiểm tra DNS hoạt động
2.1 Tạo thư mục và docker-compose.yml
mkdir -p /opt/pihole/scripts
# /opt/pihole/docker-compose.yml
# (Compose V2 hiện hành không còn dùng khóa "version:" — để lại sẽ có cảnh báo "attribute version is obsolete")
services:
pihole:
image: pihole/pihole:latest # đã xác minh 2026-10-15: 2026.09.0 (FTL v6.7.1); muốn cố định thì ghi pihole/pihole:2026.09.0
container_name: pihole
hostname: pihole
restart: unless-stopped
network_mode: host # Dùng host network để bind port 53 trực tiếp
environment:
TZ: "Asia/Ho_Chi_Minh"
# Pi-hole v6 (image latest) cấu hình bằng biến FTLCONF_<mục>_<khóa>; các biến v5
# (WEBPASSWORD, PIHOLE_DNS_, DNSSEC, VIRTUAL_HOST, REV_SERVER_*, INTERFACE, DNSMASQ_LISTENING) không còn tác dụng
FTLCONF_webserver_api_password: "Admin@PiHole2024"
FTLCONF_dns_upstreams: "1.1.1.1;8.8.8.8"
FTLCONF_dns_dnssec: "true"
# Reverse DNS cho toàn subnet lab (định dạng: <bật>,<CIDR>,<server>,<domain>)
FTLCONF_dns_revServers: "true,10.11.0.0/16,10.11.45.1,hoatranlabs.local"
# Interface binding (tên NIC lấy ở mục 1.3; sai tên thì chế độ SINGLE chỉ nhận query trên lo)
FTLCONF_dns_interface: "ens18"
FTLCONF_dns_listeningMode: "SINGLE"
volumes:
- pihole_etc:/etc/pihole
- pihole_dnsmasq:/etc/dnsmasq.d
cap_add:
- NET_ADMIN
- NET_RAW
volumes:
pihole_etc:
pihole_dnsmasq:
FTLCONF_* trong compose đều trở thành chỉ đọc (không sửa được bằng Admin UI hay pihole-FTL --config). Vì vậy compose này chỉ đặt webserver.api.password, dns.upstreams, dns.dnssec, dns.revServers, dns.interface, dns.listeningMode; còn dns.hosts (script mục 3.2) và misc.dnsmasq_lines (conditional forward wifilab.local, mục 3.4; bài 39/40 cũng ghi bằng lệnh) cố ý KHÔNG đặt ở đây.network_mode: host? Pi-hole cần bind trực tiếp port 53/UDP trên tất cả interface. Bridge network đôi khi gây vấn đề với UDP DNS query. Host mode đơn giản và đáng tin cậy nhất cho Pi-hole trên Ubuntu VM.2.2 Khởi động Pi-hole
cd /opt/pihole
docker compose pull
docker compose up -d
# Kiểm tra container đang chạy
docker compose ps
docker compose logs --tail=30 pihole
2.3 Kiểm tra DNS hoạt động
# Test DNS resolution từ VM host
dig @127.0.0.1 google.com +short
# Kết quả: phải ra một IP address
# Test từ PVE nodes hoặc VM khác trong VLAN_MGMT
dig @10.11.45.53 google.com +short
# Test admin UI (Pi-hole v6 chuyển hướng /admin về /admin/ rồi sang trang đăng nhập nên cần -L)
curl -sL -o /dev/null -w "%{http_code}" http://10.11.45.53/admin/
# Kết quả: 200
Truy cập Admin UI: http://10.11.45.53/admin
Password: Admin@PiHole2024
Cấu Hình DNS Records Nội Bộ
Thêm Local DNS Records thủ công · Script tự động thêm DNS records qua API · CNAME Records
3.1 Thêm Local DNS Records thủ công
Pi-hole Admin UI (GUI)
Đăng nhập Pi-hole Admin → Settings → Local DNS Records (khung Local DNS records: nhập Domain, IP rồi nhấn nút +)
Thêm từng record theo bảng sau:
VLAN_MGMT (10.11.45.0/24)
| Domain | IP | Mô tả |
|---|---|---|
| node1.hoatranlabs.local | 10.11.45.210 | Proxmox node1 |
| node2.hoatranlabs.local | 10.11.45.211 | Proxmox node2 |
| node3.hoatranlabs.local | 10.11.45.212 | Proxmox node3 |
| node4.hoatranlabs.local | 10.11.45.213 | Proxmox node4 |
| pbs01.hoatranlabs.local | 10.11.45.17 | Proxmox Backup Server (PBS Primary) VM101 |
| pdm01.hoatranlabs.local | 10.11.45.18 | Proxmox Datacenter Manager VM102 |
| syno-primary.hoatranlabs.local | 10.11.45.16 | Synology NAS primary |
| ops01.hoatranlabs.local | 10.11.45.20 | ops01 VM290 — máy quản trị/tự động hoá (Ansible, OpenTofu, bastion; tạo ở bài 07) |
| ups01.hoatranlabs.local | 10.11.45.19 | ups01 — UPS có thẻ mạng NMC/SNMP, NUT (bài 10) |
| prometheus.hoatranlabs.local | 10.11.45.35 | Prometheus VM235 |
| grafana.hoatranlabs.local | 10.11.45.36 | Grafana VM236 |
| kuma.hoatranlabs.local | 10.11.45.36 | Uptime Kuma (chạy trên VM236, bài 15) |
| gotify.hoatranlabs.local | 10.11.45.36 | Gotify (chạy trên VM236, bài 15) |
| loki.hoatranlabs.local | 10.11.45.35 | Loki (chạy trên VM235, bài 33) |
| wazuh-siem.hoatranlabs.local | 10.11.45.25 | Wazuh SIEM VM280 |
| wazuh.hoatranlabs.local | 10.11.45.25 | Alias của wazuh-siem |
| harbor.hoatranlabs.local | 10.11.45.39 | Harbor Registry VM239 |
| gitea.hoatranlabs.local | 10.11.45.40 | Gitea VM240 |
| netbox.hoatranlabs.local | 10.11.45.45 | NetBox IPAM VM245 |
| pihole.hoatranlabs.local | 10.11.45.53 | Pi-hole (this VM) |
| node5.hoatranlabs.local | 10.100.100.20 | Proxmox node5 (standalone, site phụ 10.100.100.0/24) |
| node6.hoatranlabs.local | 10.100.100.21 | Proxmox node6 (standalone, site phụ 10.100.100.0/24) |
| pbsdr01.hoatranlabs.local | 10.100.100.6 | Proxmox Backup Server DR (site phụ 10.100.100.0/24) |
| syno-secondary.hoatranlabs.local | 10.100.100.5 | Synology NAS secondary (site phụ 10.100.100.0/24) |
VLAN_SEC (10.11.25.0/24)
| Domain | IP | Mô tả |
|---|---|---|
| authentik.hoatranlabs.local | 10.11.25.40 | Authentik SSO VM234 |
| privacyidea.hoatranlabs.local | 10.11.25.30 | PrivacyIDEA 2FA VM233 |
| mfa.hoatranlabs.local | 10.11.25.30 | Alias của privacyidea (bài 18) |
| step-ca.hoatranlabs.local | 10.11.25.42 | step-CA PKI VM242 |
| pki.hoatranlabs.local | 10.11.25.42 | Alias của step-ca (bài 13) |
| vaultwarden.hoatranlabs.local | 10.11.25.43 | Vaultwarden VM243 |
| openvas.hoatranlabs.local | 10.11.25.44 | Greenbone OpenVAS VM244 |
| vault.hoatranlabs.local | 10.11.25.10 | HashiCorp Vault VM269 |
| thehive.hoatranlabs.local | 10.11.25.11 | TheHive VM270 |
| cortex.hoatranlabs.local | 10.11.25.11 | Cortex (chạy cùng VM270, bài 35) |
VLAN_DMZ (10.11.35.0/24)
| Domain | IP | Mô tả |
|---|---|---|
| headscale.hoatranlabs.local | 10.11.35.10 | Headscale VPN VM232 |
| mailu.hoatranlabs.local | 10.11.35.46 | Mailu Mail Server VM246 |
| mail.hoatranlabs.local | 10.11.35.46 | CNAME alias cho mailu.hoatranlabs.local |
| crowdsec.hoatranlabs.local | 10.11.35.20 | CrowdSec VM271 |
VLAN_SRV (10.11.65.0/24) + VLAN_STORAGE (10.11.85.0/24)
| Domain | IP | Mô tả |
|---|---|---|
| mediamtx.hoatranlabs.local | 10.11.65.41 | MediaMTX RTSP VM241 |
| dc1.hoatranlabs.local | 10.11.65.50 | Samba AD DC VM250 (bài 25) — phục vụ zone AD hoatranlabs.local |
| ad.hoatranlabs.local | 10.11.65.50 | Alias của dc1 |
| samba01.hoatranlabs.local | 10.11.65.51 | Samba File Server VM251 |
| samba.hoatranlabs.local | 10.11.65.51 | Alias của samba01 |
| unifi.hoatranlabs.local | 10.11.65.53 | UniFi Network Application (Controller) VM282 (bài 39) |
| mattermost.hoatranlabs.local | 10.11.65.57 | Mattermost VM272 |
| sonarqube.hoatranlabs.local | 10.11.65.66 | SonarQube VM266 |
| nexus.hoatranlabs.local | 10.11.65.67 | Nexus Repository VM267 |
| docker-internal.hoatranlabs.local | 10.11.65.67 | Docker registry nội bộ của Nexus VM267 (bài 31) |
| k3s.hoatranlabs.local | 10.11.65.55 | K3s API VIP (kube-vip, bài 28) |
| traefik.hoatranlabs.local | 10.11.65.100 | Traefik dashboard (K3s ingress VIP, bài 28) |
| grafana-k8s.hoatranlabs.local | 10.11.65.100 | Grafana trong K3s (K3s ingress VIP, bài 28) |
| argocd.hoatranlabs.local | 10.11.65.100 | ArgoCD (K3s ingress VIP/Traefik, bài 28–29) |
| s3.hoatranlabs.local | 10.11.85.10 | SeaweedFS S3 VM268 (VLAN_STORAGE, tag 85): S3 API cổng 443, Admin UI cổng 8443 (bài 32) |
3.2 Script tự động thêm DNS records qua API
#!/bin/bash
# /opt/pihole/scripts/add_dns_records.sh
# Thêm toàn bộ DNS records lab vào Pi-hole v6 (setting dns.hosts) bằng pihole-FTL --config trong container.
# Script GHI ĐÈ cả danh sách dns.hosts nên chạy lại bao nhiêu lần cũng cho cùng kết quả.
# Không đặt FTLCONF_dns_hosts trong docker-compose.yml: biến môi trường làm setting chỉ đọc, script sẽ không ghi được.
RECORDS=()
add_dns() {
local domain="$1"
local ip="$2"
echo "Adding $domain → $ip"
RECORDS+=("\"${ip} ${domain}\"")
}
echo "=== VLAN_MGMT (10.11.45.0/24) ==="
add_dns "node1.hoatranlabs.local" "10.11.45.210"
add_dns "node2.hoatranlabs.local" "10.11.45.211"
add_dns "node3.hoatranlabs.local" "10.11.45.212"
add_dns "node4.hoatranlabs.local" "10.11.45.213"
add_dns "pbs01.hoatranlabs.local" "10.11.45.17"
add_dns "pdm01.hoatranlabs.local" "10.11.45.18"
add_dns "syno-primary.hoatranlabs.local" "10.11.45.16"
add_dns "ops01.hoatranlabs.local" "10.11.45.20"
add_dns "ups01.hoatranlabs.local" "10.11.45.19"
add_dns "prometheus.hoatranlabs.local" "10.11.45.35"
add_dns "grafana.hoatranlabs.local" "10.11.45.36"
add_dns "kuma.hoatranlabs.local" "10.11.45.36"
add_dns "gotify.hoatranlabs.local" "10.11.45.36"
add_dns "loki.hoatranlabs.local" "10.11.45.35"
add_dns "wazuh-siem.hoatranlabs.local" "10.11.45.25"
add_dns "wazuh.hoatranlabs.local" "10.11.45.25"
add_dns "harbor.hoatranlabs.local" "10.11.45.39"
add_dns "gitea.hoatranlabs.local" "10.11.45.40"
add_dns "netbox.hoatranlabs.local" "10.11.45.45"
add_dns "pihole.hoatranlabs.local" "10.11.45.53"
echo ""
echo "=== Site phụ (10.100.100.0/24) ==="
add_dns "node5.hoatranlabs.local" "10.100.100.20"
add_dns "node6.hoatranlabs.local" "10.100.100.21"
add_dns "pbsdr01.hoatranlabs.local" "10.100.100.6"
add_dns "syno-secondary.hoatranlabs.local" "10.100.100.5"
echo ""
echo "=== VLAN_SEC (10.11.25.0/24) ==="
add_dns "authentik.hoatranlabs.local" "10.11.25.40"
add_dns "privacyidea.hoatranlabs.local" "10.11.25.30"
add_dns "mfa.hoatranlabs.local" "10.11.25.30"
add_dns "step-ca.hoatranlabs.local" "10.11.25.42"
add_dns "pki.hoatranlabs.local" "10.11.25.42"
add_dns "vaultwarden.hoatranlabs.local" "10.11.25.43"
add_dns "openvas.hoatranlabs.local" "10.11.25.44"
add_dns "vault.hoatranlabs.local" "10.11.25.10"
add_dns "thehive.hoatranlabs.local" "10.11.25.11"
add_dns "cortex.hoatranlabs.local" "10.11.25.11"
echo ""
echo "=== VLAN_DMZ (10.11.35.0/24) ==="
add_dns "headscale.hoatranlabs.local" "10.11.35.10"
add_dns "mailu.hoatranlabs.local" "10.11.35.46"
add_dns "mail.hoatranlabs.local" "10.11.35.46"
add_dns "crowdsec.hoatranlabs.local" "10.11.35.20"
echo ""
echo "=== VLAN_SRV (10.11.65.0/24) + VLAN_STORAGE (10.11.85.0/24) ==="
add_dns "mediamtx.hoatranlabs.local" "10.11.65.41"
add_dns "dc1.hoatranlabs.local" "10.11.65.50"
add_dns "ad.hoatranlabs.local" "10.11.65.50"
add_dns "samba01.hoatranlabs.local" "10.11.65.51"
add_dns "samba.hoatranlabs.local" "10.11.65.51"
add_dns "unifi.hoatranlabs.local" "10.11.65.53"
add_dns "mattermost.hoatranlabs.local" "10.11.65.57"
add_dns "sonarqube.hoatranlabs.local" "10.11.65.66"
add_dns "nexus.hoatranlabs.local" "10.11.65.67"
add_dns "docker-internal.hoatranlabs.local" "10.11.65.67"
add_dns "k3s.hoatranlabs.local" "10.11.65.55"
add_dns "traefik.hoatranlabs.local" "10.11.65.100"
add_dns "grafana-k8s.hoatranlabs.local" "10.11.65.100"
add_dns "argocd.hoatranlabs.local" "10.11.65.100"
add_dns "s3.hoatranlabs.local" "10.11.85.10"
echo ""
echo "=== Ghi vào Pi-hole (dns.hosts) ==="
HOSTS_JSON="["
for r in "${RECORDS[@]}"; do
HOSTS_JSON+=" ${r},"
done
HOSTS_JSON="${HOSTS_JSON%,} ]"
if docker exec pihole pihole-FTL --config dns.hosts "$HOSTS_JSON" > /dev/null; then
docker exec pihole pihole reloaddns
echo "OK: ${#RECORDS[@]} records"
else
echo "FAIL: không ghi được dns.hosts (container pihole đang chạy chưa?)"
exit 1
fi
echo ""
echo "=== Hoàn tất ==="
chmod +x /opt/pihole/scripts/add_dns_records.sh
/opt/pihole/scripts/add_dns_records.sh
3.3 CNAME Records
Trong Pi-hole Admin → Settings → Local DNS Records (khung Local CNAME records: nhập Domain, Target rồi nhấn nút +):
www.hoatranlabs.local → authentik.hoatranlabs.local
sso.hoatranlabs.local → authentik.hoatranlabs.local
monitoring.hoatranlabs.local → grafana.hoatranlabs.local
webmail.hoatranlabs.local → mail.hoatranlabs.local
3.4 Chuyển tiếp có điều kiện (conditional forward) cho domain WiFi wifilab.local
Domain WiFi RADIUS (bài 39/40) là domain AD độc lập wifilab.local, do wifi-dc01 (10.11.65.52) phục vụ DNS; Pi-hole không giữ bản ghi của domain này. Để mọi máy trong lab hỏi Pi-hole mà vẫn phân giải được *.wifilab.local, thêm một dòng dnsmasq server=/wifilab.local/<IP DC> vào setting misc.dnsmasq_lines (không dùng dns.revServers vì setting đó đã đặt bằng biến môi trường trong compose nên chỉ đọc). Làm bước này khi triển khai bài 39 (chi tiết và kiểm tra ở bài 39 mục 1.8); nếu chưa dùng WiFi RADIUS thì bỏ qua:
# Trên VM247 (container "pihole")
docker exec pihole pihole-FTL --config misc.dnsmasq_lines '["server=/wifilab.local/10.11.65.52"]'
docker exec pihole pihole reloaddns
# Kiểm tra
docker exec pihole pihole-FTL --config misc.dnsmasq_lines
dig +short wifi-dc01.wifilab.local @10.11.45.53 # mong đợi: 10.11.65.52
--config misc.dnsmasq_lines ghi đè cả mảng. Bài 40 (thêm DC thứ hai wifi-dc02 10.11.65.54) đặt lại mảng gồm hai dòng server=/wifilab.local/..., rồi chỉ còn dòng của 10.11.65.54 sau khi hạ cấp wifi-dc01. Từ FTL v6.7 (Docker 2026.09.0) setting này không sửa được qua API/Admin UI nữa nhưng vẫn đặt được bằng pihole-FTL --config như trên. Việc DNSSEC của Pi-hole có làm wifilab.local (tên miền nội bộ không ký) trả SERVFAIL hay không: cần kiểm lại trên máy thật (xem Troubleshooting bài 39).
Tích Hợp với Hạ Tầng Lab
Cấu hình FortiGate DHCP — đẩy DNS Pi-hole cho từng VLAN · Cấu hình 4 PVE nodes dùng Pi-hole DNS · Tích hợp Unbound (tùy chọn — nâng cao)
4.1 Cấu hình FortiGate DHCP — đẩy DNS Pi-hole cho từng VLAN
Đăng nhập FortiGate (10.100.100.1) → Network → DHCP Server
Chỉnh sửa DHCP server cho từng VLAN interface:
# FortiGate CLI
config system dhcp server
edit <DHCP_VLAN45_ID>
set dns-server1 10.11.45.53
set dns-server2 8.8.8.8
set domain hoatranlabs.local
next
edit <DHCP_VLAN25_ID>
set dns-server1 10.11.45.53
set dns-server2 8.8.8.8
next
edit <DHCP_VLAN35_ID>
set dns-server1 10.11.45.53
set dns-server2 8.8.8.8
next
edit <DHCP_VLAN65_ID>
set dns-server1 10.11.45.53
set dns-server2 8.8.8.8
next
edit <DHCP_VLAN85_ID>
set dns-server1 10.11.45.53
set dns-server2 8.8.8.8
next
end
4.2 Cấu hình 4 PVE nodes dùng Pi-hole DNS
Chạy lệnh sau trên từng node (node1 đến node4):
# Thay thế /etc/resolv.conf
cat > /etc/resolv.conf << 'EOF'
nameserver 10.11.45.53
nameserver 8.8.8.8
search hoatranlabs.local
EOF
# Khóa file để PVE/cloud-init không ghi đè
chattr +i /etc/resolv.conf
# Test
host pbs01.hoatranlabs.local
# Kết quả: pbs01.hoatranlabs.local has address 10.11.45.17
/etc/resolv.conf ở mục này mà giữ DNS của site phụ là FortiGate 10.100.100.1 (bản ghi node5/node6 nằm trong Pi-hole để máy ở site chính phân giải được tên của chúng). Chỉ khi đã có route/VPN site-to-site và policy cho phép DNS từ 10.100.100.0/24 tới 10.11.45.53 mới chạy các lệnh trên cho node5/node6, đặt nameserver 10.11.45.53 trước và nameserver 10.100.100.1 sau để vừa phân giải được *.hoatranlabs.local vừa còn DNS dự phòng.
4.3 Tích hợp Unbound (tùy chọn — nâng cao)
Unbound cho phép Pi-hole làm recursive resolver độc lập mà không cần upstream DNS, giải quyết query trực tiếp từ root nameserver → tăng privacy.
# /opt/pihole/docker-compose.yml — thêm service unbound
services:
pihole:
# ... (giữ nguyên, chỉ đổi FTLCONF_dns_upstreams)
environment:
FTLCONF_dns_upstreams: "127.0.0.1#5335" # ← Đổi upstream sang Unbound
depends_on:
- unbound
unbound:
image: mvance/unbound:latest
container_name: unbound
restart: unless-stopped
network_mode: host
volumes:
- /opt/pihole/unbound/unbound.conf:/opt/unbound/etc/unbound/unbound.conf:ro
# /opt/pihole/unbound/unbound.conf
server:
verbosity: 0
interface: 127.0.0.1
port: 5335
do-ip4: yes
do-udp: yes
do-tcp: yes
do-ip6: no
prefer-ip6: no
harden-glue: yes
harden-dnssec-stripped: yes
use-caps-for-id: no
edns-buffer-size: 1472
prefetch: yes
num-threads: 1
so-rcvbuf: 1m
private-address: 192.168.0.0/16
private-address: 169.254.0.0/16
private-address: 172.16.0.0/12
private-address: 10.0.0.0/8
private-address: fd00::/8
private-address: fe80::/10
Cấu Hình Firewall
UFW trên VM247 · FortiGate — cho phép các VLAN query DNS
5.1 UFW trên VM247
ufw allow ssh
ufw allow 53/tcp
ufw allow 53/udp
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable
ufw status verbose
5.2 FortiGate — cho phép các VLAN query DNS
# Chính sách FortiGate: Cho phép DNS từ tất cả VLAN về Pi-hole
config firewall policy
edit 0
set name "Allow-DNS-to-Pihole"
set srcintf "vlan25" "vlan35" "vlan65" "vlan85"
set dstintf "vlan45"
set srcaddr "all"
set dstaddr "10.11.45.53"
set service "DNS"
set action accept
set logtraffic all
next
end
Blocklist và Customization
Thêm blocklist phổ biến · Whitelist domain quan trọng trong lab
6.1 Thêm blocklist phổ biến
Pi-hole Admin → Lists → ô Address → Add blocklist:
# Recommended blocklists
https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts
https://adaway.org/hosts.txt
https://v.firebog.net/hosts/AdguardDNS.txt
https://v.firebog.net/hosts/Easylist.txt
# Cập nhật gravity (blocklist) từ CLI
docker exec pihole pihole -g
6.2 Whitelist domain quan trọng trong lab
Pi-hole Admin → Domains → tab Domain → nhập domain → Add to allowed domains (Pi-hole v6 gọi whitelist là allowlist):
# Prevent blocking internal services
hoatranlabs.local # tick "Add domain as wildcard" để áp dụng cho cả *.hoatranlabs.local
github.com
ghcr.io
registry-1.docker.io
quay.io
Backup và High Availability
Backup cấu hình Pi-hole · Pi-hole Secondary (tùy chọn)
7.1 Backup cấu hình Pi-hole
#!/bin/bash
# /opt/pihole/scripts/backup.sh
BACKUP_DIR="/opt/pihole-backups"
DATE=$(date +%Y%m%d_%H%M%S)
mkdir -p "$BACKUP_DIR"
# Backup Pi-hole teleporter (tất cả config trong 1 file .zip; Pi-hole v6 dùng pihole-FTL --teleporter thay cho pihole -a -t)
docker exec -w /tmp pihole pihole-FTL --teleporter
TELEPORTER=$(docker exec pihole sh -c 'ls -t /tmp/pi-hole_*_teleporter_*.zip | head -n 1')
docker cp "pihole:${TELEPORTER}" "${BACKUP_DIR}/pihole_${DATE}.zip"
docker exec pihole rm -f "${TELEPORTER}"
# Backup docker-compose và script
cp /opt/pihole/docker-compose.yml "${BACKUP_DIR}/docker-compose_${DATE}.yml"
# Giữ 14 ngày backup
find "$BACKUP_DIR" -name "*.zip" -mtime +14 -delete
echo "Backup: ${BACKUP_DIR}/pihole_${DATE}.zip"
chmod +x /opt/pihole/scripts/backup.sh
echo "0 2 * * * /opt/pihole/scripts/backup.sh >> /var/log/pihole-backup.log 2>&1" | crontab -
# Chạy thử một lần rồi kiểm tra thư mục backup và lịch cron
/opt/pihole/scripts/backup.sh
ls -lh /opt/pihole-backups/
# Phải thấy pihole_<ngày>_<giờ>.zip (Teleporter) và docker-compose_<ngày>_<giờ>.yml
crontab -l
7.2 Pi-hole Secondary (tùy chọn)
Nếu muốn high availability DNS, deploy Pi-hole thứ hai trên node khác (ví dụ node4):
# VM248 – pihole-secondary – 10.11.45.54 – node4
qm create 248 --name pihole-secondary \
--memory 1024 --cores 1 \
--net0 virtio,bridge=vmbr0,tag=45 \
--scsi0 vm-ceph:15 \
...
Sau khi cài, dùng Pi-hole Teleporter (Admin → Settings → Teleporter) để export config từ primary và import vào secondary.
FortiGate DHCP:
- Primary DNS:
10.11.45.53 - Secondary DNS:
10.11.45.54
Xử Lý Sự Cố
DNS không resolve — kiểm tra nhanh · Container restart loop do port 53 conflict · Admin UI không truy cập được (port 80)
8.1 DNS không resolve — kiểm tra nhanh
# Từ bất kỳ VM trong lab
nslookup pihole.hoatranlabs.local 10.11.45.53
dig @10.11.45.53 pihole.hoatranlabs.local
# Nếu timeout: Pi-hole container đang down
# Trên VM247
cd /opt/pihole && docker compose ps
docker compose logs pihole --tail=20
8.2 Container restart loop do port 53 conflict
# Nguyên nhân: systemd-resolved vẫn chiếm port 53
ss -tlnup | grep ':53'
# Fix
systemctl stop systemd-resolved
systemctl disable systemd-resolved
# Đảm bảo resolv.conf vẫn có fallback
chattr -i /etc/resolv.conf
cat > /etc/resolv.conf << 'EOF'
nameserver 8.8.8.8
nameserver 1.1.1.1
EOF
chattr +i /etc/resolv.conf
docker compose restart pihole
8.3 Admin UI không truy cập được (port 80)
# Kiểm tra port 80 trên host
ss -tlnp | grep ':80'
# Nếu port 80 bị chiếm bởi nginx/apache
systemctl stop apache2 nginx 2>/dev/null
systemctl disable apache2 nginx 2>/dev/null
docker compose restart pihole
8.4 Query bị block nhầm
# Kiểm tra một domain cụ thể có trong blocklist không
docker exec pihole pihole -q example.com
# Allowlist domain (Pi-hole v6: pihole allow thay cho pihole -w)
docker exec pihole pihole allow example.com
# Xem query log real-time
docker exec pihole pihole -t
8.5 Xem thống kê DNS
# Trạng thái dịch vụ DNS và blocking (Pi-hole v6 đã bỏ pihole -c)
docker exec pihole pihole status
# Thống kê query dạng JSON: tổng số query, số bị chặn, tỉ lệ chặn... (mặc định 24 giờ gần nhất)
docker exec pihole pihole api stats/summary
Monitoring
Cài node_exporter (để Prometheus monitor) · Pi-hole metrics cho Grafana
9.1 Cài node_exporter (để Prometheus monitor)
# node_exporter 1.12.1: giá trị dùng chung của cả series (đã xác minh 2026-10-15)
NODE_EXPORTER_VERSION="1.12.1"
wget https://github.com/prometheus/node_exporter/releases/download/v${NODE_EXPORTER_VERSION}/node_exporter-${NODE_EXPORTER_VERSION}.linux-amd64.tar.gz
tar xzf node_exporter-*.tar.gz
mv node_exporter-*/node_exporter /usr/local/bin/
rm -rf node_exporter-*
useradd --system --no-create-home node_exporter
cat > /etc/systemd/system/node_exporter.service << 'EOF'
[Unit]
Description=Node Exporter
After=network.target
[Service]
User=node_exporter
ExecStart=/usr/local/bin/node_exporter
[Install]
WantedBy=multi-user.target
EOF
systemctl enable --now node_exporter
9.2 Pi-hole metrics cho Grafana
Pi-hole v6 có REST API tại http://10.11.45.53/api/ (cần xác thực bằng session; tài liệu tương tác tại http://10.11.45.53/api/docs), file api.php của v5 đã bị gỡ. Để đưa metrics vào Prometheus dùng pihole-exporter (ekofr/pihole-exporter từ v1.0.0 hỗ trợ Pi-hole v6, cổng mặc định 9617, cấu hình bằng biến PIHOLE_HOSTNAME và PIHOLE_PASSWORD) cùng community dashboard #10176 trên Grafana.
Systemd Service cho Docker Compose
cat > /etc/systemd/system/pihole-docker.service << 'EOF'
[Unit]
Description=Pi-hole Docker Compose
Requires=docker.service
After=docker.service network-online.target
[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/opt/pihole
ExecStart=/usr/bin/docker compose up -d
ExecStop=/usr/bin/docker compose down
TimeoutStartSec=120
[Install]
WantedBy=multi-user.target
EOF
systemctl enable pihole-docker
Checklist Triển Khai
- VM247 tạo thành công trên node3, IP 10.11.45.53
- Ubuntu Server 24.04 LTS cài xong, IP tĩnh đã cấu hình (đúng tên NIC theo
ip -br link, đúng file trong/etc/netplan/) - systemd-resolved đã tắt stub listener, port 53 free
- Docker Engine + Compose plugin cài từ repo
download.docker.comsuitenoble(docker compose versionchạy được), user trong group docker - Pi-hole container ở trạng thái
running - DNS test:
dig @10.11.45.53 google.comtrả về IP - Admin UI
http://10.11.45.53/admintruy cập được - Đăng nhập admin UI thành công
- Tất cả DNS records nội bộ đã thêm (dùng script; kết quả in
OK: 53 records) - CNAME records đã thêm
- (Khi làm bài 39) Conditional forward
wifilab.local→ 10.11.65.52 đã đặt,dig +short wifi-dc01.wifilab.local @10.11.45.53ra 10.11.65.52 - Test
nslookup authentik.hoatranlabs.local 10.11.45.53→ 10.11.25.40 - FortiGate DHCP đã cập nhật DNS1=10.11.45.53 cho 5 VLAN
- 4 PVE nodes đã đổi /etc/resolv.conf về 10.11.45.53
- Blocklists đã thêm, gravity update thành công
- Whitelist các domain quan trọng
- Backup cronjob đã cài, chạy thử
backup.shra file.ziptrong/opt/pihole-backups/ - Systemd service
pihole-dockerenable thành công - node_exporter 1.12.1 cài và chạy tại :9100
- PBS đã backup snapshot VM247
Tài Liệu Tham Khảo
- Pi-hole Docs: https://docs.pi-hole.net/
- Pi-hole Docker: https://github.com/pi-hole/docker-pi-hole
- Pi-hole Docker — cấu hình bằng biến môi trường (FTLCONF_*): https://docs.pi-hole.net/docker/configuration/
- Pi-hole FTL configuration (
dns.revServers,dns.hosts,misc.dnsmasq_lines): https://docs.pi-hole.net/ftldns/configfile/ - Docker Engine trên Ubuntu (repo apt, suite noble): https://docs.docker.com/engine/install/ubuntu/
- Ubuntu Server 24.04 LTS (ISO): https://releases.ubuntu.com/24.04/
- Unbound + Pi-hole: https://docs.pi-hole.net/guides/dns/unbound/
- Grafana Dashboard Pi-hole: https://grafana.com/grafana/dashboards/10176