Chạy Pi-hole hoặc AdGuard Home trong LXC Proxmox là một bài trong serial “Proxmox thực chiến: Xây dựng homelab và hạ tầng production từ đầu”. Bài viết dành cho người đang vận hành node Proxmox độc lập hoặc cụm nhỏ, muốn hiểu vì sao một lựa chọn hoạt động thay vì chỉ sao chép cấu hình trên mạng.
Từ khóa trọng tâm “Pi-hole AdGuard Home Proxmox LXC” được đặt trong bối cảnh chạy Pi-hole hoặc AdGuard Home trong LXC mà không làm gãy DNS. Mục tiêu là đưa người đọc từ baseline, qua thay đổi có kiểm soát, đến tín hiệu xác nhận và đường rollback. Những ví dụ có địa chỉ, token, VM ID hoặc tên storage đều là placeholder; hãy thay bằng giá trị đã kiểm tra trong môi trường của bạn.
Phạm vi và quyết định cốt lõi
Thiết kế DNS, DHCP, IP tĩnh, upstream, fallback và thứ tự khởi động cho dịch vụ hạ tầng.
DNS là dependency của chính homelab; phải có resolver dự phòng và kế hoạch khi LXC/host đang reboot. Khi phạm vi chưa rõ, hãy dừng ở bước inventory thay vì áp dụng lệnh thay đổi.
Baseline trước khi thao tác
Hãy ghi lại phiên bản PVE/PBS, hostname FQDN, timezone, địa chỉ quản trị, storage-id, trạng thái VM/LXC và đường truy cập console. Với thay đổi có thể ảnh hưởng dữ liệu, tạo một bản backup hoặc clone có thể đọc được; với network/cluster, cần một đường out-of-band. Baseline không cần dài nhưng phải đủ để so sánh trước và sau.
- Xác định owner, cửa sổ thay đổi và điều kiện dừng.
- Kiểm tra version, quyền, dung lượng, trạng thái task và dependency.
- Lưu output vào file có timestamp, không gửi secret vào log.
- Chuẩn bị rollback và kiểm tra rằng đường rollback thật sự truy cập được.
Thiết kế workflow theo từng lớp
Chạy pi-hole hoặc adguard home trong lxc mà không làm gãy dns không nên được xử lý như một khối duy nhất. Hãy tách lớp phần cứng, host, storage, network, guest và ứng dụng; mỗi lớp có một tín hiệu thành công riêng. Pi-hole và AdGuard Home đều có tài liệu vận hành; các lệnh trong bài chỉ là mẫu, cần thay IP, interface và upstream theo topology.
| Lớp kiểm tra | Câu hỏi cần trả lời | Bằng chứng nên lưu |
|---|---|---|
| Host | Node còn quorate, đủ tài nguyên và đúng version không? | pveversion, pvecm/pvesm, journal |
| Storage | Backend có online, đủ chỗ và đọc/ghi ổn định không? | status, SMART/ZFS/LVM, dung lượng |
| Network | Bridge, route, DNS, VLAN và firewall có cùng policy không? | ip, bridge, dig, log firewall |
| Guest/app | VM/LXC boot và service có đáp ứng đúng không? | agent, health check, application log |
Triển khai từng bước
Trình tự dưới đây là khung triển khai cho episode này. Chạy từng bước, đọc output và chỉ chuyển sang bước kế tiếp khi điều kiện xác nhận đã đạt.
- Đặt IP tĩnh và hostname cho resolver.
- Chọn Pi-hole hoặc AdGuard theo nhu cầu quản trị.
- Tách upstream, local DNS và DHCP ownership.
- Cấu hình client fallback có chủ đích.
- Test phân giải nội bộ, Internet và khi container down.
Trong thực tế, tên interface, storage và VM ID có thể khác tài liệu. Không gắn lệnh vào một script tự động cho tới khi bạn đã chạy thủ công trên bản sao và hiểu exit code, log cũng như tác động phụ.
Lệnh và cấu hình tham khảo
ip route
resolvectl status
dig @192.0.2.53 printer.lan
dig @192.0.2.53 example.com
# Keep a tested fallback resolverĐây là khung kiểm tra, không phải lệnh copy-paste production. Hãy thay placeholder, xác minh cú pháp theo phiên bản đang chạy và tránh ghi credential thật trong shell history. Nếu thao tác có thể làm mất network, lock VM, rollback transaction hoặc xóa dữ liệu, phải có console và bản backup/clone trước.
Kiểm tra kết quả và tiêu chí dừng
Một task trả về exit code 0 chỉ là một tín hiệu. Hãy kiểm tra độc lập trạng thái resource, log và behavior của ứng dụng. Nếu một kiểm tra thất bại, quay lại baseline và khoanh vùng một lớp; không chạy thêm nhiều lệnh sửa chữa để làm mất bằng chứng.
- Đối chiếu trạng thái thực tế với baseline và mục tiêu ban đầu.
- Kiểm tra log trong cùng khoảng thời gian thay đổi.
- Thử một thao tác đại diện: boot, restore, ping, query hoặc health check.
- Ghi lại thời gian hoàn thành và bằng chứng cho người bàn giao.
Lỗi thường gặp và cách khoanh vùng
- Để DNS duy nhất trên cùng host.
- Loop resolver giữa router và LXC.
- Blocklist chặn nhầm domain update.
- Không có console khi DNS down.
Khi lỗi xuất hiện, hãy dùng timeline: thay đổi nào xảy ra trước, task nào đang chạy, disk/network nào có triệu chứng và lỗi xuất hiện ở host hay guest. Nếu có nhiều failure domain, cô lập từng backend thay vì restart toàn bộ node. Với ZFS, cluster quorum, firewall và storage, ưu tiên thao tác không phá hủy và giữ nguyên log.
Góc nhìn thực chiến từ cộng đồng
Pi-hole và AdGuard Home đều có tài liệu vận hành; các lệnh trong bài chỉ là mẫu, cần thay IP, interface và upstream theo topology.
Kinh nghiệm cộng đồng thường hữu ích ở phần triệu chứng và thứ tự điều tra, nhưng không thay thế tài liệu chính thức. Bài này giữ nguyên nguyên tắc đó: tách “đã quan sát” khỏi “khuyến nghị”, và đánh dấu rõ phần có thể gây mất dữ liệu hoặc gián đoạn.
Một resolver self-host đáng tin phải có fallback; nếu DNS duy nhất nằm trên host đang sửa, chính bạn sẽ khó sửa nó.Nguyên tắc vận hành trong serial Proxmox thực chiến
Bảo mật, backup và rollback
Pi-hole và AdGuard Home đều có tài liệu vận hành; các lệnh trong bài chỉ là mẫu, cần thay IP, interface và upstream theo topology. Không đưa password, API token, private key hoặc địa chỉ nội bộ nhạy cảm vào bài, repository hay ảnh chụp. Với production, đặt ngưỡng rollback trước khi thay đổi: nếu mất quorum, latency tăng, pool báo lỗi, backup không verify hoặc health check thất bại, hãy dừng và quay lại trạng thái đã biết tốt.
| Trước thay đổi | Trong thay đổi | Sau thay đổi |
|---|---|---|
| Backup/config/console | Một lớp, có log và owner | Health check, audit, rollback decision |
| Ghi version và baseline | Không chạy song song job rủi ro | Restore test hoặc smoke test |
Liên kết nội bộ nên đọc tiếp
Để xây kiến thức theo chuỗi, hãy đọc các bài liên quan dưới đây và đối chiếu chúng với topology thực tế. Các liên kết trong serial có thể được cập nhật khi episode tương ứng đã lên lịch.
Nguồn chính thống và nguồn tham khảo
Proxmox có thể thay đổi cú pháp, giới hạn và hành vi theo phiên bản. Hãy mở tài liệu gốc trước khi áp dụng vào node thật; nguồn forum chỉ dùng để bổ sung bối cảnh troubleshooting.
Kết luận
Hãy bắt đầu từ baseline nhỏ, thay đổi một lớp mỗi lần và lưu bằng chứng. Khi đã có backup, monitoring, quyền tối thiểu và rollback, bạn mới nên mở rộng cấu hình cho workload production nhỏ. Giá trị của Proxmox không nằm ở việc có thật nhiều tùy chọn, mà ở khả năng biến những tùy chọn đó thành một quy trình có thể kiểm thử và bàn giao.
Khi bàn giao, người khác phải biết trạng thái mong muốn, lệnh kiểm tra, log cần xem và điều kiện rollback. Nếu không trả lời được bốn câu hỏi đó, quy trình chưa đủ sẵn sàng cho production.
Trong bối cảnh chạy Pi-hole hoặc AdGuard Home trong LXC mà không làm gãy DNS, quyết định đúng cần cân bằng tính đơn giản, khả năng quan sát, chi phí và thời gian phục hồi. Nếu một cấu hình làm hệ thống khó debug hơn, hãy xem đó là chi phí vận hành cần được ghi lại.
