nginx-static 镜像文档

镜像概述

nginx-static是一个轻量级Docker镜像，基于ngineered/nginx-static项目构建，旨在提供简单高效的静态网站托管解决方案。该镜像封装了Nginx Web服务器，专注于静态内容的快速部署，适用于各类静态网站场景。

核心功能与特性

• 基础Nginx功能：集成Nginx作为Web服务器，支持静态文件（HTML、CSS、JavaScript、图片等）的高效传输
• 简化部署：开箱即用，无需复杂配置即可快速启动静态网站服务
• Docker友好：优化Docker环境下的运行配置，支持容器化部署流程
• 兼容性：兼容标准Nginx配置，可通过挂载自定义配置文件扩展功能

使用场景与适用范围

• 个人博客、静态网站部署
• 前端应用（如React、Vue构建产物）托管
• 原型展示、静态文档服务
• 开发环境静态资源服务

使用方法

基础部署（docker run）

通过本地文件目录挂载部署静态内容：

bash
docker run -d \
  -p 80:80 \
  -v /path/to/your/static/files:/usr/share/nginx/html \
  --name nginx-static-site \
  ngineered/nginx-static

参数说明：

• -p 80:80：将容器的80端口映射到主机80端口（可根据需求修改主机端口）
• -v /path/to/your/static/files:/usr/share/nginx/html：挂载本地静态文件目录到容器内Nginx网站根目录
• --name nginx-static-site：指定容器名称（可选）

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  nginx-static:
    image: ngineered/nginx-static
    ports:
      - "8080:80"  # 主机端口8080映射到容器80端口
    volumes:
      - ./static-content:/usr/share/nginx/html  # 当前目录下static-content文件夹作为静态资源目录
    restart: always  # 容器退出时自动重启

启动服务：

bash
docker-compose up -d

配置说明

默认配置

• 网站根目录：/usr/share/nginx/html（静态文件需放置于此路径）
• Nginx配置文件路径：/etc/nginx/nginx.conf（主配置）、/etc/nginx/conf.d/default.conf（默认站点配置）

自定义配置

如需修改Nginx配置（如添加gzip压缩、设置缓存策略等），可通过挂载自定义配置文件覆盖默认配置：

bash
docker run -d \
  -p 80:80 \
  -v /path/to/your/static/files:/usr/share/nginx/html \
  -v /path/to/your/custom.conf:/etc/nginx/conf.d/default.conf \
  ngineered/nginx-static

其中custom.conf为自定义Nginx站点配置文件。