Nginx配置生成器

技能简介

该技能用于自动生成 Nginx/OpenResty 反向代理配置文件，并在验证通过后重载 Web 服务器。内置熔断保护机制，确保配置错误时自动回滚，避免服务中断。

能做什么

• 根据服务名、域名和端口自动生成标准反向代理配置
• 支持从环境变量读取常用路径，简化命令行参数
• 配置生效前自动执行语法测试，失败时自动删除临时文件
• 通过 Docker 容器执行 Nginx 重载操作

使用说明

前置准备（推荐）

在宿主机设置环境变量以减少后续输入：

export NGINX_CONFIG_PATH="/path/to/nginx/conf.d"
export NGINX_CONTAINER_NAME="your_nginx_container"

安装要求

需确保系统已安装：bash、docker，且目标 Nginx/OpenResty 容器正在运行。

执行命令

方式一（已设环境变量）：

bash skills/nginx-config-creator/scripts/create-and-reload.sh \
  --service-name "grafana" \
  --domain "example.com" \
  --port "3000"

方式二（完整参数）：

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

输入与输出

见下方输入与输出表格。

风险提示

• 必须提供有效的 Nginx 配置目录路径，否则脚本无法写入文件
• Docker 容器名称错误将导致配置测试和重载失败
• 端口冲突或域名解析异常可能导致代理无法正常转发
• 建议先在测试环境验证配置模板，再用于生产环境

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/xieyuanqing/nginx-config-creator/SKILL.md
来源类型：GitHub 仓库