Apache启用`mod_proxy_ajp`模块与Java Tomcat容器进行AJP协议通信

浅雪酱_4086

浅雪酱_4086

2026-09-30

736人浏览

原创

Apache 与 Tomcat 通过 AJP 通信的关键是确保 mod_proxy_ajp 显式启用、Tomcat AJP Connector 绑定 127.0.0.1(或内网 IP)、ProxyPass 路径与 context path 严格一致、手动透传 X-Forwarded-For 等头,否则易现 503、404、IP 丢失或重定向错乱。
Apache 启用 `mod_proxy_ajp` 与 Tomcat 通过 AJP 协议通信,关键不在“通不通”,而在于协议稳、路径准、IP真、端口安。AJP 是二进制协议,比 HTTP 代理更轻量、更高效,但默认不启用、不安全、不自动传客户端信息——配置漏掉任意一环,就容易出现 503、404、真实 IP 丢失或重定向错乱。

确认并启用 mod_proxy_ajp 模块

apache 2.4 不默认加载该模块,仅启 `mod_proxy` 不够,`mod_proxy_ajp` 必须显式启用,否则 `proxypass ajp://` 会静默失败或报 invalid url。

  • 运行命令检查是否已加载:
    CentOS/RHEL:httpd -M | grep proxy_ajp
    Debian/Ubuntu:a2enmod -l | grep proxy_ajp
    输出中必须含 proxy_ajp_module (shared)
  • 编辑模块加载文件(如 /etc/httpd/conf.modules.d/00-proxy.conf 或 /etc/apache2/mods-available/proxy_ajp.load),确保以下两行未被注释:
    LoadModule proxy_module modules/mod_proxy.so
    LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
  • 若系统中同时存在 mod_jk,建议禁用它——两者共存易引发连接复用冲突,导致随机 Connection refused 或 503

限定 Tomcat 的 AJP Connector 绑定地址

Tomcat 默认 AJP 配置为 <connector port="8009" protocol="AJP/1.3"></connector>,监听 *:8009,等于把内部通信端口暴露在公网,既高危,又常因 IPv6 回环(::1)与 Apache 的 127.0.0.1 不匹配而连不上。

  • 编辑 $CATALINA_HOME/conf/server.xml,找到或新增 AJP Connector,强制指定 address:
    单机部署:address="127.0.0.1"
    分离部署:address="192.168.21.31"(填 Tomcat 实际内网 IP)
  • 完整示例:
    <connector port="8009" protocol="AJP/1.3" address="127.0.0.1" redirectport="8443" connectiontimeout="60000" keepalivetimeout="60000" maxthreads="500"></connector>
  • 重启 Tomcat 后执行:ss -tlnp | grep :8009,输出应为 127.0.0.1:8009,而非 *:8009 或 :::8009
  • 跨机器时,确保防火墙放行目标 IP + 8009 端口(如:firewall-cmd --permanent --add-port=8009/tcp)

严格对齐 ProxyPass 路径与 Tomcat context path

AJP 不解析 URL,只做字节流转发,路径是字面匹配,差一个字符或斜杠,就会引发静态资源 404、重定向跳转错误、Session 丢失等隐蔽问题。

deep-java-review
deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文,推断业务需求,进行多维度评分和分类汇总,生成完整PRD文档。包含细粒度Java代码审查清单(Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载
  • 假设 Tomcat 应用部署在 /myapp(即 context.xml 或 WAR 包名决定的上下文路径),则 Apache 配置必须完全一致:
    ProxyPass /myapp ajp://127.0.0.1:8009/myapp
    ProxyPassReverse /myapp ajp://127.0.0.1:8009/myapp
  • 结尾斜杠必须统一:写成 /myapp/ 和 /myapp 是两个不同路径,不能混用
  • 避免使用 ProxyPassMatch(如 ^/(.*\.jsp)$),它会绕过 AJP 逻辑,降级为 HTTP 处理
  • 不要图省事写 ProxyPass / ajp://...,除非 Tomcat 确实部署在根路径,否则所有请求都会被错导向根上下文

手动补全关键请求头与特殊支持

AJP 协议本身不自动透传 X-Forwarded-For、X-Forwarded-Proto 等头,也不支持 WebSocket。这些需额外配置,否则日志里全是 127.0.0.1,HTTPS 重定向变 HTTP,ws 连接直接断开。

  • 在 Apache 虚拟主机中添加:
    RequestHeader set X-Forwarded-For %{REMOTE_ADDR}s
    RequestHeader set X-Forwarded-Proto "https"(若前端有 SSL 终止)
  • 如需代理 WebSocket(如 wss://domain.com/ws),不能走 AJP:
    必须启用 mod_proxy_wstunnel
    单独配置 HTTP 协议代理:ProxyPass /ws ws://127.0.0.1:8080/ws
  • Tomcat 若启用了 RemoteIpValve,依赖上述头字段还原真实 IP,缺一不可

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

9357

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

6522

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

5812

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1024

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

848

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1216

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2469

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

19811

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1115

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Apache Maven 官方安装指南
Apache Maven 官方安装指南

共0课时 | 0人学习

Apache Maven 官方用户中心
Apache Maven 官方用户中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习