Nginx UDP反向代理启动失败：日志格式配置异常排查求助

核心问题分析 #

你的配置存在两个关键错误：

1. combined日志格式不兼容Stream模块：combined是HTTP模块专属的日志格式，处理TCP/UDP的Stream模块不支持该格式，必须使用Stream模块适配的日志格式。
2. 透明代理的权限限制（潜在触发点）：proxy_bind $remote_addr:$remote_port transparent需要Nginx以root权限运行，且系统开启IP_TRANSPARENT参数，否则也会导致启动失败。

修正后的配置文件 #

load_module /usr/lib/nginx/modules/ngx_stream_module.so;
events {}
stream {
   # 定义Stream模块专用日志格式（也可使用默认格式）
   log_format stream_log '$remote_addr:$remote_port [$time_local] '
                         '$protocol $status $bytes_sent $bytes_received '
                         '$session_time';

   upstream mms {
      server 192.168.7.217:2000 max_fails=10  fail_timeout=60s;
   }
   server {
      listen 192.168.7.217:6000-6010 udp;
      proxy_pass mms;
      # 若不需要透明代理可直接注释该行，需使用则确保权限满足（见下方补充）
      # proxy_bind $remote_addr:$remote_port transparent;
      access_log /var/log/nginx/stream_access.log stream_log;
      error_log  /var/log/nginx/stream_error.log warn;
   }
}

配套修复步骤 #

1. 创建日志文件并设置权限：

   touch /var/log/nginx/stream_access.log /var/log/nginx/stream_error.log
   chown nginx:nginx /var/log/nginx/stream_access.log /var/log/nginx/stream_error.log
   

2. 验证配置语法合法性：

   nginx -t
   

3. 重启Nginx服务：

   systemctl restart nginx
   

透明代理权限补充（若需启用） #

如果必须使用透明代理，需完成以下操作：

• 修改nginx.conf，设置Nginx以root运行：user root;
• 临时开启系统内核参数：

  echo 1 > /proc/sys/net/ipv4/ip_nonlocal_bind
  echo 1 > /proc/sys/net/ipv4/conf/all/ip_transparent
  

• 永久生效内核参数，编辑/etc/sysctl.conf添加：

  net.ipv4.ip_nonlocal_bind = 1
  net.ipv4.conf.all.ip_transparent = 1
  

  执行sysctl -p使配置立即生效。

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