ossobv/nginx

Nginx 源码构建镜像（基于Ubuntu bionic）

镜像概述

本镜像为基于Ubuntu bionic系统从源码构建的Nginx服务器镜像，提供灵活的配置选项和丰富的模块支持，适用于各类Web服务场景。

支持的标签及对应Dockerfile链接

• 1.17.0、latest nginx/Dockerfile
• 1.16.0、stable nginx/Dockerfile
• 1.15.12 nginx/Dockerfile
• 1.14.2 nginx/Dockerfile

核心功能与特性

编译配置参数

镜像构建时使用以下核心配置参数，确保功能完整性和性能优化：

--prefix=/usr/share/nginx                  # 安装前缀
--sbin-path=/usr/sbin/nginx                # 可执行文件路径
--conf-path=/etc/nginx/nginx.conf          # 主配置文件路径
--http-log-path=/var/log/nginx/access.log  # HTTP访问日志路径
--error-log-path=/var/log/nginx/error.log  # 错误日志路径
--lock-path=/var/lock/nginx.lock           # 锁文件路径
--pid-path=/run/nginx.pid                  # PID文件路径
--modules-path=/usr/lib/nginx/modules      # 模块存放路径
--http-client-body-temp-path=/var/lib/nginx/body  # 客户端请求体临时文件路径
--http-fastcgi-temp-path=/var/lib/nginx/fastcgi  # FastCGI临时文件路径
--http-proxy-temp-path=/var/lib/nginx/proxy      # 代理临时文件路径
--http-scgi-temp-path=/var/lib/nginx/scgi        # SCGI临时文件路径
--http-uwsgi-temp-path=/var/lib/nginx/uwsgi      # uWSGI临时文件路径

内置核心模块

支持多种关键功能模块，包括但不限于：

• 调试模式（--with-debug）
• PCRE即时编译（--with-pcre-jit）
• SSL/TLS支持（--with-http_ssl_module）
• HTTP状态监控（--with-http_stub_status_module）
• 真实IP获取（--with-http_realip_module）
• HTTP/2协议（--with-http_v2_module）
• WebDAV支持（--with-http_dav_module）
• 线程支持（--with-threads）
• 媒体流处理（--with-http_flv_module、--with-http_mp4_module）
• 压缩功能（--with-http_gzip_static_module）

动态模块

提供以下动态模块，需在主配置文件中通过load_module modules/<module_name.so>加载：

ndk_http_module.so                  # Nginx开发工具包模块
ngx_http_auth_pam_module.so         # PAM认证模块
ngx_http_dav_ext_module.so          # WebDAV扩展模块
ngx_http_echo_module.so             # 回声模块
ngx_http_fancyindex_module.so       # 美化索引模块
ngx_http_geoip_module.so            # GeoIP模块
ngx_http_headers_more_filter_module.so  # 自定义HTTP头模块
ngx_http_image_filter_module.so     # 图片处理模块
ngx_http_lua_module.so              # Lua脚本支持模块
ngx_http_perl_module.so             # Perl脚本模块
ngx_http_uploadprogress_module.so   # 上传进度模块
ngx_http_upstream_fair_module.so    # 公平负载均衡模块
ngx_http_xslt_filter_module.so      # XSLT过滤模块
ngx_mail_module.so                  # 邮件代理模块
ngx_nchan_module.so                 # 实时消息推送模块
ngx_rtmp_module.so                  # RTMP流媒体模块
ngx_stream_module.so                # TCP/UDP代理模块

使用场景

• Web服务器：托管静态资源，支持HTTP/2和SSL加密
• 反向代理：转发请求至后端应用服务器，隐藏真实服务地址
• 负载均衡：通过内置模块分发流量至多个后端节点
• 媒体流服务：通过RTMP模块提供视频直播/点播功能
• API网关：结合Lua模块实现复杂请求处理逻辑
• 安全代理：通过headers-more模块自定义安全响应头

使用方法

基本运行

bash
docker run -d -p 80:80 --name my-nginx ossobv/nginx:latest

挂载自定义配置

将本地配置文件挂载至容器：

bash
docker run -d -p 80:80 -p 443:443 \
  -v /path/to/nginx.conf:/etc/nginx/nginx.conf \
  -v /path/to/conf.d:/etc/nginx/conf.d \
  -v /path/to/ssl:/etc/nginx/ssl \
  --name my-nginx ossobv/nginx:latest

持久化日志

挂载日志目录至宿主机，避免容器重启后日志丢失：

bash
docker run -d -p 80:80 \
  -v /path/to/logs:/var/log/nginx \
  --name my-nginx ossobv/nginx:latest

加载动态模块示例

在nginx.conf的main块中添加模块加载指令：

nginx
load_module modules/ngx_http_lua_module.so;
load_module modules/ngx_http_geoip_module.so;
load_module modules/ngx_rtmp_module.so;

http {
    # HTTP配置...
}

rtmp {
    # RTMP流媒体配置...
}

Docker Compose示例

yaml
version: '3'
services:
  nginx:
    image: ossobv/nginx:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./conf.d:/etc/nginx/conf.d
      - ./ssl:/etc/nginx/ssl
      - ./logs:/var/log/nginx
    restart: always

注意事项

1. 动态模块需显式加载，未加载的模块不会占用资源
2. 自定义配置文件需确保语法正确，可通过nginx -t测试配置
3. 高并发场景下建议调整临时文件目录权限和磁盘IO性能