mod_remoteip 在 phpenv 下必须手动编译启用、显式配置可信代理（如 remoteiptrustedproxy）、日志格式改用 %a，且 php 中应直接使用 $_server['remote_addr']；任一环节缺失均导致日志和变量仍显示 127.0.0.1。
直接说结论：mod_remoteip 在 phpEnv 环境下必须手动启用、显式配置可信代理，并且日志格式和 PHP 中的 $_SERVER['REMOTE_ADDR'] 会随之改变——但默认不生效，漏掉任一环节都会导致日志还是显示 127.0.0.1 或内网 IP。
确认 phpEnv 是否已编译 mod_remoteip 模块
phpEnv 默认 Apache 构建通常不含 mod_remoteip，不能靠“安装扩展”方式补上（它不是 PHP 扩展）。必须检查模块文件是否存在：
- 进入 phpEnv 的 Apache 模块目录，常见路径如
/phpenv/apache/modules/或/phpenv/apache/libexec/ - 执行
ls mod_remoteip.so，若无输出，说明未编译进 Apache - 此时需重新编译 Apache：修改 phpEnv 的构建脚本（如
build.sh），在--enable-modules参数中加入remoteip，再执行完整构建流程 - 注意：phpEnv 不支持 EasyApache 那类图形化模块开关，没有“WHM/cPanel 里点一下就装好”的捷径
RemoteIPTrustedProxy 必须写对 Nginx 或 LB 的真实出口 IP
phpEnv 常见搭配是 Nginx 前置反代 Apache，此时 Apache 收到的请求源 IP 永远是 Nginx 所在机器的本地地址（127.0.0.1 或 192.168.x.x）。mod_remoteip 默认拒绝信任任何 X-Forwarded-For 值，除非你明确告诉它“谁可信”：
- 在
httpd.conf或独立配置文件（如extra/mod_remoteip.conf）中添加：LoadModule remoteip_module modules/mod_remoteip.so RemoteIPHeader X-Forwarded-For RemoteIPTrustedProxy 127.0.0.1 RemoteIPTrustedProxy 192.168.0.0/16
- 如果 Nginx 运行在另一台服务器，必须填它的**实际出网 IP**，而不是 VIP 或域名
-
RemoteIPInternalProxy在单层反代中非必需；但若 Nginx 和 Apache 同机，只配RemoteIPTrustedProxy 127.0.0.1就够了 - 配错或漏配 →
mod_remoteip完全不解析X-Forwarded-For，%h和$_SERVER['REMOTE_ADDR']仍为127.0.0.1
日志格式必须改用 %a，否则 access_log 还是旧 IP
Apache 日志默认用 %h 记录 socket 层原始 IP，而 mod_remoteip 修正后的 IP 只暴露给 %a（“remote IP as corrected by mod_remoteip”）。不改日志格式，等于白配：
- 找到当前使用的
LogFormat行（常在httpd.conf或extra/httpd-vhosts.conf） - 把类似
LogFormat "%h %l %u %t \"%r\" %>s %b" common改成：LogFormat "%a %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined - 确保
CustomLog指令引用的是这个新格式名（如CustomLog "logs/access.log" combined） - 重启 Apache 后，立刻用
curl -H "X-Forwarded-For: 203.0.113.5" http://localhost/测试，看日志是否出现203.0.113.5
PHP 中不要手动读 X-Forwarded-For，信任 $_SERVER['REMOTE_ADDR'] 即可
启用 mod_remoteip 后，$_SERVER['REMOTE_ADDR'] 已被自动替换为真实客户端 IP。手动解析 $_SERVER['HTTP_X_FORWARDED_FOR'] 是危险操作：
- 绕过
mod_remoteip的可信代理校验，可能被伪造头欺骗 - 多层代理时逻辑混乱（比如 CDN → Nginx → Apache，
X-Forwarded-For可能含多个 IP） - 只要
mod_remoteip配置正确，$_SERVER['REMOTE_ADDR']就是最终可信结果，直接用即可 - 验证方法：在 PHP 脚本中输出
echo $_SERVER['REMOTE_ADDR'];，应与日志中%a字段一致
最容易被忽略的一点：phpEnv 的 Apache 配置分散在多个 include 文件中，mod_remoteip 的 LoadModule 行如果放在某个被条件判断包裹的区块里（比如 <ifmodule mpm_prefork_module></ifmodule>），可能根本不会加载。务必确认该行位于全局作用域，且没有被注释或嵌套在错误的条件块中。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
