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 格式),按其中说明在我的环境里完成安装和配置。