socialengine/nginx-spa

socialengine/nginx-spa镜像描述

镜像概述

这是一个基于Nginx的Docker镜像，专门用于部署和服务单页应用（SPA，纯前端JavaScript应用），支持PushState路由机制以实现干净URL，并提供运行时环境变量配置功能，满足动态参数需求。

核心功能

• PushState支持：所有请求自动路由到/app/index.html，无需使用!#形式的哈希路由，实现更友好的URL结构。
• 环境变量配置：允许在容器运行时通过环境变量传递配置参数（如API地址、密钥等），自动生成config.js文件供应用调用。

使用场景

• 部署React、Vue、Angular等框架构建的纯前端单页应用。
• 需要动态调整API地址、日志服务密钥等运行时参数的场景。

配置说明

App Setup

镜像默认将应用文件放置在/app目录下，启用PushState路由。示例Dockerfile：

Dockerfile
FROM socialengine/nginx-spa
COPY build/ /app
COPY index.html /app/index.html

构建并运行应用：

bash
docker build -t your-app-image .
docker run -e API_KEY=yourkey -e API_URL=http://myapi.example.com \
  -e CONFIG_VARS=API_URL,API_KEY -p 8000:80 your-app-image

访问http://docker-ip:8000/即可查看部署的应用。

Env Config

通过环境变量传递配置参数，生成config.js文件。示例：

bash
docker run -e RAVEN_DSN=yourkey -e API_URL=http://myapi.example.com \
  -e CONFIG_VARS=API_URL,RAVEN_DSN -p 8000:80 socialengine/nginx-spa:latest

生成的config.js包含指定的环境变量，可在应用中引入使用。通过CONFIG_FILE_PATH变量可自定义文件路径。