用途:Pi-hole 作为网络级 DNS 黑洞,为整个局域网提供广告与跟踪域名拦截,核心服务为 pihole-FTL.service(DNS 解析与统计引擎)。
主要能力:通过 pihole 命令管理服务状态、拦截列表与查询日志;支持白名单/黑名单、定时禁用拦截、统计查看与配置备份。常用命令包括 pihole status、pihole -g(更新 gravity 拦截列表)、pihole enable/disable、pihole disable 300、pihole -w/-b 域名、pihole -up、pihole -r、pihole -c、pihole -a -t(Teleporter 备份)。
使用方式:官方安装脚本为 curl -sSL https://install.pi-hole.net | bash(运行前应审查)。配置目录 /etc/pihole/,拦截列表数据库为 gravity.db(SQLite),Web 界面默认端口 80,访问 http://<ip>/admin。日志可用 journalctl -u pihole-FTL 或查看 /var/log/pihole/ 下文件。自定义本地 DNS 记录写入 /etc/pihole/custom.list,格式为 IP 主机名,修改后需 pihole restartdns。
端口:53/udp+tcp(DNS)、80/tcp(Web)、67/udp(DHCP,若启用)、4711/tcp(FTL API,默认仅本机)。
适用场景:家庭或小型办公网络统一拦截广告;配合 unbound 做递归解析(上游设为 127.0.0.1#5335);Docker 部署需 network_mode: host 或谨慎端口映射。
限制与注意:FTL 以 root 运行,需保持主机更新与网络隔离;Ubuntu 18.04+ 的 systemd-resolved 会占用 127.0.0.53:53,需在 /etc/systemd/resolved.conf 设 DNSStubListener=no 并调整 /etc/resolv.conf;启用 Pi-hole DHCP 前须先关闭路由器 DHCP,避免双 DHCP 冲突;拦截列表过于激进会产生误报,可通过白名单或更换列表缓解。具体收费、价格与平台支持资料暂未提供。