# Nginx 配置生成器 - 在线生成反向代理、HTTPS、SPA 配置

> 免费在线 Nginx 配置生成：静态站、SPA、反向代理与负载均衡、WebSocket、PHP-FPM、整站跳转，一键加 HTTPS、HTTP/2、gzip、缓存、安全头、限流，另附格式化。

- 网址: https://qilingtools.com/zh/nginx-config
- 分类: 开发工具 (https://qilingtools.com/zh/dev)
- 标签: [开发](https://qilingtools.com/zh/tags/dev), [网络 HTTP](https://qilingtools.com/zh/tags/network), [运维部署](https://qilingtools.com/zh/tags/devops)
- 最后更新: 2026-10-26
- 价格: 免费，无需注册
- 隐私: 在浏览器本地处理，文件不上传服务器

每次上线新站点都要翻文档拼 Nginx 配置？在这里选好场景、填几个选项，就能得到一份带中文注释、可以直接放进 conf.d 的 nginx.conf。场景包括静态网站、单页应用（Vue / React 的 history 路由回退到 index.html，并让 index.html 不缓存）、反向代理（多个后端时自动生成 upstream，可选轮询、least_conn、ip_hash、random 负载均衡和 keepalive 长连接）、WebSocket 代理（Upgrade 头与长连接超时）、PHP-FPM（前端控制器与 fastcgi 参数）和整站 301 跳转。启用 HTTPS 后会生成证书路径、参考 Mozilla 推荐的 TLS 协议与加密套件、会话缓存、HSTS，HTTP 自动跳转 HTTPS 并保留 Let’s Encrypt 验证路径，HTTP/2 可选 nginx 1.25.1 以后的 http2 on 新写法或旧写法；还能一键统一 www 与非 www 域名。性能与安全方面可加 gzip、静态资源 30 天缓存、安全响应头、隐藏版本号、上传大小限制、按 IP 限流、CORS 跨域和 Basic Auth 密码保护。另一个标签页可以把压成一行或缩进混乱的 nginx 配置格式化成规范缩进，保留注释并检查括号是否配对。

## 使用步骤

1. 选择场景（静态网站、SPA、反向代理、WebSocket、PHP、跳转）
2. 填写域名、根目录或后端地址，按需勾选 HTTPS、gzip、缓存、安全头等选项
3. 复制或下载配置，在服务器上执行 nginx -t 检查后 reload

## 功能特点

- 静态网站、SPA、反向代理、WebSocket、PHP-FPM、整站跳转
- upstream 负载均衡与 keepalive
- HTTPS：Mozilla 推荐 TLS、HSTS、HTTP 跳转 HTTPS、HTTP/2
- www 与非 www 统一跳转
- gzip、静态缓存、安全头、限流、CORS、Basic Auth
- 配置附带注释，可直接下载 .conf
- nginx 配置格式化与括号检查

## 常见问题

### 生成的配置放在哪里？怎么生效？

Debian / Ubuntu 可以放到 /etc/nginx/sites-available/ 再软链到 sites-enabled/，或者直接放进 /etc/nginx/conf.d/ 并以 .conf 结尾（conf.d 默认被 include 在 http 块里，所以 upstream、map、limit_req_zone 可以直接写在文件顶部）。保存后先执行 nginx -t 检查语法，再执行 nginx -s reload 或 systemctl reload nginx 生效。

### HTTPS 证书从哪里来？

最常用的是 Let’s Encrypt 免费证书。勾选“保留 Let’s Encrypt 验证路径”后，可以先只启用 HTTP 配置，执行 certbot certonly --webroot -w /var/www/certbot -d 你的域名 申请证书，证书默认在 /etc/letsencrypt/live/域名/ 下，再开启 HTTPS 配置并 reload。certbot 会自动续期。

### 单页应用刷新页面 404 怎么办？

Vue Router、React Router 的 history 模式需要把找不到的路径都交给 index.html 处理，也就是 SPA 场景里的 try_files $uri $uri/ /index.html;。同时生成的配置会让 index.html 不被缓存、带哈希的静态资源长缓存，发版后用户能立刻拿到新版本。

### 为什么加了 add_header 后某些响应头消失了？

这是 Nginx 的继承规则：某个 location 里只要出现了 add_header，就不会再继承 server 块里的 add_header。所以生成器把安全头、HSTS、CORS 都放在 server 块，静态资源缓存用不会影响继承的 expires 指令实现。你自己在 location 里加 add_header 时，需要把需要的头重新写一遍。

## 相关工具

- [JSON 格式化](https://qilingtools.com/zh/json): 免费在线 JSON 格式化：一键美化、压缩，实时语法校验并定位到出错行列，支持树形视图折叠、键名排序、转义与去转义、Unicode 转中文、复制下载，数据不上传。
- [Base64 编解码](https://qilingtools.com/zh/base64): 免费在线 Base64 编码解码工具：支持中文 UTF-8、URL 安全变体，文本与 Base64 互转，实时转换，本地处理不上传。
- [URL 编解码](https://qilingtools.com/zh/url-encode): 免费在线 URL 编码解码工具：encodeURIComponent 与 encodeURI 两种模式，处理中文、空格与特殊符号，本地实时转换不上传。
- [JWT 解析](https://qilingtools.com/zh/jwt): 免费在线 JWT 解析工具：解码 JWT 的 Header 与 Payload，展示过期时间、签发时间等，本地解析不上传，保护令牌安全。
- [时间戳转换](https://qilingtools.com/zh/timestamp): 免费在线 Unix 时间戳转换工具：时间戳与日期互转，自动识别秒/毫秒，显示本地时间、UTC、ISO 8601 和相对时间，实时更新。
- [哈希计算](https://qilingtools.com/zh/hash): 免费在线哈希/摘要计算工具：对文本或文件计算 SHA-1、SHA-256、SHA-384、SHA-512，使用浏览器加密接口本地完成，文件不上传。
- [UUID 生成](https://qilingtools.com/zh/uuid): 免费在线 UUID 生成器：使用加密安全随机数批量生成符合 RFC 4122 的 UUID v4，可大写、去连字符、加花括号，一键复制。
- [进制转换](https://qilingtools.com/zh/base-convert): 免费在线进制转换工具：二进制、八进制、十进制、十六进制及任意 2–36 进制互转，支持大整数（BigInt），本地实时计算。