安裝 Pi-hole+Unbound 的 DNS (Docker)
- 安裝環境 :
- VM : 1vCore, 1G RAM, 16G SSD
- OS : Alpine 3.18 + Docker Compose
安裝設定
- 編輯 docker-compose.yml
version: '3' networks: dns_net: driver: bridge ipam: config: - subnet: 172.22.0.0/16 services: pihole: container_name: pihole hostname: pihole image: pihole/pihole:latest #shm_size: '2gb' networks: dns_net: ipv4_address: 172.22.0.6 ports: - "53:53/tcp" - "53:53/udp" - "8080:80/tcp" environment: - 'TZ=Asia/Taipei' - 'WEBPASSWORD=mypassword' - 'DNS1=172.22.0.7#53' - 'DNS2=no' volumes: - './etc-pihole/:/etc/pihole/' - './etc-dnsmasq.d/:/etc/dnsmasq.d/' restart: always unbound: container_name: unbound image: mvance/unbound:latest networks: dns_net: ipv4_address: 172.22.0.7 #volumes: #- ./etc-unbound:/opt/unbound/etc/unbound ports: - "5053:53/tcp" - "5053:53/udp" healthcheck: disable: true restart: always - 啟動服務
docker compose up -d
開始使用
- 確認設定使用 unbound - 172.22.0.7#53
驗證成效
- 可以參考 https://github.com/sefinek24/Sefinek-Blocklist-Collection/blob/main/lists/md/Pi-hole.md 加入 ADList 提高阻擋廣告能力
FAQ
- unbound 預設阻擋上游 DNS 回復私有網路保留 IP 網段 Exp. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 169.254.0.0/16 , 如果要開放這限制, 需要
- 複製 unbound 內的 /opt/unbound/etc/unbound 目錄出來成為 etc-ubound
docker cp unbound:/opt/unbound/etc/unbound . mv unbound etc-unbound
- 修改 docker-compose.yml 將 volumes 註記取消, 讓 etc-ubound 可掛載起來
: unbound: container_name: unbound image: mvance/unbound:latest networks: dns_net: ipv4_address: 172.22.0.7 volumes: - ./etc-unbound:/opt/unbound/etc/unbound ports: : - 修改 ./etc-unbound/unbound.conf 將 private-address 設定註記掉 Exp.
: # These private network addresses are not allowed to be returned for public # private-address: 10.0.0.0/8 # private-address: 172.16.0.0/12 # private-address: 192.168.0.0/16 # private-address: 169.254.0.0/16 # private-address: fd00::/8 # private-address: fe80::/10 # private-address: ::ffff:0:0/96 : - 重新啟動 docker compose
docker compose up -d
- 如何調整自動更新週期
- 參考 :
將 /etc/cron.d/pihole 掛載出來此方式會造成重啟時, dnsmasq 無法正常啟動
- 先確認可以在 host 執行更新
docker exec pihole pihole updateGravity - 在 host 建立 crontab 定義更新週期
- 如何增加一筆 wildcard 的 DNS 紀錄 Exp. *.lab.ichiayi.com → 192.168.11.30
- 其實是可以設定, 只是無法透過 GUI 來處理. 手動處理程序如下:
- 在 /etc/dnsmasq.d/ 目錄, 也就是對應出來的 /etc-dnsmasq.d 目錄內建立一個檔案 Exp. 02-lab-wildcard-dns.conf
- 在檔案內加入 address=/lab.ichiayi.com/192.168.11.30
- 重啟 pihole-FTL 服務
docker compose restart pihole - 透過 nslookup abc.lab.ichiayi.com 就可以看到回應的 IP 是 192.168.11.30
- 如何增加一筆 MX 的 DNS 紀錄 Exp. mail.ichiayi.com → mail.ichiayi.com , 50
- 其實是可以設定, 只是無法透過 GUI 來處理. 手動處理程序如下:
- 在 /etc/dnsmasq.d/ 目錄, 也就是對應出來的 /etc-dnsmasq.d 目錄內建立一個檔案 Exp. 03-mail.conf
- 在檔案內加入 mx-host=mail.ichiayi.com,mail.ichiayi.com,50
- 重啟 pihole-FTL 服務
docker compose restart pihole - 透過 nslookup set type=mx mail.ichiayi.com 就可以看到回應
- 當發現 pi-hole 內的 nslookup 查詢速度很緩慢(/etc/resolv.conf → nameserver 127.0.0.11)
- 將 docker-compose.yml 內的
: ports: - 53:53/udp - 53:53/tcp :
前面加上 host ip Exp. 172.16.0.245
: ports: - 172.16.0.245:53:53/udp - 172.16.0.245:53:53/tcp :
- 重啟 docker compse 即可解決
- 當大量查詢 pi-hole DNS 服務, 結果出現 FTL is not running 異常狀況
- docker compose logs -f 持續出現 Stopping pihole-FTL 的訊息
- docker exec pihole df -h | grep shm 出現 100% 表示 Share Memory 已經被大量 query 的紀錄塞爆
- 可以透過修改 docker-compose.yml 內將 shm_size(預設是 64MB)加大來解決, 但注意要確認不能超過主機記憶體大小
- 將 docker-compose.yml 內 #shm_size='2gb' 的 # 移除, 後面 2gb 可以改成實體主機記憶體大小的 70% 左右
- 重新啟動 docker compose
docker compose up -d - 確認修改是否成功
pve-dns:~# docker exec pihole df -h | grep shm shm 2.0G 65M 2.0G 4% /dev/shm
- 當設定 LocalDNS 後查詢還會取用到外部 DNS 回傳的 IPv6 的 IP 問題的解法