NGINX配置反向代理跳转Pihole失效显示默认页面问题求助

1. 验证Nginx配置有效性与加载状态 #

• 首先执行配置语法校验命令：sudo nginx -t，如果返回syntax is ok和test is successful才说明语法没有问题，否则根据报错提示修正配置。
• 验证配置是否被Nginx正确加载：执行sudo nginx -T（大写T），该命令会打印所有被加载的配置文件内容，确认输出中存在你写的pihole.dummydomain.com.conf的配置块。
• 确认修改配置后已经重载Nginx：执行sudo systemctl reload nginx使新配置生效。

2. 排查默认Server块优先级冲突 #

Nginx默认安装会自带00-default.conf（或default.conf）配置，其中listen 80 default_server的优先级高于普通自定义的80端口Server块，当请求匹配不到对应server_name时就会走到默认块返回默认首页，这是此类问题的最常见原因：

• 你当前的配置server_name仅填写了pihole.dummydomain.com，所以访问192.168.177.77:80的时候无法匹配该Server块，自然走到默认块返回默认页。
• 可直接删除默认配置的软链接避免冲突：sudo rm /etc/nginx/sites-enabled/00-default.conf，之后重载Nginx。

3. 补全反向代理配置适配需求 #

修改你的pihole.dummydomain.com.conf配置如下，同时适配域名和IP访问的需求，补充必要的代理请求头：

server { 
    listen 80;
    # 同时匹配域名和IP访问
    server_name pihole.dummydomain.com 192.168.177.77;
    location / {
        proxy_pass http://127.0.0.1:81;
        proxy_buffering off;
        # 传递真实请求的Host头给Pihole
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

修改完成后重载Nginx即可。

4. 本地缓存清理与验证 #

• 先清理本地浏览器缓存和DNS缓存，Mac上可以执行sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder清理DNS缓存。
• 分别访问http://pihole.dummydomain.com和http://192.168.177.77验证是否正常跳转到Pihole界面。

内容的提问来源于stack exchange，提问作者sd_19x4