duluca/minimal-node-web-server

minimal-node-web-server

容器化的Express Node Web服务器——适用于AWS ECS、Digital Ocean等平台的低成本托管
基于Alpine Linux，使用Node LTS版本，保持轻量高效（内存占用约25MB）

拉取镜像：docker pull duluca/minimal-node-web-server

镜像概述

该镜像提供了一个简单的Express.js服务器，用于托管静态内容，支持HTTPS转发、多环境配置等功能，适合静态网站或单页应用（SPA）的容器化部署。

核心功能

1. 静态内容托管：从public目录提供静态文件服务；
2. HTTPS转发：支持将HTTP请求强制转发至HTTPS，适配不同云平台（AWS、Azure等）的反向代理场景；
3. 多环境支持：可指定test、staging等环境视为生产环境，启用对应功能；
4. 轻量高效：基于Alpine Linux，内存占用极小，降低资源成本。

使用场景

• 静态网站或SPA应用的容器化部署；
• 云平台（AWS ECS、Digital Ocean、Heroku）的低成本托管；
• 微服务架构中前端应用的独立容器托管。

配置说明

基础Dockerfile示例（HTTP）

Dockerfile
FROM duluca/minimal-node-web-server

WORKDIR /usr/src/app

# （可选）设置本地环境
# ENV NODE_ENV=local

# 将本地编译后的静态内容（如dist、build）复制到容器内public目录
COPY dist public

HTTPS转发配置

通过ENFORCE_HTTPS环境变量启用HTTPS转发，不同场景对应值如下：

示例Dockerfile：

Dockerfile
FROM duluca/minimal-node-web-server

WORKDIR /usr/src/app
COPY dist public

# 适配AWS/Heroku的HTTPS转发
ENV ENFORCE_HTTPS=xProto

多环境支持配置

默认NODE_ENV为production，如需将其他环境视为生产环境，可指定：

Dockerfile
FROM duluca/minimal-node-web-server

WORKDIR /usr/src/app
COPY dist public

# 将test和staging环境视为生产环境
ENV ENVIRONMENTS=test,staging

部署示例

本地运行

bash
# 拉取镜像
docker pull duluca/minimal-node-web-server

# 挂载本地dist目录并运行（端口映射8080:80）
docker run -d -p 8080:80 -v $(pwd)/dist:/usr/src/app/public duluca/minimal-node-web-server

Docker Compose（结合反向代理）

yaml
version: '3'
services:
  web:
    image: duluca/minimal-node-web-server
    volumes:
      - ./dist:/usr/src/app/public
    environment:
      - ENFORCE_HTTPS=xProto
  proxy:
    image: jwilder/nginx-proxy
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /var/run/docker.sock:/tmp/docker.sock:ro