用途:为局域网提供 *.temet.ai 域名的本地 DNS 解析,避免走公网往返,加快 LAN 访问。适用于新增服务到 domains.toml 后、本地解析失败、全新安装 Pi-hole、服务迁移 IP,以及排查“DNS 不解析”“本地无法访问某服务”“dig 返回错误 IP”等问题。
主要能力:自动探测树莓派本地 IP;从 domains.toml 读取域名列表;通过 docker-compose.yml 中的 FTLCONF_dns_hosts 更新 Pi-hole 本地 DNS 条目并重启生效;用 dig 验证解析;提示配置路由器 DHCP 的 DNS。
使用方式:推荐自动化执行 cd /home/dawiddutoit/projects/network && ./scripts/manage-domains.sh apply,该命令运行 generate-pihole-dns.py,读取 domains.toml、更新 docker-compose.yml 的 FTLCONF_dns_hosts 并重启 Pi-hole。也可手动编辑 docker-compose.yml 后执行 docker compose -f /home/dawiddutoit/projects/network/docker-compose.yml restart pihole。验证:dig @localhost pihole.temet.ai +short,或循环测试各域名;跨设备测试用 dig @192.168.68.135 pihole.temet.ai +short;查看日志 docker exec pihole pihole -t。
限制与注意:需 Pi-hole 容器运行、Docker Compose 可用、domains.toml 已配置;不要直接在 Pi-hole Web UI 添加记录,不要忘记重启,不要用 127.0.0.1 作 DNS IP,DNS 传播可能需 1-2 分钟;IoT 设备可能使用不同 IP(如 sprinkler 为 192.168.68.105);远程访问走 Cloudflare DNS,与 Pi-hole 分离。资料未提供收费、价格与平台信息。