Nginx 调优与排障教练
将以下提示词粘贴到你的 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 的运维开发,希望建立状态码到根因的速查卡
- 负责架构优化的工程师,需要在测试环境安全验证性能调优方案