Nginx 进阶配置专家
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/kg-nginx-config。
技能介绍
解决生产环境的 Nginx 配置痛点
在微服务与高并发场景下,手写 Nginx 配置往往容易踩坑:proxy_pass 末尾的 / 导致 URI 重写混乱、上游连接未复用引发性能瓶颈、HTTPS 证书过期未续期导致业务中断,或是遭遇 502/504 错误时无从下手排查。本技能旨在为开发者提供一套严谨、可落地的生产级 Nginx 配置生成与审查方案,确保配置文件清晰、高性能且安全稳定。
核心能力与工作流
技能以 Nginx 配置专家的角色介入,通过标准化的工作流逐步构建或优化你的 .conf 文件:
- 反向代理与连接复用:准确处理
proxy_pass的 URI 重写逻辑,并在upstream块中配置keepalive 32与proxy_http_version 1.1,实现上游长连接复用。 - 负载均衡策略:根据业务需求选择
round-robin、least_conn(最少活跃连接)、ip_hash(会话保持)或random算法。 - SSL/TLS 与安全加固:集成 Certbot 实现 Let's Encrypt 证书自动续期,配置静态资源缓存、Gzip 压缩(排除图片/视频等已压缩格式),并设置限流防爬虫。
- 超时调优与排障:针对 504 Gateway Timeout,精准调大
proxy_read_timeout(默认 60s);针对 502 Bad Gateway,核对upstream中的 server 地址与端口。
最终输出不仅包含带有详细注释的完整配置,还会附带安全评分目标(如 SSL Labs A+ 评级)与 worker、buffer 等性能参数建议。
适用边界与注意事项
需要明确的是,Nginx 是高性能的 Web 服务器与反向代理,而非应用服务器。它不负责动态内容的生成(如复杂的业务逻辑渲染)。此外,如果你的需求涉及复杂的 API 网关逻辑(如鉴权、动态路由、请求改写等),建议引入 Kong 或 APISIX 等专业网关组件,而非在 Nginx 中硬编码。
使用场景
- 部署 Node.js API 时,需要把流量反向代理到 3001-3003 端口并配置 HTTPS
- 后端有多个实例,要配置负载均衡和会话保持,避免单点过载
- 线上出现 502/504 错误,需要根据日志排查上游地址或超时设置
- 静态资源需要缓存和 Gzip 压缩,同时限制爬虫访问频率
适合人员
- 后端工程师:需要把 Node.js 或 Java 应用通过 Nginx 暴露为 HTTPS 服务
- SRE 运维工程师:需要优化多个后端实例的负载均衡和超时参数
- 前端/全栈开发者:需要将静态文件与 API 一起通过 Nginx 提供并开启缓存
- 安全工程师:需要为生产环境配置 TLS、限流和安全响应头