Nginx专家

📌 Skill基础信息

• Skill名称：nginx-expert
• 简称：nginx专家
• 来源：社区第三方（pwdev-solucoes）
• 运行宿主：Claude-Code CLI
• 核心定位：专注于Nginx服务器配置诊断与优化，提供反向代理、TLS安全配置、性能调优等专业指导，适用于Web服务部署和故障排查场景。

🧩 内部核心组成

该Skill主要包含Nginx配置专家知识和诊断规则体系：

核心能力组件：

• 配置验证规则：强制要求 nginx -t 语法检查
• 错误代码诊断表：502/504/413等HTTP状态码的根因分析
• 安全约束机制：防止配置错误导致服务中断
• 最佳实践模板：反向代理、限流、TLS等标准配置片段

配置模板库：

• 反向代理基础配置
• 速率限制(rate limit)配置
• TLS安全配置规范
• 常见错误场景解决方案

🛠 安装与启用方式

# 安装命令
skills install --user pwdev-solucoes/pwdev-claude-marketplace

前置要求：

• 已安装Claude-Code CLI环境
• 具备Nginx服务器访问权限
• 拥有配置文件修改权限（需确认操作）

📋 标准工作流

1. 用户输入：用户提出Nginx相关问题时触发（包含"nginx"、"reverse proxy"、"502错误"等关键词）
2. 配置诊断：Skill分析问题类型，匹配相应的错误代码或配置场景
3. 安全验证：强制要求执行 nginx -t 语法检查 before任何重载操作
4. 方案提供：输出针对性的配置建议或修改方案
5. 确认执行：对于高风险操作（如reload、配置修改）需要用户明确确认
6. 结果验证：指导用户验证配置生效情况

⚠️ 关键限制、缺陷、注意事项

平台限制：

• 仅适用于类Unix系统环境
• 需要本地Nginx安装和配置权限

安全约束：

• 禁止自动执行nginx reload操作
• 不允许扩大服务暴露范围的配置修改
• 不处理证书签发和续期操作

使用限制：

• 需要使用者具备基本的Nginx配置知识
• 不适用于完全新手用户
• 生产环境使用需经过严格测试

已知注意事项：

• 在代理后方使用时需注意IP地址识别问题
• TLS配置需要完整的证书链（fullchain）
• 重载配置前必须通过语法检查

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景：

• Web运维人员排查Nginx相关故障
• 开发人员配置反向代理和负载均衡
• 安全团队优化TLS配置和安全策略
• 性能调优场景（缓存、压缩、限流配置）
• 教育学习Nginx最佳实践

❌ 不适合场景：

• 完全无Nginx基础的新手用户
• 需要自动化证书管理的场景
• 大规模集群的自动化部署
• 需要修改内核参数的深度优化
• 生产环境未经测试的直接应用