ricariel/nginx

Nginx通用Docker模块

镜像概述

Nginx通用Docker模块是一个基于官方Nginx镜像构建的基础Docker镜像，旨在提供便捷的Nginx服务部署方案。该镜像封装了Nginx核心功能，简化了Web服务器的搭建流程，适用于需要快速部署基础Web服务的场景。

核心功能与特性

• 基础HTTP服务支持：提供标准的HTTP/HTTPS协议处理能力，支持HTTP 1.1及常用Web服务特性
• 静态文件托管：内置静态文件处理模块，可直接托管HTML、CSS、JavaScript等静态资源
• 配置灵活性：支持通过挂载自定义配置文件修改Nginx服务参数，满足个性化需求
• 轻量级设计：基于官方精简版Nginx镜像构建，镜像体积小，启动速度快
• 兼容性良好：兼容Docker标准部署流程，支持Docker Compose等编排工具

使用场景与适用范围

• 开发环境快速搭建：适用于开发阶段快速构建本地Web服务环境，验证前端静态资源
• 静态网站托管：可用于部署个人博客、企业官网等纯静态内容的网站
• 简单Web应用部署：支持小型Web应用的基础HTTP服务需求
• 教学与演示环境：作为Nginx学习和演示的基础环境，帮助理解Web服务器配置

使用方法与配置说明

基本使用（Docker Run）

1. 启动基础Nginx服务

bash
docker run -d -p 80:80 --name nginx-generic docker.xuanyuan.run/nginx-generic-module

• 参数说明：
  • -d：后台运行容器
  • -p 80:80：将容器的80端口映射到主机的80端口
  • --name nginx-generic：指定容器名称
  • nginx-generic-module：镜像名称

2. 挂载自定义配置文件

如需使用自定义Nginx配置，可通过挂载本地配置文件实现：

bash
docker run -d -p 80:80 \
  -v /path/to/your/nginx.conf:/etc/nginx/nginx.conf \
  --name nginx-generic docker.xuanyuan.run/nginx-generic-module

• 说明：将本地的nginx.conf文件挂载到容器内的/etc/nginx/nginx.conf路径，覆盖默认配置

3. 托管静态文件

挂载本地静态文件目录到容器内的Nginx网站根目录：

bash
docker run -d -p 80:80 \
  -v /path/to/your/static/files:/usr/share/nginx/html \
  --name nginx-generic docker.xuanyuan.run/nginx-generic-module

• 说明：容器会将/usr/share/nginx/html作为网站根目录，访问http://localhost即可查看挂载的静态文件

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  nginx:
    image: docker.xuanyuan.run/nginx-generic-module
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf  # 挂载自定义配置文件（可选）
      - ./html:/usr/share/nginx/html        # 挂载静态文件目录（可选）
    restart: always

启动服务：

bash
docker-compose up -d

配置说明

• 默认配置路径：容器内Nginx主配置文件路径为/etc/nginx/nginx.conf，默认网站根目录为/usr/share/nginx/html
• 自定义配置：通过挂载本地配置文件可修改Nginx行为，如添加反向代理、设置缓存策略等
• 日志查看：容器日志可通过docker logs nginx-generic命令查看，Nginx访问日志默认位于容器内/var/log/nginx/access.log

注意事项

• 该镜像为通用基础模块，未包含高级功能（如Lua模块、特定安全加固等），复杂场景需结合官方Nginx镜像进一步定制
• 生产环境使用时，建议挂载持久化日志目录并配置日志轮转策略
• 自定义配置文件需遵循Nginx配置语***范，错误配置可能导致容器启动失败