nstapelbroek/static-webserver

镜像概述和主要用途

这是一个基于nginx的静态Web服务器镜像，具备在容器启动时插入环境变量的能力。设计初衷是为前端项目在生产和staging等不同环境中复用镜像，无需重建Docker镜像或使用服务器端语言即可动态更改配置。

核心功能和特性

• 基于nginx实现静态Web服务功能
• 支持在容器启动时自动查找并替换环境变量
• 无需重建镜像即可动态调整配置参数
• 适用于多环境（生产、staging等）复用同一前端构建产物

使用场景和适用范围

适用于前端项目部署场景，特别是需要在不同环境（如开发、测试、生产）中使用相同构建产物但动态调整配置（如API地址、环境标识等）的情况，避免因环境差异而重复构建镜像。

使用方法和配置说明

基础使用示例

创建Dockerfile并复制静态内容到镜像中：

Dockerfile
FROM nstapelbroek/static-webserver:5
COPY ./your-static-content /var/www

现代前端项目构建示例

结合前端构建流程，先构建项目再部署到该静态服务器：

Dockerfile
FROM node:21 as build
WORKDIR /opt/project

COPY package.json package-lock.json /opt/project/
RUN npm ci

COPY . /opt/project
RUN npm run build

FROM nstapelbroek/static-webserver:5
COPY --from=build --chown=nginx:nginx /opt/project/dist /var/www

更多信息

https://github.com/nstapelbroek/docker-static-webserver