Repository navigation
v0.2.5 — One-click native CPAMP panel installation
v0.2.5:插件内一键安装 CPAMP 原生面板
现在怎样安装
同机二进制部署:升级插件 → 打开插件控制台「设置 → CPAMP 原生面板」→ 点击「安装原生面板」→ 首次切换后重启 Manager Server → 点击「检查生效状态」。现有 API key 凭证无需重新添加,再在原生列表、卡片或详情额度页刷新额度。
原生页面已内置到动态库,因此插件商店只安装动态库也能使用此入口,无需另下载 management.html 或手动 export PANEL_PATH。OAuth 仍使用浏览器电脑的 commandcodebridge-login 接收官方 POST 回调。
自动探测和路径入口
- 优先检测 Linux 正在运行的 cpa-manager-plus、实际 config.json 和 PANEL_PATH。
- 官方默认目录 ~/cpa-manager-plus;managed native 使用 run.sh 的活动 runtime 标记;直接解压运行时使用二进制旁的 config.json。
- 插件设置页和 CPA 插件配置项新增 cpamp_install_dir、cpamp_config_path、cpamp_panel_path,可修改目录和文件位置。
- 安装/检查按钮会先保存路径,多实例要求明确选择。
- 自动备份原配置和页面,只修改 panelPath,保留其他配置及权限;写入失败回滚,配置发生并发修改时拒绝覆盖。
- 已有外部面板时直接替换并检查实际 HTTP 页面;首次内嵌页面切换需要重启 Manager Server。
此功能操作 CPA 插件所在主机可读写的文件。Manager Server 位于另一台机器或不共享目录的容器时,仍需在其所在主机安装面板。目录权限不足会给出明确错误,不更改服务运行用户或管理密钥。
验证
- Go race/vet、路径持久化、活动 runtime、私有备份、重复安装、并发修改拒绝、失败回滚、HTTP 内容一致性检查。
- 实际 CPA v8.0.23 与官方 CPAMP v1.14.0 Linux 二进制联测:检测 → 内置页面安装 → 备份 → 重启 → 实际 HTTP 页面完全一致;已有 PANEL_PATH 页面替换立即生效。
- 浏览器验证路径修改后直接安装,并显示实际配置/页面/备份路径。
- 四平台原生集成、CPAMP 前端构建及统一校验;所有原生包的内置页面摘要与独立前端包一致,附上游 CPAMP 许可证。
- 产物来自干净主分支 CI,未部署或修改用户目标服务器。
手动安装和异机部署仍可使用独立 cpamp-web.zip。详细说明见 docs/DEPLOYMENT.md。