自定义NGINX动态配置镜像文档

镜像概述和主要用途

本镜像为基于***NGINX构建的自定义Docker镜像，核心功能是提供robots.txt文件服务，并通过入口点（entrypoint）脚本支持动态配置调整。它继承了NGINX的基础Web服务能力，同时增强了配置灵活性，适用于需要快速部署且需动态调整NGINX参数的场景。

核心功能和特性

• 基础功能可靠：基于***NGINX镜像构建，确保Web服务稳定性和兼容性
• 内置robots.txt服务：无需额外配置即可直接提供robots.txt文件访问
• 动态配置支持：通过入口点脚本实现配置动态注入，允许容器启动时修改NGINX配置参数
• 轻量级设计：优化镜像层结构，保持较小体积，减少资源占用

使用场景和适用范围

• 快速部署需求：需立即提供robots.txt服务的Web应用（如静态网站、API服务）
• 配置频繁变更场景：开发/测试环境中需动态调整端口、Worker进程数等NGINX参数的场景
• 自动化部署流程：CI/CD流水线中，需通过环境变量注入配置的自动化部署场景
• 定制化robots需求：需要根据不同环境（生产/测试）提供差异化robots.txt内容的场景

使用方法和配置说明

基本使用方法

直接运行容器

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

容器启动后，可通过 http://localhost/robots.txt 访问默认robots.txt文件。

自定义端口映射

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

将容器内80端口映射到主机8080端口，通过 http://localhost:8080/robots.txt 访问。

动态配置参数

通过环境变量可在容器启动时调整以下核心配置（入口点脚本会自动注入到NGINX配置中）：

示例：修改工作进程数和robots内容

bash
docker run -d \
  -p 80:80 \
  -e NGINX_WORKER_PROCESSES=4 \
  -e ROBOTS_TXT_CONTENT="User-agent: *\nDisallow: /private/\nAllow: /public/" \
  --name custom-nginx [镜像名称]

docker-compose部署示例

yaml
version: '3.8'
services:
  nginx:
    image: [镜像名称]
    ports:
      - "80:80"
    environment:
      - NGINX_WORKER_PROCESSES=2
      - NGINX_PORT=80
      - ROBOTS_TXT_CONTENT="User-agent: *\nDisallow: /api/\nAllow: /"
    restart: always
    volumes:
      - ./custom-conf:/etc/nginx/conf.d  # 可选：挂载自定义配置文件

注意事项

• 若需持久化自定义配置文件，可通过-v参数挂载本地目录到容器/etc/nginx/conf.d
• 动态配置参数仅在容器启动时生效，修改后需重启容器
• 入口点脚本优先处理环境变量配置，其次读取挂载的自定义配置文件