Nginx配置WebSocket时proxy_set_header指令参数错误问题求助

可能的原因及修复方案 #

1. 环境变量替换工具误修改Nginx内置变量 #

你配置里使用了${DOMAIN}环境变量，大概率是用envsubst这类工具生成最终配置文件。默认情况下envsubst会替换所有以$开头的内容，包括Nginx的内置变量$http_upgrade，导致这条指令被破坏。

修复方法：
指定envsubst只替换你需要的变量（比如仅${DOMAIN}），修改生成配置的命令：

envsubst '${DOMAIN}' < default.conf.template > /etc/nginx/conf.d/default.conf

如果需要替换多个变量，用逗号分隔：

envsubst '${DOMAIN},${OTHER_VAR}' < default.conf.template > /etc/nginx/conf.d/default.conf

2. 检查被include的配置文件冲突 #

你配置里引入了/etc/nginx/options-ssl-nginx.conf，这个文件可能重定义了proxy_set_header指令的格式，导致当前指令参数数量不符合要求。

修复方法：
查看这个文件的内容：

cat /etc/nginx/options-ssl-nginx.conf

如果里面有类似proxy_set_header的异常配置，比如错误的参数格式，或者用proxy_set_header做了其他定义，需要调整该文件，或者在你的location /ws/块里用proxy_set_header重新覆盖正确配置，或者移除该include（如果不影响SSL配置的话）。

3. 临时验证配置正确性 #

可以直接手动写死Upgrade头的值做测试，比如：

location /ws/ {
    proxy_pass http://backend;
    proxy_http_version 1.1;
    proxy_set_header Upgrade 'websocket';
    proxy_set_header Connection "upgrade";
}

如果这样能启动Nginx，说明确实是$http_upgrade变量被篡改的问题，回到第一种方案解决即可。

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