Repository navigation
Releases
v1.4.5
gh-mirror v1.4.4 — 指标口径说明 + 链接转换区美化
一个单二进制、零第三方依赖的自托管加速网关:Docker 镜像 · GitHub 资源 · HuggingFace 权重三类加速一站搞定。v1.4.4 是两处体验打磨:统计卡加问号说明(把「总命中 / 总流量」这类指标的口径讲清楚),以及链接转换区重排(两行等宽、说明折叠)。
✨ 本版亮点
- ❓ 统计卡问号说明:概览四张指标卡标题旁新增问号,点击或悬停即弹出深色说明气泡
- Token 数:当前账号可见的 Token 数量(超管也仅自己的)
- 总命中:经
/g/与/hf/代理成功的请求次数;状态码 ≥ 400 不计入;用别人 Token 的流量记在那个 Token 上 - 总流量:上述成功响应实际写给客户端的字节数(按 Token 分别累计后求和)
- 运行时长:进程运行时长,实例重启后重置
- 纯 CSS 实现(
:hover/:focus):点击后保持显示,点别处自动消失,无需额外 JS - 缓存管理等其他页面的统计卡不显示问号,不受影响
- 🎨 链接转换区重排
- 输入框与输出框统一 560px(此前输入 460px、输出铺满整行约 1040px)
- 输出框改为等宽字体 + 浅底色,链接更易读、也明确是只读结果
- 原占 3 行的说明文字收进
<details>「使用说明与示例」,默认收起(收起仅 53px,展开 182px)
🔧 其他改进
- 链接转换两行按钮均紧随输入框,不再有「一个窄一个宽」的错位感
- 说明内容一字未减(GitHub / HuggingFace 示例、
/offline与/v2规则),拆为两段更易读 - 小屏(≤600px)输入框仍铺满,移动端不受影响
✅ 兼容性
- 无破坏性变更:端点、MCP 地址、双入口、配置与数据卷格式均不变
- MCP 主推接入方式仍是 Streamable HTTP(
"type": "http"+headers.Authorization) - 说明气泡不改变任何统计口径:仍是「当前账号可见 Token」的成功代理请求与字节数
🚀 快速开始
# 单容器 + 既有反代(推荐:单文件、真实 env、只绑 127.0.0.1:8080)
cp .env.example .env # 设 ADMIN_PASS / ADMIN_SECRET
docker compose -f docker-compose.standalone.yml up -d
# 或 docker run
docker run -d --name gh-mirror \
-p 127.0.0.1:8080:8080 \
-e ADMIN_USER=admin \
-e ADMIN_PASS='强口令' \
-e ADMIN_SECRET="$(openssl rand -hex 32)" \
-e USER_PATH=/user \
ghcr.io/yufeng8/gh-mirror:v1.4.4启动后:超级管理员访问 http://<域名>/admin;普通用户访问 http://<域名>/user。
纯 HTTP(无 TLS)部署请设
COOKIE_SECURE=false,否则浏览器不下发 Secure cookie,表现为登录无反应 / 反复跳回登录页。
ADMIN_PASS只是首次启动的种子密码,之后改该环境变量不会更新已存在用户的密码(详见docs/agent-prompt.md)。
🔗 相关链接
- 文档:README.md · docs/ · docs/mcp.md · docs/docker-deploy.md
- 镜像:ghcr.io/yufeng8/gh-mirror
- AI Agent 部署提示词:docs/agent-prompt.md
What's Changed
- fix(convert): 无 scheme 的 GitHub / HuggingFace 链接不再被误判为 Docker 镜像 by @zzidcn in #88
- feat(mcp): 面向 AI Agent 的可用性改造(修复 3 个实测问题 + 协议兼容 + 描述/schema/输出结构化) by @zzidcn in #89
- feat(mcp): tools/list 按角色裁剪,普通用户不再看到调不动的管理工具 by @zzidcn in #90
Full Changelog: v1.4.4...v1.4.5
v1.4.4
gh-mirror v1.4.4 — 指标口径说明 + 链接转换区美化
一个单二进制、零第三方依赖的自托管加速网关:Docker 镜像 · GitHub 资源 · HuggingFace 权重三类加速一站搞定。v1.4.4 是两处体验打磨:统计卡加问号说明(把「总命中 / 总流量」这类指标的口径讲清楚),以及链接转换区重排(两行等宽、说明折叠)。
✨ 本版亮点
- ❓ 统计卡问号说明:概览四张指标卡标题旁新增问号,点击或悬停即弹出深色说明气泡
- Token 数:当前账号可见的 Token 数量(超管也仅自己的)
- 总命中:经
/g/与/hf/代理成功的请求次数;状态码 ≥ 400 不计入;用别人 Token 的流量记在那个 Token 上 - 总流量:上述成功响应实际写给客户端的字节数(按 Token 分别累计后求和)
- 运行时长:进程运行时长,实例重启后重置
- 纯 CSS 实现(
:hover/:focus):点击后保持显示,点别处自动消失,无需额外 JS - 缓存管理等其他页面的统计卡不显示问号,不受影响
- 🎨 链接转换区重排
- 输入框与输出框统一 560px(此前输入 460px、输出铺满整行约 1040px)
- 输出框改为等宽字体 + 浅底色,链接更易读、也明确是只读结果
- 原占 3 行的说明文字收进
<details>「使用说明与示例」,默认收起(收起仅 53px,展开 182px)
🔧 其他改进
- 链接转换两行按钮均紧随输入框,不再有「一个窄一个宽」的错位感
- 说明内容一字未减(GitHub / HuggingFace 示例、
/offline与/v2规则),拆为两段更易读 - 小屏(≤600px)输入框仍铺满,移动端不受影响
✅ 兼容性
- 无破坏性变更:端点、MCP 地址、双入口、配置与数据卷格式均不变
- MCP 主推接入方式仍是 Streamable HTTP(
"type": "http"+headers.Authorization) - 说明气泡不改变任何统计口径:仍是「当前账号可见 Token」的成功代理请求与字节数
🚀 快速开始
# 单容器 + 既有反代(推荐:单文件、真实 env、只绑 127.0.0.1:8080)
cp .env.example .env # 设 ADMIN_PASS / ADMIN_SECRET
docker compose -f docker-compose.standalone.yml up -d
# 或 docker run
docker run -d --name gh-mirror \
-p 127.0.0.1:8080:8080 \
-e ADMIN_USER=admin \
-e ADMIN_PASS='强口令' \
-e ADMIN_SECRET="$(openssl rand -hex 32)" \
-e USER_PATH=/user \
ghcr.io/yufeng8/gh-mirror:v1.4.4启动后:超级管理员访问 http://<域名>/admin;普通用户访问 http://<域名>/user。
纯 HTTP(无 TLS)部署请设
COOKIE_SECURE=false,否则浏览器不下发 Secure cookie,表现为登录无反应 / 反复跳回登录页。
ADMIN_PASS只是首次启动的种子密码,之后改该环境变量不会更新已存在用户的密码(详见docs/agent-prompt.md)。
🔗 相关链接
- 文档:README.md · docs/ · docs/mcp.md · docs/docker-deploy.md
- 镜像:ghcr.io/yufeng8/gh-mirror
- AI Agent 部署提示词:docs/agent-prompt.md
What's Changed
- style(admin): 链接转换区美化(两行等宽 560px + 输出框等宽字体 + 说明折叠) by @zzidcn in #85
- feat(admin): 统计卡加问号说明(点击/悬停弹出指标口径气泡) by @zzidcn in #86
- style(admin): 「Token 数」问号说明去掉括号补充 by @zzidcn in #87
Full Changelog: v1.4.3...v1.4.4
v1.4.3
gh-mirror v1.4.3 — 镜像搜索详情 · 注册验证码交互 · 后台体验细化
一个单二进制、零第三方依赖的自托管加速网关:Docker 镜像 · GitHub 资源 · HuggingFace 权重三类加速一站搞定。v1.4.3 是一轮「细节补齐」:镜像搜索结果补齐关键信息、离线包显示版本与上游更新时间、注册页图形验证码改为按需展开并加 60 秒冷却,以及链接转换与侧栏的一批体验优化。
✨ 本版亮点
- 🔍 镜像搜索结果补全详情
- 修复此前只有
21411 ★的问题:/api/search现在输出规范化字段name / description / stars / pulls / official / updated - 每条结果显示:镜像名(如
library/nginx)、官方标记、★ 星级、拉取数(千分位)、上游更新时间(N 天前)、描述
- 修复此前只有
- 📦 离线包显示版本与上游更新时间
- 镜像名下方新增
版本 7.2(取拉取时的 tag;digest 引用显示缩写)与上游更新 3 天前(取镜像 config 的created) - 用户下载与后台重拉两条路径都会记录并持久化
⚠️ 升级前已缓存的包没有该时间,重新拉取或新拉取后出现
- 镜像名下方新增
- 🔐 注册页图形验证码改为「发码时展开」+ 60 秒冷却
- 图形码默认隐藏,点「发送验证码」才展开并要求输入(避免首屏同时出现两个验证码)
- 发码接口在开启用户入口验证码时会校验图形码(防刷)
- 发送成功后按钮进入 60 秒倒计时,失败自动刷新图形码
- 🚀 链接转换更好用:输入框收窄至 460px,新增「🔍 搜索镜像」按钮(复用镜像选择面板),选中即填入
- 👋 侧栏展示当前用户:底部新增用户名 + 「👋 欢迎你!」卡片(退出登录与 Star 引导之间)
🔧 其他改进
- 镜像选择面板的常用镜像、搜索结果与拉取输入框宽度统一(460px),链接转换与离线包两处一致
- 「我的 Docker 自定义路径」输入框由 130px 加宽到 320px,长路径不再被截断
- 发码按钮在找回密码场景也能正确定位(不再依赖注册页专属 id)
✅ 兼容性
- 无破坏性变更:端点、MCP 地址、双入口、配置与数据卷格式均不变
- MCP 主推接入方式仍是 Streamable HTTP(
"type": "http"+headers.Authorization) offline-cache.json新增upstream字段,旧文件自动兼容(缺失视为未知)
🚀 快速开始
# 单容器 + 既有反代(推荐:单文件、真实 env、只绑 127.0.0.1:8080)
cp .env.example .env # 设 ADMIN_PASS / ADMIN_SECRET
docker compose -f docker-compose.standalone.yml up -d
# 或 docker run
docker run -d --name gh-mirror \
-p 127.0.0.1:8080:8080 \
-e ADMIN_USER=admin \
-e ADMIN_PASS='强口令' \
-e ADMIN_SECRET="$(openssl rand -hex 32)" \
-e USER_PATH=/user \
ghcr.io/yufeng8/gh-mirror:v1.4.3启动后:超级管理员访问 http://<域名>/admin;普通用户访问 http://<域名>/user。
纯 HTTP(无 TLS)部署请设
COOKIE_SECURE=false,否则浏览器不下发 Secure cookie,表现为登录无反应 / 反复跳回登录页。
ADMIN_PASS只是首次启动的种子密码,之后改该环境变量不会更新已存在用户的密码(详见docs/agent-prompt.md)。
🔗 相关链接
- 文档:README.md · docs/ · docs/mcp.md · docs/docker-deploy.md
- 镜像:ghcr.io/yufeng8/gh-mirror
- AI Agent 部署提示词:docs/agent-prompt.md
What's Changed
- feat(admin): 镜像搜索补详情(名称/拉取数/更新时间)+ 离线包显示版本与上游更新时间 by @zzidcn in #81
- feat(admin): 链接转换输入框收窄 + 新增「搜索镜像」按钮(复用选择面板) by @zzidcn in #82
- feat(auth): 注册页图形验证码发码时展开 + 发码校验 + 60 秒冷却倒计时 by @zzidcn in #83
- feat(admin): 侧栏底部展示当前用户名与欢迎词 + Docker 路径输入框加宽 by @zzidcn in #84
Full Changelog: v1.4.2...v1.4.3
v1.4.2
gh-mirror v1.4.2 — 列表分页与搜索 · Token 批量删除 · 镜像选择面板 · 详情弹窗修复
一个单二进制、零第三方依赖的自托管加速网关:Docker 镜像 · GitHub 资源 · HuggingFace 权重三类加速一站搞定。v1.4.2 集中打磨后台的列表体验:四个列表统一分页与每页条数、用户列表支持搜索、Token 支持勾选批量删除、离线包拉取新增「选择镜像」面板,并修复实际部署下 Token 详情弹窗的「网络错误」。
✨ 本版亮点
- 📄 列表分页统一:Token / 邀请码 / 离线包 每页 10/20/50,用户列表 10/20/30/50;页码、每页条数、上一页/下一页在同一行
- 🔍 用户搜索:按用户名 / 邮箱子串匹配(不区分大小写);搜索与翻页互相保留参数,可一键「清除」
- ☑️ Token 批量删除:行复选框 + 表头全选 + 「删除选中(N)」,逐个做归属校验(只能删自己的)
- 🖼️ 离线包「选择镜像」面板:常用镜像前 10(nginx / redis / postgres / mysql / mariadb / mongo / node / python / alpine / ubuntu)+ Docker Hub 实时搜索(前 10 条含 stars / 官方 / 描述),点击即填入
- 🐛 修复 Token 详情弹窗「网络错误」:此前通过
fetch /admin/users/tokens.json拉数据,经反代(对.json有特殊规则)或自定义ADMIN_PATH时会失败。改为服务端内嵌数据、弹窗本地渲染,不再发额外请求
🔧 其他改进
- 离线包列表分页条此前只在「有数据」时渲染(0 个包时看不到分页)→ 现在始终显示,并移到「已缓存离线包」标题右侧
- 邀请码「上一页 / 下一页」从表格下方移到页码同一行,去掉重复分页行
- 用户列表的「Token 数」点击弹窗在各分页下仍准确(统计基于全部用户)
✅ 兼容性
- 无破坏性变更:端点、MCP 地址、双入口、配置与数据卷格式均不变
- 分页参数:Token / 用户 / 离线包用
size+page;邀请码用inv_size+inv_page settings.json/users.json自动兼容旧格式
🚀 快速开始
# 单容器 + 既有反代(推荐:单文件、真实 env、只绑 127.0.0.1:8080)
cp .env.example .env # 设 ADMIN_PASS / ADMIN_SECRET
docker compose -f docker-compose.standalone.yml up -d
# 或 docker run
docker run -d --name gh-mirror \
-p 127.0.0.1:8080:8080 \
-e ADMIN_USER=admin \
-e ADMIN_PASS='强口令' \
-e ADMIN_SECRET="$(openssl rand -hex 32)" \
-e USER_PATH=/user \
ghcr.io/yufeng8/gh-mirror:v1.4.2启动后:超级管理员访问 http://<域名>/admin;普通用户访问 http://<域名>/user。
纯 HTTP(无 TLS)部署请设
COOKIE_SECURE=false,否则浏览器不下发 Secure cookie,表现为登录无反应 / 反复跳回登录页。
ADMIN_PASS只是首次启动的种子密码,之后改该环境变量不会更新已存在用户的密码(详见docs/agent-prompt.md)。
🔗 相关链接
- 文档:README.md · docs/ · docs/mcp.md · docs/docker-deploy.md
- 镜像:ghcr.io/yufeng8/gh-mirror
- AI Agent 部署提示词:docs/agent-prompt.md
What's Changed
- fix(admin): Token 详情弹窗改用内嵌数据,修复实际部署后「网络错误」 by @zzidcn in #75
- feat(admin): Token 列表分页(10/20/50)+ 行复选框 + 批量删除 by @zzidcn in #76
- feat(admin): 离线包拉取加「选择镜像」面板(常用镜像 10 个 + Docker Hub 搜索) by @zzidcn in #77
- feat(admin): 邀请码列表分页(每页 10/20/50)+ 翻页 by @zzidcn in #78
- fix(admin): 离线包列表分页条始终显示(空列表也有 10/20/50 + 翻页) by @zzidcn in #79
- feat(admin): 用户列表搜索(用户名/邮箱)+ 分页(10/20/30/50);邀请码翻页并入页码行 by @zzidcn in #80
Full Changelog: v1.4.1...v1.4.2
v1.4.1
gh-mirror v1.4.1 — 修复用户 Token 详情页 · 详情改弹窗 · MCP 主推 Streamable HTTP
一个单二进制、零第三方依赖的自托管加速网关:Docker 镜像 · GitHub 资源 · HuggingFace 权重三类加速一站搞定。v1.4.1 是 v1.4.0 的修复与完善版:修掉「Token 详情」页空白的问题,把查看他人 Token 改为当前页弹窗(不跳转),并把 MCP 接入在文档与后台统一改为主推 Streamable HTTP。
🐛 修复:用户 Token 详情页空白
现象:用户管理页显示某用户「Token 数 = 1」,点进去详情页表格却是空的。
根因:userTokensBody 模板漏了 flash 占位符(只有 5 个 %s,handler 传了 6 个参数),fmt.Sprintf 参数整体错位——标题被塞进 topbarRight(显示成「Token 详情 · 健康检查」)、卡片标题变成用户名、<tbody> 里塞进「返回用户管理」按钮,真正的 Token 行从未渲染。
修复:补上占位符并修正参数顺序,详情页可正常展示该用户的 Token。
✨ 改进:Token 详情改为弹窗(不跳转页面)
- 用户列表的 Token 数改为文字按钮,点击在当前页弹窗展示
- 弹窗内:完整 Token(带复制)、备注、类型、命中、流量、创建时间、最近使用
- 仅「安装时创建的超级管理员」可查看;只读,不能修改或删除
- 新增
GET /admin/users/tokens.json?user=<用户名>供前端拉取(仅安装时超管,403/400/404 明确报错) - 弹窗宽度 1040px,7 列完整不被裁;原
/admin/users/tokens页面保留(深链兼容)
🚀 MCP:主推 Streamable HTTP("type": "http")
/ai/<用户名>/mcp 一直兼容 MCP Streamable HTTP(2025-03-26 规范)——无状态、POST 返回单个 JSON、GET 405 属规范允许。本次把它在所有入口提为首选:
{
"mcpServers": {
"gh-mirror": {
"type": "http",
"url": "https://<你的域名>/ai/<用户名>/mcp",
"headers": { "Authorization": "Bearer <高级Token>" }
}
}
}docs/mcp.md:方式一改为「Streamable HTTP(远程网关 · 推荐首选)」,新增客户端配置、Accept示例与「协议行为」说明README.md/README_EN.md:配置示例放首位,stdio 明确标注「备选(仅同机)」- 后台
/admin/mcp:方式一标题标注推荐首选,新增可一键复制的mcpServersJSON(Token 段随选择器联动) docs/agent-prompt.md与首页特性卡片同步
客户端若把
type写作"streamable-http"语义相同;url末尾带不带/均可。
✅ 兼容性
- 无破坏性变更:端点、MCP 地址、双入口、配置与数据卷格式均不变
settings.json/users.json自动兼容旧格式- 原
/admin/users/tokens深链页面保留
🚀 快速开始
# 单容器 + 既有反代(推荐:单文件、真实 env、只绑 127.0.0.1:8080)
cp .env.example .env # 设 ADMIN_PASS / ADMIN_SECRET
docker compose -f docker-compose.standalone.yml up -d
# 或 docker run
docker run -d --name gh-mirror \
-p 127.0.0.1:8080:8080 \
-e ADMIN_USER=admin \
-e ADMIN_PASS='强口令' \
-e ADMIN_SECRET="$(openssl rand -hex 32)" \
-e USER_PATH=/user \
ghcr.io/yufeng8/gh-mirror:v1.4.1启动后:超级管理员访问 http://<域名>/admin;普通用户访问 http://<域名>/user。
纯 HTTP(无 TLS)部署请设
COOKIE_SECURE=false,否则浏览器不下发 Secure cookie,表现为登录无反应 / 反复跳回登录页。
ADMIN_PASS只是首次启动的种子密码,之后改该环境变量不会更新已存在用户的密码(详见docs/agent-prompt.md)。
🔗 相关链接
- 文档:README.md · docs/ · docs/mcp.md · docs/docker-deploy.md
- 镜像:ghcr.io/yufeng8/gh-mirror
- AI Agent 部署提示词:docs/agent-prompt.md
What's Changed
- fix(admin): 修复用户 Token 详情页空白(模板占位符错位)+ Token 数改为弹窗展示 by @zzidcn in #73
- docs(mcp): Streamable HTTP(type: http)提为主推接入方式(文档 + 后台 + 首页) by @zzidcn in #74
Full Changelog: v1.4.0...v1.4.1
v1.4.0
gh-mirror v1.4.0 — 注册三态 · 设置弹窗 · Token 可见性收紧 · 后台视觉统一
一个单二进制、零第三方依赖的自托管加速网关:Docker 镜像 · GitHub 资源 · HuggingFace 权重三类加速一站搞定。v1.4.0 是后台账号体系与界面的一次整合版本:注册模式合并为无歧义的三态、设置改为弹窗表格、Token 默认只看自己的、用户列表补上邮箱/最后登录/Token 数,并对整个后台做了一轮统一美化。
✨ 本版亮点
- 🔐 注册三态(取代两个独立开关):
关闭注册/仅邀请码注册/开放注册一个下拉搞定;旧settings.json自动迁移(关闭→关闭、开启+仅邀请码→仅邀请码、开启→开放),并回写旧字段便于回滚。
修复一处真实矛盾:此前/user/register不校验注册开关,关闭后仍能打开注册页(提交才被拒);现在关闭时直接跳回登录页并提示「注册未开放」。 - ⚙️ 设置改为弹窗表格:「用户注册与邮箱」放在「用户管理」页顶部,默认只显示「⚙️ 设置」按钮 + 状态摘要(注册模式 / 联系邮箱 / SMTP);点击弹出居中弹窗,内部两列表格:注册模式、图形验证码、首页隐藏登录、联系邮箱、SMTP(主机/端口/账号/密码/发件人/TLS),底部保存/取消固定,内容超高时带可见滚动条(自绘,不依赖系统 overlay)。
- 🛡️ Token 可见性收紧:任何角色(含超级管理员)在 Token(令牌)管理、概览统计、侧栏计数、MCP
list_tokens、链接转换中都只看/只用自己的 Token;删除/编辑同样只能操作自己的。管理员(非安装时超管)在任何页面都无法查看他人 Token。 - 📋 用户列表增强:列为
用户名 / 邮箱 / 角色 / 创建时间 / 最后登录 / Token 数 / 操作。- 邮箱为空显示「—」;最后登录在登录成功时写入
users.json(从未登录显示「—」); - Token 数点击进入该用户的 只读 Token 详情页(仅安装时超管):可查看/复制完整 Token、备注、类型、命中、流量、创建/最近使用,但不能修改或删除。
- 邮箱为空显示「—」;最后登录在登录成功时写入
- 🎨 后台统一美化(借鉴 shadcn 设计语言,纯 CSS)
- 设计令牌:
--radius .625rem、--shadow-sm/md、--ring-soft;统一细滚动条与 focus ring - 按钮统一 36px 高 / 圆角 / hover 层次;登录、注册、重置密码按钮改为 44px + flex 垂直居中 + 1rem 字号
- 侧栏当前项加左侧主色指示条;卡片/表头/行 hover 统一
- 「Token 管理」页面标题与侧栏菜单改为「令牌管理」;Token 表列宽优化(访问次数收窄、流量加宽、操作按钮不换行)
- 登录页「忘记密码」展开时位置完全固定(不再左右/上下漂移);用户入口不再显示「超管密码无法在线找回」提示
- 小屏顶部汉堡按钮靠右;首页登录按钮支持后台隐藏(仅隐藏入口,
/admin、/user仍可直达)
- 设计令牌:
⚠️ 升级提示(三处行为变化)
- 注册设置变成三态:原「开启注册 + 仅邀请码」自动换算,无需手动改;后台界面从两个勾选框变成一个下拉。
- 超管在令牌管理页也只看到自己的 Token(此前可见全部)。查看他人请走「用户管理 → 该用户 Token 数」(只读详情)。
- 后台界面有较大调整:设置入口在用户管理页顶部(弹窗表单)、Token 菜单与标题改为「令牌管理」、登录卡片改为顶部锚定。
✅ 兼容性
- 端点、MCP 地址(
/ai/<用户名>/mcp)、双入口(/admin+/user)、配置与数据卷格式均不变;无破坏性变更。 settings.json/users.json均自动兼容旧格式(新增字段缺省时按旧值推导),升级只需替换镜像 / 二进制。
🚀 快速开始
# 单容器 + 既有反代(推荐:单文件、真实 env、只绑 127.0.0.1:8080)
cp .env.example .env # 设 ADMIN_PASS / ADMIN_SECRET
docker compose -f docker-compose.standalone.yml up -d
# 或 docker run
docker run -d --name gh-mirror \
-p 127.0.0.1:8080:8080 \
-e ADMIN_USER=admin \
-e ADMIN_PASS='强口令' \
-e ADMIN_SECRET="$(openssl rand -hex 32)" \
-e USER_PATH=/user \
ghcr.io/yufeng8/gh-mirror:v1.4.0启动后:超级管理员访问 http://<域名>/admin;普通用户访问 http://<域名>/user。
纯 HTTP(无 TLS)部署请设
COOKIE_SECURE=false,否则浏览器不下发 Secure cookie,表现为登录无反应 / 反复跳回登录页。
另注意:ADMIN_PASS只是首次启动的种子密码,之后改该环境变量不会更新已存在用户的密码(详见docs/agent-prompt.md)。
🔗 相关链接
- 文档:README.md · docs/ · docs/docker-deploy.md · docs/mcp.md
- 镜像:ghcr.io/yufeng8/gh-mirror
- AI Agent 部署提示词:docs/agent-prompt.md
What's Changed
- fix(ui): 修复设置弹窗错位 + 后台统一美化(shadcn 设计语言) by @zzidcn in #67
- fix(ui): 弹窗内容滚动 + 底部按钮固定 + 自绘滚动条 + 邀请码输入框加宽 by @zzidcn in #68
- style(admin): 用户管理页「用户注册与邮箱」设置区移到用户列表上方 by @zzidcn in #69
- style(admin): Token 表列宽优化 + 侧栏菜单改为「令牌管理」 by @zzidcn in #70
- fix(ui): 登录/注册按钮垂直居中与字号 + 令牌管理页标题 + 移除用户入口超管提示 by @zzidcn in #71
- fix(ui): 登录页「忘记密码」展开时位置不再漂移 by @zzidcn in #72
Full Changelog: v1.3.5...v1.4.0
v1.3.5
gh-mirror v1.3.5 — 注册三态 · 设置弹窗 · Token 可见性收紧
一个单二进制、零第三方依赖的自托管加速网关:Docker 镜像 · GitHub 资源 · HuggingFace 权重三类加速一站搞定。v1.3.5 收尾后台账号体系的几处不一致:注册模式合并为无歧义的三态、设置区移回用户管理并改为弹窗表格、Token 可见性收紧为「只看自己的」,用户列表补上邮箱 / 最后登录 / Token 数。
✨ 本版亮点
- 🔐 注册三态(取代两个独立开关):
关闭注册/仅邀请码注册/开放注册一个下拉搞定;旧settings.json自动迁移(关闭→关闭、开启+仅邀请码→仅邀请码、开启→开放),并回写旧字段便于回滚。
修复了一处真实矛盾:此前/user/register不校验注册开关,关闭后仍能打开注册页(提交才被拒);现已统一为「关闭时直接跳回登录页并提示」。 - ⚙️ 设置改为弹窗表格:「用户注册与邮箱」移回「用户管理」页,只显示「⚙️ 设置」按钮与状态摘要(注册模式 / 联系邮箱 / SMTP);点击弹出居中弹窗,内部为两列表格:注册模式、图形验证码、首页隐藏登录、联系邮箱、SMTP(主机/端口/账号/密码/发件人/TLS),底部保存/取消。SMTP 密码不回显、留空保持不变。服务管理页只保留「邀请码管理」。
- 🛡️ Token 可见性收紧:任何角色(含超级管理员)在 Token 管理页、概览统计、侧栏计数、MCP
list_tokens、链接转换中都只看/只用自己的 Token;删除/编辑同样只能操作自己的。管理员(非安装时超管)在任何页面都无法查看他人 Token。 - 📋 用户列表增强:列变为
用户名 / 邮箱 / 角色 / 创建时间 / 最后登录 / Token 数 / 操作。- 邮箱为空显示「—」;最后登录在登录成功时写入
users.json(从未登录显示「—」); - Token 数点击进入该用户的 只读 Token 详情页(仅安装时超管):可查看/复制完整 Token、备注、类型、命中、流量、创建/最近使用,但不能修改或删除。
- 邮箱为空显示「—」;最后登录在登录成功时写入
⚠️ 升级提示(两处行为变化)
- 注册设置变成三态:原「开启注册 + 仅邀请码」会自动换算为三态之一,无需手动改;只是后台界面从两个勾选框变为一个下拉。
- 超管在 Token 管理页也只看到自己的 Token(此前可见全部)。需要查看他人的 Token 时,请走「用户管理 → 该用户 Token 数」进入只读详情页。
✅ 兼容性
- 端点、MCP 地址(
/ai/<用户名>/mcp)、双入口(/admin+/user)、配置与数据卷格式均不变;无破坏性变更。 settings.json/users.json均自动兼容旧格式(新增字段缺省时按 old 值推导),升级只需替换镜像 / 二进制。
🚀 快速开始
# 单容器 + 既有反代(推荐:单文件、真实 env、只绑 127.0.0.1:8080)
cp .env.example .env # 设 ADMIN_PASS / ADMIN_SECRET
docker compose -f docker-compose.standalone.yml up -d
# 或 docker run
docker run -d --name gh-mirror \
-p 127.0.0.1:8080:8080 \
-e ADMIN_USER=admin \
-e ADMIN_PASS='强口令' \
-e ADMIN_SECRET="$(openssl rand -hex 32)" \
-e USER_PATH=/user \
ghcr.io/yufeng8/gh-mirror:v1.3.5启动后:超级管理员访问 http://<域名>/admin;普通用户访问 http://<域名>/user。
纯 HTTP(无 TLS)部署请设
COOKIE_SECURE=false,否则浏览器不下发 Secure cookie,表现为登录无反应 / 反复跳回登录页。
另注意:ADMIN_PASS只是首次启动的种子密码,之后改该环境变量不会更新已存在用户的密码(详见docs/agent-prompt.md)。
🔗 相关链接
- 文档:README.md · docs/ · docs/docker-deploy.md · docs/mcp.md
- 镜像:ghcr.io/yufeng8/gh-mirror
- AI Agent 部署提示词:docs/agent-prompt.md
What's Changed
Full Changelog: v1.3.4...v1.3.5
v1.3.4
gh-mirror v1.3.4 — 角色权限收紧 · 后台设置整合与交互优化
一个单二进制、零第三方依赖的自托管加速网关:Docker 镜像 · GitHub 资源 · HuggingFace 权重三类加速一站搞定。v1.3.4 聚焦账号权限边界与后台设置体验:只有安装时创建的超级管理员能管理用户与角色,后台设置区完成整合、改为可展开表单,并修掉一处会互相覆盖保存的缺陷。
✨ 本版亮点
- 🛡️ 角色权限收紧(行为变更,请留意):新增「唯一超管」概念——只有安装时创建的超级管理员(
ADMIN_USER种子)能进入用户管理、增删用户、改角色、重置密码,以及管理「用户注册与邮箱」「邀请码」。后续被设为「管理员」的账号不再能把超级管理员降级或互相提权;种子超管本身不可被降级 / 删除。服务管理、缓存管理、离线包等运维操作仍对管理员开放。升级提示:若你的实例此前创建了多个
super账号,升级后除ADMIN_USER之外的那些账号将失去用户管理权限(其余权限不受影响)。 - 🧩 后台整合:「用户注册与邮箱」(含 SMTP)与「邀请码管理」从「用户管理」页移到「服务管理」页;左侧导航顺序调整为「服务管理 → 缓存管理 → 用户管理」。
- ⚙️ 设置改为「按钮 + 表单」:「用户注册与邮箱」不再平铺,默认只显示「⚙️ 设置」按钮与状态摘要(注册开 / 关、联系邮箱、SMTP 是否已配置),点开是一个完整表单(注册开关 / 图形验证码 / 首页隐藏登录按钮 / 联系邮箱 / SMTP),底部保存 / 取消;保存后自动展开并回显。SMTP 密码不回显、留空保持不变。
- 🐛 修复设置互相覆盖:此前注册区与 SMTP 区是两个表单却共用一个端点、全量覆盖——点「保存」会清空 SMTP 凭据,点「保存邮箱设置」会把注册开关与联系邮箱重置。现统一为分组 / 单一表单保存。
- 🎨 细节优化:小屏顶部导航汉堡按钮靠右;首页登录 / 注册按钮可在后台隐藏(
/admin、/user仍可直达,不会锁死后台);邀请码管理改为分区布局(批量生成 / 自定义各占一行),导出格式补齐占位符说明与真实示例。
✅ 兼容性
- 端点、MCP 地址(
/ai/<用户名>/mcp)、双入口(/admin+/user)、配置与数据卷格式均不变;无破坏性变更。 - 唯一的行为变更是用户管理权限收紧(见上);升级只需替换镜像 / 二进制。
🚀 快速开始
# 单容器 + 既有反代(推荐:单文件、真实 env、只绑 127.0.0.1:8080)
cp .env.example .env # 设 ADMIN_PASS / ADMIN_SECRET
docker compose -f docker-compose.standalone.yml up -d
# 或 docker run
docker run -d --name gh-mirror \
-p 127.0.0.1:8080:8080 \
-e ADMIN_USER=admin \
-e ADMIN_PASS='强口令' \
-e ADMIN_SECRET="$(openssl rand -hex 32)" \
-e USER_PATH=/user \
ghcr.io/yufeng8/gh-mirror:v1.3.4启动后:超级管理员访问 http://<域名>/admin;普通用户访问 http://<域名>/user。
纯 HTTP(无 TLS)部署请设
COOKIE_SECURE=false,否则浏览器不下发 Secure cookie,表现为登录无反应 / 反复跳回登录页。
🔗 相关链接
- 文档:README.md · docs/ · docs/docker-deploy.md · docs/mcp.md
- 镜像:ghcr.io/yufeng8/gh-mirror
- AI Agent 部署提示词:docs/agent-prompt.md
What's Changed
- fix(admin): 用户注册与邮箱设置分组保存,修复两表单互相覆盖(存注册清空 SMTP / 存 SMTP 重置注册) by @zzidcn in #59
- feat(home): 小屏汉堡按钮靠右 + 首页登录按钮可后台隐藏 by @zzidcn in #60
- refactor(admin): 用户注册与邮箱 / 邀请码管理 移到「服务管理」页 by @zzidcn in #61
- fix(admin): 只有安装时的超级管理员能管理用户/角色(禁止管理员把超管降级) by @zzidcn in #62
- feat(admin): 用户注册与邮箱改为「设置」按钮 + 展开表单(不再平铺) by @zzidcn in #63
- style(admin): 邀请码管理区分组布局 + 导出占位符说明与示例 by @zzidcn in #64
- style(admin): 侧栏「用户管理」挪到最后 by @zzidcn in #65
Full Changelog: v1.3.3...v1.3.4
v1.3.3
gh-mirror v1.3.3 — 反幻觉提示词强化 · 首页提示词取自 GitHub · MCP stdio 修正
一个单二进制、零第三方依赖的自托管加速网关:Docker 镜像 · GitHub 资源 · HuggingFace 权重三类加速一站搞定。v1.3.3 聚焦让 AI Agent 部署不再产生幻觉配置、首页提示词始终同步 GitHub,并修正 MCP stdio 的说明与一处地址推导缺陷。无破坏性变更。
✨ 本版亮点
- 🛡️ AI Agent 提示词升级为「白名单 + 反幻觉总规则」(
docs/agent-prompt.md,内嵌首页#agent;README 中 / 英副本同步):
之前只点名禁止GM_*,Agent 换个前缀就能绕过(实测已冒出GHW-MODE/GHW-DB/GHW-DATA-DIR/GHW-USER-MAX-CONC)。现新增最高优先级的【第零步:反幻觉总规则】——只用白名单、不确定就先 grep 查证、绝不发明任何GM_*/GHW_*/GH_*前缀变量、不发明「看起来合理」的开关(并发 / 线程 / 模式 / 数据库等变量根本不存在,限流用RATELIMIT_ENABLED、内存与 CPU 限制用 docker 层mem_limit)、只读真实存在的文档(点名仓库没有COMPOSE.md/RELEASES.md/INSTALL.md/releases.atom)。 - 🔗 首页提示词改为直接从 GitHub 取最新:不再内嵌展示(旧版要等发版打 tag 才更新)。首页
#agent现在是引导卡片 + 「📋 复制最新提示词(从 GitHub 拉取)」按钮,前端从 jsDelivr → raw.githubusercontent.com 取仓库最新版并写入剪贴板;离线 / 内网实例自动回退镜像内置版本;管理员自定义过(AGENT_PROMPT_FILE/gm-data/agent-prompt.md)则优先用管理员版本。服务端不代拉 GitHub(不暴露实例 IP、不被限流、不拖慢首屏)。 - 🔧 MCP stdio 说明修正 + 一处 bug 修复:澄清
gh-mirror mcp操作的是本机数据目录、不是远程网关的遥控器(远程部署请用 HTTPPOST /ai/<用户名>/mcp);Docker 镜像无 shell,不能docker exec运行 stdio。并修复defaultBase对LISTEN=0.0.0.0:8080推导出http://0.0.0.0:8080(不可访问地址)导致convert_link生成坏链接的缺陷,现已归一为127.0.0.1。 - 📝 示例与文档同步:
.env.example(根 +deploy-docker)补全LISTEN/CACHE_DIR/TOKENS_FILE/DOCKER_ENABLED等真实变量,并把禁令升级为「任何非白名单前缀」;docs/docker-deploy.md反面教材加入GHW_*并新增「给 AI Agent / 自动部署」指引(含不要验证 gh-mirror 不代理的端点);docker-compose.standalone.yml示例镜像同步到 v1.3.2 起的最新正式版。
⚠️ 为什么做这些
第三方 AI Agent 自动部署时反复臆造环境变量:GM_* 之后又冒出 GHW-MODE / GHW-DB / GHW-DATA-DIR / GHW-USER-MAX-CONC(程序一个都不读,所谓「1GB 内存调低并发」完全不生效),还会去读仓库里根本不存在的文档、枚举验证 gh-mirror 不代理的端点(/hf/*/discussions、/hf/*/pulls/*/diff 必然 404)并误判安装失败。v1.3.3 用「白名单 + 先查证再使用」从源头堵住,并让首页提示词始终等于仓库最新版,不必等发版。
✅ 兼容性
- 端点格式、MCP 地址(
/ai/<用户名>/mcp)、双入口(/admin+/user)、配置与数据卷格式均与 v1.3.2 一致。 - 无破坏性变更;从 v1.3.2 升级只需替换镜像 / 二进制。
🚀 快速开始
# 单容器 + 既有反代(推荐:单文件、真实 env、只绑 127.0.0.1:8080)
cp .env.example .env # 设 ADMIN_PASS / ADMIN_SECRET
docker compose -f docker-compose.standalone.yml up -d
# 或 docker run
docker run -d --name gh-mirror \
-p 127.0.0.1:8080:8080 \
-e ADMIN_USER=admin \
-e ADMIN_PASS='强口令' \
-e ADMIN_SECRET="$(openssl rand -hex 32)" \
-e USER_PATH=/user \
ghcr.io/yufeng8/gh-mirror:v1.3.3启动后:超级管理员访问 http://<域名>/admin;普通用户访问 http://<域名>/user。
纯 HTTP(无 TLS)部署请设
COOKIE_SECURE=false,否则浏览器不下发 Secure cookie,表现为登录无反应 / 反复跳回登录页。
🔗 相关链接
- 文档:README.md · docs/ · docs/docker-deploy.md · docs/mcp.md
- 镜像:ghcr.io/yufeng8/gh-mirror
- AI Agent 部署提示词:docs/agent-prompt.md
What's Changed
- docs(agent): 提示词加反幻觉总规则与白名单(防 GHW_/GM_ 幻觉 + 文档/端点清单) by @zzidcn in #56
- feat(home): 首页提示词改为从 GitHub 拉取最新(取消内嵌展示,带离线兜底) by @zzidcn in #57
- fix(mcp): stdio 适用前提澄清(非远程遥控器)+ defaultBase 修复 0.0.0.0 推导 by @zzidcn in #58
Full Changelog: v1.3.2...v1.3.3
v1.3.2
gh-mirror v1.3.2 — 部署脚手架与 AI Agent 提示词完善
一个单二进制、零第三方依赖的自托管加速网关:Docker 镜像 · GitHub 资源 · HuggingFace 权重三类加速一站搞定。v1.3.2 在 v1.3.1 基础上聚焦部署体验与「纠正第三方 AI Agent 幻觉配置」,无代码逻辑变更、无破坏性变更。
✨ 本版亮点
- 🐳 新增
docker-compose.standalone.yml(单容器最小正确配置):只暴露127.0.0.1:8080、使用真实环境变量(ADMIN_*/USER_PATH/CACHE_*/LISTEN/COOKIE_SECURE)、不内置 nginx、不占主机 80/443,配合根目录.env.example即可docker compose -f docker-compose.standalone.yml up -d。专为「机器已有 nginx / KPanel / CDN 反代」场景,也供 AI Agent / 自动部署直接选用,免于自己补端口时连带编出无效变量。 - 📝
.env.example补全真实变量并加警示(根 +deploy-docker):补齐USER_PATH等可选项;顶部明确「主服务只认这些变量」,点名GM_DATA_DIR/GM_PROXY_*/GM_ALLOWED_NETWORKS/GM_ADMIN_PASSWORD等一律不被读取(唯一GM_开头的是GM_MCP_TOKEN,仅用于gh-mirror mcp子命令)。 - 📄
docs/docker-deploy.md新增「最小单文件 compose」小节:推荐standalone.yml,并附GM_*幻觉配置的反面教材说明。 - 🤖 AI Agent 提示词同步:
docs/agent-prompt.md(内嵌首页 #agent 区块)+ README 中/英副本 + 首页 #deploy 示例——A 场景明确指向standalone.yml,新增「严禁臆造 GM_ 前缀变量」硬约束。
⚠️ 为什么做这些
某些第三方 AI Agent 自动部署时,会臆造出一大堆 GM_DATA_DIR、GM_PROXY_MAX_*、GM_PROXY_MAX_PROXY_*、GM_ALLOWED_NETWORKS、GM_ADMIN_PASSWORD 等环境变量——这些程序一概不读取(等于无效配置,还可能把明文密码写进 compose)。v1.3.2 通过「给一份开箱即用的正确配置 + 在文档 / 提示词 / 示例里明确真实变量清单与禁令」从源头降低这类幻觉。
✅ 兼容性
- 端点格式、MCP 地址(
/ai/<用户名>/mcp)、双入口(/admin+/user)均与 v1.3.1 完全一致。 - 无破坏性变更;从 v1.3.1 升级只需替换镜像 / 二进制,配置与数据卷不变。
🚀 快速开始
# 方式一:单容器 + 既有反代(推荐,已含正确 env)
cp .env.example .env # 设 ADMIN_PASS / ADMIN_SECRET
docker compose -f docker-compose.standalone.yml up -d
# 方式二:docker run(与 v1.3.1 相同)
docker run -d --name gh-mirror \
-p 127.0.0.1:8080:8080 \
-e ADMIN_USER=admin \
-e ADMIN_PASS='强口令' \
-e ADMIN_SECRET="$(openssl rand -hex 32)" \
-e USER_PATH=/user \
ghcr.io/yufeng8/gh-mirror:v1.3.2启动后:超级管理员访问 http://<域名>/admin;普通用户访问 http://<域名>/user。
🔗 相关链接
- 文档:README.md · docs/ · docs/docker-deploy.md
- 镜像:ghcr.io/yufeng8/gh-mirror
- AI Agent 部署提示词:docs/agent-prompt.md
What's Changed
- docs(deploy): 新增单容器最小配置 standalone + 纠正 GM_* 幻觉变量 by @zzidcn in #54
- docs(agent): AI Agent 提示词同步 standalone + 加 GM_ 禁令 by @zzidcn in #55
Full Changelog: v1.3.1...v1.3.2