Pi-hole 网站
通过您自己的 Linux 硬件实现网络范围广告屏蔽

Pi-hole® 是一个 DNS 黑洞，可在无需安装任何客户端软件的情况下保护您的设备免受不需要内容的侵扰。

易于安装：我们的对话框引导您在十分钟内完成简单安装过程
坚决：内容在 非浏览器位置 被屏蔽，例如广告泛滥的移动应用和智能电视
响应迅速：通过缓存 DNS 查询，无缝提升日常浏览速度体验
轻量级：在最低硬件和软件要求下流畅运行
健壮：经过质量保证的命令行界面，确保互操作性
洞察力强：美观且响应式的 Web 界面仪表板，用于查看和控制您的 Pi-hole
多才多艺：可选作 DHCP 服务器，确保所有设备自动受到保护
可扩展：安装在服务器级硬件上时，能够处理数亿次查询
现代化：同时屏蔽 IPv4 和 IPv6 上的广告
免费：开源软件，帮助确保您是掌控自己隐私的唯一人

一键自动安装

希望快速便捷上手的人，可以使用以下命令安装 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 服务器。

Pi-hole 是免费的，但由您的支持驱动

维护免费、开源且尊重隐私的软件涉及许多经常性成本；我们的志愿开发者自掏腰包分摊这些费用。这只是我们对自己软件及其维护重要性坚定信念的一个例子。

请明确一点：您的支持对于帮助我们保持创新至关重要！

捐赠

使用我们的赞助按钮进行捐赠，极有助益，可抵消我们每月部分开支：

其他支持方式

如果您不打算捐赠（这没关系！），还有以下方式可以帮助支持我们：

GitHub Sponsors
Patreon
Hetzner Cloud 联盟链接
Digital Ocean 联盟链接
Stickermule 首次购买后可获得 10 美元信用额度
Amazon US 联盟链接
传播我们的软件以及您从中受益的经验

通过 GitHub 贡献

我们欢迎 所有人 贡献问题报告、建议新功能以及创建拉取请求。

如果您有想要添加的内容——无论是拼写错误还是全新功能，我们都乐于审查！只需在提交请求时填写我们的模板；模板中的问题将帮助志愿者快速理解您的目标。

您会发现安装脚本和调试脚本包含大量注释，这将帮助您更好地理解 Pi-hole 的工作原理。它们对于希望学习编写脚本或编程的人来说也是宝贵的资源！我们鼓励喜欢动手的人阅读它们并提交拉取请求供我们审查。

联系我们

虽然我们主要通过 Discourse 用户论坛联系，但您也可以在各种社交媒体上找到我们。

在开始新讨论前，请务必查看常见问题解答，因为我们没有多余时间回复每个求助请求。

功能详解

超光速引擎

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 的人都可以审计。

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

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

Web 界面仪表板

这个可选仪表板允许您查看统计信息、更改设置和配置 Pi-hole。它拥有命令行界面的强大功能，却无需学习曲线！