Nginx

配置与调试Nginx服务器,解决代理、负载均衡、SSL/TLS、缓存等问题。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Nginx。
它的用途是:配置与调试Nginx服务器,解决代理、负载均衡、SSL/TLS、缓存等问题。
完整的 Skill 内容见:https://321skill.com/skills/nginx-x-5/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'我的网站在通过Nginx代理后,WebSocket连接总是失败,请帮我检查配置。' 它会分析你提供的Nginx配置,指出可能缺失的`proxy_set_header Upgrade $http_upgrade;`等关键指令,并给出完整的WebSocket代理配置示例。或者,你可以说:'Nginx日志里大量出现504超时错误,后端服务响应慢,如何调整参数?' 它会建议你调整`proxy_read_timeout`, `proxy_connect_timeout`等超时设置,并可能提出启用缓存或优化上游服务器健康检查的策略。

介绍

本技能专注于解决Nginx服务器在配置、调试和性能优化中遇到的各种实际问题。无论是作为反向代理、负载均衡器,还是处理SSL/TLS终止、缓存和静态文件服务,它都能提供专业的指导和解决方案。

当你在编写或审查nginx.conf配置文件、配置server块、location规则、upstream上游服务器或proxy_pass指令时,可以使用本技能。它尤其擅长诊断和修复由Nginx引起的各类网站故障,例如502/504网关错误、413请求实体过大、403禁止访问、重定向循环等。

本技能适合后端开发、运维工程师、全栈开发等需要直接与Nginx打交道的技术人员。无论是部署新服务、排查线上故障,还是进行性能调优,都能从中获得针对性帮助。

使用建议:在提问时,尽可能提供相关的配置片段和错误日志,这将有助于获得更精准的解答。请注意,本技能不处理SSL证书的签发与续期(如ACME、Let’s Encrypt),此类问题请使用专门的ssl技能。

核心特点

与通用的Web服务器技能相比,本技能深度聚焦于Nginx的特定配置语法、内部工作原理和复杂故障场景(如WebSockets/SSE/gRPC代理穿透、证书浏览器兼容性、路径重写、Docker/K8s部署等),提供的是Nginx专家级的诊断和调优建议,而非泛泛的服务器管理知识。

注意事项

不适用于SSL/TLS证书的签发、续期(如Let's Encrypt ACME流程)或证书颁发机构(CA)相关操作。

常见问题

如何解决Nginx反向代理后出现的502 Bad Gateway错误?

通常与后端服务不可达或响应超时有关,请检查proxy_pass指向的后端地址、端口、防火墙以及后端服务本身的状态和日志。

如何在Nginx中配置WebSocket代理?

需要在location块中添加特定的proxy_set_header指令,如Upgrade和Connection,以支持HTTP协议升级。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/nginx-x-5/raw/index.md 读取 Nginx 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。