stvfccn/nginx_proxy

Nginx Docker镜像文档

概述

本镜像基于Alpine Linux构建，提供Nginx Web服务器功能，支持反向代理和simplesamlphp配置。通过优化配置路径和集成实用工具，简化Nginx的部署与自定义流程，适用于需要灵活配置的Web应用场景。

核心功能与特性

• 配置路径优化：Nginx主要配置文件移至$NGINX_OPTS文件夹（默认路径为/opt/nginx），便于用户通过挂载卷覆盖默认配置
• 构建参数自定义：支持通过构建参数设置NGINX_OPTS和NGINX_ROOT文件夹路径，满足不同环境的目录结构需求
• 清理sites-enabled：自动清理$NGINX_OPTS/sites-enabled目录，避免残留配置文件影响服务器启动
• 集成H5bp配置：本地包含H5bp配置文件，路径为$NGINX_ROOT/h5bp，提供优化的Web服务器配置模板
• 自定义init脚本：内置定制化init脚本，负责启动并监控Web服务器所需进程，确保服务稳定运行

使用场景

• 需要反向代理功能的Web应用部署
• 集成simplesamlphp进行身份验证的Web服务
• 对Nginx配置有高度自定义需求的环境
• 追求轻量级基础镜像（Alpine）的容器化部署场景

使用方法与配置说明

构建参数

配置覆盖

通过挂载卷将自定义配置文件映射到$NGINX_OPTS目录，覆盖默认配置。例如，将本地配置文件夹./nginx-config挂载到容器的/opt/nginx：

bash
docker run -v ./nginx-config:/opt/nginx [镜像名称]

进程管理

容器通过自定义init脚本启动Nginx及相关进程，并持续监控进程状态，确保服务异常时能够及时恢复。

部署示例

基本运行命令

bash
docker run -d -p 80:80 --name nginx-server [镜像名称]

自定义配置路径构建示例

bash
docker build --build-arg NGINX_OPTS=/custom/nginx -t nginx-custom .

挂载自定义配置并运行

bash
docker run -d -p 80:80 -v ./my-config:/opt/nginx --name nginx-custom [镜像名称]