aurium/semver-file-server

SemVer 文件服务器

!https://gitlab.com/nT***/semver-file-server/badges/main/pipeline.svg — 网页 — https://gitlab.com/nT***/semver-file-server

镜像概述

本项目提供Docker镜像，助力发布版本化静态文件（如JS库、共享CSS、微前端组件等）。您可将其用于公共服务或受保护服务，并支持配置CORS头以适配不同访问场景。

核心功能

• 发布版本化静态文件（支持文件/目录级版本标记）
• 对未携带完整版本名称的请求自动重定向（支持仅指定主版本或主+次版本）
• 可通过环境变量配置CORS规则
• 基于NGINX实现高效资源访问

使用场景

• 托管公共JS库、共享CSS资源
• 发布微前端组件版本
• 为内部系统提供版本化静态资源服务
• 构建轻量级版本化资源CDN

配置说明

部署示例

sh
docker run \
  -p 8080:80 \
  -v /本地静态文件目录:/usr/share/nginx/html \
  -e CORS_RE='^https?:\/\/([a-z]+\.)*example\.com(:\d+)?
部署后访问 `http://localhost:8080/inner/path/to/versioned-thing` 即可测试资源访问。

### 目录结构要求
静态文件目录需遵循以下规则：
- **版本化文件**：扩展名前添加 `@<主版本>.<次版本>.<修订版本>`（如 `utils@1.0.2.js`）
- **版本化目录**：名称末尾添加 `@<主版本>.<次版本>.<修订版本>`（如 `widget@2.1.0/`）
参考https://gitlab.com/nT***/semver-file-server/-/tree/main/test/fixtures/sample-fs了解具体结构。

### 环境变量配置
- `CORS_RE`：CORS允许的来源正则表达式（如示例中的`^https?:\/\/([a-z]+\.)*example\.com(:\d+)?# SemVer 文件服务器
!https://gitlab.com/nT***/semver-file-server/badges/main/pipeline.svg &mdash; 网页 &mdash; https://gitlab.com/nT***/semver-file-server



## 镜像概述
本项目提供Docker镜像，助力发布版本化静态文件（如JS库、共享CSS、微前端组件等）。您可将其用于公共服务或受保护服务，并支持配置CORS头以适配不同访问场景。

## 核心功能
- 发布版本化静态文件（支持文件/目录级版本标记）
- 对未携带完整版本名称的请求自动重定向（支持仅指定主版本或主+次版本）
- 可通过环境变量配置CORS规则
- 基于NGINX实现高效资源访问

## 使用场景
- 托管公共JS库、共享CSS资源
- 发布微前端组件版本
- 为内部系统提供版本化静态资源服务
- 构建轻量级版本化资源CDN

## 配置说明
### 部署示例
```sh
docker run \
  -p 8080:80 \
  -v /本地静态文件目录:/usr/share/nginx/html \
  -e CORS_RE='^https?:\/\/([a-z]+\.)*example\.com(:\d+)?
部署后访问 `http://localhost:8080/inner/path/to/versioned-thing` 即可测试资源访问。

### 目录结构要求
静态文件目录需遵循以下规则：
- **版本化文件**：扩展名前添加 `@<主版本>.<次版本>.<修订版本>`（如 `utils@1.0.2.js`）
- **版本化目录**：名称末尾添加 `@<主版本>.<次版本>.<修订版本>`（如 `widget@2.1.0/`）
参考https://gitlab.com/nT***/semver-file-server/-/tree/main/test/fixtures/sample-fs了解具体结构。

### 环境变量配置
- `CORS_RE`：CORS允许的来源正则表达式（如示例中的）

## 工作原理
与公共JS CDN类似，当请求未指定完整版本的资源时，服务器会自动重定向到最新版本的对应资源路径。该功能通过NGINX结合njs脚本语言实现，保证高效处理；项目包含Node.js单元测试和基于curl的行为测试，确保功能稳定性。 \
  aurium/semver-file-server

部署后访问 CODE_TOKEN_1 即可测试资源访问。

目录结构要求

静态文件目录需遵循以下规则：

• 版本化文件：扩展名前添加 CODE_TOKEN_2（如 CODE_TOKEN_3）
• 版本化目录：名称末尾添加 CODE_TOKEN_4（如 CODE_TOKEN_5） 参考https://gitlab.com/nT***/semver-file-server/-/tree/main/test/fixtures/sample-fs%E4%BA%86%E8%A7%A3%E5%85%B7%E4%BD%93%E7%BB%93%E6%9E%84%E3%80%82

环境变量配置

• CODE_TOKEN_6：CORS允许的来源正则表达式（如示例中的__CODE_TOKEN_7__）

工作原理

与公共JS CDN类似，当请求未指定完整版本的资源时，服务器会自动重定向到最新版本的对应资源路径。该功能通过NGINX结合njs脚本语言实现，保证高效处理；项目包含Node.js单元测试和基于curl的行为测试，确保功能稳定性。