timoreymann/nginx-spa

nginx-spa


镜像概述和主要用途

nginx-spa 是一个轻量级 Docker 镜像，专为快速部署单页应用（SPA）设计，无需复杂配置即可实现托管。该镜像基于 Nginx，针对 SPA 特性优化，提供默认安全配置、缓存策略及精简的镜像结构，适用于各类静态前端应用的快速交付。

核心功能和特性

• 默认安全配置：内置安全最佳实践，如适当的 HTTP 头（CSP、X-Content-Type-Options 等），降低常见 Web 安全风险。
• 缓存优化：针对 SPA 静态资源（JS、CSS、图片等）优化缓存策略，提升加载速度和用户体验。
• 优化的单层基础镜像：采用精简的单层镜像结构，减少镜像体积，提高部署效率和安全性（减少***面）。

使用场景和适用范围

• 前端开发与测试：快速搭建本地或测试环境，无需手动配置 Nginx。
• 演示环境：临时部署 SPA 用于产品演示或客户展示。
• 生产环境静态托管：作为生产环境中静态 SPA 的托管解决方案，尤其适合无服务架构（Serverless）或轻量级部署需求。
• CI/CD 流程集成：与持续集成/部署流程结合，自动化构建并部署 SPA。

详细使用方法和配置说明

基本使用要求

• 已安装 Docker 环境。

核心配置说明

• 文件挂载路径：需将 SPA 静态文件目录挂载至容器内 /app 目录，镜像会自动托管该目录下的文件。
• 运行用户：容器以非特权用户 1002:1002 运行，增强安全性。
• 默认端口：容器内部监听端口为 8080，需通过端口映射暴露至主机。

Docker 部署示例

1. 使用 docker run 命令部署

bash
docker run --name=my-spa -v /path/to/your/spa/files:/app -p 8000:8080 timoreymann/nginx-spa

• 参数说明：
  • --name=my-spa：指定容器名称为 my-spa。
  • -v /path/to/your/spa/files:/app：将主机上的 SPA 文件目录（替换为实际路径）挂载至容器 /app 目录。
  • -p 8000:8080：将主机端口 8000 映射至容器端口 8080，通过 http://localhost:8000 访问应用。

2. 使用 docker-compose 部署

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  spa:
    image: timoreymann/nginx-spa
    container_name: my-spa
    volumes:
      - /path/to/your/spa/files:/app  # 替换为实际 SPA 文件路径
    ports:
      - "8000:8080"  # 主机端口:容器端口
    restart: unless-stopped  # 可选，配置容器自动重启策略

启动服务：

bash
docker-compose up -d

访问应用

部署完成后，通过 http://<主机IP>:8000 访问 SPA（若本地部署，使用 http://localhost:8000）。

注意事项

• 确保挂载的 /path/to/your/spa/files 目录包含 SPA 入口文件（通常为 index.html），Nginx 会默认将其作为首页。
• 若需自定义 Nginx 配置（如修改端口、添加自定义 headers 等），可通过挂载配置文件至容器 /etc/nginx/conf.d/ 目录实现（需注意权限问题）。
• 生产环境建议结合反向代理（如 Traefik、Nginx）使用，添加 HTTPS 支持。# nginx-spa

[![Renovate]([***]