authkeys/nginx-spa Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Nginx SPA

概述

这是一个专为单页应用(SPA)设计的Nginx镜像，容器以非特权用户nginx运行nginx进程，暴露8080端口，并对大于1024字节的文件启用Gzip压缩，确保SPA应用的正确路由和静态资源服务。

核心功能与特性

非特权运行

以nginx非特权用户运行，提升容器安全性。

端口暴露

默认暴露8080端口，便于外部访问应用。

Gzip压缩

自动对大小超过1024字节的文件启用Gzip压缩，减少网络传输数据量。

SPA路由规则

• 带扩展名（非.html）的路径：如.css、.js、.png等，文件必须存在，否则返回404错误。
• 无扩展名或.html结尾的路径：若文件不存在，自动返回/index.html，支持SPA前端路由跳转。

使用场景

适用于部署单页应用（如React、Vue、Angular等框架构建的前端项目），需要Nginx处理静态资源并支持前端路由（避免路由跳转返回404）的场景。

使用方法

扩展镜像

通过Dockerfile构建自定义镜像，将SPA构建产物复制到容器内：

dockerfile
FROM authkeys/nginx-spa

COPY dist/ /app  # 将本地dist目录下的SPA文件复制到容器/app目录

直接运行容器

挂载本地SPA构建目录，快速启动服务：

bash
docker run -p 8080:8080 -v $PWD/dist:/app authkeys/nginx-spa

（注：$PWD/dist为本地SPA构建产物目录，映射到容器内/app目录；-p 8080:8080将容器8080端口映射到主机8080端口）