Nginx 配置生成器

选择站点类型,填写域名和路径,勾选 HTTPS、HTTP/2、缓存、压缩、安全头、限流等功能,生成带中文注释的 Nginx server 配置。已有 Apache 的 .htaccess 规则要迁移,请用 .htaccess 转 Nginx 工具。

使用步骤

  1. 把配置保存为 /etc/nginx/conf.d/域名.conf(Debian / Ubuntu 也可以放在 sites-available 再链接到 sites-enabled;宝塔面板在网站设置的“配置文件”中修改)。
  2. 申请证书:sudo certbot certonly --webroot -w 网站根目录 -d example.com -d www.example.com,证书默认保存在 /etc/letsencrypt/live/域名/。
  3. 执行 sudo nginx -t 检查语法,没有报错后 sudo systemctl reload nginx 让配置生效。
  • HTTP/2 的写法变了:Nginx 1.25.1 起推荐用单独的 http2 on;,旧的 listen 443 ssl http2; 会出现弃用警告;还在使用旧版本时勾选“Nginx 1.25 以前的写法”。用 nginx -v 查看版本。
  • HTTP/3 需要额外条件:Nginx 1.25 起内置支持,但编译时要带 ngx_http_v3_module,服务器防火墙和云厂商安全组还需要放行 UDP 443 端口。
  • 限流和真实 IP:limit_req_zone 只能写在 http 块中(nginx.conf),生成的配置中已注明位置;使用 CDN 后客户端 IP 都是 CDN 节点,需要配置 real_ip,否则限流和日志都会针对 CDN 节点。
  • 反向代理超时:后端处理时间超过 60 秒会返回 504,需要时调大 proxy_read_timeout,但更推荐把耗时任务改成异步处理。

迁移 Apache 规则请用 .htaccess 转 Nginx,HTTP 状态码的含义见 HTTP 状态码大全。

Nginx 配置生成器常见问题

Nginx 配置生成器怎么使用?

点选站点类型,填写域名、网站根目录或后端地址、上传大小限制,勾选 HTTPS、HTTP 跳转、www 统一、HTTP/2、HTTP/3、HSTS、Gzip、静态资源缓存、安全响应头、隐藏版本号、禁止访问隐藏文件、接口限流、跨域和 CDN 真实 IP 等选项,右侧实时生成配置。

Nginx 怎么配置 HTTPS?

勾选“启用 HTTPS”,填写证书路径,并开启 HTTP 跳转 HTTPS。

Vue 项目刷新 404 怎么办?

选择单页应用类型,配置中的 try_files 会把不存在的路径交给 index.html。

Nginx 怎么反向代理到 Node?

选择反向代理类型,填写后端地址如 127.0.0.1:3000,已包含 WebSocket 支持。

配置改完怎么生效?

先执行 nginx -t 检查语法,再执行 systemctl reload nginx。

Nginx 配置生成器的结果应怎样理解?

生成的是常见场景的配置模板,证书路径默认使用 Let's Encrypt 的位置;限流区域、WebSocket 的 map 和真实 IP 需要写在 nginx.conf 的 http 块中,已在配置开头注明。

输入内容会保存或发给外部服务吗?

所有内容在浏览器本地生成,不会上传。

没有结果或操作失败时先检查什么?

执行 nginx -t 报错时,按提示的行号检查;出现 http2 弃用警告时去掉“Nginx 1.25 以前的写法”,旧版本 Nginx 报 unknown directive http2 时则勾选它。

相关工具

WebSocket 在线测试 · JSON 格式化校验 · Base64 编码解码 · URL 编码解码 · 全部开发工具