Nginx

配置与调试Nginx的专家技能

安装使用

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

帮我安装这个 AI Skill:Nginx。
它的用途是:配置与调试Nginx的专家技能
完整的 Skill 内容见:https://321skill.com/skills/nginx-x-7/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'我的Nginx反向代理后端的WebSocket连接总是断开,帮我检查配置并修复。' 它会分析nginx.conf,检查proxy_set_header Upgrade和Connection设置,添加WebSocket支持所需的配置,并测试连接稳定性。

介绍

该技能专注于Nginx的配置与调试,涵盖反向代理、负载均衡、SSL/TLS终止、缓存、重定向、静态文件服务等核心功能。当您需要编写或审查nginx.conf、server block、location、upstream、proxy_pass等配置,或遇到502、504、413、403错误、重定向循环、WebSocket/SSE/gRPC代理中断、证书在浏览器警告、请求命中错误location、后端路径错误、工作者/缓冲区/gzip/代理缓存调优、限流防滥用、原始TCP/UDP代理、Docker/Kubernetes中运行Nginx等问题时,可调用此技能。

使用方法:直接向AI描述您的Nginx相关需求或问题,例如“帮我配置一个反向代理,将/api请求转发到后端服务器”或“我的Nginx返回502错误,请帮我排查”。AI将调用此技能分析您的配置、日志或场景,给出具体配置修改建议、调试步骤或最佳实践。该技能已内置常见问题诊断逻辑,能快速定位配置错误、性能瓶颈和安全风险。

适合运维工程师、后端开发人员、全栈工程师以及需要管理Nginx服务的开发者。无论是生产环境调优、迁移部署,还是学习Nginx配置,此技能都能提供专业、高效的辅助。

使用建议:提供尽可能完整的Nginx配置片段、错误日志或访问日志,以帮助AI快速定位问题。注意该技能不处理证书签发续期(ACME/Let’s Encrypt),如需证书管理请使用对应的ssl技能。

核心特点

与泛化的Web服务器配置技能不同,该技能深度覆盖Nginx专属的数十种典型故障场景和调优需求,从反向代理到原始TCP/UDP,从Docker到Kubernetes,提供针对性的配置诊断和修复建议。

注意事项

不适用于证书签发或续期(ACME、Let's Encrypt),也不处理Nginx之外的其他Web服务器配置。

常见问题

如何配置Nginx反向代理?

在server block中添加location和proxy_pass指令,例如:location /api { proxy_pass http://backend; }。AI可帮你生成完整配置。

Nginx返回502 Bad Gateway怎么办?

常见原因:后端服务未启动或端口错误、proxy_pass地址不可达、缓冲区设置过小。AI可分析你的配置和日志给出具体修复方案。

给 AI 助手的安装指引

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

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