# nginx-generator

**Repository Path**: XQT09/nginx-generator

## Basic Information

- **Project Name**: nginx-generator
- **Description**: 一个自动生成Nginx配置文件的开源工具，支持模板化、自动化部署，提升运维效率。
- **Primary Language**: HTML
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-26
- **Last Updated**: 2026-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nginx 配置生成器

一个纯前端的可视化 Nginx 配置生成工具，无需后端、无构建步骤，打开即用。通过表单选择场景和参数，实时生成可直接使用的 nginx 配置。

## 功能特性

- **6 种常见场景**：静态文件、反向代理、SPA 应用、负载均衡、PHP-FPM、WebSocket
- **双目标平台**：Linux 服务器 / Windows（自动切换路径、PHP 地址、日志位置等默认值）
- **SSL/HTTPS**：证书配置、HTTP 自动跳转 HTTPS、HSTS
- **两种输出模式**：
  - 片段模式（默认）：仅 `server` 块，放入 `conf.d/` 或 `sites-enabled/`
  - 完整模式：含 `events {}`、`http {}` 外壳，可直接作为 `nginx.conf` 使用
- **高级选项**：Gzip、访问日志、静态资源缓存、隐藏版本号、安全响应头、CORS 跨域
- **贴心细节**：
  - 端口合法性校验，非法值自动回退
  - Windows 路径自动将 `\` 转为 `/`，含空格路径自动加引号
  - IPv6 监听可开关
  - 表单状态 localStorage 持久化，刷新不丢失
  - 明/暗主题切换
- 生成结果一键复制、一键下载（`.conf` 文件）

## 文件结构

```
├── index.html                  # 主页面（单文件应用，含全部业务逻辑）
├── favicon.ico
└── assets/
    ├── social-preview.png      # 社交分享预览图
    └── tools/
        ├── css/tool-base.css   # 基础样式 + 悬浮外壳样式
        └── js/
            ├── tool-chrome.js  # 运行时外壳（主题切换按钮、结构化数据）
            └── tools_h.js
```

## 使用方法

### 本地使用

直接用浏览器打开 `index.html` 即可。

### 静态部署

整个目录原样上传到任意静态托管（nginx、GitHub Pages、对象存储等）即可，注意保持 `index.html` 与 `assets/` 的相对位置不变（页面内以 `./assets/...` 引用）。

## 生成的配置如何生效

**片段模式**（默认）输出顶部注释包含部署指引：

```bash
# Linux
#   Debian/Ubuntu: 放入 /etc/nginx/sites-available/ 并软链到 sites-enabled/
#   CentOS/Docker: 放入 /etc/nginx/conf.d/xxx.conf
# Windows: 保存为 conf/vhosts/xxx.conf（需主配置 include vhosts/*.conf）

# 验证并重载
nginx -t
nginx -s reload        # Linux 也可用 systemctl reload nginx
```

## 技术说明

- 纯 HTML + CSS + 原生 JavaScript，零依赖、零构建
- 字体使用 [fonts.loli.net](https://fonts.loli.net) 镜像（JetBrains Mono / Space Grotesk），国内可稳定访问
- 生成的 HTTPS 配置使用 `http2 on;` 新写法，需 nginx ≥ 1.25.1；旧版本请按生成配置中的注释提示调整