如何将Nginx的remote_addr设置为真实客户端IP？

你遇到的核心问题是Docker默认bridge网络的端口映射会做源地址转换（SNAT），请求到达Nginx容器时，源IP已经被替换成了Docker主机（你的虚拟机）的IP，所以remote_addr始终显示虚拟机IP。以下是两种直接修改remote_addr使其显示真实客户端IP的可行方案：

方案一：切换Docker网络为Host模式 #

让Nginx容器直接使用主机的网络栈，跳过Docker的端口转发，这样Nginx能直接获取到客户端的真实IP，remote_addr自然就是客户端IP。

修改你的docker-compose.yml中Nginx服务的配置：

services:
  nginx:
    image: nginx:alpine
    network_mode: host
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./html:/usr/share/nginx/html
    # 无需配置ports，直接使用nginx.conf里listen指定的主机端口

注意事项：

• 确保主机上对应端口未被其他服务占用
• Windows/macOS的Docker Desktop下，host模式可能受虚拟机底层限制，兼容性不如Linux环境

方案二：使用Nginx realip模块改写remote_addr（需存在可信代理层） #

如果你的Nginx前端还有其他可信代理（比如云厂商负载均衡、上层反向代理），且该代理会把真实客户端IP放在X-Forwarded-For或X-Real-IP请求头中，可以通过ngx_http_realip_module直接改写remote_addr。

在nginx.conf的http块中添加以下配置：

# 指定可信代理的IP范围（比如负载均衡IP、上层代理的子网）
set_real_ip_from 192.168.1.0/24;
# 从X-Forwarded-For头读取真实客户端IP
real_ip_header X-Forwarded-For;
# 多层代理时，取X-Forwarded-For中最外层的客户端IP
real_ip_recursive on;

注：如果只有Docker+Nginx两层，默认bridge模式下Docker不会传递真实客户端IP，这种方案不适用，必须配合Host或Macvlan网络模式。

另外你提到的realip_remote_addr，其实就是realip模块改写后的remote_addr值——配置完成后，remote_addr会自动被替换为真实客户端IP，无需额外引用这个变量。

内容的提问来源于stack exchange，提问作者Kosmylo