NginxStream模块代理Tomcat获取客户端真实IP的终极攻略

本文介绍了使用Nginx代理Tomcat时获取客户端真实IP地址的正确方法。许多用户尝试使用Nginx Stream模块进行TCP代理，但由于Stream模块不解析HTTP请求，导致Tomcat无法获取真实IP。文章指出，正确的做法是使用Nginx HTTP模块，通过配置`proxy_set_header X-Real-IP $remote_addr`和`proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for`，将客户端IP信息添加到HTTP请求头中，从而使Tomcat能够正确获取客户端IP。文章详细对比了两种方法，并提供了完整的Nginx HTTP模块配置示例，有效解决Nginx Stream模块代理Tomcat获取真实IP的难题。

Nginx Stream模块与Tomcat真实IP地址获取：常见问题及解决方案

在使用Nginx Stream模块代理Tomcat时，正确获取客户端真实IP地址是一个常见挑战。本文将分析问题根源并提供有效解决方案。

问题描述：

尝试使用Nginx Stream模块代理Tomcat，Nginx配置如下：

stream {
    server {
        listen 9000;
        proxy_pass 127.0.0.1:8080;
        proxy_protocol on;
    }
}

Tomcat connector配置也开启了proxyprotocol：

通过http://localhost:9000/xxx访问应用，浏览器报错，Tomcat访问日志仅记录代理前缀，缺少关键的客户端IP、目标IP、端口信息。抓包显示Nginx发送了包含proxy tcp4 ip1 ip2 端口1 端口2信息的报文，但Tomcat无法正常访问。

问题分析与解决方案：

根本原因在于：Nginx Stream模块处理的是TCP协议，而用户试图将其用于HTTP代理。Stream模块并非设计用于解析HTTP请求，它主要用于TCP层代理，例如负载均衡。因此，在Stream模块中使用proxy_protocol on无法让Tomcat获取客户端真实IP。proxy_protocol需要与能够解析HTTP请求的模块（例如Nginx HTTP模块）结合使用。

正确方法：使用Nginx HTTP模块进行代理，并利用HTTP请求头传递客户端IP信息。

正确的Nginx配置应使用HTTP模块，并设置相应的header：

http {
    server {
        listen 80;
        location / {
            proxy_pass http://127.0.0.1:8080;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
    }
}

Tomcat端可以通过获取X-Real-IP或X-Forwarded-For请求头获取客户端真实IP。 多层代理情况下，X-Forwarded-For包含多个IP，需根据实际情况选择合适的IP。

通过切换到Nginx HTTP模块并正确设置HTTP headers，即可解决Tomcat无法获取客户端真实IP的问题，确保应用正常运行。

今天关于《NginxStream模块代理Tomcat获取客户端真实IP的终极攻略》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！