使用Godoxy实现Pi-Hole管理页面的自动重定向

在Docker环境中部署Pi-Hole时，许多用户会遇到一个常见问题：如何配置反向代理使其自动重定向到/admin管理页面。本文将详细介绍如何通过Godoxy项目实现这一功能。

问题背景

Pi-Hole作为一款流行的网络广告拦截工具，其Web管理界面默认位于/admin路径下。当用户通过域名访问时，往往需要手动输入完整路径才能进入管理页面，这显然不够友好。

解决方案

Godoxy提供了灵活的规则配置方式，可以实现路径重定向。以下是完整的Docker Compose配置示例：

services:
  pihole:
    container_name: pihole
    image: pihole/pihole:latest
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "8280:80/tcp"
      - "8443:443/tcp"
    labels:
      proxy.pihole.port: 8280
      proxy.pihole.homepage: |
        name: Pi-Hole
        icon: "@selfhst/pi-hole.svg"
      proxy.pihole.rules: |
        - on: path /
          do: rewrite / /admin
        - name: default
          do: pass
    environment:
      TZ: 'America/Los_Angeles'
      FTLCONF_dns_listeningMode: 'all'
      FTLCONF_dns_upstreams: '10.0.0.1'
      FTLCONF_webserver_api_password: 'test'
    volumes:
      - './etc-pihole:/etc/pihole'
    restart: unless-stopped

关键配置解析

1. 端口映射：将Pi-Hole的80和443端口分别映射到8280和8443，避免与主机上其他服务冲突。

2. Godoxy标签配置：

   • proxy.pihole.port：指定服务监听的端口
   • proxy.pihole.rules：定义重定向规则
     • on: path /：匹配根路径请求
     • do: rewrite / /admin：将根路径重写为/admin路径
     • do: pass：默认规则，允许其他请求通过

3. 环境变量：

   • 时区设置
   • DNS监听模式配置
   • 上游DNS服务器设置
   • Web界面API密码

注意事项

1. 确保Godoxy服务已正确安装并运行
2. 检查防火墙设置，确保相关端口未被阻止
3. 重定向规则应放在其他规则之前，确保优先匹配
4. 测试时建议先使用临时密码，确认功能正常后再设置正式密码

通过以上配置，用户访问Pi-Hole的域名时，系统会自动重定向到管理页面，大大提升了使用体验。这种配置方式不仅适用于Pi-Hole，也可推广到其他需要路径重写的Web应用部署场景中。