升级与迁移

主控、Agent 升级和主控迁移。

📄️查询节点 Agent 版本与升级状态

并发连接所有根节点的 Agent，查询其当前版本和升级运行状态。仅管理员可调用；单个节点连接失败不会使整个查询失败，该节点会在列表中标记为失败并携带错误信息。

从已配置的升级服务器获取当前主控要求的 Agent 版本，并向指定根节点发送升级请求。仅管理员可调用；单个节点时同步发送，多个节点时并发发送。请求中的每个 IP 必须对应一个根节点。

向指定节点的 Agent 请求最近一次升级日志。仅管理员可调用；节点必须存在且 Agent 在 20 秒内响应。

验证目标主控的 SSH 连接和当前管理员密码后，在后台启动主控迁移任务，仅管理员可调用。迁移目标的 Elasticsearch 数据目录必须提供；当 `bt=1` 时，表示同时迁移宝塔环境的 MySQL 数据，必须额外提供 MySQL 连接信息。服务端同一时间只允许一个迁移进程运行。

停止当前服务器上正在执行的主控迁移及其备份、MySQL 导出子进程，仅管理员可调用。服务端先尝试正常终止，等待约 3 秒后再强制终止仍在运行的进程。本接口不接收请求体；即使当前没有迁移进程，也会返回停止成功。

读取当前服务器的主控迁移日志，仅管理员可调用。响应最多包含日志文件的最后 1,000 行，每个数组元素保留原始行末换行符。迁移日志文件尚未生成或不可读取时，服务端会返回非业务异常。

查询当前服务器是否存在正在运行的主控迁移进程，仅管理员可调用。本接口只反映迁移脚本进程是否仍存在，不表示数据迁移是否成功或失败。

查询主控当前版本、可升级的最新版本、所需 Agent 版本和升级程序运行状态，仅管理员可调用。在线模式会向升级服务器请求版本元数据；离线授权模式优先读取本地缓存。响应还包含升级流程所需的主控、日志服务和镜像配置，属于敏感管理数据，不应向非管理员暴露。

启动或停止当前主控的软件升级流程，仅管理员可调用。默认操作为 `start`：服务端获取升级锁后启动升级任务；`stop` 会终止升级脚本及其子进程。本接口不接收请求体。

读取当前服务器主控升级日志的最后 1,000 行，仅管理员可调用。本接口不接收参数，`data` 是一次性返回的日志文本而非逐行数组；升级日志文件尚未生成或不可读取时，服务端会返回非业务异常。