自托管 · 单二进制 · MIT

一个网关
加速三类资源。

把 Docker 镜像、GitHub 资源与 HuggingFace 权重接入同一条链路。Token 鉴权、多用户隔离、磁盘缓存与 MCP 服务端,全部收进一个零依赖的 Go 二进制。

  • 最新 v1.4.5
  • Go 1.24
  • 零第三方依赖
  • amd64 / arm64
route-inspector / gh-mirror edge
加速端点 用户名段 + Token
/g/<用户名>/<token>/<完整 GitHub 地址>
请求示例
curl -L -o app.zip \
  "https://mirror.example.com/g/admin/ghm_xxx/https://github.com/owner/repo/releases/download/v1.0/app.zip"

覆盖 blob / raw、Releases、仓库打包与 API,支持 Range 断点续传,命中后直接返回磁盘缓存。

Token 归属校验X-Cache: HITRange 续传
X-Cache: HIT 缓存命中即返回,不再回源
UPSTREAM Docker Hub GHCR Quay GCR registry.k8s.io GitHub HuggingFace

一套网关,三条链路。

不必为每类资源维护一套代理。回源、鉴权与缓存放在同一处,客户端只需要改一个域名。

/ g

GitHub 资源加速

blob / raw、Releases、仓库归档与 API 一个前缀全覆盖,支持 Range 断点续传。

/g/<用户名>/<token>/…
  • Token 归属校验
  • 磁盘缓存与命中标记
/ v2

Docker 镜像加速

兼容 Registry API v2,多源回源;Manifest 与 Token 内存缓存,Layer 写透磁盘。

/v2/<用户名>[/自定义路径]/…
  • Docker Hub / GHCR / Quay / GCR
  • 流式传输与 Range 续传
  • 内置镜像搜索与标签浏览
/ hf

HuggingFace 加速

模型与 LFS 大文件流式下载,自动跟随 302 到 CDN,按版本精确缓存。

/hf/<用户名>/<token>/…
  • models / datasets 权重
  • 断点续传与大文件缓存

离线镜像 tar

不用本地 Docker,直接把镜像打包成 docker load 可用的 tar。自动处理多架构,同一镜像并发打包返回 429 防抖。

terminal
curl -L -o nginx.tar "https://mirror.example.com/offline/<用户名>/<token>/library/nginx:1.25"
docker load -i nginx.tar

请求只走一条链路。

无论来自浏览器、docker pull 还是 AI Agent,都先经过同一道鉴权、缓存与限流,再按白名单回源。

浏览器 / 命令行curl · wget
Docker 客户端pull · load
AI AgentMCP / HTTP
gh-mirror单二进制加速网关
gateway
01鉴权与会话

Token / 用户名段

02访问控制

ACL · 令牌桶限流

03磁盘缓存

TTL · 容量自动清理

04MCP 服务端

12 个运维工具

用户名 / Token归属校验缓存查询白名单回源落盘
Docker RegistryHub · GHCR · Quay · GCR · k8s
GitHubraw · releases · archive · API
HuggingFace模型 · LFS · CDN

同一套鉴权、缓存与限流策略覆盖所有出站链路。

小机器也能跑,边界也能守。

不引入数据库、消息队列或任何第三方 Go 模块。部署成本和审计成本都压到最低。

zero dependency

单二进制,零依赖

CGO_ENABLED=0 静态编译,无第三方 Go 模块。1 核 512M 的机器就能跑,多架构镜像直接拉取。

disk cache

真磁盘缓存,不只内存

Layer 与文件落盘,命中直接返回。缓存总量、单文件上限与 TTL 都能在后台热改,超限按最旧优先清理。

multi-user

多用户强隔离

超管与用户双入口、独立会话。Token 与 Docker 路径按用户归属,错配一律 404。

mcp server

MCP 原生接入

内置 Streamable HTTP 与 stdio 服务端,Agent 可直接管理 Token、开关服务、查缓存、搜镜像。

access control

访问可控

IP(CIDR)与仓库黑白名单、令牌桶限流,回源仅限白名单域名;IPv6 按 /64 归并。

把网关交给
AI Agent。

内置 MCP 服务端,Agent 不必猜接口。用标准协议管理 Token、开关加速、调整缓存、转换链接、搜索镜像——12 个工具覆盖日常运维。

健康health
Tokenlist_tokenscreate_tokendelete_token
服务get_servicesset_service
缓存get_cache_statsset_cache_limitsclear_cache
镜像convert_linksearch_imageslist_tags
阅读 MCP 接入文档
mcp.json streamable http
推荐 · 远程网关无需本地二进制
{
  "mcpServers": {
    "gh-mirror": {
      "type": "http",
      "url": "https://mirror.example.com/ai/<用户名>/mcp",
      "headers": {
        "Authorization": "Bearer <高级Token>"
      }
    }
  }
}
入口:POST /ai/<用户名>/mcp 高级 Token 按归属定位用户

运维不必登服务器。

服务开关即时生效并持久化;缓存上限与 TTL 可以热改;Token、用户与邀请码都在网页里管理。

  • 服务状态与统计:Token 数、命中、流量、运行时长
  • 缓存管理:容量 / 时效 / 清除 / 离线包文件
  • 用户体系:邮箱验证码注册、SMTP、邀请码
  • 链接转换:粘贴 GitHub / HF / 镜像名,直接得到加速地址
查看完整界面一览
mirror.example.com/admin
深色
gh-mirror 管理后台概览:服务状态、Token 统计、缓存与链接转换
真实运行截图 · 管理后台概览(深色主题)

三分钟跑起来。

推荐用预构建镜像部署,数据落在命名卷里。生产环境放在 nginx + HTTPS 之后,由反代转发到 127.0.0.1:8080。

docker-compose.standalone.yml
# 在仓库目录内,按 .env.example 配置密码
cp .env.example .env
docker compose -f docker-compose.standalone.yml up -d

# 默认只监听 127.0.0.1:8080,交给既有反代

两个高频坑:纯 HTTP 部署必须设置 COOKIE_SECURE=false,否则登录会反复跳回登录页;ADMIN_PASS 只在首次启动时写入账号,之后修改环境变量不会更新已有密码。

self-hosted · v1.4.5 · MIT

把加速链路
握在自己手里。

单二进制部署,数据、缓存与 Token 都留在你的机器上。