System & Network Pi-hole DNS
Bài 12 · Giai đoạn 2 — Hạ tầng nền tảng

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.

VM247 · node3 Ubuntu Server 24.04 LTS 10.11.45.53 2 vCPU · 2 GB · 20 GB

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

Vị trí trong chuỗi bài: Bài 12 thuộc Giai đoạn 2 — Hạ tầng nền tảng, nối tiếp Bài 11. Runbook sự cố và đứng trước Bài 13. step-CA PKI.
Mức độ cần thiết: 🔴 Bắt buộc — DNS foundation, triển khai đầu tiên trong nhóm dịch vụ hạ tầng (bài 12 trở đi)
KIỂM TRA VMID TRƯỚC KHI BẮT ĐẦU TOÀN BỘ CHUỖI DEPLOY: Các file hướng dẫn dùng VMID từ 232–290 (VM dịch vụ 232–280, 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ụcNội dung
Ứng dụng trong DNInternal service discovery (hostname thay IP), DNS filtering/blocking cho toàn mạng, network-level ad blocking
Tác dụng chínhResolve tất cả .hoatranlabs.local hostname; block 100K+ domain quảng cáo/malware; DNS-over-HTTPS upstream
Nếu không triển khaiKhô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 đâyTấ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ủIPVLAN · NodeVai trò trong bài này
pihole (Pi-hole DNS) · VM24710.11.45.5345 (MGMT) · node3Má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.21245 (MGMT) · cluster HOATRANHUBNode 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.1Quả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.21045 (MGMT) · cluster HOATRANHUBNode 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.21145 (MGMT) · cluster HOATRANHUBNode 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.21345 (MGMT) · cluster HOATRANHUBNode 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) · VM10110.11.45.1745 (MGMT) · node4Sao 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) · VM23510.11.45.3545 (MGMT) · node2Scrape 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) · VM23610.11.45.3645 (MGMT) · node2Hiể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) · VM23410.11.25.4025 (SEC) · node1Má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) · VM28110.11.65.5265 (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 domain hoatranlabs.local do 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-hole 10.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-dc01 10.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)
QUAN TRỌNG — DEPLOY PI-HOLE TRƯỚC TIÊN Pi-hole là dịch vụ hạ tầng lớp đầu tiên. Tất cả service khác (Authentik, NetBox, Grafana, v.v.) dùng DNS để tìm nhau. Pi-hole phải được deploy trước trong chuỗi triển khai lab.
Hậu quả khi VM247 down: Toàn bộ lab mất DNS nội bộ. Các service sẽ không liên lạc được với nhau qua hostname. Giảm thiểu bằng cách:
  1. Cấu hình DNS fallback 8.8.8.8 trong FortiGate DHCP cho từng VLAN
  2. Cân nhắc cài Pi-hole thứ hai (secondary) trên node khác

Thông tin VM:

Thuộc tínhGiá trị
VMID247
Hostnamepihole
Nodenode3 (10.11.45.212)
IP10.11.45.53/24
Gateway10.11.45.1
VLANVLAN_MGMT (tag 45)
vCPU2
RAM2 GB
Disk20 GB (Ceph)
OSUbuntu Server 24.04 LTS (Noble Numbat)
Ports53/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ầnPhiên bảnGhi chú
Ubuntu Server24.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 pluginBả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_exporter1.12.1Cổng 9100, cài bằng tarball + systemd
01

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)

1
Đăng nhập Proxmox Web UI → chọn Node: node3 → nhấn Create VM (góc trên phải)
2
General:
  • VM ID: 247
  • Name: pihole
  • 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 (tải từ https://releases.ubuntu.com/24.04/)
  • Guest OS Type: Linux, Version: 6.x - 2.6 Kernel
4
System:
  • Machine: q35
  • SCSI Controller: VirtIO SCSI single
  • BIOS: SeaBIOS
  • Qemu Agent: ☑
5
Disks:
  • Bus/Device: SCSI 0, Storage: vm-ceph
  • Disk size: 20 GiB, Cache: Write back, Discard: ☑
6
CPU:
  • Sockets: 1, Cores: 2, Type: x86-64-v2-AES
7
Memory:
  • Memory (MiB): 2048
8
Network:
  • Bridge: vmbr0, VLAN Tag: 45, Model: VirtIO (paravirtualized), Firewall: ☐
9
Confirm: Xem lại → Finish → Start VM → Console để bắt đầu cài Ubuntu.
Hộp thoại Create VM, tab Confirm của VM247 (pihole) trên node3 — kiểm tra lại toàn bộ thông số trước khi Finish.
Hộp thoại Create VM, tab Confirm của VM247 (pihole) trên node3 — kiểm tra lại toàn bộ thông số trước khi Finish.

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
Lưu ý: Sau khi Pi-hole đã chạy ổn định, đổi DNS của chính VM này về 127.0.0.1 để VM dùng Pi-hole local.
Màn hình cài Ubuntu Server 24.04 LTS: cấu hình mạng tĩnh 10.11.45.53/24, gateway 10.11.45.1, DNS tạm 8.8.8.8, hostname pihole.
Màn hình cài Ubuntu Server 24.04 LTS: cấu hình mạng tĩnh 10.11.45.53/24, gateway 10.11.45.1, DNS tạm 8.8.8.8, hostname pihole.

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
Các lệnh từ mục 1.4 trở đi ghi sẵn không có 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
Kết quả ss -tlnup | grep :53 sau khi tắt DNSStubListener — port 53 không còn bị systemd-resolved giữ.
Kết quả ss -tlnup | grep :53 sau khi tắt DNSStubListener — port 53 không còn bị systemd-resolved giữ.

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
02

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:
Lưu ý về biến môi trường (Pi-hole v6): mọi setting FTL đặt bằng biến 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.
Tại sao dùng 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
docker compose ps trong /opt/pihole: container pihole (pihole/pihole:latest, network host) ở trạng thái Up (healthy), và docker compose logs --tail=30 pihole cho thấy FTL khởi động không báo lỗi.
docker compose ps trong /opt/pihole: container pihole (pihole/pihole:latest, network host) ở trạng thái Up (healthy), và docker compose logs --tail=30 pihole cho thấy FTL khởi động không báo lỗi.

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
dig @10.11.45.53 google.com +short trả về địa chỉ IP, và curl -sL -o /dev/null -w "%{http_code}" http://10.11.45.53/admin/ in ra 200 (cờ -L để theo chuyển hướng của Pi-hole v6).
dig @10.11.45.53 google.com +short trả về địa chỉ IP, và curl -sL -o /dev/null -w "%{http_code}" http://10.11.45.53/admin/ in ra 200 (cờ -L để theo chuyển hướng của Pi-hole v6).

Truy cập Admin UI: http://10.11.45.53/admin
Password: Admin@PiHole2024

Trang đăng nhập Pi-hole v6 tại http://10.11.45.53/admin: ô nhập Password (mật khẩu đặt qua FTLCONF_webserver_api_password trong docker-compose.yml).
Trang đăng nhập Pi-hole v6 tại http://10.11.45.53/admin: ô nhập Password (mật khẩu đặt qua FTLCONF_webserver_api_password trong docker-compose.yml).
Dashboard Pi-hole v6 sau khi đăng nhập: các ô Total queries, Queries Blocked, Percentage Blocked, Domains on Lists và biểu đồ truy vấn.
Dashboard Pi-hole v6 sau khi đăng nhập: các ô Total queries, Queries Blocked, Percentage Blocked, Domains on Lists và biểu đồ truy vấn.
03

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)

DomainIPMô tả
node1.hoatranlabs.local10.11.45.210Proxmox node1
node2.hoatranlabs.local10.11.45.211Proxmox node2
node3.hoatranlabs.local10.11.45.212Proxmox node3
node4.hoatranlabs.local10.11.45.213Proxmox node4
pbs01.hoatranlabs.local10.11.45.17Proxmox Backup Server (PBS Primary) VM101
pdm01.hoatranlabs.local10.11.45.18Proxmox Datacenter Manager VM102
syno-primary.hoatranlabs.local10.11.45.16Synology NAS primary
ops01.hoatranlabs.local10.11.45.20ops01 VM290 — máy quản trị/tự động hoá (Ansible, OpenTofu, bastion; tạo ở bài 07)
ups01.hoatranlabs.local10.11.45.19ups01 — UPS có thẻ mạng NMC/SNMP, NUT (bài 10)
prometheus.hoatranlabs.local10.11.45.35Prometheus VM235
grafana.hoatranlabs.local10.11.45.36Grafana VM236
kuma.hoatranlabs.local10.11.45.36Uptime Kuma (chạy trên VM236, bài 15)
gotify.hoatranlabs.local10.11.45.36Gotify (chạy trên VM236, bài 15)
loki.hoatranlabs.local10.11.45.35Loki (chạy trên VM235, bài 33)
wazuh-siem.hoatranlabs.local10.11.45.25Wazuh SIEM VM280
wazuh.hoatranlabs.local10.11.45.25Alias của wazuh-siem
harbor.hoatranlabs.local10.11.45.39Harbor Registry VM239
gitea.hoatranlabs.local10.11.45.40Gitea VM240
netbox.hoatranlabs.local10.11.45.45NetBox IPAM VM245
pihole.hoatranlabs.local10.11.45.53Pi-hole (this VM)
node5.hoatranlabs.local10.100.100.20Proxmox node5 (standalone, site phụ 10.100.100.0/24)
node6.hoatranlabs.local10.100.100.21Proxmox node6 (standalone, site phụ 10.100.100.0/24)
pbsdr01.hoatranlabs.local10.100.100.6Proxmox Backup Server DR (site phụ 10.100.100.0/24)
syno-secondary.hoatranlabs.local10.100.100.5Synology NAS secondary (site phụ 10.100.100.0/24)

VLAN_SEC (10.11.25.0/24)

DomainIPMô tả
authentik.hoatranlabs.local10.11.25.40Authentik SSO VM234
privacyidea.hoatranlabs.local10.11.25.30PrivacyIDEA 2FA VM233
mfa.hoatranlabs.local10.11.25.30Alias của privacyidea (bài 18)
step-ca.hoatranlabs.local10.11.25.42step-CA PKI VM242
pki.hoatranlabs.local10.11.25.42Alias của step-ca (bài 13)
vaultwarden.hoatranlabs.local10.11.25.43Vaultwarden VM243
openvas.hoatranlabs.local10.11.25.44Greenbone OpenVAS VM244
vault.hoatranlabs.local10.11.25.10HashiCorp Vault VM269
thehive.hoatranlabs.local10.11.25.11TheHive VM270
cortex.hoatranlabs.local10.11.25.11Cortex (chạy cùng VM270, bài 35)

VLAN_DMZ (10.11.35.0/24)

DomainIPMô tả
headscale.hoatranlabs.local10.11.35.10Headscale VPN VM232
mailu.hoatranlabs.local10.11.35.46Mailu Mail Server VM246
mail.hoatranlabs.local10.11.35.46CNAME alias cho mailu.hoatranlabs.local
crowdsec.hoatranlabs.local10.11.35.20CrowdSec VM271

VLAN_SRV (10.11.65.0/24) + VLAN_STORAGE (10.11.85.0/24)

DomainIPMô tả
mediamtx.hoatranlabs.local10.11.65.41MediaMTX RTSP VM241
dc1.hoatranlabs.local10.11.65.50Samba AD DC VM250 (bài 25) — phục vụ zone AD hoatranlabs.local
ad.hoatranlabs.local10.11.65.50Alias của dc1
samba01.hoatranlabs.local10.11.65.51Samba File Server VM251
samba.hoatranlabs.local10.11.65.51Alias của samba01
unifi.hoatranlabs.local10.11.65.53UniFi Network Application (Controller) VM282 (bài 39)
mattermost.hoatranlabs.local10.11.65.57Mattermost VM272
sonarqube.hoatranlabs.local10.11.65.66SonarQube VM266
nexus.hoatranlabs.local10.11.65.67Nexus Repository VM267
docker-internal.hoatranlabs.local10.11.65.67Docker registry nội bộ của Nexus VM267 (bài 31)
k3s.hoatranlabs.local10.11.65.55K3s API VIP (kube-vip, bài 28)
traefik.hoatranlabs.local10.11.65.100Traefik dashboard (K3s ingress VIP, bài 28)
grafana-k8s.hoatranlabs.local10.11.65.100Grafana trong K3s (K3s ingress VIP, bài 28)
argocd.hoatranlabs.local10.11.65.100ArgoCD (K3s ingress VIP/Traefik, bài 28–29)
s3.hoatranlabs.local10.11.85.10SeaweedFS S3 VM268 (VLAN_STORAGE, tag 85): S3 API cổng 443, Admin UI cổng 8443 (bài 32)
Pi-hole Admin → Settings → Local DNS Records, khung Local DNS records: bảng Domain → IP sau khi thêm các bản ghi (node1…node6, pbs01, authentik...).
Pi-hole Admin → Settings → Local DNS Records, khung Local DNS records: bảng Domain → IP sau khi thêm các bản ghi (node1…node6, pbs01, authentik...).

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
Kết quả chạy add_dns_records.sh: các dòng "Adding <domain> → <IP>" theo từng nhóm VLAN, rồi "OK: 53 records" và "=== Hoàn tất ===" (script ghi dns.hosts bằng pihole-FTL --config và nạp lại bằng pihole reloaddns).
Kết quả chạy add_dns_records.sh: các dòng "Adding <domain> → <IP>" theo từng nhóm VLAN, rồi "OK: 53 records" và "=== Hoàn tất ===" (script ghi dns.hosts bằng pihole-FTL --config và nạp lại bằng pihole reloaddns).

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
Pi-hole Admin → Settings → Local DNS Records, khung Local CNAME records: bốn alias www, sso, monitoring, webmail đã thêm.
Pi-hole Admin → Settings → Local DNS Records, khung Local CNAME records: bốn alias www, sso, monitoring, webmail đã thêm.

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
Lệnh --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).
04

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
FortiGate, DHCP server của VLAN 45 (Network → DHCP Server hoặc show system dhcp server): dns-server1 10.11.45.53, dns-server2 8.8.8.8, domain hoatranlabs.local.
FortiGate, DHCP server của VLAN 45 (Network → DHCP Server hoặc show system dhcp server): dns-server1 10.11.45.53, dns-server2 8.8.8.8, domain hoatranlabs.local.

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
Lệnh host pbs01.hoatranlabs.local trên một node PVE (sau khi đổi /etc/resolv.conf về 10.11.45.53) in "pbs01.hoatranlabs.local has address 10.11.45.17".
Lệnh host pbs01.hoatranlabs.local trên một node PVE (sau khi đổi /etc/resolv.conf về 10.11.45.53) in "pbs01.hoatranlabs.local has address 10.11.45.17".
Site phụ (node5, node6): hai node standalone này không đổi /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
05

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
06

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
Pi-hole Admin → Lists: các blocklist đã thêm (StevenBlack, AdAway, AdguardDNS, Easylist); sau docker exec pihole pihole -g gravity cập nhật thành công.
Pi-hole Admin → Lists: các blocklist đã thêm (StevenBlack, AdAway, AdguardDNS, Easylist); sau docker exec pihole pihole -g gravity cập nhật thành công.

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
07

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
Thư mục /opt/pihole-backups sau khi chạy thử backup.sh: file pihole_YYYYMMDD_HHMMSS.zip (Teleporter, tạo bằng pihole-FTL --teleporter) và docker-compose_YYYYMMDD_HHMMSS.yml.
Thư mục /opt/pihole-backups sau khi chạy thử backup.sh: file pihole_YYYYMMDD_HHMMSS.zip (Teleporter, tạo bằng pihole-FTL --teleporter) và docker-compose_YYYYMMDD_HHMMSS.yml.

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
08

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
Pi-hole Admin → Query Log: bảng truy vấn có cột Status (Blocked / Allowed), lọc theo domain để tìm query bị chặn nhầm trước khi chạy pihole allow.
Pi-hole Admin → Query Log: bảng truy vấn có cột Status (Blocked / Allowed), lọc theo domain để tìm query bị chặn nhầm trước khi chạy pihole allow.

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
09

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.

10

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.com suite noble (docker compose version chạy được), user trong group docker
  • Pi-hole container ở trạng thái running
  • DNS test: dig @10.11.45.53 google.com trả về IP
  • Admin UI http://10.11.45.53/admin truy 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.53 ra 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.sh ra file .zip trong /opt/pihole-backups/
  • Systemd service pihole-docker enable 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

Zalo