Web UI
项目地址:Cli-Proxy-API-Management-Center
一个官方的基于Web的CLIProxyAPI管理界面。
基础路径:http://localhost:8317/management
设置 remote-management.disable-control-panel 为 true 时,服务器将跳过下载 management.html,且 /management.html 会返回 404,从而禁用内置管理界面。
你可以通过设置环境变量 MANAGEMENT_STATIC_PATH 来指定 management.html 的存储目录。
使用自定义 Web UI
现在支持从自定义 GitHub 仓库获取管理面板。配置示例:
yaml
remote-management:
panel-github-repository: "https://github.com/your-org/your-management-ui"- 仓库地址写法:
https://github.com/<org>/<repo>,程序会自动转换成https://api.github.com/repos/<org>/<repo>/releases/latest调用。 - 也可以直接写 API 地址:
https://api.github.com/repos/<org>/<repo>/releases/latest。 - 后台会定期检查最新 Release,查找名为
management.html的资产并下载到静态目录(默认是配置文件同级的static/,或MANAGEMENT_STATIC_PATH指定的目录)。如资产包含digest字段(推荐使用sha256:<hex>),会用于哈希校验。
在 GitHub 发布自定义 Web UI 的规范
- 构建自定义管理面板,生成单个
management.html(建议将静态资源打包进同一个文件)。 - 创建 GitHub 仓库并推送代码。
- 创建 Release(使用
latest会被自动检测),上传资产文件:- 必须包含文件名
management.html。 - 推荐在资产元数据中填写
digest字段,格式sha256:<文件哈希>,方便校验完整性。
- 必须包含文件名
- 在 CLIProxyAPI 配置中设置
remote-management.panel-github-repository为该仓库地址或对应的 API 地址。 - 重启或热加载配置后,服务器会自动拉取最新的管理面板。