Nginx 配置生成器

Nginx 配置生成器使用指南

📌 简介

Nginx 配置生成器是一款面向运维工程师、全栈开发者的在线辅助工具。在部署 Node.js 接口、Vue/React 前端项目或 Java 后端时，编写 Nginx 配置经常容易遗漏某些关键的 Header（如 Host 丢失、CORS 跨域报错）。本工具通过可视化的勾选，一键生成符合最佳实践的 Nginx 配置文件，省去查文档的时间。

📖 反向代理与静态托管的区别

1. 反向代理：当你的应用运行在 3000、8080 等非标准端口时，通过 Nginx 将 80/443 端口的请求转发给应用。配置中必须带上 proxy_set_header Host $host;，否则后端的重定向和 Cookie 域会发生错乱。
2. 静态文件：通常是打包后的单页应用（SPA），配置 try_files $uri $uri/ /index.html; 是为了解决前端路由（如 Vue-Router history 模式）刷新后 404 的问题。

💼 常见应用场景

• 新项目上线：为新申请的域名配置标准的 HTTP / HTTPS 服务。
• 解决跨域报错：在后端代码未配置跨域时，直接利用 Nginx 生成并注入 CORS 相关的 Response Header。
• 配置 HTTPS：一键生成带有 TLS 1.2/1.3 优化、强制 301 重定向的加密配置。

⚙️ 使用步骤

1. 输入你的域名（如 api.example.com）。
2. 选择应用类型（反向代理或静态网站），并填入目标端口或目录。
3. 根据服务器安全需求，勾选是否强制 HTTPS、是否允许跨域。
4. 右侧会自动生成对应配置。点击“复制配置”，粘贴到宝塔或服务器的 `/etc/nginx/conf.d/` 下即可。

⚠️ 注意事项

• 如果勾选 HTTPS，请务必确保你的服务器已申请 SSL 证书，并将生成的代码中的证书路径修改为真实路径。
• 如果开启了 WebSocket 支持（默认已生成），需要后端服务本身也支持 WebSocket 协议。
• 修改配置后，记得在服务器上执行 nginx -t 测试语法，然后 nginx -s reload 重载服务。

❓ 常见问题 (FAQ)