soulteary/prebuilt-nginx-modules

Nginx预构建动态模块

镜像概述和主要用途

本镜像提供了一系列预构建的Nginx动态模块，旨在简化Nginx功能扩展过程。当前支持的Nginx程序版本为1.21.0，包含多种实用模块，可满足动态管理上游服务器、自定义HTTP头、实现缓存、增强安全防护等需求。

核心功能和特性

支持的模块列表

镜像版本说明

• Debian基础镜像：默认镜像，如 soulteary/prebuilt-nginx-modules:headers-more-1.21.0
• Alpine基础镜像：带有-alpine后缀，如 soulteary/prebuilt-nginx-modules:headers-more-1.21.0-alpine

其他可用Nginx版本

除1.21.0外，还支持以下Nginx版本：1.20.0、1.19.10、1.19.9、1.19.8、1.19.7（模块拉取命令格式相同，只需替换版本号）。

使用场景和适用范围

适用于需要扩展Nginx功能的各类场景，包括但不限于：

• 动态管理上游服务器集群（如自动扩缩容场景）
• 自定义HTTP请求/响应头（如安全头配置、跨域设置）
• 实现基于Redis/Memcached的缓存策略
• 增强Web应用安全防护（WAF功能）
• 在Nginx配置中使用类shell命令（如调试、延时控制）

使用方法

拉取镜像

根据所需模块和基础系统，使用以下命令拉取镜像：

bash
# Debian基础镜像示例（headers-more模块）
docker pull soulteary/prebuilt-nginx-modules:headers-more-1.21.0

# Alpine基础镜像示例（echo模块）
docker pull soulteary/prebuilt-nginx-modules:echo-1.21.0-alpine

集成到Nginx配置

拉取镜像后，需在Nginx配置中通过load_module指令加载模块，例如：

nginx
# 加载headers-more模块
load_module /path/to/modules/ngx_http_headers_more_filter_module.so;

http {
    # 模块配置示例
    more_set_headers "X-Content-Type-Options: nosniff";
}

（注：具体模块路径需根据镜像内模块存放位置调整）