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：
<Connector connectionTimeout="20000" maxParameterCount="1000" port="8080" protocol="http/1.1" proxyProtocol="true" redirectPort="8443"/>
通过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的问题，确保应用正常运行。
