duluca/minimal-nginx-web-server

docker-nginx

常青v1版本，基于Alpine的Nginx服务器

从kyma/docker-nginx分叉而来

镜像概述和主要用途

这是一个基于Alpine的高性能Nginx基础镜像，专为Docker环境设计，用于提供静态网站服务。该镜像会自动提供/var/www目录下的所有内容，适用于需要轻量级、高性能Nginx环境的静态网站部署场景。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 高性能：优化的Nginx配置，适合静态内容高效分发
• 静态网站支持：默认提供/var/www目录下的所有文件
• SSL支持：可配置SSL证书，启用HTTPS服务
• 云平台适配：支持AWS、Heroku、Digital Ocean、Vercel Now等主流云平台
• 可定制配置：允许通过自定义Dockerfile修改Nginx配置

使用场景和适用范围

• 静态网站部署（如React、Vue、Angular等前端框架构建的单页应用）
• 静态资源服务器（如HTML、CSS、JavaScript、图片等）
• 需要轻量级Nginx环境的容器化部署场景
• AWS ECS & Fargate、Heroku、Digital Ocean、Vercel Now等云平台的应用部署

使用方法和配置说明

基础使用方法

创建Dockerfile

如果您的网站文件位于dist目录下，创建如下Dockerfile：

Dockerfile
FROM duluca/minimal-nginx-web-server
COPY dist /var/www
CMD 'nginx'

构建和运行镜像

bash
# 构建镜像
$ docker build -t mysite .
...
Successfully built 5ae2fb5cf4f8

# 运行容器
$ docker run -p 80:80 -d mysite
da809981545f

# 测试访问
$ curl localhost
...

SSL配置

要启用SSL，需将证书文件放置在/etc/nginx/ssl目录并启用default-ssl站点：

Dockerfile配置

Dockerfile
ADD server.crt /etc/nginx/ssl/
ADD server.key /etc/nginx/ssl/
RUN ln -s /etc/nginx/sites-available/default-ssl /etc/nginx/sites-enabled/default-ssl

运行容器（开放443端口）

bash
$ docker run -p 80:80 -p 443:443 -d mysite

注意：生产环境中的HTTPS配置较为复杂，通常依赖云服务提供商处理私钥管理、反向代理或负载均衡等任务。

HTTPS转发（开发中 - 暂不可用）

根据不同云平台，可通过复制容器tmp目录中的不同Nginx配置文件来修改配置：

AWS、Heroku、Nginx、负载均衡器等平台配置

Dockerfile
FROM duluca/minimal-nginx-web-server
RUN cp /tmp/default-xproto /etc/nginx/sites-enabled/default
COPY dist /var/www
CMD 'nginx'

健康检查可使用/healthCheck路径绕过HTTPS强制检查。

nginx.conf配置

该镜像的nginx.conf和mime.types文件基于h5bp Nginx HTTP服务器样板配置项目（https://github.com/h5bp/server-configs-nginx%EF%BC%89%E8%BF%9B%E8%A1%8C%E4%BA%86%E8%BD%BB%E5%BE%AE%E4%BF%AE%E6%94%B9%E3%80%82

自定义Nginx配置

如需修改Nginx配置，可通过自定义Dockerfile复制修改后的配置文件：

dockerfile
# 指南参考：
# https://github.com/KyleAMathews/docker-nginx

# 构建命令：
# docker build -t 容器名称 .

# 基于本镜像构建
FROM duluca/minimal-nginx-web-server

# 示例：替换默认服务器配置文件
COPY 本地配置路径/default /etc/nginx/sites-enabled/default

# 复制网站文件
COPY dist /var/www

CMD 'nginx'

开发者指南

构建与发布

执行以下脚本构建并发布镜像：

bash
./publish.sh