compilenix/nginx

镜像概述

这是一组轻量的https://nginx.org/en/容器镜像，通过Fedora从源码构建为`FROM scratch`的镜像。构建该镜像的主要动机包括：使用最新的库和构建工具、内置常用第三方模块、更小的镜像体积、支持自定义源码补丁、提供多种镜像变体以平衡大小与功能。

核心功能

• https://github.com/openssl/openssl
• 默认支持并启用kTLS
• Nginx NJS模块
• Nginx Perl模块
• https://github.com/openresty/headers-more-nginx-module
• https://github.com/arut/nginx-rtmp-module
• https://github.com/google/ngx_brotli
• https://github.com/tokers/zstd-nginx-module
• 内置大多数可选/非默认Nginx模块
• 提供sh和envsubst入口点，用于容器启动时处理Nginx配置

使用场景

• 静态资源服务：托管网站静态文件（HTML、CSS、JS等）
• 反向代理：作为后端服务入口，实现负载均衡、请求转发
• 媒体流服务：通过rtmp模块提供视频直播或点播功能
• API网关：处理API请求的路由、认证、限流等
• 压缩优化：利用brotli或Zstandard提升内容传输效率

配置说明

镜像变体

默认变体（<version>、1.29、1、latest）

包含常规场景所需功能与模块，保持较小体积。支持动态加载自定义模块、调试连接、HTTP/2/3等，不含部分不常用模块（如邮件相关、grpc模块）。

Extras变体（<version>-extras、1.29-extras、1-extras、latest-extras）

包含所有功能模块，不侧重体积优化。除默认功能外，还包含Perl模块、邮件模块、geoip模块等。

Slim变体（<version>-slim、1.29-slim、1-slim、latest-slim）

侧重最小化依赖与体积，仅内置headers-more-nginx-module，不含NJS、brotli、rtmp等模块。

部署示例

Docker Run命令

bash
docker run -d -p 80:80 -v /path/to/nginx.conf:/etc/nginx/nginx.conf docker.xuanyuan.run/compilenix/nginx:latest

Docker Compose示例

yaml
version: '3'
services:
  nginx:
    image: docker.xuanyuan.run/compilenix/nginx:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./html:/usr/share/nginx/html
      - ./ssl:/etc/nginx/ssl
    restart: always

项目链接

• https://hub.docker.com/r/compilenix/nginx
• Git仓库
• 问题反馈
• https://github.com/CompileNix/docker-nginx
• https://gitlab.com/CompileNix/docker-nginx

完整文档

Readme