Linux下搭建Pi-hole广告拦截教程

本文详细介绍了如何在Linux系统上通过官方一键脚本快速部署Pi-hole，将其配置为网络级广告拦截DNS服务器：从系统环境准备、依赖安装、自动化安装与密码记录，到静态IP设置、路由器DNS重定向，再到服务验证与Web管理界面访问，全程覆盖实战关键步骤，让普通用户也能轻松搭建一个高效、稳定、全网生效的广告过滤中枢。

如果您希望在Linux系统上部署一个网络级广告拦截工具，Pi-hole可以作为DNS服务器拦截广告域名请求。以下是完成Pi-hole安装与基础配置的具体步骤：

一、检查系统要求与准备环境

Pi-hole官方推荐运行在64位Linux发行版上，最低需1GB内存，建议使用Debian 11+、Ubuntu 20.04+或Raspberry Pi OS。安装前需确保系统已更新并具备curl命令和sudo权限。

1、执行系统更新：
sudo apt update && sudo apt upgrade -y

2、安装必要依赖：
sudo apt install curl gnupg2 lsb-release -y

3、确认当前用户具有sudo权限：
groups | grep sudo

二、通过官方脚本一键安装

Pi-hole提供自动化安装脚本，可自动检测系统环境、配置DNS服务并启动Web界面。该方式适用于大多数标准Linux桌面或服务器环境。

1、下载并执行安装脚本：
curl -sSL https://install.pi-hole.net | bash

2、安装过程中出现交互提示时：
选择“Install”继续，对IPv6支持选“否”，DNS上游服务器保持默认（如Cloudflare）

3、记录安装完成后显示的Web管理密码：
该密码仅在首次安装时显示一次，务必保存

三、手动指定网络接口与静态IP

若Pi-hole所在设备连接多个网卡或需固定局域网访问地址，必须为其分配静态IP并绑定监听接口，否则客户端无法稳定解析DNS。

1、编辑DHCP分配范围外的静态IP配置（以netplan为例）：
sudo nano /etc/netplan/01-network-manager-all.yaml

2、添加固定IP段配置（示例为192.168.1.100/24）：
addresses: [192.168.1.100/24]

3、应用网络配置：
sudo netplan apply

4、重启Pi-hole DNS服务：
sudo pihole restartdns

四、配置路由器DNS指向Pi-hole

使整个局域网设备自动使用Pi-hole过滤广告，需将路由器的DHCP DNS服务器地址修改为Pi-hole主机IP。此操作生效后，所有新获取IP的设备将默认走Pi-hole解析。

1、登录路由器管理页面（通常为192.168.1.1或192.168.0.1）

2、进入LAN设置或DHCP服务器选项

3、将主DNS服务器地址设为：Pi-hole主机的静态IP（如192.168.1.100）

4、保存设置并重启路由器DHCP服务

五、验证Pi-hole运行状态

安装完成后需确认核心服务正常响应，包括DNS解析、Web界面可访问及实时查询日志是否生成。

1、检查pihole-FTL进程状态：
sudo systemctl status pihole-FTL

2、测试本地DNS解析能力：
dig google.com @127.0.0.1

3、在浏览器中访问：http://pi.hole/admin 或 http://[Pi-hole-IP]/admin

4、查看实时查询日志：
sudo pihole tail

终于介绍完啦！小伙伴们，这篇关于《Linux下搭建Pi-hole广告拦截教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！