外观
升级
授权版的每个版本都由厂商离线签名:sytp update、面板与节点程序只安装签名核对通过的发布包与节点程序,没有签名或被改过的不装(唯一的例外要在服务器的终端里以 root 明确确认,见仍然存在的风险)。升级之前自动备份,升级之后检查面板是否正常,不正常就自动回滚到原来的版本。
先看「版本与更新」
管理员在侧栏最下面看到「站点名 控制台 · v版本」,点它打开「版本与更新」(「授权与更新」页里也有同样的一块):
- 有新版本时写「有新版本 vX」、旁边一个橙点;有安全更新时红点闪烁,页面顶部另有横幅;
- 每个比本机新的版本:日期、级别(安全 / 推荐 / 常规)、更新说明、需要先升级到的版本、停机时间、要不要更新节点程序、「厂商建议暂缓」;
- 「立即检查」、渠道(stable / beta)、检查间隔,以及对某个版本「7 天内不再提醒」(安全更新不能忽略);
- 最下面给出这台服务器该用的升级命令与下载链接。
面板自己不执行升级:升级在服务器上用下面的命令做。各版本的说明也在更新日志(以面板里显示的为准)。
授权版之间的升级
普通安装
以 root 执行:
bash
sytp update # 终端里:显示当前版本并问「在线检查新版本?」
sytp update --online # 在线:本渠道里最新的、可以直接升级到的版本
sytp update /root/sytp-pro-<V>-linux-amd64.tar.gz # 指定下载好的发布包(离线也用这个)也可以打开 sytp 菜单选第 13 项「更新(在线或指定发布包)」。它依次:
- 检查磁盘空间(不够时列出各处缺多少并停下)、拿升级锁(同一时刻只有一个升级);
- 核对发布包的签名与每个文件,按规则判断能不能装;
- 显示摘要(当前 → 目标、级别、停机时间、更新说明的前 20 行)并请你确认(
--yes不再确认); - 备份到
/var/backups/sytp/sytp-pre-<当前>-to-<目标>-<时间>.tar.gz(这种备份只留最新的 10 份),旧程序留一份/opt/sytp/sytp.old; - 替换、重启,检查健康:180 秒内连续 3 次正常(数据库迁移时最多等 30 分钟);
- 正常:「已升级到 vX」;不正常:自动回滚到原来的版本。
替换、重启、检查与回滚在 systemd 的临时任务里执行:SSH 断开、终端关闭、按 Ctrl+C 都不影响它做完。
Docker 安装
命令相同,在宿主上执行管理命令 sytp update(菜单第 13 项「更新」):在线时由面板容器下载并核对,宿主上的程序再验一次签名;升级之前 sytp backup、把当前的面板镜像标为 sytp-panel:rollback,构建、启动或检查失败时几秒内换回。
Docker 的管理命令没有 --proxy、--shell-proxy 与 --recover:下载的代理同面板(「授权与更新」的「网络与诊断」)。中途被打断时,再执行 sytp update 会先说明上次停在哪一步,只接受 sytp update --resume(用已装好的文件接着构建、启动与检查)或 sytp update --rollback(回到升级之前)。
一键脚本「升级」
再次运行一键安装脚本(安装里的命令),选「升级到最新版本」:已是授权版时,脚本先修好管理命令、核对上次的升级有没有做完,再交给已安装的程序升级到脚本对应的版本(它同样显示摘要、请你确认)。
规则与参数
不能装时显示原因与代码(代码的含义见错误码),以及能越过这条规则的参数:
| 情况 | 缺省 | 能越过它的参数 |
|---|---|---|
| 签名、哈希或包的结构不对 | 拒绝 | 不能 |
| 目标比当前旧 | 拒绝 | --allow-downgrade(先 sytp backup) |
| 目标与当前相同 | 拒绝 | --reinstall(补齐被删或被改的文件,如缺少的 release.json) |
| 当前版本低于目标要求的最低版本 | 拒绝,说明要先装的中间版本 | --online 不给 --version 时先装中间版本(一次一跳,装完再执行一次);--force |
| 目标被厂商撤回 | 拒绝 | --allow-yanked:终端里显示撤回理由,要求输入版本号确认 |
| 目标发布于授权的更新服务期之后 | 拒绝(安全更新照常可装) | --force(建议先续费) |
| 本机是 stable 渠道而包是 beta | 拒绝 | --channel beta |
| 本机的授权不提供这个渠道 | 拒绝 | --force |
在线时 --version V 指定版本、--channel stable 或 --channel beta 指定渠道。sytp update --help 列出全部参数。
只核对、不安装:sytp verify <发布包>(0 通过、1 不通过、2 用法错误)。
退出码
| 退出码 | 含义 |
|---|---|
| 0 | 成功,或已是最新 |
| 1 | 不通过或失败,没有任何改动 |
| 2 | 用法错误 |
| 3 | 升级失败,已回滚到原来的版本 |
| 4 | 回滚也失败:按屏幕上的步骤处理,升级前的备份在 /var/backups/sytp |
回滚与没做完的升级
- 回到上一个版本:
sytp update --rollback,回到上一次sytp update之前的版本(只保留一代)。数据库不回滚:表结构只增不删,旧版本能用新的表结构;需要时用升级前的备份sytp restore。 - 断电、进程被杀之后(普通安装):
sytp update --recover,停在替换阶段就换回旧文件,停在检查阶段就重新检查。Docker 用sytp update --resume或--rollback。 - 升级正在进行(如 SSH 断开后重新登录):
sytp update会说明正在进行的那一次与查看进度的命令(journalctl -fu sytp-upgrade-<id>)。等它结束,不要重启服务器或删除文件。 - 没有 systemd 的安装(Supervisor 等):替换之后在进程管理器里重启面板,再执行
sytp update --recover确认;不正常时sytp update --rollback。
节点程序
节点程序的版本与面板分开:节点代码没有变化的面板版本沿用上一版的节点程序,节点不必更新(「版本与更新」里写着要不要更新节点程序)。
- 远程更新:面板「节点管理」里版本标着「可更新」的节点,点「更新」(可以多选批量更新)。节点先向面板取厂商签名的
release.json,核对节点程序的大小、sha256 与版本之后才替换。 - 在节点上:
sytp-agent update(从面板取签名与程序);离线时sytp-agent update <文件>,同目录要有release.json与release.json.sig(见离线与内网)。 - 节点不会悄悄降级:要降级时
sytp-agent update --downgrade,或在节点详情里确认。 - 面板缺少本版的
release.json时,能验签的节点不能远程更新:「版本与更新」会说明原因与补上的命令(通常面板会自动补取)。