Nginx
配置、调试和优化 Nginx 服务器,解决代理、负载均衡、SSL/TLS、缓存等常见问题。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Nginx。 它的用途是:配置、调试和优化 Nginx 服务器,解决代理、负载均衡、SSL/TLS、缓存等常见问题。 完整的 Skill 内容见:https://321skill.com/skills/nginx-x-2/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我的网站在通过Nginx代理后,WebSocket连接总是几秒钟后就断开,请帮我检查一下配置。’ 它会分析你的 nginx.conf 中相关的 location 和 proxy 设置,指出可能缺少的 `proxy_read_timeout`、`proxy_send_timeout` 或 WebSocket 专用的 header 配置,并给出修改示例。或者,你可以说:‘Nginx日志里大量出现 413 Request Entity Too Large 错误,怎么调整?’ 它会指导你修改 `client_max_body_size` 等参数。
介绍
本 Skill 专注于解决 Nginx 服务器的配置、调试与性能优化问题。当您需要编写或审查 nginx.conf 配置文件、设置服务器块(server blocks)、配置位置指令(locations)或上游服务器(upstreams)时,它可以提供专业的指导和语法检查。
当网站出现 502、504、413、403 等错误,或陷入重定向循环时,它能帮助您快速定位配置错误。对于 WebSockets、SSE 或 gRPC 等需要通过代理的现代协议连接中断问题,以及 SSL/TLS 证书在浏览器中告警等疑难杂症,它也能提供排查思路。
该 Skill 非常适合需要直接与 Nginx 打交道的后端开发、运维工程师和全栈开发者。无论是调整 worker 进程数、缓冲区大小、gzip 压缩,还是配置代理缓存、速率限制以阻止滥用,甚至是 Docker 或 Kubernetes 环境下的 Nginx 部署,都能从中获得帮助。
请注意,本 Skill 专注于 Nginx 本身的配置与调试,不涉及 SSL/TLS 证书的签发或续期(例如使用 ACME、Let‘s Encrypt),此类功能应由专门的 SSL 相关 Skill 处理。
核心特点
与通用服务器管理技能不同,它深度聚焦于 Nginx 配置文件的语法、调试逻辑和性能调优参数,能针对具体的错误代码(如502、504)和高级代理场景(如WebSockets、gRPC)提供精准的解决方案。
注意事项
不适用于 SSL/TLS 证书的自动签发、续期(如 Let‘s Encrypt ACME 流程)或非 Nginx 的 Web 服务器(如 Apache、Caddy)配置问题。
常见问题
如何解决 Nginx 反向代理后出现的 502 Bad Gateway 错误?
通常与后端服务无法连接或超时有关,可以检查 proxy_pass 指向的后端地址、端口、防火墙设置,以及 upstream 配置的健康检查。
如何让 Nginx 正确代理 WebSocket 连接?
需要在 location 块中添加特定的 proxy_set_header 指令来升级 HTTP 连接,例如设置 `Upgrade` 和 `Connection` 头。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/nginx-x-2/raw/index.md 读取 Nginx 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/nginx-x-2/raw/index.md(查看排版版本)