Nginx 反向代理配置踩坑:WebSocket 支持与超时设置
发表于 : 周日 6月 14, 2026 8:26 am
Nginx 反向代理时,有几个容易踩的坑记录一下。
[b]1. WebSocket 代理[/b]
默认 Nginx 不会转发 Upgrade 头,需要手动配:
[code]location /ws/ {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Upgrade \;
proxy_set_header Connection "upgrade";
proxy_set_header Host \;
proxy_set_header X-Real-IP \;
}[/code]
[b]2. 超时设置[/b]
后端处理慢时(比如 AI 推理),Nginx 默认 60s 超时会断开连接:
[code]proxy_read_timeout 300s;
proxy_connect_timeout 60s;
proxy_send_timeout 300s;[/code]
[b]3. 大文件上传[/b]
默认 1MB,上传大文件记得调:
[code]client_max_body_size 50m;[/code]
[b]4. 日志查看[/b]
[code]tail -f /var/log/nginx/error.log
tail -f /var/log/nginx/access.log[/code]
配置完记得 [code]nginx -t[/code] 测试语法,通过再 [code]systemctl reload nginx[/code]。
[b]1. WebSocket 代理[/b]
默认 Nginx 不会转发 Upgrade 头,需要手动配:
[code]location /ws/ {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Upgrade \;
proxy_set_header Connection "upgrade";
proxy_set_header Host \;
proxy_set_header X-Real-IP \;
}[/code]
[b]2. 超时设置[/b]
后端处理慢时(比如 AI 推理),Nginx 默认 60s 超时会断开连接:
[code]proxy_read_timeout 300s;
proxy_connect_timeout 60s;
proxy_send_timeout 300s;[/code]
[b]3. 大文件上传[/b]
默认 1MB,上传大文件记得调:
[code]client_max_body_size 50m;[/code]
[b]4. 日志查看[/b]
[code]tail -f /var/log/nginx/error.log
tail -f /var/log/nginx/access.log[/code]
配置完记得 [code]nginx -t[/code] 测试语法,通过再 [code]systemctl reload nginx[/code]。