Nginx 配置生成器（企业级）

该技能可自动化创建 Nginx/OpenResty 反向代理配置，兼顾易用性与安全性，内置环境感知能力及关键的安全检查机制。

特性

• 环境感知：通过读取环境变量中的配置简化命令调用。
• 安全检查：集成“熔断”（fuse）机制。在应用配置前先执行测试；若测试失败，则自动回滚，避免 Web 服务中断。

前置条件（推荐）

为获得最佳使用体验，建议在宿主机系统中预先设置以下环境变量：

• NGINX_CONFIG_PATH：Nginx conf.d 目录的绝对路径。
• NGINX_CONTAINER_NAME：正在运行的 Nginx/OpenResty Docker 容器名称。

若未设置上述环境变量，则 必须 通过命令行参数显式提供。

核心操作：scripts/create-and-reload.sh

该脚本完成全部流程。

输入（命令行参数）

• --service-name：（必需）服务的简称（例如：grafana）。
• --domain：（必需）根域名（例如：example.com）。
• --port：（必需）服务监听的本地端口（例如：3000）。
• --config-path：（可选）Nginx conf.d 目录路径。优先级高于 NGINX_CONFIG_PATH 环境变量。
• --container-name：（可选）Nginx Docker 容器名称。优先级高于 NGINX_CONTAINER_NAME 环境变量。

输出

• 成功时：打印逐步执行日志及最终成功提示信息。
• 失败时：向 stderr 输出描述性错误信息并退出；若失败发生在 Nginx 配置测试阶段，则完整显示 nginx -t 的报错内容。

执行流程

1. 解析参数与环境变量：脚本从命令行参数和环境变量中收集所有必需的路径与名称。
2. 生成配置文件：在目标目录中创建 .conf 文件。
3. 测试配置（安全检查）：在指定容器内执行 nginx -t 命令验证配置语法正确性。
4. 决策与执行：
   • 若测试通过，则继续执行 nginx -s reload 重载 Nginx 配置。
   • 若测试失败，则 自动删除已生成的配置文件（回滚） 并报告错误。
5. 结果反馈：向用户汇报最终执行结果。

使用示例

场景 1：已预设环境变量

# 为后续使用提前设置
export NGINX_CONFIG_PATH="/path/to/your/nginx/conf.d"
export NGINX_CONTAINER_NAME="your_nginx_container"

# 此时命令极为简洁：
bash skills/nginx-config-creator/scripts/create-and-reload.sh 
  --service-name "grafana" 
  --domain "example.com" 
  --port "3000"

场景 2：未设置任何环境变量（全部信息通过参数传入）

bash skills/nginx-config-creator/scripts/create-and-reload.sh 
  --service-name "grafana" 
  --domain "example.com" 
  --port "3000" 
  --config-path "/path/to/your/nginx/conf.d" 
  --container-name "your_nginx_container"

容错策略

• 缺失必要参数：若必需的命令行参数或环境变量未提供，脚本将直接报错退出。
• nginx -t 执行失败：本技能以安全性为首要设计原则。它 绝不会 尝试重载存在错误的配置；而是自动清理临时产物，并向用户展示确切的错误详情，确保线上 Web 服务始终不受影响。