Pi-hole在Fedora 41系统上的安装问题分析与解决方案

Pi-hole是一款流行的开源DNS服务器软件，主要用于网络广告拦截和设备级内容过滤。近期在Fedora 41系统上安装Pi-hole时，用户遇到了安装程序无法正确检测和安装依赖包的问题。

问题现象

当用户在Fedora 41系统上执行标准安装命令时，安装程序会错误地报告所有依赖包已满足，而实际上系统缺少关键依赖。这导致后续安装步骤失败，特别是当需要克隆Git仓库时，由于git命令未安装而无法继续。

具体表现为：

1. 安装程序错误显示"Checking for git"为已满足状态
2. 实际系统环境中git命令并不存在
3. 安装过程在克隆仓库步骤失败

问题根源

经过技术团队分析，此问题源于Fedora 41系统中dnf包管理器的行为变更。在新版本dnf中，查询未安装包时的返回状态码与旧版本不同：

• 旧版dnf查询未安装包时返回非零状态码
• Fedora 41的dnf查询未安装包时返回零状态码

Pi-hole安装脚本原先依赖dnf的非零返回状态来判断包是否已安装，这一变更导致脚本无法正确识别缺失的依赖包。

解决方案

针对此问题，Pi-hole开发团队已发布v5.18.4版本修复该问题。用户可以选择以下解决方案：

方案一：使用修复后的正式版本

直接运行标准安装命令，安装程序将自动获取修复后的版本：

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

方案二：手动预装依赖包

对于需要立即安装的用户，可先手动安装所有依赖：

dnf install -y grep bind-utils git dialog iproute newt procps-ng chkconfig ca-certificates cronie curl findutils sudo unzip libidn2 psmisc libcap nmap-ncat jq lighttpd lighttpd-fastcgi php-common php-cli php-pdo php-xml php-json php-intl

然后再运行标准安装命令。

方案三：安装开发中的v6版本

v6版本已包含此问题修复，且不再依赖lighttpd和php：

dnf install git
git clone 仓库地址 /etc/.pihole
git clone 管理界面仓库 /var/www/html/admin
mkdir /etc/pihole
echo "development" > /etc/pihole/ftlbranch
cd /var/www/html/admin && git checkout development
cd /etc/pihole && git checkout development
./automated\ install/basic-install.sh

技术建议

对于在Fedora等快速更新的Linux发行版上部署Pi-hole，建议：

1. 在安装前检查系统版本和关键依赖
2. 关注Pi-hole的版本更新日志
3. 对于生产环境，考虑使用稳定版而非最新版操作系统
4. 遇到安装问题时，可尝试手动安装依赖后重试

此问题的修复体现了开源社区对兼容性问题的快速响应能力，也提醒我们在自动化脚本中需要更健壮的依赖检测机制。