oneunity/website

Nginx静态网站Docker镜像文档

镜像概述

本Docker镜像基于Nginx构建，专注于提供静态网站内容的部署与服务能力。通过将静态资源（HTML、CSS、JavaScript、图片等）与Nginx服务器打包为容器，实现静态网站的快速部署、隔离运行和高效访问，适用于各类静态内容的Web服务场景。

核心功能与特性

1. 高性能静态内容服务

• 基于Nginx作为Web服务器，具备轻量级、高性能的特点，支持高并发静态资源请求处理
• 内置Nginx优化配置，针对静态文件（如HTML、CSS、JS、图片）提供高效缓存和传输能力

2. 简化部署流程

• 无需手动配置Nginx环境，通过容器化方式实现"一键部署"，降低环境依赖和配置复杂度
• 支持静态资源与容器解耦，可通过数据卷挂载本地资源目录，实现内容动态更新

3. 灵活配置支持

• 兼容标准Nginx配置文件，可通过挂载自定义配置实现端口修改、URL重写、跨域设置等高级需求
• 支持多端口映射，适应不同网络环境下的访问需求

使用场景与适用范围

适用场景

• 个人博客、自媒体站点等静态内容展示平台
• 企业官网、产品介绍页等纯静态营销网站
• 前端项目（如React、Vue、Angular）打包后的生产环境部署
• 技术文档站点（如使用Markdown生成的静态文档）
• 临时静态页面展示（如活动宣传页、 landing page）

不适用场景

• 需要服务端动态渲染的网站（如PHP、Python后端驱动的动态内容）
• 需要复杂数据库交互的应用

使用方法与配置说明

前提条件

• 已安装Docker Engine（建议版本20.10+）
• 本地已准备静态网站资源（目录结构需符合Nginx默认静态文件要求，通常以index.html为入口文件）

基础使用步骤

1. 获取镜像

若镜像已上传至Docker Registry，可直接拉取：

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/nginx-static-image:latest

若需基于Dockerfile构建（假设本地存在Dockerfile）：

bash
# 进入包含Dockerfile和静态资源的目录
cd /path/to/project
# 构建镜像
docker build -t nginx-static-image:latest .

2. 运行容器

通过以下命令启动容器，将本地静态资源目录挂载至容器内Nginx默认静态文件目录（/usr/share/nginx/html）：

bash
docker run -d \
  --name static-website \
  -p 80:80 \  # 端口映射：宿主机80端口映射到容器80端口
  -v /path/to/local/static/files:/usr/share/nginx/html \  # 挂载本地静态资源目录
  nginx-static-image:latest

3. 访问网站

容器启动后，通过浏览器访问 http://localhost 或 http://[宿主机IP] 即可查看静态网站内容。

高级配置示例

自定义Nginx配置

如需修改Nginx配置（如修改默认端口、添加跨域头、设置缓存策略等），可通过挂载自定义配置文件覆盖容器内默认配置：

1. 本地创建自定义Nginx配置文件（如custom-nginx.conf），示例内容：

nginx
server {
    listen 8080;  # 修改监听端口为8080
    server_name localhost;

    root /usr/share/nginx/html;
    index index.html index.htm;

    # 跨域配置示例
    add_header Access-Control-Allow-Origin *;

    # 缓存配置示例（对图片、CSS、JS设置30天缓存）
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        expires 30d;
        add_header Cache-Control "public, max-age=2592000";
    }
}

2. 启动容器时挂载自定义配置文件（覆盖Nginx默认站点配置）：

bash
docker run -d \
  --name static-website \
  -p 8080:8080 \  # 端口映射调整为8080
  -v /path/to/local/static/files:/usr/share/nginx/html \
  -v /path/to/custom-nginx.conf:/etc/nginx/conf.d/default.conf \  # 挂载自定义配置文件
  nginx-static-image:latest

多端口映射

若需同时开放多个端口（如80和443，后者用于HTTPS），可通过多个-p参数实现：

bash
docker run -d \
  --name static-website \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/local/static/files:/usr/share/nginx/html \
  -v /path/to/ssl/certs:/etc/nginx/ssl \  # 挂载SSL证书目录（如需HTTPS）
  nginx-static-image:latest

容器管理命令

• 查看容器状态：docker ps --filter "name=static-website"
• 停止容器：docker stop static-website
• 重启容器：docker restart static-website
• 删除容器：docker rm -f static-website（需先停止容器）

注意事项

1. 静态资源目录结构需确保包含入口文件（通常为index.html），否则Nginx可能返回403错误
2. 挂载本地目录时，确保宿主机目录路径正确且容器有读取权限（可通过chmod调整宿主机目录权限）
3. 若需部署HTTPS，需准备SSL证书并通过Nginx配置启用HTTPS（监听443端口，配置ssl_certificate和ssl_certificate_key）
4. 生产环境建议设置容器自动重启策略（如--restart=always），确保服务稳定性：

   bash
   docker run -d --restart=always ...