Skip to content

Releases

v1.0.1

Choose a tag to compare

@guangzan guangzan released this 18 Nov 10:45
2749c43

维护性发布,包内容与 1.0.0 相同:恢复 tag 触发的 npm 发布 job,改走 OIDC Trusted Publisher,之后打 v* tag 即自动发布,并附带 provenance。

安装方式不变:

magpie plugin add npm:magpie-gateway-admin

v1.0.0

Choose a tag to compare

@guangzan guangzan released this 10 Nov 07:40

网关用户管理界面

给 magpie 的网关加上多用户管理:批量发 key、限额、模型权限、用量看板。magpie 自带的 Gateway 页面是给单用户准备的(一把共享 key,改不了名、停不了用),这个插件补的是「把网关开给一群人」的那部分——每把 key 有自己的权限、限额和用量。

安装

# npm
magpie plugin add npm:magpie-gateway-admin

# GitHub(不用 npm,直接读仓库里提交的构建产物)
magpie plugin add github:guangzan/magpie-gateway-admin

# 本地目录
magpie plugin add /path/to/magpie-gateway-admin

npm 上的包:https://www.npmjs.com/package/magpie-gateway-admin (1.0.0)。

这一版有什么

  • 批量发 key:一次 1–100 把,名称按前缀自动编号;整批是一个事务,任何一把失败就把这一批已落盘的 key 全部删掉,不留半批没限额的孤儿。
  • 权限配置:模型白名单(openai/*、group/<路由组>)、上游账号、只读、是否允许查看上游账号余额、是否允许签发子 key。
  • 限额:每天 / 每周 / 每月 / N 天 / N 小时,最多五条,可按 tokens 或美元计,也可把缓存读计入 tokens;默认每月 $20 一条。
  • 用量看板:每把 key 今天 / 近 7 天 / 近 30 天的调用数和花费估算;限额状态显示已用 / 上限 / 重置时间,跑满标红,清零不影响日历窗口。
  • 需要关注:限额用尽、接近上限(≥80%)、7 天内到期时列表顶部提示,一键筛选;支持按状态筛选和按名称 / 调用 / 花费 / 限额使用率排序。
  • 交付密钥:创建或轮换后弹一次明文,可逐把复制、复制全部或导出 CSV;列表本身只显示掩码。
  • 模板:把常用的窗口和限额存成模板,最多 40 个,存在配置目录的 plugin-data/magpie-gateway-admin/templates.json,不碰 magpie 自己的配置。
  • 成员自助查用量:直接复用 magpie 网关自带的 /me 页(http://<运行 magpie 的机器>:3425/me),不用额外部署。

插件不替换 magpie 的 Gateway 页面:默认共享 key 仍由 magpie 自己管理,这里管理的是新建的多用户 key。

要求

  • magpie ≥ 0.1.3078(更早的版本没有插件页面)
  • Bun ≥ 1.1(插件按 Bun 运行时编写,magpie 会自动准备;开发本地服务时也需要)
  • 第一次打开会启动插件自己的本机服务,默认 http://127.0.0.1:3478/,只对本机开放;端口被占用时可在插件选项里改 port。

许可

Apache-2.0,见 LICENSE。