Pi-hole：十分钟安装、免费开源，实现全网广告拦截还有多种支持方式！-洪萨配资

Pi-hole：无需客户端软件，十分钟安装实现全网广告拦截，还有多种支持方式！

Pi-hole® 是一个 DNS 黑洞，无需安装任何客户端软件，就能保护你的设备免受不良内容的侵扰。它具备诸多优点：

易于安装：安装向导会引导你完成简单的安装流程，整个过程不到十分钟。
拦截彻底：不仅能在浏览器中拦截广告，还能在非浏览器环境（如充斥广告的移动应用和智能电视）中阻止不良内容。
响应迅速：通过缓存 DNS 查询，无缝提升日常浏览速度。
轻量运行：对硬件和软件要求极低，运行流畅。
功能强大：具备命令行界面，确保互操作性。
直观易用：拥有美观且响应式的 Web 界面仪表盘，方便查看和控制 Pi-hole。
用途广泛：可选择作为 DHCP 服务器，确保所有设备自动受到保护。
可扩展性强：安装在服务器级硬件上时，能够处理数亿次查询。
紧跟潮流：支持 IPv4 和 IPv6 协议下的广告拦截。
完全免费：开源软件，保障你对个人隐私的绝对掌控。

一键自动安装

如果你想快速便捷地开始使用 Pi-hole，可以使用以下命令进行安装：

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

其他安装方法

将命令通过管道传递给 bash 存在一定争议，因为这会让你无法查看即将在系统上运行的代码。因此，提供了以下替代安装方法，让你在安装前可以审查代码：

方法一：克隆仓库并运行安装脚本

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

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

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

方法三：使用 Docker 部署 Pi-hole
请参考 Pi-hole 的 Docker 仓库，使用官方 Docker 镜像进行部署。

安装后配置：让网络充分利用 Pi-hole

安装完成后，你需要配置路由器，让 DHCP 客户端将 Pi-hole 作为 DNS 服务器。这样配置路由器后，所有连接到你网络的设备都能自动拦截不良内容，无需进一步操作。

如果你的路由器不支持设置 DNS 服务器，你可以使用 Pi-hole 内置的 DHCP 服务器，但要先禁用路由器的 DHCP 功能（如果有此功能）。万不得已时，你也可以手动为每个设备设置 Pi-hole 为 DNS 服务器。

Pi-hole 免费但需要你的支持

维护免费、开源且注重隐私的软件需要承担许多经常性成本，志愿者开发者会自掏腰包来支付这些费用。这充分体现了对软件的重视以及维护它的决心。请相信，你的支持对持续创新至关重要！

捐赠

通过赞助按钮进行捐赠，能有效分担每月的部分开支。

其他支持方式

如果你不想捐赠（这也没关系），还有其他方式可以支持：

GitHub 赞助
Patreon 支持
使用 Hetzner Cloud 联盟链接
使用 Digital Ocean 联盟链接
在 Stickermule 首次购买后可获得 10 美元信用额度
使用亚马逊美国联盟链接
宣传软件以及从中获得的益处

通过 GitHub 贡献代码

欢迎大家提交问题报告、提出新功能建议并创建拉取请求。无论你是要修正一个拼写错误，还是添加全新的功能，都乐意审查。提交请求时，请务必填写模板，其中的问题能帮助志愿者快速了解意图。

安装脚本和调试脚本有大量注释，有助于更好地理解 Pi-hole 的工作原理，对于想学习编写脚本或编程的人来说，也是宝贵的资源。鼓励喜欢钻研的人仔细阅读并提交拉取请求供审查。

联系我们

主要在 Discourse 用户论坛上与大家交流，也活跃于各大社交媒体平台。开始新讨论前，请先查看常见问题解答，因为没有足够的时间回复每一个求助请求。

常见问题与功能请求

你可以在 Reddit、Twitter 上了解更多信息，也能查看功能详细介绍。

功能详解

FTLDNS 超光速引擎：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 等。你可以阅读核心功能详细介绍了解更多信息。
Web 界面仪表盘：这个可选的仪表盘让你可以查看统计数据、更改设置并配置 Pi-hole。它兼具命令行界面的强大功能，却无需你花费时间学习。一些显著功能包括：移动友好界面、密码保护、详细的图表和环形图、域名和客户端排行榜、可过滤和排序的查询日志、查看用户自定义时间范围内数据的长期统计功能、轻松管理和配置 Pi-hole 功能等，以及命令行界面的所有主要功能。
- 访问仪表盘的方式：
  - 使用 Pi-hole 作为 DNS 服务器时：`http://pi.hole/admin/`
  - `http:///admin/`