Komari Theme Market CN — EdgeOne 加速国内主题市场

Komari 是一款精致的服务器监控面板，它的主题市场默认从 GitHub 拉取主题目录和资源。但在国内，GitHub 的访问速度懂的都懂——预览图加载慢、主题包下载超时，体验很打折扣。

Komari Theme Market CN 就是为了解决这个问题而生的：它通过 EdgeOne Pages 为 Komari 主题市场搭建了一个国内加速镜像站。

项目地址：github.com/mikus-loli/theme-market-cn

工作原理#

整个流程围绕上游的 v1.json（主题目录文件）展开：

1
GitHub 上游仓库 (komari-monitor/theme-market)
2
     │  定时同步 v1.json
3
     ▼
4
data/v1.json  ──►  构建脚本下载所有 preview / download 资源
5
     │                      │
6
     │                      ▼
7
     │               dist/resources/（资源本地副本）
8
     │                      │
9
     ▼                      ▼
10
仅替换 v1.json 中的资源链接为 EdgeOne 加速链接
11
     │
12
     ▼
13
部署到 EdgeOne Pages → https://komari-market.mikus.ink

简单来说就是三步：

同步 — 从上游拉取最新的 v1.json
构建 — 下载所有主题的预览图和安装包到本地，然后把 v1.json 里的链接换成 EdgeOne 的加速地址
部署 — 推送到 EdgeOne Pages

项目结构#

1
theme-market-cn/
2
├── config/config.json              # 全局配置
3
├── scripts/
4
│   ├── sync-upstream.js            # 上游同步脚本
5
│   ├── build.js                    # 构建 + 资源下载 + 链接替换
6
│   ├── utils.js                    # 工具函数
7
│   └── logger.js                   # 日志系统
8
├── data/                           # 同步下来的数据
9
├── dist/                           # 构建产物（部署到 EdgeOne）
10
├── src/                            # Vue3 前端
11
└── .github/workflows/
12
    └── sync-and-deploy.yml         # CI/CD 工作流

技术细节#

配置驱动#

所有配置集中在 config/config.json 里：

1
{
2
  "upstream": {
3
    "repo": "komari-monitor/theme-market",
4
    "branch": "main",
5
    "mirrorRawUrl": "https://mirror.mikus.ink/https://raw.githubusercontent.com"
6
  },
7
  "edgeone": {
8
    "domain": "https://komari-market.mikus.ink",
9
    "resourcePath": "/resources/"
10
  },
11
  "build": {
12
    "concurrency": 8,
13
    "timeoutMs": 60000,
14
    "maxRetries": 3
15
  }
16
}

同步脚本#

sync-upstream.js 会按优先级依次尝试三种方式拉取 v1.json：

GitHub API（有 Token 时优先，限流更高）
GitHub Raw（直连）
镜像地址（通过 mirror.mikus.ink 兜底）

拉取后会与本地的 data/v1.json 做内容对比，没有变化就跳过后续流程，避免不必要的构建和部署。

构建脚本#

build.js 负责核心的加速逻辑：

读取 data/v1.json，遍历每个主题
并发下载 preview（预览图）和 download（主题包）到 dist/resources/
替换 v1.json 中的原始 GitHub 链接为 EdgeOne 加速链接
运行 Vite 构建前端
下载失败的资源保留原始 URL，不影响其他资源

并发数、超时、重试次数均可配置。默认 8 并发、60 秒超时、3 次重试。

CI/CD#

GitHub Actions 工作流做了几件事：

定时触发 — 每天 UTC 12:05 自动同步一次
push 触发 — 代码更新时自动同步
手动触发 — 支持 workflow_dispatch
提交同步数据 — 检测到上游更新时，自动 commit 并 push
提交构建产物 — 构建完成后提交 dist/ 目录
EdgeOne 部署 — 可选的 EdgeOne CLI 部署，或者用 EdgeOne Git 集成自动部署

1
on:
2
  schedule:
3
    - cron: '5 12 * * *'   # 每天 UTC 12:05
4
  workflow_dispatch:
5
  push:
6
    branches: [main, master]

日志系统#

日志同时输出到控制台和文件，按天滚动保留 14 天：

1
[2026-07-26T12:05:00.000Z] [INFO] [build] 下载成功 {"type":"preview","theme":"Mikus","size":49956}
2
[2026-07-26T12:05:01.000Z] [INFO] [build] 下载成功 {"type":"download","theme":"Mikus","size":284561}