Apache 编译时需显式启用 mod_headers（--enable-headers=static），运行时须在 <IfModule mod_headers.c> 中用 RequestHeader set X-Real-IP "%{REMOTE_ADDR}e" early 等指令，并配合 LogFormat 记录，三者缺一不可。
Apache 源码编译时，mod_headers 默认不自动启用，必须在 configure 阶段显式启用，才能在后续使用 Header、RequestHeader 等指令处理请求头/响应头。要让它支持获取真实请求头（如 X-Real-IP、X-Forwarded-For），关键不是“开启模块”就完事，而是编译时包含 + 运行时加载 + 正确取值逻辑三者缺一不可。
编译阶段：configure 时启用 headers 模块
源码编译 Apache（如 httpd 2.4.x）时，mod_headers 属于 base module，但默认不静态链接，需主动启用：
./configure \ --enable-headers=static \ # 静态编译进 httpd 二进制（推荐，避免运行时加载失败） --enable-proxy=static \ --enable-rewrite=static \ --prefix=/usr/local/apache2 \ --with-included-apr
✅
--enable-headers=static表示将mod_headers编译为静态模块（直接嵌入httpd），启动时无需额外LoadModule；
❌ 若用--enable-headers（无=static），则生成动态模块mod_headers.so，仍需手动LoadModule并确保路径正确。
编译安装后验证：
/usr/local/apache2/bin/httpd -M | grep headers # 应输出： headers_module (static)
运行时：确认模块已加载并可执行 header 指令
即使静态编译，配置中仍需保证语法有效：
- 所有
Header/RequestHeader指令必须放在<IfModule mod_headers.c>块内（即使静态加载，此判断仍有效且推荐）； -
RequestHeader用于注入或修改传给后端的请求头（如设置X-Real-IP），它依赖mod_headers，也依赖mod_proxy（若做反向代理）； - 获取真实客户端 IP 的可靠方式是：
<IfModule mod_headers.c> # 从 TCP 连接源头取真实 IP（最可信，防伪造） RequestHeader set X-Real-IP "%{REMOTE_ADDR}e" early # 或从可信上游头提取（仅当 Nginx/CDN 已透传且可信） # RequestHeader set X-Real-IP "expr=%{reqhdr('X-Forwarded-For')}" early </IfModule>⚠️
early修饰符确保在代理转发前执行，否则可能被覆盖；%{REMOTE_ADDR}e是环境变量取值，比%{HTTP:X-Forwarded-For}i更安全。
Apache Superset Dashboard and SQL Exploration Skill下载Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
配合日志：用 %{X-Real-IP}i 记录真实请求头
要在 LogFormat 中记录该头，需确保：
- 请求中确实存在
X-Real-IP（由RequestHeader set注入，或上游透传）； - 日志格式写法正确：
LogFormat "%h %a %{X-Real-IP}i %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined_realip%a是实际连接 IP（即REMOTE_ADDR），%{X-Real-IP}i是注入/透传的头值，二者可并存对比排查代理链问题。
补充：调试真实头是否到达
- 启用
mod_dumpio（需单独--enable-dumpio=static编译）可打印原始请求头，验证X-Real-IP是否出现在请求中； - 或临时加一行响应头用于肉眼验证：
Header always set X-Debug-Real-IP "%{X-Real-IP}i"然后用
curl -I查看响应头是否回显。
不复杂但容易忽略
