Linux Apache JK配置出错怎么办?apache jk mod_jk配置详解

在 Linux 环境下,Apache 配合 JK (mod_jk) 是一种经典的架构,主要用于将 Apache 作为前端 Web 服务器(处理静态资源、SSL 终止等),并将动态请求转发给后端的 Tomcat 或 Jetty 等应用服务器。

mod_jk 是 Apache 的一个模块,它使用 AJP (Apache JServ Protocol) 协议与后端应用服务器通信。

Linux操作系统-Apache服务器的安装
加载中
Linux操作系统-Apache服务器的安装

以下是完整的配置指南,涵盖安装、配置和常见问题。


架构简述

[ 客户端 ] --> [ Apache (mod_jk) :80/443 ] --> [ AJP 协议 ] --> [ Tomcat :8009 ]
  • Apache: 负责静态文件(HTML/CSS/JS/图片)、SSL 加密、负载均衡。
  • mod_jk: Apache 的连接器模块。
  • Tomcat: 运行 Java Web 应用,监听 AJP 端口(默认 8009)。

安装步骤

1 安装 Apache 和 mod_jk

Ubuntu/Debian:

sudo apt update
sudo apt install apache2 libapache2-mod-jk

CentOS/RHEL:

sudo yum install httpd mod_jk
# 或者在较新版本中使用 dnf
sudo dnf install httpd mod_jk

2 安装 Tomcat

确保 Tomcat 已安装并正在运行,默认情况下,Tomcat 的 AJP 连接器在 server.xml 中是启用的,监听端口为 8009。


配置 Tomcat

确保 Tomcat 的 server.xml 中启用了 AJP 连接器:

<!-- 在 server.xml 的 <Service> 标签内 -->
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

注意:如果修改了 Tomcat 配置,请重启 Tomcat。

Linux Apache JK配置出错怎么办?apache jk mod_jk配置详解


配置 mod_jk

mod_jk 的主要配置文件通常位于 /etc/libapache2-mod-jk/ 或 /etc/httpd/conf/ 目录下。

1 创建 workers.properties

定义后端 Tomcat 服务器列表。

文件路径: /etc/libapache2-mod-jk/workers.properties

# 定义 worker 名称
worker.list=worker1
# 定义 worker1 的类型为 ajp13
worker.worker1.type=ajp13
# 指定 Tomcat 主机地址(本地则为 localhost)
worker.worker1.host=localhost
# 指定 Tomcat 的 AJP 端口(默认 8009)
worker.worker1.port=8009
# 设置负载因子(用于负载均衡,单节点可忽略)
worker.worker1.lbfactor=1

2 配置 Apache 加载 mod_jk

文件路径: /etc/apache2/mods-available/jk.conf (Ubuntu) 或 /etc/httpd/conf.d/jk.conf (CentOS)

# 加载 mod_jk 模块
LoadModule jk_module /usr/lib/apache2/modules/mod_jk.so
# 或者在 CentOS 上可能是: LoadModule jk_module modules/mod_jk.so
# 指定 workers.properties 文件路径
JkWorkersFile /etc/libapache2-mod-jk/workers.properties
# 指定 JK 日志文件路径
JkLogFile /var/log/apache2/mod_jk.log
# 设置日志级别 (info, debug, error, trace)
JkLogLevel info
# 指定哪些请求需要转发给 Tomcat
# 所有以 .jsp, .do, .action 结尾的请求
JkMount /.jsp worker1
JkMount /.do worker1
JkMount /.action worker1
# 或者:将所有请求都转发(不推荐,静态文件会由 Tomcat 处理,效率低)
# JkMount / worker1

提示:在 Ubuntu 上,你可能需要启用该模块:

sudo a2enmod jk

3 配置虚拟主机(可选但推荐)

为了更精细地控制,建议在虚拟主机配置中指定 JkMount。

Linux Apache JK配置出错怎么办?apache jk mod_jk配置详解

文件路径: /etc/apache2/sites-available/000-default.conf 或自定义 vhost 文件

<VirtualHost :80>
    ServerName www.example.com
    DocumentRoot /var/www/html
    # 静态文件由 Apache 直接处理
    <Directory /var/www/html>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    # 动态请求转发给 Tomcat
    JkMount /app/ worker1
    JkMount /app/.jsp worker1
    # 日志
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

重启服务

# 重启 Apache
sudo systemctl restart apache2
# 或
sudo systemctl restart httpd
# 检查 Tomcat 是否运行
sudo systemctl status tomcat

验证配置

  1. 访问 Apache 的静态页面,确认能正常显示。
  2. 访问动态页面(如 /app/test.jsp),确认能由 Tomcat 处理并返回结果。
  3. 查看日志:
    tail -f /var/log/apache2/mod_jk.log

常见问题与排查

Q1: 502 Bad Gateway 或 Connection Refused

  • 原因:Tomcat 未启动,或 AJP 端口(8009)未监听。
  • 解决:检查 Tomcat 状态,确认 server.xml 中 AJP 连接器已启用。

Q2: 静态文件访问慢

  • 原因:如果配置了 JkMount / worker1,所有请求都会转发给 Tomcat,包括 CSS/JS/图片。
  • 解决:只将动态请求(如 .jsp, .do, /api/)转发给 Tomcat,静态文件由 Apache 直接提供。

Q3: mod_jk 已弃用?

Linux Apache JK配置出错怎么办?apache jk mod_jk配置详解

  • 现状:mod_jk 确实已停止维护多年,Apache 官方推荐使用 mod_proxy_ajp 或 mod_proxy_http。
  • 替代方案:
    • mod_proxy_ajp: 配置更简单,无需 workers.properties。
      LoadModule proxy_module modules/mod_proxy.so
      LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
      ProxyPass /app ajp://localhost:8009/app
      ProxyPassReverse /app ajp://localhost:8009/app
    • mod_proxy_http: Tomcat 配置了 HTTP 连接器(默认 8080),可以使用 HTTP 协议转发。
      ProxyPass /app http://localhost:8080/app
      ProxyPassReverse /app http://localhost:8080/app

建议:如果是新项目,推荐使用 mod_proxy_ajp 或 mod_proxy_http,它们更轻量且维护更好。mod_jk 仅建议在遗留系统中使用。


特性 mod_jk mod_proxy_ajp
协议 AJP 1.3 AJP 1.3
配置文件 需要 workers.properties 直接在 Apache 配置中指定
维护状态 已停止维护 活跃维护
性能 良好 良好
推荐度 仅用于遗留系统 新项目推荐

如果你正在搭建新系统,建议直接使用 mod_proxy_ajp 或 mod_proxy_http,如果必须使用 mod_jk,请确保正确配置 workers.properties 和 JkMount。

首发原创文章,作者:王坚‌,如若转载,请注明出处:https://idctop.com/article/478317.html

赞 (0)
Excel表格怎么换行分列?
上一篇 2026年7月10日 05:18
H5本地数据库最大存储量是多少?indexedDB存储上限
下一篇 2026年7月10日 05:20

相关推荐

  • 天翼云服务器一个IP到底多少钱?,怎么收费的?

    天翼云服务器的公网IP价格并非固定数值,而是由带宽计费模式、IP类型(静态/弹性)及地域节点共同决定,基础静态IP月租大致在几十元区间,但实际成本需结合带宽套餐综合计算,先搞懂天翼云IP的定价逻辑很多朋友一上来就问“一个IP多少钱”,其实这个问题就像问“一辆车多少钱”一样,答案取决于配置,天翼云的IP费用从来不……

    2026年8月11日
    2300
  • 黑室服务器室到底值多少钱,怎么评估价格?

    黑室服务器室的价值取决于物理硬件、网络环境、运维保障和合规资质四个维度,当前市场行情下,一台标准42U机柜的裸金属托管年费大致在5000元至2万元区间,但无资质运营的黑室往往报价低于市场价30%以上,隐蔽成本却远超纸面差价,先算明白钱到底花在哪:黑室服务器室的成本构成硬件本身只是底价黑室服务器室的核心资产是机柜……

    2026年9月25日
    700
  • mysql一个服务器能建几个库?,mysql连接数满了怎么办

    一台服务器能跑多少个MySQL实例,得看你怎么理解“多少个”——如果问的是单个实例里能建多少个数据库,答案是“基本不受限”;如果问的是一台物理机上同时部署几个MySQL实例,那就要掰着指头算CPU、内存和磁盘IO的账了, 这个问题的完整答案,涉及实例数量、数据库数量、表数量、连接数四个维度,每一个维度的天花板都……

    2026年10月5日
    800
  • 服务器最多能带多少台电脑,卡顿怎么办?

    一台服务器能连接并服务的电脑数量没有硬性上限,但实际运营中,普通配置的物理机能稳定支撑数百到数千台电脑同时在线,通过合理的集群架构,则可以扩展至数万甚至更多,这个数字取决于网络带宽、硬件配置、软件调优以及业务类型,而非简单的一对一绑定关系,理解服务器与客户端的关系在开始讨论具体数字之前,需要先厘清一个基础概念……

    相关资讯 2026年11月10日
    900
  • 群晖服务器硬盘多少钱一台,哪个型号性价比高?

    群晖服务器硬盘的价格取决于硬盘类型、容量和定位,主流4TB NAS专用盘价格在600-1100元区间,8TB在1300-2200元区间,企业级硬盘则从2000元起步,具体选购需结合盘位数量和raid模式综合决策,为什么群晖硬盘价格差异巨大群晖NAS本身不捆绑硬盘销售,用户需要自行搭配,市面适配群晖的硬盘主要分三……

    相关资讯 2026年10月22日
    1600
  • 一台4路服务器到底多少钱,4路服务器租用和购买哪个更划算

    4路服务器全新整机的实际成交价大多在6万元到25万元之间,高配全闪存或大内存机型会突破40万元;裸机价只占一部分,CPU、内存和原厂服务会明显拉开差距,4路服务器的报价为什么不像标品那样固定4路服务器不是手机,没有统一零售价,厂商给出基础平台价格,实际成交价像组装台式机一样由选配件决定,同样是4路,一台跑虚拟化……

    2026年9月10日
    200
  • 1m服务器能支持多少人同时使用,服务器带宽多少够用?

    对于一台带宽只有1Mbps的服务器来说,它能支撑的在线人数通常在几十人到几百人之间,具体数字取决于你的业务类型、网站架构以及单次请求消耗的流量大小,如果你做的是纯文字博客,撑起200人同时在线没有太大问题;但若是图片站或视频站,可能连10个人都扛不住,要计算1M服务器的承载力,核心公式只有一条:带宽(1Mbps……

    2026年8月20日
    700
  • 服务器到底能同时ping多少个地址,ping不通怎么办?

    一台服务器能同时ping的人数没有固定上限,但受带宽、系统内核参数、防火墙规则和CPU性能四重制约,普通配置下轻松支撑上万并发ICMP请求,而默认Windows服务器往往连100个都撑不住,先搞懂ping的底层逻辑:它根本不“占用”连接数很多人误以为ping像网页访问一样需要建立TCP连接,其实完全不是一回事……

    相关资讯 2026年11月21日
    300
  • 安心网络服务器IP地址是多少,怎么查IP地址?

    安心网络服务器的IP地址并非固定值,而是根据你选择的云服务商和具体实例动态分配,以简米科技和酷番云为例,用户可在控制台轻松获取服务器公网IP,为什么服务器IP没有统一答案云服务器的IP分配机制当你购买一台云服务器,服务商会从IP池中分配一个公网IP给你,这个IP可能是动态的,也可能是弹性公网IP,动态IP在服务……

    2026年8月24日
    900
  • 大巴服务器一个月消费多少钱,怎么收费?

    大巴服务器租用一年的消费通常在6000元到30000元之间,具体金额由CPU型号、内存容量、硬盘类型和带宽大小四项核心配置决定,月付模式则折合500元到2500元左右,这个价格区间覆盖了从入门级电商站到中大型游戏业务的绝大多数需求,但真正拉开消费差距的往往不是机器本身,而是带宽线路、防御能力以及服务商的持牌资质……

    相关资讯 2026年11月5日
    300

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注