sourcemation/nginx-stable

Sourcemation打包的稳定版Nginx镜像

Nginx（engine x）是一款高性能的HTTP服务器、反向代理和负载均衡器，以稳定性强、功能丰富、配置简单及资源消耗低而闻名。本Docker镜像基于Sourcemation的Debian 13 Slim系统，提供纯净、轻量的Nginx稳定版本。

核心功能

• 高性能HTTP服务：支持静态资源托管、动态请求转发
• 反向代理：可作为后端服务的代理层，提升服务可用性
• 负载均衡：实现多后端节点的流量分发，优化系统性能
• 配置模板支持：通过envsubst替换环境变量，灵活定制配置
• 多镜像变体：提供基础版、带Perl模块版、带OpenTelemetry监控模块版

使用场景

• 临时测试Nginx功能
• 快速部署静态网站
• 构建自定义配置的Nginx服务
• 集成OpenTelemetry进行服务监控
• 运行依赖Perl模块的Nginx应用

配置说明

基础使用

运行临时Nginx容器：

bash
docker run --rm -it docker.xuanyuan.run/sourcemation/nginx-stable

自定义配置

通过Dockerfile添加自定义配置文件：

dockerfile
FROM docker.xuanyuan.run/sourcemation/nginx-stable
COPY nginx.conf /etc/nginx/nginx.conf

挂载本地目录

将本地./content目录挂载为静态资源目录：

bash
docker run -v ./content:/usr/share/nginx/html:ro --name static-website docker.xuanyuan.run/sourcemation/nginx-stable

Docker Compose示例

yaml
version: '3'
services:
  nginx:
    image: docker.xuanyuan.run/sourcemation/nginx-stable
    ports:
      - "80:80"
    volumes:
      - ./content:/usr/share/nginx/html:ro
      - ./nginx.conf:/etc/nginx/nginx.conf:ro

配置模板

将模板文件存放在/etc/nginx/templates目录（可通过NGINX_TEMPLATES_DIR环境变量修改），镜像会使用envsubst替换模板中的环境变量。查看模板处理脚本：

bash
docker run --rm -it docker.xuanyuan.run/sourcemation/nginx-stable /usr/bin/cat /docker-entrypoint.d/20-envsubst-on-templates.sh

镜像变体

• nginx-stable:TAG：基于构建时最新稳定版Nginx的基础镜像
• nginx-stable:TAG-perl：包含Perl相关包的稳定版Nginx镜像
• nginx-stable:TAG-otel：集成OpenTelemetry模块的稳定版Nginx镜像

环境变量

关键环境变量：

• NGINX_VERSION=X.YY.Z：Nginx版本（例如：1.27.5）

贡献与问题反馈

欢迎贡献！可通过以下方式提交需求或反馈：

• https://github.com/Sourcemation/images/issues/new/choose
• https://github.com/Sourcemation/images/compare

额外说明

本镜像未移除Nginx仓库配置，可安装额外的Nginx相关包。

补充信息

镜像组件风险分析

镜像及组件的详细风险分析报告可在https://www.sourcemation.com/查看（部分镜像报告暂未上线，可联系获取更多信息）。

许可协议

Nginx核心许可协议为https://nginx.org/LICENSE。