插件管理
插件管理用于安装、启用、配置和排查 CPA 插件。CPAMP 提供统一入口，让你查看插件状态、配置项和插件页面资源。
本页说明如何在面板里安装、启用、配置和排查插件。
页面结构
插件管理通常分为两个入口：
- 已安装插件：查看当前运行时发现的插件、状态、配置和页面资源。
- 插件商店：从配置的商店源查看并安装插件。
如果插件系统被全局关闭，页面会提示 plugins.enabled 的状态。此时即使某个插件实例配置为启用，也不会真正生效。
已安装插件
- 查看已安装插件、版本、作者、状态和配置项。
- 启用或停用插件。
- 编辑插件配置、优先级和启用状态。
- 根据插件声明的字段填写字符串、数字、布尔、数组或对象。
- 发起插件提供的 OAuth 登录。
- 打开插件提供的页面。
- 删除插件配置或插件文件。
保存配置后，如果页面提示需要重启，按部署方式重启 CPA 或 Manager Server。不要只刷新浏览器。
插件商店
插件商店依赖 plugins.store-sources 和可选的商店认证配置。常见操作：
- 刷新商店列表。
- 查看插件名称、版本、来源和说明。
- 安装或更新插件。
- 处理需要认证的商店源。
安装后回到已安装插件列表确认状态。插件文件所在目录需要持久化，否则容器重建后可能丢失。
启用前检查
- CPA 已启用插件功能。
- 插件目录在容器或宿主机上持久化。
- 插件支持当前系统平台和架构。
- 插件需要的配置项已经填写。
- 如果插件提供 OAuth 或页面资源，反向代理已包含
/v0/resource/plugins/*到 CPAMP。
插件能否运行取决于 CPA 运行时能力和插件自身兼容性。CPAMP 提供管理入口，但不能保证插件一定支持当前 CPA 版本、系统平台或架构。
插件页面空白
常见原因：
- 插件未启用或未注册。
- 插件配置缺失。
- 反向代理没有把
/v0/resource/plugins/*交给 CPAMP。 - 插件资源文件缺失或版本不兼容。
先到 反向代理 检查路径边界，再查看日志页面中的运行时错误。