# 在线升级

在面板里升级主控与节点：升级前确认、灰度与一键升级、失败自动回退。

主控和节点的升级都在面板「系统管理 › 升级与维护」里做,无需重新执行安装命令。


## 升级主控
进入「系统管理 › 升级与维护 › 主控升级」,先看当前版本与可升级的新版本,确认后点「升级主控」。升级后如提示需要重启主控,按提示重启。

:::tip
升级前先看更新日志里这个版本是否标了「需重启」,安排在访问低谷时做。
:::

## 升级节点
节点升级支持灰度和一键升级:先挑少数节点升级,观察正常后再放开到全部。灰度阶段与自动回退的细节见[灰度发布与自动回滚](https://www-sa2.kuxitong.com/zh/guide/rollout)。也可以勾选「升级主控时自动升级节点」,主控升完自动带上节点。

节点升级是整包替换:新版本解到独立目录后原子切换。新配置检查不过、或 nginx 重启后没有就绪,节点会自动切回旧版本照常服务,升级单记为失败;上一版留着,面板的「回退」可以随时切回。

升级需要重启 nginx 时,节点先摘出解析、等解析缓存过期后再重启,基本不断流;主控连不上、主控版本较旧或线路组里摘不出这台节点时,会直接重启、短暂断流。节点多时建议在访问低谷分批升级。

节点默认拒绝降级:升级的目标版本比节点当前版本旧时,节点直接拒绝并写明原因。只有升级单上的「回退」,或新建升级时面板提示「将回退到旧版本」并经您确认的,才会退回旧版本。

## 重装也能升
重跑主控的安装命令同样会把主控升到物料站的新版本;命令不变,已有数据不动。

:::warn
一键升级主控只换主控程序和配置,不升级 ClickHouse;ClickHouse 版本只在重跑安装脚本时才会升。
:::

升级过程中如果遇到授权问题,见[授权与增值功能](https://www-sa2.kuxitong.com/zh/guide/license)。