Apache通过mod_proxy_ajp连接JBoss需手动启用AJP监听（如8009端口并绑定127.0.0.1）、显式加载proxy和proxy_ajp模块、严格路径匹配、注入X-Forwarded头，并协同配置超时与禁用SELinux防火墙拦截。
Apache 通过 mod_proxy_ajp 连接后端 JBoss 容器（如 WildFly 或传统 JBoss EAP）实现协议加速，本质是复用 AJP/1.3 二进制协议的优势：免 HTTP 文本解析、精准透传客户端 IP/SSL 状态、连接复用率高。但 JBoss 默认不启用 AJP，且其配置逻辑与 Tomcat 不同——直接套用 Tomcat 教程极易失败。
确认 JBoss 是否支持并启用了 AJP Connector
JBoss EAP 6/7 和 WildFly 从 8 开始默认禁用 AJP；它不像 Tomcat 那样开箱即用。必须手动启用并绑定到安全地址：
- 编辑
$JBOSS_HOME/standalone/configuration/standalone.xml（或 domain 模式对应文件） - 在
<subsystem xmlns="urn:jboss:domain:undertow:...>内，找到<handlers>或<ajp-listener>区域；若无，需在<server>的<https-listener>同级添加：
<ajp-listener name="ajp" socket-binding="ajp" max-parameters="1000"/>
- 再确保
<socket-binding-group>中已定义ajp绑定，例如：
<socket-binding name="ajp" port="8009" interface="private"/>
-
interface="private"对应<interfaces>中的<interface name="private"><inet-address value="127.0.0.1"/></interface>—— 强制只监听本地回环，杜绝公网暴露 - 重启 JBoss 后执行
ss -tlnp | grep :8009，应看到127.0.0.1:8009，而非*:8009
Apache 端必须显式加载并验证 mod\_proxy\_ajp
Apache 2.4 不默认启用该模块，且不会报错提示缺失，只会静默失败：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 运行
httpd -M | grep proxy_ajp，确认输出含proxy_ajp_module (shared) - 检查模块加载文件（如
/etc/httpd/conf.modules.d/00-proxy.conf），确保以下两行未被注释：
LoadModule proxy_module modules/mod_proxy.so<br>LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
- 禁用
mod_jk：两者共存会争夺 AJP 连接资源，引发随机 503 或 Connection refused - 在虚拟主机中配置时，
<Proxy>段需授权：
<Proxy *><br> Require all granted<br></Proxy>
路径对齐与真实 IP 透传不可省略
AJP 协议本身不自动携带 X-Forwarded-For 或 X-Forwarded-Proto，而 JBoss 应用常依赖这些头做鉴权或重定向判断：
-
路径必须严格一致：若 JBoss 应用部署为
/myapp（WAR 名为 myapp.war），Apache 配置必须为：
ProxyPass /myapp ajp://127.0.0.1:8009/myapp<br>ProxyPassReverse /myapp ajp://127.0.0.1:8009/myapp
- 结尾斜杠、大小写、路径层级全部匹配；用
ProxyPassMatch会绕过 AJP，导致失效 - 手动注入客户端信息：
RequestHeader set X-Forwarded-For %{REMOTE_ADDR}s<br>RequestHeader set X-Forwarded-Proto "http"<br># 若 Apache 前有 TLS 终止，此处应设为 "https"性能与故障排查关键点
503 错误极少因 ProxyPass 写错引起，多源于底层链路中断：
-
SELinux 或防火墙拦截：CentOS/RHEL 上执行
setenforce 0临时关闭 SELinux 测试；确认semanage port -l | grep ajp是否允许 8009 -
连接超时参数协同：Apache 端
ProxyPass /myapp ajp://127.0.0.1:8009/myapp retry=60 keepalive=On，但真正起效的是 JBoss 的 AJP 超时设置 —— 在standalone.xml的<ajp-listener>中加属性：connection-timeout="60000"和keep-alive-timeout="60000" -
WebSocket 不支持：AJP 协议原生不处理 ws/wss，需单独配
mod_proxy_wstunnel并走 HTTP 代理到 JBoss 的 HTTP 端口（如 8080）
