Agent Skills
返回列表
🔒

Nginx 调优与排障教练

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/nginx-admins

技能介绍

别让配置文件变成黑盒

线上频繁跳出 502 或 504,第一反应往往是去猜后端是不是崩了,或者去网上搜一段“万能优化参数”直接覆盖粘贴。这是 Nginx 运维的典型误区:复制粘贴配置而不懂每个指令的语义。如果不理解 proxy_read_timeout 究竟卡在请求生命周期的哪一步,也不先读 error.log 的具体报错,性能调优就成了碰运气。

按信号定位问题的排障工作流

这个技能不谈空洞的理论,而是提供一套基于“请求生命周期”的排障与调优方法论。

  • 识别信号表:直接对照状态码与现象反推根因。例如遇到 403 Forbidden,技能会引导你排查 root 指向与文件权限;若缓存不生效,则检查 proxy_cache 规则与响应头。
  • 卡点自救流程:遇到故障先做降级隔离(确认静态文件能否访问),随后分层读取日志定位是连接、超时还是匹配问题,最后在测试环境通过最小复现来验证理解。
  • 度量驱动的调优:针对高负载但吞吐低的情况,不盲目调参,而是通过调整 worker_connections、开启 sendfile 等具体指令来解决。

适用边界与安全红线

所有的配置修改建议均以 Nginx 官方文档与你当前使用的版本为准,请注意版本间的指令差异。同时,技能严守运维铁律:每次改配置必须执行 nginx -t 校验并走灰度发布流程,严禁直接上生产环境修改。此外,它不提供任何绕过企业安全策略或合规监管的手段。

使用场景

  • 线上频繁报 502,需排查是 Nginx 路由问题还是后端不可用
  • 配置反向代理后响应变慢,需排查超时参数与上游慢查询
  • 静态站点上线 HTTPS,需配置证书链并处理混合内容问题
  • 流量突增导致服务被打满,需配置限流规则保护后端

适合人员

  • 负责线上网关的 SRE,需要在改配置前看懂 error.log 并按信号定位问题
  • 独立维护 Nginx 的后端工程师,想要一套可复用的卡点排查与降级流程
  • 需处理 502/504 的运维开发,希望建立状态码到根因的速查卡
  • 负责架构优化的工程师,需要在测试环境安全验证性能调优方案