> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cyberun.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 升级

> Cyberun 版本如何发布、运维方如何应用 —— 发布节奏、补丁/次/大版本边界,以及大版本发布对许可证意味着什么。

Cyberun 在三条独立通道上发布。运维方通过拉取新产物、替换正在运行的二进制或容器镜像并重启来应用升级。跨通道兼容性由大版本号管控。

## 发布通道

| 通道    | 标签模式           | 发布内容                                                                                                 |
| ----- | -------------- | ---------------------------------------------------------------------------------------------------- |
| Cloud | `vX.Y.Z`       | 云侧二进制:API 服务器、代理网关、许可证服务。                                                                            |
| Agent | `agent/vX.Y.Z` | 无头代理二进制。通过公开的安装脚本分发。                                                                                 |
| CLI   | `cli/vX.Y.Z`   | `cyberun` 命令行客户端,从 `releases.cyberun.cloud/cli/install.sh` 安装。见 [Cloud → CLI](/zh/cloud/guides/cli)。 |

这些通道按自己的节奏发布 —— Cyberun 可以推送代理的修复而无需强制控制面升级,反之亦然。**大版本号**(开头的 `vN`)是兼容性边界。

## 版本策略

* **补丁(`v1.2.3` → `v1.2.4`)**:仅修复缺陷。直接替换。无许可证变更,无架构迁移。
* **次版本(`v1.2.x` → `v1.3.0`)**:增量功能、新的可选能力、自动处理的架构新增。直接替换。
* **大版本(`v1.x.x` → `v2.0.0`)**:任何破坏既有契约或要求重新颁发许可证的变化。始终附带说明迁移步骤与架构变更姿态的发布说明。

运维方应让三条通道的大版本号保持一致(云侧 `vN.*`、代理 `vN.*`、CLI `vN.*`),以使许可证通道保持连贯。不支持大版本号混搭的部署。

## 云侧升级

对于容器部署 —— 推荐形态 —— 升级走标准的"拉取、部署、观察"流程:

1. 阅读发布说明。大版本会显式标注迁移与许可证续订触发点。
2. 拉取三个组件(API 服务器、网关、许可证服务)各自的新镜像标签。
3. 滚动部署(按你的编排器约定进行滚动重启)。云侧进程在进程级别无状态 —— 滚动期间运行多个副本是安全的。
4. 验证:许可证服务仍校验该部署;API 服务器的运行版本与你拉取的相符。

零停机控制面升级流程,包括副本间的架构迁移协调,正在作为公开部署指南的一部分编写中。在它发布之前,推荐模式是"短暂计划维护窗口、完整滚动重启、随后验证"。

## 代理升级

每台代理主机可通过重新运行安装脚本独立升级:

```sh theme={null}
# Linux / macOS — rootless re-run; no sudo, comfyui is the default tool
curl -sL https://releases.cyberun.cloud/agent/install.sh | bash -s -- \
    --api-key ak-…
```

安装器换上新的二进制并重新应用服务定义;ComfyUI 与模型缓存被保留。macOS 上 launchd 代理会立即重新加载;Linux 上需重启服务(`systemctl --user restart cyberun-agent-<tool>`)以加载新二进制。整队升级工具正在编写中;在此之前,把代理当作"牲畜"处理,通过配置管理工具(Ansible、Salt、Chef 等)重新运行安装器。

## 架构迁移

云侧二进制在启动时自动处理增量架构变化。破坏性或回填密集的变化通过显式的迁移钩子运行,这类钩子由大版本边界门控 —— 从不出现在补丁或次版本中。

正式的架构迁移运行手册(零停机模式、在线回填、回滚)正在编写中。在它发布之前,计划进行大版本升级的合作伙伴部署会从 Cyberun 收到针对其部署的运行手册。

## 跨大版本的许可证交互

许可证内嵌一个大版本边界。`v1.x` 许可证在每个 `v1.y.z` 发布上都继续生效 —— 补丁与次版本升级不触发续订。跨越大版本(`v1` → `v2`)会刻意轮换平台的指纹盐与内嵌的大版本号;既有许可证在新大版本上校验失败,并会为 `v2` 颁发一份新的许可证。

这是有意为之:大版本发布是商业接缝点,新的授权、新的配额或新的兼容性承诺都在此处生效。把许可证刷新与升级窗口协同 —— 在打大版本升级窗口标签前,请[联系我们](mailto:sales@cyberun.cloud)。

## 备份与 DR

备份叙事(需要捕获哪些状态、恢复流程、多区域复制、RTO/RPO 目标)正在作为独立页面编写中。今天合作伙伴会收到针对其部署的备份运行手册,涵盖:关系型数据库快照、对象存储复制策略、许可证密钥托管。

## 另见

* [架构](/zh/platform/architecture) —— 每个组件升级会影响什么。
* [要求](/zh/platform/requirements) —— 外部依赖,它们的升级节奏需要你与之协同。
* [许可证管理](/zh/platform/license) —— 完整许可证生命周期。
* [代理](/zh/platform/agents) —— 安装 / 重新安装脚本参考。