Zoraxy项目中客户端真实IP获取的技术实现方案

在网络服务场景中，获取客户端真实IP地址是一个常见需求。Zoraxy作为一款开源的网络工具，提供了标准的IP透传机制。本文将详细介绍其实现原理和配置方法。

标准头部字段透传机制

Zoraxy默认会通过以下标准HTTP头部字段传递客户端IP信息：

1. X-Forwarded-For
   这是行业通用的IP记录字段，采用逗号分隔的IP列表格式。Zoraxy会自动将客户端原始IP追加到该头部末尾。

2. X-Real-IP
   该头部直接包含最外层客户端的真实IP地址。

高级配置选项

在Zoraxy的管理界面中，用户可以通过"Custom Header Snippet"工具进行高级配置：

1. 保留Hop-by-Hop头部
   在高级设置中取消勾选"Remove Hop-by-Hop Header"选项，可使Zoraxy不对相关头部进行任何处理，实现完全透明的头部透传。

2. 自定义头部覆盖
   用户可以通过变量注入方式覆盖默认的IP头部值，支持使用以下预定义变量：

   • $remote_addr：客户端原始IP
   • $proxy_addr：Zoraxy节点IP

常见问题排查

当上游服务无法获取真实IP时，建议按以下步骤排查：

1. 检查上游服务是否配置了正确的信任设置
2. 验证网络拓扑中是否存在多层服务
3. 测试禁用Hop-by-Hop头部过滤功能
4. 检查是否有中间设备（如防火墙）修改了HTTP头部

最佳实践建议

1. 对于安全敏感场景，建议同时验证X-Forwarded-For和X-Real-IP头部
2. 在生产环境中应保持Hop-by-Hop头部过滤启用状态
3. 可通过自定义头部添加额外的验证信息
4. 定期审计配置，确保IP传递路径可信

通过合理配置Zoraxy的IP透传功能，可以确保上游服务准确获取客户端真实IP，同时保持系统的安全性和可维护性。