Nginx 配置生成
反代 / 静态站点,勾选即出 server 块
如何使用本工具
- 填域名(多个用空格分隔),选反代还是静态站点,再填后端地址或站点根目录。
- 勾「80 跳 443」会多生成一个跳转 server 块,证书路径按 Let's Encrypt 的默认位置写好,路径不同就改两行。
- 静态站点要做前端路由(React / Vue history 模式)就勾 SPA 回退,否则刷新子路径会 404。
- 反代后端是 WebSocket 服务时勾上升级头,不然握手会返回 400。
- 复制生成的配置粘进 /etc/nginx/conf.d/ 下的 .conf 文件,先 nginx -t 再 reload。
常见问题
Q:proxy_pass 后面带不带斜杠有什么区别?
A:带斜杠(proxy_pass http://127.0.0.1:8080/;)会把 location 匹配到的前缀替换掉,不带则原样透传。比如 location /api/ 配 http://host/ 时,/api/user 会变成 /user;配 http://host 时还是 /api/user。这是 Nginx 反代最常见的坑,本工具默认不加尾斜杠。
Q:为什么 WebSocket 必须加 Upgrade 头?
A:Nginx 默认按 HTTP/1.0 处理并且不转发逐跳头部,后端收不到 Upgrade: websocket 就会把它当普通请求,握手直接失败(常表现为 400 或连接后立刻断开)。所以要显式写 proxy_http_version 1.1 加上 Upgrade 和 Connection 两个头。
Q:SPA 的 try_files 为什么要兜底到 index.html?
A:history 模式下 /user/123 在服务端并不存在对应文件,Nginx 会直接返回 404。把不存在的路径交给 index.html,前端路由才能接手。注意兜底要写在最后,否则接口路径也会被吃掉。
Q:静态资源缓存 30 天会不会导致改版不生效?
A:文件名带内容哈希(app.3f2a1b.js)就没问题,改版后文件名变了自然会重新拉。真正要小心的是 index.html 这种固定名字的入口,必须设成 no-cache,否则用户会拿着旧 HTML 去找已经删掉的旧资源。
Q:client_max_body_size 不设会怎样?
A:默认只有 1MB,上传稍大的图片或文件就返回 413 Request Entity Too Large。这个错误是 Nginx 在收到请求体之前就拒绝的,后端日志里什么都看不到,很容易误判成前端问题。
Q:真实 IP 那个选项要不要开?
A:只有当 Nginx 前面还有一层代理(CDN、SLB、Cloudflare)时才需要,而且必须配 set_real_ip_from 白名单。不开白名单直接信任 X-Forwarded-For,客户端可以随便伪造这个头,日志和限流都会失真。