架構概覽
客戶端 → Apache (HTTP/HTTPS, 靜態資源, SSL 終結, 負載均衡)
↓ mod_jk (AJP/1.3 協議)
Tomcat 集群 (業務邏輯, 動態處理, Session 複製)
優勢:Apache 擅長靜態/SSL/併發連接,Tomcat 專注業務邏輯,職責分離。
安裝部署步驟
1. 環境準備
# CentOS 7/8
yum -y install httpd httpd-devel gcc make java-1.8.0-openjdk-devel
# 或 dnf install ...
# 驗證 apxs 路徑
which apxs
# /usr/bin/apxs 或 /usr/sbin/apxs
2. 下載並編譯 mod_jk
cd /usr/local/src
wget https://dlcdn.apache.org/tomcat/tomcat-connectors/jk/tomcat-connectors-1.2.48-src.tar.gz
tar xzf tomcat-connectors-1.2.48-src.tar.gz
cd tomcat-connectors-1.2.48-src/native
./configure --with-apxs=/usr/bin/apxs
make -j$(nproc)
make install
# 生成:/usr/lib64/httpd/modules/mod_jk.so
3. Apache 配置 mod_jk
# /etc/httpd/conf.d/mod_jk.conf
LoadModule jk_module modules/mod_jk.so
JkWorkersFile /etc/httpd/conf.d/workers.properties
JkLogFile /var/log/httpd/mod_jk.log
JkLogLevel info
JkShmFile /var/run/httpd/jk.shm
JkMountFile /etc/httpd/conf.d/uriworkermap.properties
# 靜態資源由 Apache 直接服務
Alias /static /var/www/html/static
Require all granted
4. Worker 定義
# /etc/httpd/conf.d/workers.properties
worker.list=lb,status
# Tomcat 節點 1
worker.tomcat1.type=ajp13
worker.tomcat1.host=192.168.10.11
worker.tomcat1.port=8009
worker.tomcat1.lbfactor=1
worker.tomcat1.connection_pool_size=100
worker.tomcat1.connection_pool_timeout=600
worker.tomcat1.socket_keepalive=1
worker.tomcat1.socket_timeout=30
# Tomcat 節點 2
worker.tomcat2.type=ajp13
worker.tomcat2.host=192.168.10.12
worker.tomcat2.port=8009
worker.tomcat2.lbfactor=1
worker.tomcat2.connection_pool_size=100
worker.tomcat2.connection_pool_timeout=600
worker.tomcat2.socket_keepalive=1
worker.tomcat2.socket_timeout=30
# 負載均衡 Worker
worker.lb.type=lb
worker.lb.balance_workers=tomcat1,tomcat2
worker.lb.sticky_session=1 # Session 親和性
worker.lb.sticky_session_force=1
# 狀態監控 Worker
worker.status.type=status
5. URI 映射規則
# /etc/httpd/conf.d/uriworkermap.properties
# 所有 /app/* 請求轉發給 lb worker
/app/*=lb
/app=lb
# 管理監控頁面
/jkstatus=status
# 靜態資源不轉發 (由 Apache 直接服務)
!/static/*
!/images/*
!/css/*
!/js/*
6. Tomcat 配置 AJP 連接器
7. Session 複製 (集群高可用)
性能調優關鍵參數
| 參數 | 推薦值 | 說明 |
| worker.*.connection_pool_size | 100-200 | 連接池大小,避免頻繁創建連接 |
| worker.*.socket_keepalive | 1 | TCP Keepalive 防火牆不斷開長連接 |
| worker.*.socket_timeout | 30-60 | Socket 讀寫超時 (秒) |
| worker.lb.sticky_session | 1 | Session 親和性,配合 jvmRoute |
| JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories | 啟用 | 傳遞 SSL 密鑰長度、兼容 URI、禁用目錄轉發 |
| Tomcat maxThreads | 200-500 | 根據 CPU 核心數與業務類型調整 |
| Tomcat acceptCount | 100-200 | 等待隊列長度 |
監控與故障排查
# 1. mod_jk 狀態頁
https://apache-server/jkstatus
# 2. 關鍵日志
tail -f /var/log/httpd/mod_jk.log
tail -f /var/log/httpd/error_log
tail -f /usr/local/tomcat/logs/catalina.out
# 3. 連接數監控
watch -n 1 'ss -ant | grep :8009 | wc -l'
netstat -an | grep :8009 | awk '{print $6}' | sort | uniq -c
# 4. 常見錯誤
# "Cannot connect to worker" → Tomcat AJP 端口未啟動/防火牆/網絡不通
# "Worker is in error state" → 連接失敗超過 retry 次數,標記錯誤狀態
# "Service unavailable" → 所有後端 worker 均錯誤狀態
現代替代方案
| 方案 | 協議 | 優點 | 缺點 |
| mod_proxy_ajp | AJP | Apache 內建模塊、無需編譯 | 功能較簡單、調優參數少 |
| mod_proxy_http | HTTP | 通用、支持 HTTP/2、調試方便 | HTTP 頭開銷、無原生 Session 親和 |
| Nginx + upstream | HTTP/FastCGI/uwsgi | 高性能、配置簡潔、熱加載 | 需額外部署 Nginx |
| HAProxy | TCP/HTTP | 專業負載均衡、健康檢查豐富 | 無 Web 服務功能 |
| Envoy/Traefik/Ingress Controller | HTTP/gRPC | 雲原生、服務發現、TLS 自動化 | 學習曲線、架構複雜 |