Whoogle搜索服务在反向代理环境下获取真实客户端IP的解决方案

问题背景

在使用Whoogle搜索引擎服务时，当部署在反向代理（如Caddy+CDN服务）架构后方时，用户搜索"my ip"会返回容器内部IP地址而非真实的客户端IP地址。这是一个典型的反向代理环境下源IP传递问题。

技术分析

在多层网络架构中，HTTP请求经过以下路径：

1. 客户端 → CDN服务
2. CDN → Caddy反向代理
3. Caddy → Whoogle容器

默认情况下，Whoogle服务只能看到最靠近它的上游IP（即Caddy容器IP），而无法获取原始客户端IP。这是因为：

1. 网络包在每经过一跳转发时，源IP都会被替换
2. HTTP标准头部如X-Forwarded-For需要被显式配置传递
3. 云服务商有自己特定的IP传递头部

解决方案

核心思路

通过正确配置反向代理，将CDN服务提供的客户端真实IP传递给后端Whoogle服务。

Caddy配置实现

search.example.com {
  reverse_proxy http://whoogle-search:5000 {
    header_up X-Real-IP {header.Client-IP}
  }
}

配置说明

1. header_up指令：设置向上游传递的HTTP头部
2. {header.Client-IP}：提取CDN注入的客户端真实IP
3. X-Real-IP：标准化的真实IP头部字段，被大多数Web服务识别

技术原理

1. CDN特性：在边缘节点会自动添加Client-IP头部，包含原始客户端IP
2. 头部传递机制：反向代理需要显式地将这个值传递给后端服务
3. IP识别标准：Web应用通常按以下顺序识别真实IP：
   • X-Real-IP
   • X-Forwarded-For
   • 直接连接IP

扩展建议

1. 安全验证：建议同时配置CDN的IP白名单，确保只有CDN节点可以访问您的Caddy服务
2. 多级代理：如果存在多级反向代理，需要确保每级都正确传递IP头部
3. 日志记录：在Caddy配置中添加客户端IP日志记录，便于调试和审计

验证方法

1. 使用不同网络环境访问服务
2. 检查Whoogle返回的IP是否与客户端一致
3. 查看Caddy日志确认头部传递是否正确

通过以上配置，Whoogle服务将能够正确识别终端用户的真实IP地址，提供准确的"my ip"查询结果。这种解决方案同样适用于其他类似的Web服务在反向代理环境下的真实IP获取需求。