Nginx 配置

这个工具按三种模式生成可直接贴进 http{} 的配置片段：反向代理（含 upstream 池）、静态站点（含 expires/try_files/SPA 回退）、HTTPS 跳转与终结（80 端口 301/308 跳转 + 一台 TLS 服务器，SSL 端口默认 443、可改）。表单字段都是实名的，而且只出现在它真正生效的那一行。

它不做的事同样明确：不执行 `nginx -t`，不连服务器，也不校验你的指令拼写是否在当前编译参数下可用（比如 brotli 需要第三方 ngx_brotli 模块，官方发行版没有）。TLS 段取自 Mozilla ssl-config-generator Guideline 5.7 的 intermediate 与 recommended 两档现值（协议、密码套件、会话缓存、HSTS max-age），生成器页面标注了它们的目标 nginx/OpenSSL 版本，上线前请回原站重新生成核对。gzip 段是固定写进输出的（`gzip on` 加 comp_level/min_length/vary/proxied/types 五行），本页没有给它开关。

Nginx 配置怎么用

• 先选模式再填占位符：三种模式各自只露出自己用得上的行：静态模式是公共三样（域名、监听端口、client_max_body_size）加站点根目录、SPA 回退与缓存天数，location 前缀/匹配方式/转发路径这三个控件在静态模式下不出现；代理模式填上游列表与负载方式，超时和 proxy_buffering 要点开「高级：超时与缓冲」才看得到；HTTPS 模式在 TLS 行填 SSL 端口、证书目录、TLS 档位与 HSTS/OCSP 开关。折叠收起或切走模式再切回来，填过的值都不丢（控件只是看不见，没有被卸载）。所有小输入框都会把域名、目录、上游列表渲染进输出文本，拿到的是具体配置而不是占位符。
• 对比 proxy_pass 两种写法：「转发路径」下拉切换带斜杠（剥掉 location 前缀）与不带斜杠（原样转发完整路径）两种渲染，输出里的注释直接写明 /api/user 各会被转发成什么；选中正则匹配时工具会警告并退化 proxy_pass，这正是 nginx -t 的报错点。
• 上线三步：把片段放进 http 层对应 server 文件 → 本机 nginx -t 验证（工具不替你校验）→ reload。HTTPS 模式请确认证书路径存在、80 端口的 /.well-known/acme-challenge/ 没被跳转吃掉，再开 HSTS：它一旦下发就按 max-age 缓存在浏览器里，撤销不了。
• 每种模式露出哪些行：公共行三样——域名、监听端口、client_max_body_size；代理行有 location 前缀与匹配方式（前缀、`= 精确、^~ 优先、~ 与 ~* 正则）、转发路径（剥前缀/原样）、负载方式（轮询/ip_hash/least_conn）与 keepalive 池、WebSocket 升级、上游列表（一行一个）；TLS 行有 SSL 端口、证书目录、TLS 档位、重定向与 HSTS/OCSP、新老 http2 写法；静态行是站点根目录、SPA 回退与缓存天数。连接/读/发超时与 proxy_buffering 收在代理行下面的「高级：超时与缓冲」折叠里，默认收起但值一直保留。
• 输出与「上线前检查」折叠：输出 pane 全宽、最高 620px 内滚，它下面默认折着一条「上线前检查」折叠，展开就是那份自检清单，讲的都是最容易翻车的顺序与层级问题：location 匹配优先级（= 先停 → ^~ 最长前缀跳过正则 → 正则按配置先后 → 回落最长前缀）、proxy_pass 结尾带不带斜杠对转发路径的两种渲染结果对照（正则 location 里带 URI 更是直接报错）、root 与 alias 的拼路径区别、try_files $uri $uri/ =404 为什么必要、client_max_body_size 加在错误层级导致 413、以及 worker_connections 与文件描述符上限 nofile 的乘法关系。

常见问题