跳到主要内容

参考资料

配置项行为对不上、指令参数记不清时，按这个顺序翻：官方文档定口径，Wiki 补场景，博客看演进，OpenResty 管扩展。

官方文档​

  • nginx.org 官方文档：唯一权威口径，指令的语法、上下文、默认值和可用版本都以这里为准，页面右下角还能切到对应版本。
  • nginx.com 文档中心：商业化视角的文档，除了开源版还覆盖 Plus、Ingress Controller、Unit 等产品线，部署架构和最佳实践写得比 wiki 细。
  • 指令索引：全部指令按字母排序，排查「到底该写在哪个层级」最快的一页。
  • 核心模块参考：location、root、alias、listen 这些最常用指令的完整说明。

Wiki 与社区​

  • Nginx Wiki：官方 Trac 上的 Wiki，配置示例、模块清单、常见问题都有，风格偏老但信息密度高。
  • Nginx 官方论坛：邮件列表形态的问答区，搜索历史问题时经常能翻到开发者本人的回复。
  • GitHub 仓库：源码、issue 和 changelog，确认某个行为是不是 bug、哪个版本修的，看这里最直接。
  • nginx-ru / 邮件列表存档：老邮件列表归档，很多经典问题的原始讨论都在这。

官方博客​

  • nginx.org 博客：版本发布说明、配置技巧和架构文章，讲 proxy_cache、HTTP/2、限流这类专题时配图清楚，适合当进阶读物。

OpenResty​

  • OpenResty 官网：把 LuaJIT 嵌进 Nginx 的发行版，需要按请求写逻辑（鉴权、灰度、动态路由、日志加工）时用它，纯静态配置搞不定的场景基本都往这条路走。
  • OpenResty 最佳实践：社区维护的中文实践指南，ngx_lua 各阶段的用法和性能坑讲得比较系统。

相关工具​

  • nginx-prometheus-exporter：把 stub_status 转成 Prometheus 指标，第 5 篇的监控方案就是它。
  • nginxconfig.io：配置生成器，选好场景（反向代理、HTTPS、缓存）能直接导出可用的配置文件，适合快速搭骨架。
  • Mozilla SSL Configuration Generator：按 Nginx 版本和服务端软件生成 TLS 配置，比自己拼 ssl_ciphers 靠谱。