## 官方模块（NGINX 官方文档 Modules reference 列表）
好家伙，这是一份**Nginx 官方模块全家桶** 😄  
我给你在**后面新增一列「一句话说明」**，每个模块都用**一句话、偏功能点**来解释，方便你查阅 / 做文档 / 选型。

---

### HTTP 模块

| 分类  | 模块名                                   | 子系统  | 说明                                     |
| --- | ------------------------------------- | ---- | -------------------------------------- |
| 官方  | ngx_http_core_module                  | HTTP | HTTP 模块核心，提供 server/location、请求处理等基础能力 |
| 官方  | ngx_http_access_module                | HTTP | 基于 IP 的访问控制（allow/deny）                |
| 官方  | ngx_http_addition_module              | HTTP | 在响应前后追加额外内容                            |
| 官方  | ngx_http_api_module                   | HTTP | 提供 Nginx 内部状态与配置的 API 接口               |
| 官方  | ngx_http_auth_basic_module            | HTTP | HTTP Basic 认证                          |
| 官方  | ngx_http_auth_jwt_module              | HTTP | 基于 JWT 的用户认证                           |
| 官方  | ngx_http_auth_request_module          | HTTP | 将认证逻辑委托给子请求                            |
| 官方  | ngx_http_auth_require_module          | HTTP | 对变量结果进行逻辑认证判断                          |
| 官方  | ngx_http_autoindex_module             | HTTP | 自动生成目录索引页面                             |
| 官方  | ngx_http_browser_module               | HTTP | 根据 User-Agent 做兼容性判断                   |
| 官方  | ngx_http_charset_module               | HTTP | 设置响应字符集及编码转换                           |
| 官方  | ngx_http_dav_module                   | HTTP | 支持 WebDAV 协议                           |
| 官方  | ngx_http_empty_gif_module             | HTTP | 返回 1x1 空 GIF，常用于统计                     |
| 官方  | ngx_http_f4f_module                   | HTTP | Adobe HDS（F4F）视频流支持                    |
| 官方  | ngx_http_fastcgi_module               | HTTP | 与 FastCGI 后端通信（如 PHP-FPM）              |
| 官方  | ngx_http_flv_module                   | HTTP | FLV 视频流按需拖动                            |
| 官方  | ngx_http_geo_module                   | HTTP | 基于 IP 段映射变量                            |
| 官方  | ngx_http_geoip_module                 | HTTP | 基于 GeoIP 数据库定位                         |
| 官方  | ngx_http_grpc_module                  | HTTP | 反向代理 gRPC 服务                           |
| 官方  | ngx_http_gunzip_module                | HTTP | 解压后端返回的 gzip 内容                        |
| 官方  | ngx_http_gzip_module                  | HTTP | 对响应进行 gzip 压缩                          |
| 官方  | ngx_http_gzip_static_module           | HTTP | 直接发送预压缩的 .gz 文件                        |
| 官方  | ngx_http_headers_module               | HTTP | 添加、修改 HTTP 响应头                         |
| 官方  | ngx_http_hls_module                   | HTTP | 支持 HLS 流媒体分发                           |
| 官方  | ngx_http_image_filter_module          | HTTP | 动态裁剪、缩放图片                              |
| 官方  | ngx_http_index_module                 | HTTP | 定义默认首页文件                               |
| 官方  | ngx_http_internal_redirect_module     | HTTP | 支持内部重定向逻辑                              |
| 官方  | ngx_http_js_module                    | HTTP | 使用 JavaScript（njs）处理请求                 |
| 官方  | ngx_http_keyval_module                | HTTP | 共享内存键值存储                               |
| 官方  | ngx_http_limit_conn_module            | HTTP | 限制并发连接数                                |
| 官方  | ngx_http_limit_req_module             | HTTP | 请求速率限制                                 |
| 官方  | ngx_http_log_module                   | HTTP | 访问日志与日志格式定义                            |
| 官方  | ngx_http_map_module                   | HTTP | 根据变量值映射新变量                             |
| 官方  | ngx_http_memcached_module             | HTTP | 访问 Memcached 数据                        |
| 官方  | ngx_http_mirror_module                | HTTP | 镜像请求到其他后端                              |
| 官方  | ngx_http_mp4_module                   | HTTP | MP4 视频按需播放                             |
| 官方  | ngx_http_num_map_module               | HTTP | 数值型 map 映射                             |
| 官方  | ngx_http_oidc_module                  | HTTP | OpenID Connect 认证                      |
| 官方  | ngx_http_perl_module                  | HTTP | 使用 Perl 脚本处理请求                         |
| 官方  | ngx_http_proxy_module                 | HTTP | HTTP 反向代理核心模块                          |
| 官方  | ngx_http_proxy_protocol_vendor_module | HTTP | Proxy Protocol 扩展支持                    |
| 官方  | ngx_http_random_index_module          | HTTP | 随机选择首页文件                               |
| 官方  | ngx_http_realip_module                | HTTP | 获取真实客户端 IP                             |
| 官方  | ngx_http_referer_module               | HTTP | 防盗链（Referer 校验）                        |
| 官方  | ngx_http_rewrite_module               | HTTP | URL 重写与跳转                              |
| 官方  | ngx_http_scgi_module                  | HTTP | SCGI 协议代理                              |
| 官方  | ngx_http_secure_link_module           | HTTP | 防盗链安全链接校验                              |
| 官方  | ngx_http_session_log_module           | HTTP | 会话级日志记录                                |
| 官方  | ngx_http_slice_module                 | HTTP | 大文件分片请求                                |
| 官方  | ngx_http_split_clients_module         | HTTP | 客户端分流（A/B 测试）                          |
| 官方  | ngx_http_ssi_module                   | HTTP | Server Side Includes                   |
| 官方  | ngx_http_ssl_module                   | HTTP | HTTPS / TLS 支持                         |
| 官方  | ngx_http_status_module                | HTTP | HTTP 状态统计                              |
| 官方  | ngx_http_stub_status_module           | HTTP | 简易运行状态监控                               |
| 官方  | ngx_http_sub_module                   | HTTP | 响应内容字符串替换                              |
| 官方  | ngx_http_tunnel_module                | HTTP | HTTP 隧道转发                              |
| 官方  | ngx_http_upstream_module              | HTTP | 上游服务器定义与管理                             |
| 官方  | ngx_http_upstream_conf_module         | HTTP | 动态管理 upstream                          |
| 官方  | ngx_http_upstream_hc_module           | HTTP | upstream 健康检查                          |
| 官方  | ngx_http_userid_module                | HTTP | 用户标识 Cookie                            |
| 官方  | ngx_http_uwsgi_module                 | HTTP | uWSGI 协议代理                             |
| 官方  | ngx_http_v2_module                    | HTTP | HTTP/2 支持                              |
| 官方  | ngx_http_v3_module                    | HTTP | HTTP/3（QUIC）支持                         |
| 官方  | ngx_http_xslt_module                  | HTTP | XSLT XML 转换                            |

---

### MAIL 模块

| 分类  | 模块名                       | 子系统  | 说明            |
| --- | ------------------------- | ---- | ------------- |
| 官方  | ngx_mail_core_module      | MAIL | 邮件代理核心模块      |
| 官方  | ngx_mail_auth_http_module | MAIL | HTTP 方式进行邮件认证 |
| 官方  | ngx_mail_proxy_module     | MAIL | 邮件协议代理        |
| 官方  | ngx_mail_realip_module    | MAIL | 获取真实客户端 IP    |
| 官方  | ngx_mail_ssl_module       | MAIL | 邮件 TLS 加密     |
| 官方  | ngx_mail_imap_module      | MAIL | IMAP 协议支持     |
| 官方  | ngx_mail_pop3_module      | MAIL | POP3 协议支持     |
| 官方  | ngx_mail_smtp_module      | MAIL | SMTP 协议支持     |

---

### STREAM 模块

| 分类  | 模块名                                     | 子系统    | 说明                |
| --- | --------------------------------------- | ------ | ----------------- |
| 官方  | ngx_stream_core_module                  | STREAM | TCP/UDP 流量处理核心    |
| 官方  | ngx_stream_access_module                | STREAM | 基于 IP 的访问控制       |
| 官方  | ngx_stream_geo_module                   | STREAM | TCP 场景 IP 映射      |
| 官方  | ngx_stream_geoip_module                 | STREAM | TCP GeoIP 定位      |
| 官方  | ngx_stream_js_module                    | STREAM | 使用 njs 处理流量       |
| 官方  | ngx_stream_keyval_module                | STREAM | 流量共享内存 KV         |
| 官方  | ngx_stream_limit_conn_module            | STREAM | 连接数限制             |
| 官方  | ngx_stream_log_module                   | STREAM | 流量日志              |
| 官方  | ngx_stream_map_module                   | STREAM | 流量变量映射            |
| 官方  | ngx_stream_mqtt_preread_module          | STREAM | MQTT 协议预读         |
| 官方  | ngx_stream_mqtt_filter_module           | STREAM | MQTT 流量过滤         |
| 官方  | ngx_stream_num_map_module               | STREAM | 数值映射              |
| 官方  | ngx_stream_pass_module                  | STREAM | 直接透传流量            |
| 官方  | ngx_stream_proxy_module                 | STREAM | TCP/UDP 反向代理      |
| 官方  | ngx_stream_proxy_protocol_vendor_module | STREAM | Proxy Protocol 支持 |
| 官方  | ngx_stream_realip_module                | STREAM | 获取真实 IP           |
| 官方  | ngx_stream_return_module                | STREAM | 直接返回数据            |
| 官方  | ngx_stream_set_module                   | STREAM | 设置变量              |
| 官方  | ngx_stream_split_clients_module         | STREAM | 流量分流              |
| 官方  | ngx_stream_ssl_module                   | STREAM | TLS 支持            |
| 官方  | ngx_stream_ssl_preread_module           | STREAM | TLS SNI 预读        |
| 官方  | ngx_stream_upstream_module              | STREAM | 上游服务器管理           |
| 官方  | ngx_stream_upstream_hc_module           | STREAM | upstream 健康检查     |
| 官方  | ngx_stream_zone_sync_module             | STREAM | 多实例状态同步           |

---

### MISC 模块

| 分类  | 模块名                         | 子系统  | 说明                   |
| --- | --------------------------- | ---- | -------------------- |
| 官方  | ngx_google_perftools_module | MISC | 集成 Google 性能分析工具     |
| 官方  | ngx_mgmt_module             | MISC | Nginx 管理接口           |
| 官方  | ngx_http_acme_module        | HTTP | 自动签发与续期 HTTPS 证书     |
| 官方  | ngx_otel_module             | MISC | OpenTelemetry 可观测性支持 |

---


## 非官方 / 第三方模块（常见示例）

| 分类 | 模块名 | 主要用途 | 典型来源/项目 |
|---|---|---|---|
| 非官方 | ngx_http_lua_module | 在 NGINX 中嵌入 Lua（OpenResty 核心能力之一） | openresty/lua-nginx-module |
| 非官方 | ngx_brotli（相关模块） | Brotli 压缩支持 | google/ngx_brotli |
| 非官方 | ModSecurity-nginx | NGINX 对接 ModSecurity v3（WAF） | owasp-modsecurity/ModSecurity-nginx |
| 非官方 | nginx-rtmp-module（相关模块） | RTMP/HLS/DASH 流媒体能力 | arut/nginx-rtmp-module |
| 非官方 | headers-more-nginx-module | 更强的请求/响应 Header 操作能力 | openresty/headers-more-nginx-module |
| 非官方 | ngx_http_geoip2_module | GeoIP2（MaxMind）支持 | leev/ngx_http_geoip2_module |
| 非官方 | nchan | Pub/Sub、WebSocket、SSE、长轮询等实时推送 | slact/nchan |
| 非官方 | nginx-http-flv-module | 流媒体（HTTP-FLV/RTMP/HLS 等，README 提到包含 nginx-rtmp-module 功能） | winshining/nginx-http-flv-module |
