gh-mirror
登录 GitHub

gh-mirror

多服务加速网关

Docker 镜像 · GitHub 资源 · HuggingFace 权重,一个网关全加速。私有化部署,Token 可控,磁盘缓存 + Range 续传,并支持 MCP 接入,让 AI Agent 也能直接完成部署、调用与运维。

01
Features

通用特性

这是什么? 在国内或受限网络中拉取 GitHub / Docker Hub / HuggingFace 常常很慢、超时、CI 频繁失败?把 gh-mirror 部署在能顺畅访问这些服务的节点上,对内提供高速回源与本地缓存,浏览器与命令行(curl/wget/docker)通用。

GitHub 全场景加速

覆盖 blob/raw、Releases、仓库打包 archive、短链 gh/,支持 Range 断点续传。

HuggingFace 权重

加速模型 / LFS 大文件下载,config.toml 一键开启。

Docker 镜像加速

registry-mirror 回源 Docker Hub / GHCR,另支持 /offline/<用户名>/<token>/<镜像> 产出可 docker load 的 tar(离线包需 token)。

SRC

镜像搜索

内置强大的镜像搜索:/search、/tags 页面与 API,并可通过 MCP 供 Agent 调用。

AI

MCP 接入 · Agent 友好

内置 MCP 服务端,主推 Streamable HTTP("type": "http"),AI Agent 可直接管理 Token、服务开关、缓存与链接转换。

AUTH

Token 鉴权

后台签发 Token,无效请求返回 404,访问可控、可审计。

底层能力:流式代理 + 磁盘缓存(支持 Range 断点续传),全部由 Go 标准库实现、零第三方依赖,单二进制即可运行,提供多架构镜像。

02
Usage

基本使用

GitHub 资源

域名后拼接 /g/<用户名>/<token>/ 再加完整 GitHub 地址。

bash
curl -L -o file "<你的域名>/g/<用户名>/<token>/https://github.com/owner/repo/releases/download/v1.0/app.zip"

HuggingFace 权重

拼接 /hf/<用户名>/<token>/ 与 owner/repo 路径(token 模式需带用户名段与 token)。

bash
curl -L -o config.json "<你的域名>/hf/<用户名>/<token>/openai-community/gpt2/resolve/main/config.json"

Docker 镜像

registry 加速走 /v2/<用户名>/…(无需 token,路径必须带用户名段,后台可再加自定义路径);离线 tar 走 /offline/<用户名>/<token>/<镜像> 供 docker load。

bash
docker pull <你的域名>/<用户名>/library/nginx:1.25

镜像搜索:内置强大的搜索能力,/search?q=nginx 与 /tags?repo=library/nginx 页面及 JSON API 均可用,也能通过 MCP 交给 AI Agent 直接调用。

03
Deploy

快速部署

bash
git clone https://github.com/yufeng8/gh-mirror.git && cd gh-mirror
cp .env.example .env   # 设 ADMIN_PASS / ADMIN_SECRET
docker compose -f docker-compose.standalone.yml up -d   # 预构建镜像,仅暴露 127.0.0.1:8080,交给既有反代转发
# 干净主机无反代:docker compose up -d --build  # 用根 docker-compose.yml + 内置 nginx(--profile proxy)
curl -fsS http://127.0.0.1:8080/healthz   # 期望 ok

也可用预构建镜像不编译直接跑:镜像 ghcr.io/yufeng8/gh-mirror 搭配 GitHub Releases 里的最新正式版 tag。详见 docs/docker-deploy.md 与 docs/deploy-runbook.md。

04
Releases

关注更新

最新版本、特性与新功能,请前往 GitHub Releases 与 README 查看:

05
AI Agent

一键交给 AI Agent 部署

它也是 AI Agent 友好型服务:内置 MCP 服务端,Agent(CodeBuddy / Cursor / Claude 等)可用标准协议直接管理 Token、开关 Docker/HF 加速、调整缓存、转换链接与搜索镜像,无需再手工拼接口。

部署提示词以 GitHub 上的 docs/agent-prompt.md 为准——始终最新,不必等发版。点下面的按钮即可复制最新版,整体交给你的 AI Agent(CodeBuddy / Cursor / Claude 等),它就能照着仓库文档自动完成部署与验证。提示词中的 <你的域名> 是通用占位符,请先替换为你要部署的实际域名(或让 Agent 先向你确认)。

提示词内置反幻觉白名单:真实环境变量 / 文档 / 端点清单,以及「不确定就先查证、绝不用自己编的名字填空」的硬约束——可避免 Agent 臆造 GM_* / GHW_* 等无效变量、读取不存在的文档,或把 gh-mirror 不代理的端点当成安装失败。

在 GitHub 上查看 / 手动复制 raw 原文

复制时优先从 jsDelivr / GitHub raw 取最新内容;若本实例所在网络访问不了外网,会自动回退到镜像内置版本(可能不是最新)。

本服务同时支持 MCP 接入:AI Agent 可通过标准 MCP 协议直接管理 Token、服务开关与缓存,无需再猜接口。详见 docs/mcp.md。