freenas/pi-hole

Pi-Hole镜像

镜像概述

本镜像基于Diginc的Docker镜像构建，实现了Pi-Hole的核心功能——DNS级广告拦截。Pi-Hole是一款开源工具，通过在DNS层面过滤广告域名，无需在设备上安装客户端即可覆盖所有联网设备。

核心功能

• DNS级广告拦截：直接在域名解析阶段阻止广告请求，有效过滤各类互联网广告。
• 无客户端依赖：无需在手机、电脑等设备上安装额外软件，通过网络配置即可生效。
• 跨设备覆盖：支持家庭或企业网络内的所有设备（包括智能设备、IoT设备）。

使用场景

• 家庭网络广告拦截：为家中所有设备（手机、电脑、电视）过滤广告。
• 小型企业网络：减少员工上网时的广告干扰，提升工作效率。
• 个人开发环境：净化本地网络环境，避免广告影响开发测试。

配置说明

镜像支持通过环境变量和卷挂载进行配置：

• 环境变量：参考Diginc项目的https://github.com/diginc/docker-pi-hole/blob/master/README.md#environment-variables%E3%80%82
• 卷挂载：需挂载/etc/pihole（Pi-Hole配置）和/etc/dnsmasq.d（DNS配置）目录以持久化数据。

部署示例

Docker Run命令

bash
docker run -d \
  --name pi-hole \
  -p 53:53/tcp -p 53:53/udp \
  -p 80:80 \
  -e TZ="Asia/Shanghai" \
  -v "$(pwd)/etc-pihole:/etc/pihole" \
  -v "$(pwd)/etc-dnsmasq.d:/etc/dnsmasq.d" \
  --restart=unless-stopped \
  freenas/pi-hole

部署后，可通过访问http://<容器IP>进入Pi-Hole管理界面，进行进一步配置。 ===END===