Nginx反向代理转发Tomcat实现指南

基本原理

Nginx作为高性能的Web服务器和反向代理服务器，可以将客户端请求转发到后端的Tomcat服务器，实现负载均衡、SSL终止、静态资源处理等功能。

实现步骤

1. 准备工作

• 确保已安装Nginx和Tomcat
• 确认Tomcat正常运行（默认端口8080）
• 确认Nginx正常运行（默认端口80）

2. 配置Tomcat

确保Tomcat配置了正确的应用上下文路径。例如在server.xml中：

<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">
    <Context path="" docBase="your_webapp" reloadable="true"/>
</Host>

3. 配置Nginx反向代理

编辑Nginx配置文件（通常在/etc/nginx/nginx.conf或/etc/nginx/conf.d/default.conf）：

server {
    listen 80;
    server_name yourdomain.com;  # 替换为你的域名或IP

    location / {
        proxy_pass http://localhost:8080;  # Tomcat默认地址
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # 可选：WebSocket支持
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    # 可选：静态资源由Nginx直接处理
    location ~* \.(jpg|jpeg|png|gif|ico|css|js|html)$ {
        root /path/to/your/static/files;
        expires 30d;
    }
}

4. 高级配置选项

A. 负载均衡

如果有多个Tomcat实例：

upstream tomcat_servers {
    server 127.0.0.1:8080 weight=5;
    server 127.0.0.1:8081;
    server 127.0.0.1:8082;
}

server {
    location / {
        proxy_pass http://tomcat_servers;
        # 其他proxy设置...
    }
}

B. SSL配置

server {
    listen 443 ssl;
    server_name yourdomain.com;

    ssl_certificate /path/to/your/cert.pem;
    ssl_certificate_key /path/to/your/key.pem;

    location / {
        proxy_pass http://localhost:8080;
        # 其他proxy设置...
    }
}

C. WebSocket支持

对于需要WebSocket的应用：

location /ws/ {
    proxy_pass http://localhost:8080;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_read_timeout 86400s;
    proxy_send_timeout 86400s;
}

5. 测试与重启

1. 测试Nginx配置是否正确：

   nginx -t
   

2. 重新加载Nginx配置：

   nginx -s reload
   # 或
   systemctl reload nginx
   

常见问题解决

1. 502 Bad Gateway错误：

   • 检查Tomcat是否运行
   • 检查Nginx配置中的proxy_pass地址是否正确
   • 检查防火墙设置

2. 静态资源无法加载：

   • 确保静态资源路径配置正确
   • 检查文件权限

3. Session丢失问题：

   • 确保负载均衡配置了ip_hash或使用共享session方案

   upstream tomcat_servers {
      ip_hash;
      server 127.0.0.1:8080;
      server 127.0.0.1:8081;
   }
   

通过以上配置，Nginx将作为反向代理服务器，将请求转发到后端的Tomcat应用服务器，同时可以利用Nginx的高性能处理静态资源和SSL等任务。