一键安装脚本

安装脚本适合第一次部署，或已经有 CPA、只想把 CPAMP 跑起来的环境。它不会直接覆盖已有配置文件；执行前会先展示安装摘要，确认后才写入文件和启动服务。

运行方式

下载脚本后运行：

curl -fsSLO https://raw.githubusercontent.com/seakee/CPA-Manager-Plus/main/bin/install-cpamp.sh
bash install-cpamp.sh

如果需要先查看内容：

less install-cpamp.sh
bash install-cpamp.sh

脚本会按顺序处理：

1. 检查系统、架构、WSL、端口和必要命令。
2. 选择后续操作语言。
3. 选择安装范围：CPA + CPAMP，或仅安装 CPAMP。
4. 选择部署方式：Docker，或 CPAMP 原生包。
5. 生成最小配置文件和本机 secret 文件。
6. 展示摘要，可确认、返回修改或退出。
7. 确认后执行部署。

支持的组合

安装范围	Docker	原生包
CPA + CPAMP	支持	暂不支持
仅 CPAMP	支持	支持

完整安装推荐 Docker。CPAMP 原生包只包含 Manager Server，不包含 CPA 运行时；如果要用原生包，需要先单独部署 CPA。

完整 Docker 安装

选择 CPA + CPAMP 后，脚本会生成：

compose.yaml
.env
secrets/cpamp-admin-key
secrets/cpa-management-key
secrets/cpa-demo-client-key
cliproxyapi/config.yaml
cliproxyapi/auths/
cliproxyapi/logs/

默认生成的密钥格式如下：

CPAMP 管理员密钥: cpamp_ + 32 位字母数字
CPA Management Key: cpa_ + 32 位字母数字
演示客户端 API Key: sk- + 64 位字母数字

重跑脚本时，已有的非空单行 secret 文件会被原样复用；手动管理的密钥不需要符合默认生成格式。

CPA 最小配置会启用远程管理和用量发布：

api-keys:
  - "sk-..."

remote-management:
  secret-key: "cpa_..."
  allow-remote: true

usage-statistics-enabled: true
redis-usage-queue-retention-seconds: 60

生成的 Compose 会按 CPA 镜像的实际工作目录挂载：

./cliproxyapi/config.yaml -> /CLIProxyAPI/config.yaml
./cliproxyapi/auths       -> /root/.cli-proxy-api
./cliproxyapi/logs        -> /CLIProxyAPI/logs

CPA 启动时会把明文 remote-management.secret-key 自动写回为 bcrypt hash，所以 cliproxyapi/config.yaml 需要保持可写。

CPAMP 会通过 Docker secret 读取 CPA Management Key，并使用 Docker 内网地址：

http://cli-proxy-api:8317

这组连接由安装目录中的 compose.yaml 和 secrets/cpa-management-key 管理。打开面板后直接使用 CPAMP 管理员密钥登录，不需要再走首次 setup。

部署完成后打开：

http://<host>:18317/management.html

脚本会在最后打印 CPAMP 管理员密钥。演示客户端 API Key 只用于安装后快速连通性验证，生产客户端建议在面板里重新创建并按用途命名。

仅安装 CPAMP

如果 CPA 已经在运行，选择仅安装 CPAMP。交互向导会优先询问是否现在填写 CPA URL 和 CPA Management Key。

选择“现在填写并跳过首次 setup”后，脚本会把连接写入安装目录：

.env
secrets/cpa-management-key

启动后直接使用 CPAMP 管理员密钥登录，不需要再在面板里填写首次 setup。这个模式是环境管理配置：CPA URL 和 CPA Management Key 来自安装目录，面板不能直接改写这组连接；需要调整时，更新安装目录中的配置和 secret 后重启 CPAMP。

如果选择稍后填写，脚本不会把 CPA Management Key 写入环境文件；打开面板后，在 setup 中填写：

CPA URL
CPA Management Key
请求监控偏好

如果想让连接配置由环境管理，可以在脚本里选择“写入本机 secret 文件并由环境管理”。这种模式下，CPA URL 和 CPA Management Key 来自配置文件，面板不能直接改写这组连接。

Docker 方式仅安装 CPAMP 时，如果 CPA 跑在同一台宿主机上，脚本默认使用：

http://host.docker.internal:8317

Linux 上会同时写入 host.docker.internal:host-gateway，让容器能访问宿主机上的 CPA。CPA 跑在其他机器时，把 CPA URL 改成对应地址即可。

原生包模式

仅安装 CPAMP 时可以选择原生包。脚本会按系统和架构下载 GitHub Release 中的包，生成：

runtime/<package>/
data/
secrets/cpamp-admin-key
run.sh
cpa-manager-plus.service  # Linux
cpa-manager-plus.log
cpa-manager-plus.pid

原生包会以前台程序的方式启动到后台。Linux 会额外生成 cpa-manager-plus.service，可复制到 systemd 服务目录后按你的系统策略启用；macOS 或已有进程管理方式可以继续参考 run.sh。

高级用法

只看计划，不写文件、不启动服务：

CPAMP_DRY_RUN=1 bash install-cpamp.sh

生成配置但不启动：

CPAMP_SKIP_EXECUTE=1 bash install-cpamp.sh

非交互完整 Docker 安装示例：

CPAMP_NON_INTERACTIVE=1 \
CPAMP_CONFIRM=1 \
CPAMP_LANG=zh-CN \
CPAMP_INSTALL_MODE=stack \
CPAMP_DEPLOY_METHOD=docker \
CPAMP_INSTALL_DIR="$HOME/cpa-manager-plus" \
bash install-cpamp.sh

常用变量：

变量	说明
CPAMP_LANG	zh-CN 或 en-US。
CPAMP_INSTALL_MODE	stack 或 cpamp。
CPAMP_DEPLOY_METHOD	docker 或 native。
CPAMP_INSTALL_DIR	安装目录，默认 ~/cpa-manager-plus。
CPAMP_PORT	CPAMP 对外端口，默认 18317。
CPAMP_CPA_PORT	完整 Docker 安装时 CPA 对外端口，默认 8317。
CPAMP_IMAGE	CPAMP Docker 镜像。
CPAMP_CPA_IMAGE	CPA Docker 镜像。
CPAMP_VERSION	原生包版本，默认 latest。
CPAMP_CPA_CONNECTION_MODE	setup 或 env。
CPAMP_CPA_URL	env 模式下的 CPA URL。
CPAMP_CPA_MANAGEMENT_KEY	env 模式下的 CPA Management Key。

重跑和覆盖

脚本会复用已经存在的 secret 文件，但不会默认覆盖 compose.yaml、.env、config.yaml 或 run.sh。如果确定要重新生成配置，可以设置：

CPAMP_OVERWRITE=1 bash install-cpamp.sh

覆盖配置前先备份安装目录，尤其是 secrets/、data/ 和 cliproxyapi/。丢失 data.key 后，已保存的 CPA Management Key 无法恢复。