Cli-Proxy-API-Management-Center

插件商店

管理路径： /plugin-store

插件商店提供插件市场浏览、安装和更新功能。该菜单仅在当前 CPA 能力支持插件时显示。

核心功能与服务

1. 插件浏览：
   • 分类展示官方和社区插件。
   • 插件卡片展示名称、简介、版本、下载量、评分。
2. 插件安装与更新：
   • 一键安装未安装的插件。
   • 已安装插件显示”更新”按钮（当有新版本时）。
   • 安装进度和状态反馈。
   • 插件安装请求最多等待 10 分钟；浏览器不会按普通管理请求的 30 秒超时提前取消。
   • 二进制下载流被代理临时中断时，后端最多自动重试 2 次；服务退出或安装上下文真正超时后不再重试。
3. 插件详情：
   • 查看插件完整描述、作者、依赖项、兼容版本。
   • 用户评价和安装统计。

界面交互与 UI 元素

• 插件卡片网格：图标、名称、简介、安装按钮。
• 安装状态指示：安装中（进度条）/ 已安装 / 可更新。
• 搜索与筛选：按分类或关键字搜索插件。

插件商店的具体实现可能依赖外部插件注册中心 API，如有变动请以实际页面为准。

显示条件

与「插件管理」相同：仅当运行中的 CPA/cpamc 二进制以 CGO 构建并返回 X-CPA-SUPPORT-PLUGIN: 1 时，侧边栏与路由才会开放 /plugin-store。

代理与下载

• 插件商店列表/安装共用后端出站网络配置：plugin-proxy 的 status 决定直连、系统代理、自定义代理或 GitHub 加速器。
• GitHub Release 资源下载常会 302 到带临时 token 查询参数的 CDN 地址；运行时请求允许跟随该签名链接。
• 加速器只改写可下载的 GitHub 资源（github.com releases、raw.githubusercontent.com、CDN 等），不会改写 api.github.com 元数据请求，避免公共加速器共享出口 IP 触发 GitHub REST 限流 403。
• 注册表/清单中声明的永久 artifact URL 仍禁止携带 token/api_key 等敏感 query，避免把长期密钥写进配置。

连接地址与 CPAMC 扩展 API 回退

插件商店、插件代理等二开功能调用 /v0/cpamc/* 扩展 API，该路由只存在于 cpamc 管理后端（默认 :18317），外部 CLIProxyAPI 上没有这些路由。

• 登录时填写的”服务器地址”（apiBase）若指向外部 CLIProxyAPI（external-cpa 直连用法），/v0/cpamc/* 请求会得到 404，页面曾因此误报”当前后端未暴露插件商店 API”。
• 前端 apiClient 的 cpamc 请求族现在会在收到 404 时自动改用面板自身 origin（即提供 /management.html 的 cpamc 后端）重试一次；回退请求不经过全局拦截器，其 401 以普通错误呈现，不会触发全局登出。
• 推荐配置：面板由 cpamc 后端提供时，登录连接地址直接填面板地址（如 http://<host>:18317），CPA 上游连接通过系统配置/setup 向导保存到后端，由 cpamc 统一代理 /v0/management/*。
• 回退仍失败（面板 origin 也没有扩展路由）时，页面保留”未暴露插件商店 API”提示，此时应确认部署的是包含插件商店接口的 cpamc 构建。

This site is open source. Improve this page.