epicsoft/nginx

Nginx 自动重载配置镜像

镜像概述

本镜像基于官方 Nginx 构建，核心增强功能为文件或配置变更时自动重载 Nginx 配置。通过监控指定目录下的文件变化（如配置文件、静态资源等），自动执行 nginx -s reload 命令，实现配置实时生效，无需手动操作，适用于开发与生产环境中需要动态调整 Nginx 配置的场景。

核心功能和特性

主要特性

1. 自动重载配置：监控指定目录/文件，当内容变更时（如修改 nginx.conf 或 conf.d/*.conf），自动触发 Nginx 配置重载，确保变更实时生效。
2. 原生 Nginx 功能：完整继承官方 Nginx 能力，支持反向代理、负载均衡、静态文件服务、SSL 终端等标准功能。
3. 轻量化监控：采用高效文件监控机制（如 inotify），低资源占用，避免性能损耗。
4. 灵活配置：支持自定义监控目录、文件匹配规则及重载延迟，适配不同场景需求。

使用场景和适用范围

• 开发环境：频繁修改 Nginx 配置（如反向代理规则、路由转发）时，无需手动执行 reload，提高开发效率。
• 生产环境：配置文件通过外部挂载（如 ConfigMap、本地目录）更新后，自动应用变更，减少人工操作失误。
• 动态配置场景：微服务架构中，需动态调整反向代理后端节点（如新增/下线服务实例），或静态资源（如 HTML/CSS/JS）更新时自动生效。
• 自动化运维：配合 CI/CD 流水线，配置文件通过自动化工具推送后，镜像自动完成重载，实现配置更新闭环。

使用方法和配置说明

获取镜像

镜像托管于 GitLab Container Registry，可通过以下命令拉取：

bash
docker pull registry.gitlab.com/epicdocker/nginx:latest

更多版本标签可查看 镜像仓库。

基本使用（docker run）

通过 -v 挂载本地配置目录/文件至容器内监控路径，启动容器后自动监控变更并重载。

示例：挂载默认配置目录

bash
docker run -d \
  --name auto-reload-nginx \
  -p 80:80 \  # 映射 HTTP 端口（根据需求调整）
  -p 443:443 \  # 如需 HTTPS，映射 443 端口
  -v $(pwd)/nginx/conf.d:/etc/nginx/conf.d \  # 挂载自定义配置文件目录（推荐）
  -v $(pwd)/nginx/nginx.conf:/etc/nginx/nginx.conf \  # 挂载主配置文件（可选，如修改全局配置）
  -v $(pwd)/static:/usr/share/nginx/html \  # 挂载静态资源目录（如需监控静态文件变更）
  registry.gitlab.com/epicdocker/nginx:latest

说明：

• 容器默认监控路径为 /etc/nginx/nginx.conf 和 /etc/nginx/conf.d/（可通过环境变量自定义，见下文“配置参数”）。
• 本地目录 ./nginx/conf.d 中的 .conf 文件变更时，容器会自动重载配置。

docker-compose 配置

通过 docker-compose.yml 定义服务，适用于多容器协同场景（如配合后端服务的反向代理）。

示例 docker-compose.yml：

yaml
version: '3.8'
services:
  nginx:
    image: registry.gitlab.com/epicdocker/nginx:latest
    container_name: auto-reload-nginx
    ports:
      - "80:80"
      - "443:443"  # 如需 HTTPS，映射 443 端口
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d  # 挂载自定义配置目录
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf  # 主配置文件（可选）
      - ./static:/usr/share/nginx/html  # 静态资源目录（可选）
      - ./ssl:/etc/nginx/ssl  # SSL 证书目录（如需 HTTPS，可选）
    environment:
      - WATCH_DIRECTORIES="/etc/nginx/conf.d,/etc/nginx/nginx.conf,/usr/share/nginx/html"  # 自定义监控目录（多目录用逗号分隔）
      - RELOAD_DELAY=2  # 检测到变更后延迟 2 秒重载（避免频繁变更触发多次重载）
    restart: unless-stopped  # 容器异常退出时自动重启

配置参数说明（环境变量）

通过 environment 自定义镜像行为，支持以下参数：

注意事项

1. 文件权限：挂载的本地文件/目录需确保容器内用户（默认 nginx）有读取权限，避免因权限不足导致监控失败。
2. 重载影响：nginx -s reload 为平滑重载，不会中断现有连接，但频繁重载可能导致短暂的 CPU 波动，建议生产环境合理设置 RELOAD_DELAY（如 2-5 秒）。
3. 监控范围：避免监控过大目录（如包含大量静态资源的目录），建议仅监控配置文件目录，减少资源占用。

相关链接

• 代码仓库：[***]
• 镜像仓库：[***]