步骤 1: 获取 Pi-hole 安装包
Pi-hole 提供了多种安装方式,包括基于 Debian 的安装包和基于 Docker 的安装方式,以下是两种常见的安装方法。
方法 1: 使用官方 Pi-hole 安装包
- 访问 Pi-hole 官方网站:
- 打开浏览器,访问 https://pi-hole.net。
- 下载安装包:
- 在官网找到适用于你的 Raspberry Pi 模型的安装包(如
raspberry-pi-hole-<version>-arm64.deb)。
- 在官网找到适用于你的 Raspberry Pi 模型的安装包(如
- 传输安装包到 Pi:
使用 USB 或网络将安装包传输到你的 Raspberry Pi。
方法 2: 使用 GitHub 存储库
- 克隆 Git 仓库:
- 打开终端,运行以下命令:
git clone https://github.com/pi-hole/pi-hole.git
- 打开终端,运行以下命令:
- 进入仓库目录:
- 进入克隆的仓库目录:
cd pi-hole
- 进入克隆的仓库目录:
- 下载依赖项:
- 执行以下命令以下载所需的依赖项:
./utils/pihole.sh dependencies
- 执行以下命令以下载所需的依赖项:
步骤 2: 安装 Pi-hole
根据你下载的安装包类型(Debian 或 Docker),以下是两种安装方法。
方法 1: 安装 Debian 包
- 安装必要的依赖项:
- 在终端运行以下命令:
sudo apt-get update && sudo apt-get install -y curl software-properties-common
- 在终端运行以下命令:
- 安装 Pi-hole:
- 使用以下命令安装:
sudo dpkg -i raspbian-pi-hole_*.deb
- 如果提示输入密码,输入你的 Raspberry Pi 密码。
- 使用以下命令安装:
方法 2: 使用 Docker
- 安装 Docker:
- 如果你选择使用 Docker 安装 Pi-hole,请先安装 Docker:
sudo apt-get install docker.io docker-compose sudo systemctl enable --now docker
- 如果你选择使用 Docker 安装 Pi-hole,请先安装 Docker:
- 下载 Docker 镜像:
- 拉取 Pi-hole 的 Docker 镜像:
docker pull pihole/pi-hole:latest
- 拉取 Pi-hole 的 Docker 镜像:
- 运行 Pi-hole 容器:
- 创建 Pi-hole 的配置文件(
pihole.conf):echo 'perso' >> /etc/pihole/pihole.conf echo 'localhost' >> /etc/pihole/api_users
- 启动 Docker 容器:
docker run -d --name pi-hole -v /etc/pihole:/etc/pihole -v /var/log/pihole:/var/log/pihole pihole/pi-hole:latest
- 创建 Pi-hole 的配置文件(
步骤 3: 配置 Pi-hole
-
访问 Pi-hole Web 界面:
- Raspberry Pi 上的 IP 地址可以通过
168.x.x或16.x.x查看。 - 在浏览器中访问
http://<IP>/admin,登录你的 Pi-hole 管理界面。
- Raspberry Pi 上的 IP 地址可以通过
-
设置 DNS 和 API 钓鱼:
在管理界面中,设置 DNS 重定向和 API 钓鱼功能。
步骤 4: 更新 Pi-hole
- 定期更新:
- 为了保持最佳的广告过滤能力,定期更新 Pi-hole 软件:
sudo pihole update
- 为了保持最佳的广告过滤能力,定期更新 Pi-hole 软件:
- 重启服务:
- 重启 Pi-hole 服务以应用更改:
sudo systemctl restart pihole
- 重启 Pi-hole 服务以应用更改:
Pi-hole 的功能
- 广告过滤:屏蔽家庭网络中的广告。
- DNS 安全:过滤恶意 DNS 请求。
- 网络监控:实时监控网络流量。
- API 接口:通过 API 进行广告过滤和统计。
如果你在安装过程中遇到问题,可以参考 Pi-hole 官方文档 或在社区求助,祝你成功安装!




