# 镜像同步方案（外部代码库 → git.vanusys.com）

> 版本：v2 · 2026-08-18 · 状态：**Gitea 原生镜像已启用（astryx 已收录）**
> 目标：把我们关注的 GitHub 等外部代码库**定期镜像**到 git.vanusys.com，让内部服务器（宁波、局域网等无法直连 GitHub 的环境）也能直接拉取，并在合集中用子模块统一引用。

## 结论：使用 Gitea 原生镜像（pull mirror）

`git.vanusys.com` 为 **Gitea 1.27.1**，服务器位于**香港**（154.21.200.211，可直连 GitHub）。
采用 **Gitea 仓库镜像（pull mirror）**：Gitea 服务端按周期主动从 GitHub 拉取，**不依赖任何本机定时任务**。

- 镜像仓库：`VanuSystems-Mirror/facebook-astryx`（private，mirror=true；镜像统一放 **VanuSystems-Mirror 组织**）
- 上游：https://github.com/facebook/astryx （MIT，16k+ 提交，~666MB，含 200+ 分支）
- 同步周期：24h（已通过 API 设置 `mirror_interval`）

### 新增镜像的标准流程（下次收录同类仓库）

1. 调 Gitea API 创建镜像仓库（见下）。
2. 等待首次同步完成（大仓库可能需 10~30 分钟）。
3. 在合集中 `git submodule add <内部镜像地址> <分类>/<仓库名>`，提交收录。

### Gitea API 创建镜像仓库（参考命令，凭据取自本机 GCM，勿回显）

```
POST /api/v1/repos/migrate
{
  "clone_addr": "https://github.com/<org>/<repo>",
  "repo_name": "<org>-<repo>",
  "repo_owner": "VanuSystems-Mirror",
  "mirror": true,
  "private": true,
  "description": "Mirror of <org>/<repo> (auto-sync from GitHub)",
  "mirror_interval": "24h0m0s"
}
```

创建后检查 `mirror_interval` 是否生效（PATCH /api/v1/repos/{owner}/{repo} 可补设）。
注意：迁移完成前（repo 处于 migrating 状态）无法转移/删除仓库。

## 备用方案：本机脚本同步（仅当 Gitea 镜像不可用时）

`tools/sync-mirrors.ps1`（本机）或香港服务器 cron 方式，保持可用但**不再作为首选**：
GitHub → 本地裸镜像（mirrors/）→ `git push --mirror` → git.vanusys.com。

## 收录清单登记表

| 上游仓库 | 镜像地址 | 分类 | 同步方式 | 状态 |
|---------|---------|------|---------|------|
| https://github.com/facebook/astryx | git.vanusys.com/VanuSystems-Mirror/facebook-astryx | frontend | Gitea pull mirror（24h） | ✅ 已镜像 |