docker-nginx 镜像文档

1. 镜像概述

docker-nginx是一个预配置的Nginx Docker镜像，旨在提供开箱即用的容器化环境，帮助用户快速部署高性能的Nginx Web服务器。该镜像基于***Nginx构建，优化了容器启动流程，支持灵活的配置定制，适用于开发、测试及生产环境。

2. 核心功能与特性

高性能Web服务：集成Nginx核心功能，支持HTTP/HTTPS协议，具备高并发处理能力，适用于静态资源托管、API服务代理等场景。
轻量级设计：镜像体积精简，启动速度快，资源占用低，可在各类硬件环境中高效运行。
配置灵活：支持通过挂载本地配置文件自定义Nginx配置（如虚拟主机、反向代理规则等），满足个性化需求。
即开即用：预配置基础运行环境，无需手动安装依赖，拉取镜像后可直接启动容器提供服务。

3. 适用场景

静态网站托管：快速部署HTML、CSS、JavaScript等静态资源，适用于个人博客、企业官网等场景。
反向代理：作为前端与后端服务的中间层，将客户端请求转发至后端应用服务器（如Node.js、Java服务）。
负载均衡：通过配置Nginx upstream模块，实现多后端服务的请求分发与负载均衡。
开发环境搭建：为Web开发提供一致的Nginx运行环境，避免因本地环境差异导致的配置问题。

4. 使用方法

4.1 基本部署命令

通过以下命令快速启动Nginx容器，映射主机80端口至容器80端口：

bash
docker run --name my-nginx -p 80:80 -d nginx

--name my-nginx：指定容器名称（可自定义）
-p 80:80：端口映射（主机端口:容器端口）
-d：后台运行容器

启动后，访问http://localhost即可看到Nginx默认欢迎页面。

4.2 自定义配置与网站内容

4.2.1 挂载本地配置文件

将自定义Nginx配置文件（如default.conf）挂载至容器/etc/nginx/conf.d/目录，覆盖默认配置：

bash
docker run --name my-nginx -p 80:80 \
  -v /path/to/local/conf.d:/etc/nginx/conf.d \
  -d nginx

注：/path/to/local/conf.d为本地存放Nginx配置文件的目录，配置文件需符合Nginx语***范。

4.2.2 挂载网站静态资源

将本地网站文件挂载至容器/usr/share/nginx/html目录，托管自定义内容：

bash
docker run --name my-nginx -p 80:80 \
  -v /path/to/website:/usr/share/nginx/html \
  -d nginx

其中/path/to/website为本地存放静态资源（如index.html）的目录。

4.3 Docker Compose 配置示例

创建docker-compose.yml文件，定义服务配置：

yaml
version: '3'
services:
  nginx:
    image: nginx
    container_name: my-nginx
    ports:
      - "80:80"       # HTTP端口
      - "443:443"     # 若启用HTTPS，映射443端口
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d       # 挂载自定义配置
      - ./website:/usr/share/nginx/html        # 挂载网站内容
      - ./nginx/ssl:/etc/nginx/ssl             # 若启用HTTPS，挂载SSL证书
    restart: always  # 容器退出时自动重启

执行docker-compose up -d启动服务，docker-compose down停止服务。

4.4 常用配置参数说明

端口映射：通过-p <主机端口>:<容器端口>调整端口（如-p 8080:80将主机8080端口映射到容器80端口）。
配置文件路径：容器内Nginx主配置文件路径为/etc/nginx/nginx.conf，虚拟主机配置建议放在/etc/nginx/conf.d/目录。
日志路径：访问日志和错误日志默认位于/var/log/nginx/，可通过挂载本地目录持久化日志（如-v /path/to/logs:/var/log/nginx）。