Docker容器内Node.js服务器如何获取客户端真实远程IP？

问题背景 #

在Windows Docker Desktop环境中运行独立Express服务时，req.socket.remoteAddress始终返回172.23.0.1这类Docker网桥IP，无法获取访问服务器的客户端真实IP；尝试配置network_mode: "host"后外部无法连接服务，而直接在主机运行Node.js应用则能正常获取真实IP。

解决方案 #

• 确保Express监听所有接口
  默认情况下如果Express仅监听localhost（127.0.0.1），容器外请求无法正常到达，还会导致IP转发异常。必须让服务监听0.0.0.0，这样容器内服务才能接收来自任意接口的请求：

  app.listen(8000, '0.0.0.0', () => {
    console.log('Server running on port 8000');
  });
  

• 调整Docker端口映射与防火墙设置
  Windows Docker Desktop不支持Linux原生的host网络模式，保持默认bridge网络即可，只需确保端口映射绑定到主机的所有接口，并开放Windows防火墙对应端口：

  1. 修改docker-compose.yml的端口配置：

     ports:
       - "0.0.0.0:8000:8000"
       - "0.0.0.0:8080:8080"
     

  2. 打开Windows防火墙，允许Docker Desktop或Node.js应用通过8000、8080端口接收外部连接。

• 排查路由器端口转发的NAT影响
  由于你的服务通过路由器WAN端口转发到主机，部分路由器在端口转发时会做NAT转换，导致请求源IP变为路由器内网IP。如果遇到这种情况，需要在路由器后台开启"转发真实客户端IP"类功能（具体名称依路由器型号而定），确保客户端真实IP能传递到主机。

• 临时应急方案
  若暂时不需要容器化部署，直接在主机运行Express服务即可正常获取真实客户端IP，这是最快捷的临时解决方式。

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