Pi-hole 是一个基于 Linux 的网络过滤工具，常用于家庭网络中过滤不良内容，如成人内容、广告、社交媒体等。以下是配置 Pi-hole 在路由器上的步骤

安装 Pi-hole

1 安装 Raspbian（推荐使用 Raspbian Buster 或 Bullseye）

• 下载并写入 SD 卡：

  • 下载 Raspbian
  • 使用 dd 工具将镜像写入 SD 卡。

• 连接 Pi-hole（以 Raspberry Pi 为例）：

  • 使用一个 microSD 卡。
  • 将 SD 卡插入 Raspberry Pi，连接网络接口卡（以 eth 为例）。
  • 打开终端，运行：

    sudo -i

    这将切换到 root 用户。

2 安装必要软件

sudo apt update && sudo apt upgrade -y
sudo apt install -y dnsmasq pi-hole

配置 Pi-hole

1 初始化 Pi-hole

pihole init

2 启用 Pi-hole 服务

sudo systemctl enable pihole@.service
sudo systemctl start pihole@.service

配置路由器

Pi-hole 通常通过 Dnsmasq 作为 DNS 和 HTTP 过滤代理，我们需要将 Dnsmasq 和 Pi-hole 绑定到路由器的网络接口（eth）。

1 修改 Dnsmasq 配置

编辑 Dnsmasq 配置文件：

sudo nano /etc/dnsmasq.conf

interface=eth
server=192.168.1.1

这里，server=192.168.1.1 是你的路由器 IP 地址,保存并退出编辑器。

2 启用 Dnsmasq 并绑定到 eth

sudo systemctl unmask dnsmasq
sudo systemctl enable dnsmasq@.service
sudo systemctl start dnsmasq@.service

检查 Dnsmasq 是否运行：

sudo systemctl status dnsmasq@.service

如果显示 active，表示 Dnsmasq 正常运行。

配置路由器的 DNS 和 HTTP 过滤

1 配置路由器的 DNS

• 登录路由器的管理界面（通常是 192.168.1.1）。
• 进入 网络 > DNS 页面，设置：
  • 主 DNS 服务器：168.1.1
  • secondary DNS 服务器：8.8.8（Google 的 DNS 服务器）
• 保存更改。

2 配置路由器的 HTTP 过滤

• 进入 网络 > 过滤 页面,或者类似的设置页面。
• 设置 HTTP 过滤规则：
  • 过滤 URL：blacklist（禁止访问）
  • 允许访问某些网站：如 *.youtube.com 或 *.google.com（可选）
• 保存更改。

启用 Pi-hole 的 Web 界面

如果你希望访问 Pi-hole 的管理界面：

1 修改 Pi-hole 配置文件

编辑 Pi-hole 的配置文件：

sudo nano /etc/pihole/pihole.conf

http_port=808

保存并退出编辑器。

2 重启 Pi-hole 服务

sudo systemctl restart pihole@.service

你可以通过浏览器访问 http://192.168.1.1:808 来访问 Pi-hole 的管理界面。

验证配置

• 使用网络测试网站（如 DNS查询 或 SpeedTest）验证你的网络是否正常连接。
• 检查是否能够访问被过滤的网站。

其他配置（可选）

• 自定义过滤规则：编辑 /etc/pihole/pihole.conf,添加自定义规则。
• 限制访问 Pi-hole 的管理界面：
  • 修改 /etc/dnsmasq.conf，添加：

    --add-filter="127...1 example.com"

  • 保存并重启 Dnsmasq 服务。

定期更新

• 定期更新 Pi-hole 和 Dnsmasq：

  sudo apt update && sudo apt upgrade -y

故障排除

• 如果网络访问被阻止，检查 Dnsmasq 和 Pi-hole 的日志：

  sudo tail -f /var/log/pihole.log

• 确保 Dnsmasq 和 Pi-hole 都绑定到正确的网络接口（eth）。

通过以上步骤，你应该能够成功配置 Pi-hole 在路由器上进行内容过滤。