exoplatform/nginx

eXo Nginx容器

概述

这是一个自定义构建的Nginx镜像，集成了ModSecurity、Google PageSpeed等额外模块及多种增强功能。该镜像专为需要高级HTTP功能和增强安全性的环境设计，可满足复杂Web服务的需求。

核心功能和特性

激活的模块列表

以下模块已包含并激活在此构建中：

核心模块

• http_ssl_module：启用HTTPS支持
• http_v2_module：添加HTTP/2协议支持
• http_auth_request_module：支持基于请求的授权验证
• http_stub_status_module：提供Nginx运行状态信息
• http_realip_module：将客户端IP地址调整为可信上游服务器的IP
• http_addition_module：在响应内容前后追加额外内容
• http_gunzip_module：为不支持gzip的客户端解压缩响应
• http_gzip_static_module：提供预压缩的.gz静态文件服务
• http_secure_link_module：通过令牌机制保护链接安全
• http_slice_module：支持部分内容传输（断点续传）
• http_flv_module：支持FLV格式文件流式传输
• http_mp4_module：支持MP4格式文件流式传输

动态模块

• ngx_headers_more：允许灵活修改HTTP请求/响应头
• ngx_brotli：提供Brotli压缩算法支持
• ModSecurity-nginx：集成ModSecurity Web应用防火墙，增强安全性
• ngx_http_geoip2_module：基于GeoIP2数据库获取客户端地理位置信息
• ngx_security_headers：自动设置安全相关HTTP头（如CSP、HSTS）
• nginx-auth-ldap：支持基于LDAP的用户认证

流模块

• stream：启用TCP/UDP代理功能
• stream_ssl_module：为TCP/UDP流添加SSL/TLS加密支持
• stream_ssl_preread_module：允许在SSL握手前检查连接信息
• stream_geoip_module：为TCP/UDP流提供GeoIP支持

其他功能

• https://github.com/Refinitiv/nginx-sticky-module-ng%EF%BC%9A%E5%AE%9E%E7%8E%B0%E4%BC%9A%E8%AF%9D%E6%8C%81%E4%B9%85%E6%80%A7%EF%BC%88%E7%B2%98%E6%80%A7%E4%BC%9A%E8%AF%9D%EF%BC%89
• https://github.com/nulab/nginx-upstream-jvm-route%EF%BC%9A%E6%94%AF%E6%8C%81%E5%9F%BA%E4%BA%8EJVM%E8%B7%AF%E7%94%B1%E7%9A%84%E4%B8%8A%E6%B8%B8%E6%9C%8D%E5%8A%A1%E8%B4%9F%E8%BD%BD%E5%9D%87%E8%A1%A1

使用场景和适用范围

该镜像适用于以下场景：

• 需要启用HTTPS和HTTP/2的安全Web服务
• 要求增强Web应用安全性的生产环境（通过ModSecurity）
• 需要优化内容传输性能的高流量网站（通过Brotli/gzip压缩、HTTP/2）
• 提供视频流媒体服务（FLV/MP4流式传输）
• 需要自定义HTTP头或安全头的场景
• 需要基于LDAP进行用户认证的企业环境
• 需要会话持久性或JVM上游服务负载均衡的场景

使用方法和配置说明

基本使用

该镜像的使用方式与官方https://hub.docker.com/_/nginx/%E7%B1%BB%E4%BC%BC%EF%BC%8C%E5%90%8C%E6%97%B6%E6%94%AF%E6%8C%81%E9%A2%9D%E5%A4%96%E5%8A%9F%E8%83%BD%E5%92%8C%E6%A8%A1%E5%9D%97%E3%80%82%E9%85%8D%E7%BD%AE%E5%92%8C%E7%AE%A1%E7%90%86%E9%81%B5%E5%BE%AA%E6%A0%87%E5%87%86Nginx%E7%BA%A6%E5%AE%9A%E3%80%82

示例用法

bash
docker run --name exo-nginx \
  -v $(pwd)/nginx.conf:/etc/nginx/nginx.conf:ro \
  -p 80:80 \
  -p 443:443 \
  exoplatform/nginx

配置覆盖

镜像默认使用自定义nginx.conf配置文件，可通过挂载本地配置文件覆盖默认配置：

bash
# 使用自定义配置文件
docker run -v $(pwd)/custom-nginx.conf:/etc/nginx/nginx.conf:ro exoplatform/nginx

# 挂载整个配置目录（包含conf.d等子目录）
docker run -v $(pwd)/nginx-config:/etc/nginx:ro exoplatform/nginx

暴露端口

• 80：HTTP服务端口
• 81：额外HTTP服务端口（如配置需要）
• 443：HTTPS服务端口

高级配置

Supervisord

镜像集成supervisord进行进程管理，配置文件位于：
/etc/supervisor/conf.d/supervisord.conf

ModSecurity

ModSecurity配置示例文件位于：
/etc/nginx/modsec/modsecurity.conf.example

Unicode映射文件路径：
/etc/nginx/modsec/unicode.mapping

更多详细信息请参考Nginx官方文档及相关模块仓库。