Skip to content

Releases

v1.4.5

Choose a tag to compare

@github-actions github-actions released this 19 Oct 08:43

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)。

🔗 相关链接



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

Choose a tag to compare

@github-actions github-actions released this 19 Oct 07:51

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)。

🔗 相关链接



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

Choose a tag to compare

@github-actions github-actions released this 19 Oct 07:09

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)。

🔗 相关链接



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

Choose a tag to compare

@github-actions github-actions released this 19 Oct 06:20

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)。

🔗 相关链接



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

Choose a tag to compare

@github-actions github-actions released this 19 Oct 05:36

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:方式一标题标注推荐首选,新增可一键复制的 mcpServers JSON(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)。

🔗 相关链接



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

Choose a tag to compare

@github-actions github-actions released this 19 Oct 05:12

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 仍可直达)

⚠️ 升级提示(三处行为变化)

  1. 注册设置变成三态:原「开启注册 + 仅邀请码」自动换算,无需手动改;后台界面从两个勾选框变成一个下拉。
  2. 超管在令牌管理页也只看到自己的 Token(此前可见全部)。查看他人请走「用户管理 → 该用户 Token 数」(只读详情)。
  3. 后台界面有较大调整:设置入口在用户管理页顶部(弹窗表单)、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)。

🔗 相关链接



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

Choose a tag to compare

@github-actions github-actions released this 19 Oct 03:57

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、备注、类型、命中、流量、创建/最近使用,但不能修改或删除。

⚠️ 升级提示(两处行为变化)

  1. 注册设置变成三态:原「开启注册 + 仅邀请码」会自动换算为三态之一,无需手动改;只是后台界面从两个勾选框变为一个下拉。
  2. 超管在 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)。

🔗 相关链接



What's Changed

  • feat(admin): 注册三态 + 设置弹窗表格 + Token 仅本人可见 + 用户列表邮箱/最后登录/Token 数 by @zzidcn in #66

Full Changelog: v1.3.4...v1.3.5

v1.3.4

Choose a tag to compare

@github-actions github-actions released this 19 Oct 03:03

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,表现为登录无反应 / 反复跳回登录页。

🔗 相关链接



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

Choose a tag to compare

@github-actions github-actions released this 18 Oct 19:21

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 操作的是本机数据目录、不是远程网关的遥控器(远程部署请用 HTTP POST /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,表现为登录无反应 / 反复跳回登录页。

🔗 相关链接



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

Choose a tag to compare

@github-actions github-actions released this 18 Oct 07:57

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。

🔗 相关链接



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