Nginx

核心用法

Nginx 是全球最广泛使用的 Web 服务器和反向代理软件，本 Skill 提供从基础配置到生产级部署的完整指南。核心能力包括：

反向代理配置：详细说明 proxy_pass 尾缀斜线的关键差异——带斜线会替换路径，不带则保留原始路径；提供标准代理头设置（Host、X-Real-IP、X-Forwarded-For、X-Forwarded-Proto）确保后端正确识别客户端信息。

负载均衡与高可用：通过 upstream 块定义后端服务器池，支持 max_fails 和 fail_timeout 健康检查，以及 keepalive 连接池减少连接开销。

SSL/TLS 安全加固：强制 TLSv1.2+ 协议，证书链完整配置，服务端优先选择加密套件，符合现代安全标准。

性能优化：worker_processes auto 自动匹配 CPU 核心，sendfile 内核级零拷贝传输，智能 gzip 压缩策略（仅文本类型、最小 1000 字节）。

静态资源与 SPA 支持：try_files 指令完美支持单页应用路由回退，location 匹配优先级规则（精确匹配 → 前缀优先 → 正则 → 最长前缀）避免路由冲突。

显著优点

• 生产级权威性：配置建议源自 Nginx 官方最佳实践，涵盖常见陷阱（如 nginx -t 验证、alias 与 root 区别、变量解码行为）
• 实用速查结构：按主题分类的 Quick Reference 便于快速定位 SSL、性能调优、典型配置
• 深度细节覆盖：解析 $uri 与 $request_uri 的编码差异、^~ 修饰符的匹配终止行为等易错点

潜在局限

• 仅覆盖开源版 Nginx，未涉及 Nginx Plus 的商业特性（如高级负载均衡算法、实时活动监控）
• 不包含 Kubernetes Ingress Controller 或特定云厂商的托管服务配置
• 安全建议相对基础，未深入 TLS 1.3 0-RTT 的隐私风险等进阶话题

适合人群

• DevOps 工程师与系统管理员部署生产环境
• 全栈开发者配置开发/测试环境反向代理
• 需要迁移 Apache 或其他 Web 服务器至 Nginx 的技术团队

常规风险

• 配置语法严格，遗漏分号导致启动失败
• proxy_pass 路径处理不当引发双重路径或路由丢失
• 证书链不完整导致浏览器兼容性警告
• 日志级别设为 debug 在高流量环境产生大量磁盘 I/O

核心用法

该 Skill 是一个完整的 Nginx 配置参考知识库，采用模块化 Markdown 结构组织内容。核心功能覆盖四大场景：

反向代理与负载均衡：通过 proxy_pass 实现后端转发，详解尾部斜杠差异（/api 保留路径 vs /api/ 替换路径）；upstream 块定义后端服务器池，支持健康检查（max_fails、fail_timeout）和连接池（keepalive）以降低延迟。

SSL/TLS 安全终止：配置证书链（ssl_certificate 需包含中间证书）、私钥权限管控、协议版本限制（TLSv1.2+）、以及服务器优先 cipher 策略。配套 X-Forwarded-* 头传递协议信息，确保后端正确识别 HTTPS。

静态资源与 SPA 部署：try_files 指令实现单页应用回退（$uri $uri/ /index.html）；location 匹配优先级规则（= > ^~ > ~/~* > 前缀）指导复杂路由设计；区分 root（追加路径）与 alias（替换路径）避免目录遍历错误。

性能调优与运维：worker_processes auto 自动适配 CPU 核心；sendfile 零拷贝传输；gzip 压缩针对文本类型设置阈值（gzip_min_length 1000）；按条件关闭静态资源访问日志减少 I/O。

显著优点

• 零攻击面：纯 Markdown 文档，无代码执行、无网络请求、无依赖引入，安全审计获 S 级评分
• 生产导向：聚焦常见陷阱（nginx -t 测试先于 reload、变量在 if 中的异常行为、路径斜杠遗漏）
• 快速检索：表格化速查结构，支持按需定位 proxy/ssl/performance 专题

潜在局限

• T3 来源级别：个人开发者维护，建议交叉验证关键配置与官方 Nginx 文档
• 无交互能力：仅提供配置参考，无法自动生成或验证用户实际配置文件语法
• 版本敏感：Nginx 商业版（Plus）与开源版特性差异未明确标注

适合人群

DevOps 工程师、全栈开发者、系统管理员，尤其适合需要快速查阅 Nginx 配置模式而非逐行阅读官方文档的用户。

常规风险

内容本身无风险，但应用层面需注意：配置复制粘贴可能因环境差异（如后端端口、证书路径）导致服务启动失败；正则 location 性能陷阱（贪婪匹配回溯）在高并发场景可能引发 CPU 飙升。