Repository navigation
Releases
Releases · guangzan/magpie-gateway-admin
v1.0.1
维护性发布,包内容与 1.0.0 相同:恢复 tag 触发的 npm 发布 job,改走 OIDC Trusted Publisher,之后打 v* tag 即自动发布,并附带 provenance。
安装方式不变:
magpie plugin add npm:magpie-gateway-admin- npm:https://www.npmjs.com/package/magpie-gateway-admin
- 要求、功能与 1.0.0 相同,见上一版说明。
v1.0.0
给 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-adminnpm 上的包: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。
