如何在树莓派 Zero 上安装 Pi-hole

最后更新: 九月9, 2026

树莓派 Zero 硬件的详细电子电路板图纸。

如果你厌倦了上网时铺天盖地的广告,搭建一个过滤服务器是终极解决方案。树莓派 Zero 在这方面堪称完美,因为它…… 体积小,消耗量极少 它会在不知不觉中完成清理网络的脏活累活。

Pi-hole no es más que un «agujero negro» para los anuncios; básicamente intercepta las peticiones de DNS y 屏蔽恶意域名 或者在广告到达您的设备之前就将其拦截。它是一款超级轻便的工具,您可以把它放在家里的某个角落运行,几乎完全不用管它。

你需要什么开始?

以太网电缆连接到网络端口,说明了 Pi-hole 服务器推荐的稳定网络配置。

首先要检查硬件。虽然软件本身非常轻量级,但你需要一台能够运行它的机器。Pi-hole 需要一台…… 至少 512 MB RAM 大约需要 2 GB 的磁盘空间,不过理想情况下最好有 4 GB,以便更灵活地使用。如果您使用的是 Raspberry Pi Zero 2W,我们强烈建议您使用…… 以太网 HAT 为了保证连接稳定,因为WiFi有时会断断续续。

关于供电方面,一个常见的问题是它是否可以通过路由器的 USB 端口供电。答案是,虽然有些路由器允许这样做, 最好使用插头 可靠的壁挂式支架,可防止意外重启或系统不稳定。

支持的操作系统

现代网络路由器是家庭网络的中心节点,DNS 在其中配置以过滤广告。

并非任何软件版本都适用。为了确保一切顺利运行,您需要安装一个使用特定软件版本的发行版。 systemd 或 sysvinit以下是一些最可靠的选择:

  • 树莓派操作系统: Buster 和 Bullseye 版本在 ARM 架构上完美运行。
  • Debian: 完全兼容版本 10、11 和 12。
  • Ubuntu的: 从 20.x 到 23.x,ARM 和 x86_64 平台均有支持。
  • 其他选择: Armbian OS、Fedora(36-38)和 CentOS Stream(8/9)。
  MySQL 用户管理:基本技巧

请注意:如果您尝试将其安装在非常新的或不受支持的版本上(例如在较旧型号上安装某些 Raspbian 12 版本),则可能会遇到问题。 兼容性错误 阻碍你前进的因素。

网络和端口配置

笔记本电脑屏幕上显示安全锁图标,象征着安全、私密和无广告的浏览体验。

为了防止网络出现故障,Pi-hole 服务器必须具备以下条件: 静态IP地址如果您不想手动配置树莓派的 IP 地址,可以在路由器上设置 DHCP 保留地址,使其始终获得相同的地址。

关于港口问题,我们必须保持警惕,防止冲突发生。 53(TCP/UDP)是DNS的核心。如果您使用了其他 DNS 服务器(例如 BIND),则需要将其关闭。用于 Web 管理的端口是 [原文中缺少端口号]。 80(HTTP)因此,如果您已经有一个 Apache 服务器,则需要更改 lighttpd 端口。如果您想使用 Pi-hole 作为 DHCP 服务器,则需要打开相应的端口。 67和547最后,FTL API 引擎监听 4711 端口,但仅限于本地。

分步安装指南

最快捷简便的方法是自动安装。只需通过 SSH(例如使用 PuTTY)登录,然后运行以下命令: curl -sSL https://install.pi-hole.net | bash

如果您不想直接从网页运行脚本,您可以选择以下方法: 更多手动操作方案您可以使用以下命令下载可执行文件: wget -O basic-install.sh https://install.pi-hole.net 然后运行它 sudo bash basic-install.sh另一种方法是使用以下命令克隆官方 GitHub 存储库。 git clone --depth 1 https://github.com/pi-hole/pi-hole.git Pi-hole 进入自动安装文件夹以启动脚本。

  最佳 JavaScript 网络资源

使用 Docker 进行部署

对于那些偏爱容器技术的人来说,Docker 是一个绝佳的选择。最简单的方法是创建一个文件。 泊坞窗,compose.yml在这个文件中,你必须定义图像。 pihole/pihole:latest 并映射端口 53、67 和 80。添加这些端口至关重要。 cap_add:NET_ADMIN 如果您要管理 DHCP 并配置卷,以便在容器重启时黑名单不会被删除。

服务器启动运行后,你会看到包含登录信息的最终界面,这时最精彩的一招就是…… 在您的设备上配置 DNS 或者直接在路由器上设置。这样,你家中的所有网络流量都会经过过滤器,你就可以告别烦人的横幅广告了。

在 Raspberry Pi Zero 上安装 Pi-hole 可以改变您的浏览体验,因为它可以在网络层面消除广告,只需要适度的硬件、静态 IP 地址,并且可以使用脚本或 Docker 容器自动安装,从而确保 DNS 和 HTTP 端口空闲,实现最佳性能。