通过您自己的 Linux 硬件进行网络范围的广告拦截

Pi-hole® 是一个 DNS sinkhole，它无需安装任何客户端软件即可保护您的设备免受有害内容的侵害。

• 易于安装：我们的对话框引导您在十分钟内完成简单的安装过程
• 可靠：在_非浏览器位置_（例如广告缠身的移动应用和智能电视）的内容会被屏蔽
• 响应式：通过缓存 DNS 查询，无缝提升日常浏览体验
• 轻量级：运行流畅，硬件和软件要求极低
• 强大：命令行界面，互操作性得到质量保证
• 深入浅出：美观的响应式 Web 界面仪表板，用于查看和控制您的 Pi-hole
• 多功能：可选用作 DHCP 服务器确保您的所有设备都自动受到保护
• 可扩展：安装在服务器级硬件上时，能够处理数亿次查询
• 现代：可拦截 IPv4 和 IPv6 上的广告
• 免费：开源软件，有助于确保您是唯一掌控自己隐私的人

官方支持以下操作系统：

• Raspberry Pi 操作系统（原名 Raspbian）
• Armbian 操作系统
• Ubuntu
• Debian
• Fedora
• CentOS Stream

Web 界面

除了屏蔽广告之外，Pi-hole 还具有信息丰富的 Web 界面，可显示网络上查询的所有域的统计信息。

内置 DHCP 服务器

Pi-hole 可以与现有的 DHCP 服务器配合良好，但您可以使用 Pi-hole 将网络管理集中在一个地方。

一步自动安装

想要快速便捷地开始使用 Pi-hole 的用户可以使用以下命令安装：

curl -sSL https://install.pi-hole.net | bash

其他安装方法

通过管道连接到 bash 存在争议，因为它会阻止您读取即将在系统上运行的代码。因此，我们提供了以下其他安装方法，以便在安装前进行代码审查：

方法 1：克隆我们的代码库并运行

git clone --depth 1 https://github.com/pi-hole/pi-hole.git Pi-hole
cd "Pi-hole/automated install/"
sudo bash basic-install.sh

方法 2：手动下载安装程序并运行

wget -O basic-install.sh https://install.pi-hole.net
sudo bash basic-install.sh

方法 3：使用 Docker 部署 Pi-hole

请参阅 Pi-hole Docker 仓库 以使用官方 Docker 镜像。

安装后：让您的网络充分利用 Pi-hole

安装程序运行完成后，您需要配置您的路由器，使 DHCP 客户端使用 Pi-hole 作为其 DNS 服务器。此路由器配置将确保所有连接到您网络的设备的内容都会被屏蔽，无需任何进一步的干预。

如果您的路由器不支持设置 DNS 服务器，您可以使用 Pi-hole 的内置 DHCP 服务器；请务必先禁用路由器上的 DHCP（如果路由器支持此功能）。

作为最后的选择，您可以手动将每台设备设置为使用 Pi-hole 作为其 DNS 服务器。

功能详解

Faster-than-light 引擎

FTLDNS是一个轻量级的专用守护进程，用于提供 Web 界面所需的统计信息，其 API 可以轻松集成到您自己的项目中。顾名思义，FTLDNS 可以非常快速地完成所有操作！

您可以集成的一些统计数据包括：

• 被拦截的域名总数
• 今日 DNS 查询总数
• 今日拦截的广告总数
• 拦截广告百分比
• 唯一域名
• 转发的查询（至您选择的上游 DNS 服务器）
• 缓存的查询
• 唯一客户端

使用以下方式访问 API：

• 您的浏览器：http://pi.hole/api/docs
• curl：curl --connect-timeout 2 -ks "https://pi.hole/api/stats/summary" -H "Accept: application/json";
• 命令行 - 示例：pihole api config/webserver/port 或 pihole api stats/summary。

命令行界面

pihole 命令具有全面管理 Pi-hole 所需的所有功能，无需使用 Web 界面。它速度快、用户友好，任何了解 bash 的人都可以审计。

一些值得注意的功能包括：

• 允许列表、拒绝列表（又称白名单、黑名单）和正则表达式
• 调试实用程序
• 查看实时日志文件
• 更新广告列表
• 查询被屏蔽域名的广告列表
• [启用和禁用] Pi-hole](https://docs.pi-hole.net/core/pihole-command/#enable-disable)
• ... 还有更多！

您可以阅读我们的核心功能详解 了解更多信息。

Web 界面仪表板

这个可选仪表板 允许您查看状态、更改设置以及配置您的 Pi-hole。它拥有命令行界面的强大功能，而且没有任何学习难度！

一些值得关注的功能包括：

• 移动友好界面
• 密码保护
• 详细图表和圆环图
• 域名和客户端热门列表
• 可过滤和排序的查询日志
• 长期统计信息，可查看用户自定义时间范围内的数据
• 轻松管理和配置 Pi-hole 功能
• ……以及命令行界面的所有主要功能！

有几种方法可以访问仪表板：

1. http://pi.hole/admin/（使用 Pi-hole 作为 DNS 服务器时）
2. http://<IP_ADDRESS_OF_YOUR_PI_HOLE>/admin/