Nginx

配置和调试nginx,涵盖反向代理、负载均衡、SSL/TLS等

安装使用

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

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

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

使用示例

'我的nginx返回502 Bad Gateway,后端服务是Java应用,帮我排查并修复。' 它会分析nginx错误日志,检查upstream配置,给出调整proxy_pass、增加超时时间或检查后端健康状态的建议,并生成修复后的配置片段。例如:'在upstream块中添加keepalive,将proxy_read_timeout设为60s,并检查后端端口是否正确。'

介绍

本技能专为解决nginx配置与调试中的常见问题而设计。它覆盖了反向代理、负载均衡、SSL/TLS终止、缓存、重定向、静态文件服务等核心场景,并能处理典型的HTTP错误(如502、504、413、403、重定向循环)、WebSocket/SSE/gRPC代理异常、证书警告、请求路径错误、性能调优(workers、buffers、gzip、proxy cache)、限流防滥用、TCP/UDP代理,以及Docker/Kubernetes环境下的nginx运行问题。无论你是从零编写nginx.conf,还是排查线上故障,这个技能都能提供针对性的配置建议和调试步骤。

使用方式很简单:直接描述你的需求,比如“帮我配置一个反向代理,将/api请求转发到后端,并启用SSL”或“我的nginx返回502,后端是Java应用,帮忙排查”。技能会分析你的描述,生成或修改nginx.conf配置,同时解释每条指令的作用,并给出调试命令行(如检查错误日志、测试配置语法)。你还可以要求它优化现有配置,或针对特定错误(如413请求体过大)生成修复方案。

该技能适用于运维工程师、后端开发人员、全栈开发者,以及任何需要管理nginx服务器的技术人员。无论你是新手还是专家,都能从中获得快速、准确的配置建议和问题排查思路。对于复杂的多站点、多upstream场景,它也能高效处理。

使用前建议备份现有的nginx.conf,并在测试环境验证配置后再上线。本技能专注于nginx配置与调试,不涉及证书签发和续期(ACME/Let’s Encrypt),如需管理SSL证书请使用专门的ssl技能。对于特别复杂的性能调优或安全加固,建议结合其他专用技能。

核心特点

与通用nginx文档或教程不同,这个技能能根据用户描述的具体错误(如502、重定向循环)直接给出诊断和修复方案,并支持WebSocket、SSE、gRPC等现代协议,同时提供交互式配置生成和调试建议,而非静态示例。

注意事项

不适用于证书签发和续期(ACME/Let's Encrypt),请使用ssl技能。

常见问题

如何配置nginx反向代理?

描述你的后端服务地址和请求路径,技能会生成对应的proxy_pass、proxy_set_header等配置,并解释每个参数的作用。

nginx 502错误怎么排查?

技能会指导你检查后端服务是否正常运行、upstream配置是否正确、超时时间是否合理,并建议查看nginx error日志和后端日志。

给 AI 助手的安装指引

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

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