saitho/git-file-webserver

静态Git文件服务器镜像

镜像概述

本镜像基于saitho/git-file-webserver构建，用于将Git仓库中的选择性内容以静态文件形式提供服务，用户可按分支或标签访问对应版本的文件。最初设计用于发布JSON Schema文件的最新版本，支持灵活配置以满足不同场景需求。

核心功能

• 搭建Git仓库的静态文件镜像
• 限制展示特定文件（通过文件通配符）
• 按分支或标签访问文件版本
• 支持Webhook（GitHub）或定时缓存方式更新仓库内容
• 虚拟语义化版本标签（如v1指向最新v1.x.x版本）

使用场景

• 发布项目的JSON Schema文件，方便用户获取不同版本的schema
• 展示仓库中特定目录下的文件（如文档、配置文件）的历史版本
• 搭建轻量级的版本化文件服务，供团队或外部用户访问

配置说明

Git仓库设置

通过config.yml配置仓库信息，包括仓库URL、工作目录、更新方式等：

yaml
git:
  repositories:
    - title: StackHead
      slug: stackhead
      url: https://github.com/getstackhead/stackhead.git
      work_dir: schemas
      update:
        mode: webhook_github # 可选cache或webhook_github
        webhook:
          github:
            secret: your-secret

文件设置

指定需要展示的文件类型（通配符）：

yaml
files:
  - "**/*.json" # 仅展示JSON文件

显示设置

控制前端展示的分支、标签等：

yaml
display:
  branches:
    filter: [master, develop]
  tags:
    order: desc
    show_date: true
    virtual_tags:
      enable_semver_major: true # 启用虚拟主版本标签

Docker部署示例

bash
docker run -p 8080:80 -v "$(pwd)/config.yml":/config/config.yml saitho/git-file-webserver:latest

服务将在本地8080端口提供访问。