NX

Nginx 配置生成

反代 / 静态站点,勾选即出 server 块

多个域名用空格分隔,会写进 server_name。
反代填 http://ip:port,静态站点填 /var/www/site 这样的绝对路径。

        

如何使用本工具

  1. 填域名(多个用空格分隔),选反代还是静态站点,再填后端地址或站点根目录。
  2. 勾「80 跳 443」会多生成一个跳转 server 块,证书路径按 Let's Encrypt 的默认位置写好,路径不同就改两行。
  3. 静态站点要做前端路由(React / Vue history 模式)就勾 SPA 回退,否则刷新子路径会 404。
  4. 反代后端是 WebSocket 服务时勾上升级头,不然握手会返回 400。
  5. 复制生成的配置粘进 /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,客户端可以随便伪造这个头,日志和限流都会失真。