Apache2/httpd日志中客户端IP显示为-，如何配置使其正常记录？

遇到日志里客户端IP显示为-的问题，通常分两种场景来解决，我帮你梳理下具体的配置调整步骤：

这种情况大概率是日志格式配置有问题，或者模块干扰导致IP无法被正确捕获：

• 检查日志格式配置
  首先确认你的Apache日志格式里包含了正确的IP字段。默认的combined格式用%h来记录客户端IP，你可以在配置文件（apache2.conf/httpd.conf或者sites-available下的站点配置）里找到LogFormat指令，比如：

  LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
  

  然后对应的CustomLog要正确引用这个格式：

  CustomLog ${APACHE_LOG_DIR}/access.log combined
  

  如果LogFormat里没有%h或者写错了，就会出现-。另外也可以用%a，它会记录客户端的IP地址（直接访问场景下和%h效果一致）。

• 排查模块干扰
  如果你的配置里错误加载了mod_remoteip但没有正确配置，可能会导致IP被覆盖成-。检查配置文件里有没有LoadModule remoteip_module ...的行，如果没有用到代理，建议注释掉这行，然后重启Apache。

这种情况下，Apache直接接收到的是代理服务器的请求，客户端真实IP会被代理放在请求头里（比如X-Forwarded-For、X-Real-IP或者CDN专属的头），需要通过mod_remoteip来提取真实IP：

1. 启用mod_remoteip模块

   • Debian/Ubuntu系统：执行命令

     sudo a2enmod remoteip
     sudo systemctl restart apache2
     

   • RHEL/CentOS系统：编辑httpd.conf，确保有以下行（如果没有就添加）：

     LoadModule remoteip_module modules/mod_remoteip.so
     

     然后重启服务：

     sudo systemctl restart httpd
     

2. 配置要读取的请求头
   在配置文件（可以是主配置或者站点配置）里添加指令，指定代理传递真实IP的请求头。比如大多数代理用X-Forwarded-For：

   RemoteIPHeader X-Forwarded-For
   

   如果是CDN（比如Cloudflare），可能用CF-Connecting-IP，就改成：

   RemoteIPHeader CF-Connecting-IP
   

3. 添加可信代理IP
   为了避免伪造IP，需要指定哪些代理服务器是可信的，只有来自这些IP的请求，Apache才会提取请求头里的真实IP。比如你的代理服务器IP是192.168.1.100，添加：

   RemoteIPTrustedProxies 192.168.1.100
   

   如果是多个IP或者CIDR段，可以用空格分隔：

   RemoteIPTrustedProxies 192.168.1.0/24 10.0.0.0/8
   

   对于CDN，需要查询对应提供商的官方可信IP段并添加进去。

4. 调整日志格式（可选但推荐）
   虽然mod_remoteip会自动把%h替换成真实IP，但用%a字段更明确，它会始终记录客户端的真实IP。修改LogFormat里的%h为%a：

   LogFormat "%a %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
   

• 查看Apache的错误日志（error.log），看有没有配置相关的报错，比如模块加载失败、指令语法错误。
• 用curl模拟请求测试，比如从代理服务器发送带X-Forwarded-For的请求：

  curl -H "X-Forwarded-For: 123.123.123.123" http://your-apache-server/
  

  然后查看访问日志，看IP是否正确记录。
• 检查代理服务器的配置，确保它确实在转发请求时添加了正确的IP头。

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