外观
错误码
sytp update、sytp verify、Docker 安装的管理命令与节点程序更新时,没有通过检查会在说明后面的括号里写出代码,例如:
text
不能安装 v1.1.0:v1.1.0 比本机的 v1.1.1 旧:降级要加 --allow-downgrade(code downgrade;可用的参数 --allow-downgrade)按括号里的代码(这里是 downgrade)在下面的表里查含义与处理办法。没有通过检查时不会有任何改动(退出码 1),面板照常运行。
先做这几件事
| 遇到的情况 | 先做什么 |
|---|---|
发布包检查未通过(package:…)、签名无效(signature)、哈希不符 | 不要安装。从厂商的下载站重新下载,按安全核对核对 sha256;只核对、不安装可以用 sytp verify <发布包> |
连不上下载站或下载太慢(unreachable、slow) | 检查服务器能否连上下载站(curl -I https://dl.ikitten.net/sytp/keys.json),以及「授权与更新」→「网络与诊断」里的代理设置;下载太慢时可以在别处下载好发布包,再 sytp update <发布包>(离线与内网) |
不能安装这个版本(downgrade、needs_intermediate、yanked、after_service 等) | 看下面第一张表:每一条写着为什么、能不能越过、用哪个参数 |
节点不能远程更新、提示缺少本版的 release.json 或节点程序不一致 | 在面板服务器上重新安装本版:sytp update --online --reinstall(不能联网时 sytp update --reinstall <本版的发布包>) |
签名密钥被吊销(revoked)、不认识的密钥(unknown_key) | 能联网时直接 sytp update --online(它先取下载站最新的密钥目录);装本地的发布包时,激活了的面板先在「授权与更新」点「立即校验」,没有激活的等它检查更新时取目录(每天最多一次),再装。见下面的签名与证书 |
| 上次的升级没有完成 | 普通安装 sytp update --recover,Docker 安装 sytp update --resume 或 --rollback(见回滚与没做完的升级) |
仍然解决不了时,把命令的完整输出与 sytp version --json(Docker 安装:/opt/sytp/app/sytp version --json)的结果发给我们(Telegram @sytpchannel)。
授权(激活、校验、试用)的提示不用这些代码:按「授权与更新」页上的说明处理,见激活授权;连不上授权站时,在同一页的「网络与诊断」里点「诊断」。
不能安装这个版本
sytp update、sytp verify 与 Docker 安装的管理命令在核对通过之后,按本机的情况判断能不能装,不能装时显示「不能安装 v…:…(code …;可用的参数 …)」。括号里写着能越过这条规则的参数;写着「不能越过」的没有参数可用。
| 代码 | 含义 | 怎么办 |
|---|---|---|
downgrade | 要装的版本比本机的旧(降级)。 | 确实要退回旧版本时加 --allow-downgrade。数据库不会回退:新版本加的表与字段留在库里,旧版本照常使用。 |
same_version | 要装的就是本机现在的版本。 | 要补齐被删或被改的文件时加 --reinstall 重新安装同一版本;否则不用做什么。 |
needs_intermediate | 这个版本要求本机先升级到某个中间版本(说明里写着是哪个)。 | 先装说明里的那个版本,再装这个;确实要跳过时加 --force。 |
yanked | 这个版本已被厂商撤回(说明里写着理由)。 | 改装更新的版本。确实要装时加 --allow-yanked,并在终端里按提示输入版本号确认。 |
after_service | 这个版本发布于本机授权的更新服务期截止之后。 | 续费之后再装;确实要装时加 --force。安全更新在服务期之后照常可以装(授权写明不提供的除外)。 |
channel | 本机用的是 stable 渠道,而这个版本是 beta(预发布)渠道的。 | 确实要装 beta 版本时加 --channel beta。 |
channel_not_allowed | 本机的授权不提供这个渠道的更新。 | 改装授权提供的渠道的版本;确实要装时加 --force。 |
flavor | 这不是授权版的发布包(或签名文档写的产品不对)。 | 不能越过。从厂商的下载站重新下载授权版的发布包(安装)。 |
发布包检查未通过
sytp update <发布包>、sytp verify <发布包> 与在线升级下载的发布包没有通过逐个文件的核对时,显示「发布包检查未通过:…(code package:…)」。只要有一处不对,整个包都不会装。
| 代码 | 含义 | 怎么办 |
|---|---|---|
package:arch | 本机的架构不是授权版支持的(只支持 Linux 的 amd64 与 arm64)。 | 换一台 amd64 或 arm64 的 Linux 服务器。 |
package:elf | 包里的程序不是这台服务器的架构(或不是 Linux 程序)。 | 换成对应架构的发布包:uname -m 为 x86_64 用 amd64 的,aarch64 用 arm64 的。 |
package:gzip | 文件不是完整的发布包(下载不完整,或不是 gzip 压缩的包)。 | 重新下载发布包,并按安全核对核对 sha256。 |
package:tar | 发布包已损坏。 | 重新下载发布包,并按安全核对核对 sha256。 |
package:limit | 发布包的大小、解开之后的大小或文件个数超过上限。 | 这不是厂商的发布包:从厂商的下载站重新下载,并核对 sha256。 |
package:format | 包里有不是标准格式的条目。 | 这不是厂商打出的包:从厂商的下载站重新下载,并核对 sha256。 |
package:order | 包里的签名文件(release.json 与 release.json.sig)缺少,或不在包的开头。 | 这不是厂商打出的包(原版的发布包也会这样):从厂商的下载站重新下载授权版的发布包。 |
package:name | 包里有文件不在顶层目录 sytp/ 下,或路径写法不对。 | 这不是厂商打出的包:重新下载,并核对 sha256。 |
package:dir | 包里的目录重复,或多了签名清单之外的目录。 | 包被改动过:重新下载,并核对 sha256。 |
package:type | 包里有普通文件与目录之外的东西(如链接)。 | 包被改动过:重新下载,并核对 sha256。 |
package:extra | 包里多了厂商签名的清单里没有的文件。 | 包被改动过:重新下载,并核对 sha256。 |
package:dup | 包里同一个文件出现了两次。 | 包被改动过:重新下载,并核对 sha256。 |
package:missing | 厂商签名的清单列着的文件,包里没有。 | 包不完整或被改动过:重新下载,并核对 sha256。 |
package:size | 某个文件的大小与厂商签名的清单不符。 | 包被改动过:重新下载,并核对 sha256。 |
package:sha256 | 某个文件的内容(sha256)与厂商签名的清单不符。 | 包被改动过:重新下载,并核对 sha256。 |
package:mode | 某个文件的权限与厂商签名的清单不符。 | 包被改动过:重新下载,并核对 sha256。 |
package:version | 包里的 VERSION 文件与签名写的版本不符。 | 包被改动过:重新下载,并核对 sha256。 |
package:extract | 核对通过的文件写不进目标目录(磁盘满、没有权限,或目录不是空的)。 | 检查磁盘空间(df -h)与目录的权限;sytp verify --extract 的目录要是不存在的或空的目录。 |
签名文档不合规
发布包里、下载站上的签名文档(release.json、manifest.json、版本索引与它们的 .sig)没有通过核对时,sytp update、sytp verify 显示「(code release:…)」,节点程序更新时显示「厂商签名的发布文档验不过:…(release:…),已拒绝更新」。冒号之后可能还有出问题的字段名。
| 代码 | 含义 | 怎么办 |
|---|---|---|
release:sig:<字段> | 签名文件(.sig)的格式不对。 | 文件不完整或不是厂商的:重新下载;节点上出现时在面板上重新安装本版(sytp update --reinstall)。 |
release:purpose | 签名的用途与文件不符(拿别的文件的签名冒充)。 | 文件被调换过:从厂商的下载站重新下载。 |
release:format | 签名文档的格式比本机的程序新,本机认不出。 | 先把面板升级到较新的版本(按升级逐步升级),再装这个版本。 |
release:field:<字段> | 签名文档里的某个字段无效。 | 文件不是厂商的或已损坏:重新下载。 |
release:time:<字段> | 签名文档里的日期先后不对。 | 文件不是厂商的或已损坏:重新下载。 |
release:product | 签名文档不属于本产品。 | 从厂商的下载站重新下载 SYTP 的发布包。 |
release:flavor | 签名文档不是授权版的。 | 从厂商的下载站重新下载授权版的发布包。 |
release:chain:<字段> | 版本索引、清单与 release.json 之间对不上(如版本号、sha256 不同)。 | 下载站或镜像上的文件不完整、混了不同版本的:稍后重试;用自己的镜像时重新同步。 |
release:unprovisioned | 本机的程序没有内置厂商的根公钥,核对不了签名(不是厂商发布的构建)。 | 用厂商的发布包重新安装(安装、升级)。 |
签名与证书
核对签名文档的签名与签名密钥的证书时出的问题,写在说明后面的括号里(如「(code signature)」,节点程序上是「(signature)」)。
| 代码 | 含义 | 怎么办 |
|---|---|---|
signature | 签名无效:文件被改动过,或签名不是厂商的。 | 不要安装:从厂商的下载站重新下载,并按安全核对核对 sha256;节点上出现时在面板上重新安装本版(sytp update --reinstall)。 |
unknown_key | 签名用的密钥本机不认识(目录里没有它的证书)。 | 能联网时直接 sytp update --online(它先取下载站最新的密钥目录)。装本地的发布包时:激活了的面板在「授权与更新」点「立即校验」(授权站有更新的密钥目录时当场取来),几分钟后再试;没有激活或离线激活的面板在检查更新时取目录,每天最多一次。仍然不行时联系我们。 |
revoked | 签名用的密钥已被厂商吊销。 | 不要安装这个包:厂商已用新的密钥发布了修订版本。改装最新版本:能联网时直接 sytp update --online(它先取下载站最新的密钥目录)。装本地的发布包时:激活了的面板在「授权与更新」点「立即校验」(授权站有更新的密钥目录时当场取来),几分钟后再试;没有激活或离线激活的面板在检查更新时取目录,每天最多一次。 |
cert_time | 文档的日期不在签名密钥的证书有效期内。 | 文件不是厂商的或已损坏:重新下载。 |
cert_use | 签名密钥的证书不是用来签发布文档的。 | 文件不是厂商的:从厂商的下载站重新下载。 |
cert_conflict | 签名密钥的几份证书互相矛盾。 | 让面板取到厂商最新的密钥目录再试:能联网时直接 sytp update --online(它先取下载站最新的密钥目录)。装本地的发布包时:激活了的面板在「授权与更新」点「立即校验」(授权站有更新的密钥目录时当场取来),几分钟后再试;没有激活或离线激活的面板在检查更新时取目录,每天最多一次。仍然出现请联系我们(Telegram @sytpchannel)。 |
malformed | 签名或证书的格式不对。 | 文件不完整或不是厂商的:重新下载。 |
tag | 签名里的证书不是发布证书。 | 文件不是厂商的:重新下载。 |
kid | 签名或证书里的密钥编号无效。 | 文件不是厂商的:重新下载。 |
weak_key | 证书里的公钥不可用。 | 文件不是厂商的:重新下载。 |
json:<规则> | 文档不是规范的 JSON(损坏或被改动过)。 | 重新下载。 |
missing:<字段> | 证书或文档缺少必填的字段。 | 文件不完整或不是厂商的:重新下载。 |
field:<字段> | 证书或文档里的某个字段无效。 | 文件不是厂商的或已损坏:重新下载。 |
version | 证书的格式版本本机认不出。 | 把面板升级到较新的版本再试。 |
other | 核对时出了别的错。 | 重试一次;仍然出现请把完整的输出发给我们(Telegram @sytpchannel)。 |
在线取版本信息
sytp update --online 取不到能用的版本索引时显示「取不到能用的版本索引(stable 渠道):<下载站>:<代码>(…)」,每个下载站或镜像一段;面板「授权与更新」页的「版本与更新」里检查失败的原因是同样的几种。
| 代码 | 含义 | 怎么办 |
|---|---|---|
unreachable | 连不上下载站或镜像,或它的回答不是正常的内容。 | 检查服务器能否访问下载站(curl -I https://dl.ikitten.net/sytp/keys.json)与代理的设置(「授权与更新」→「网络与诊断」);内网的面板可以用自己的镜像(离线与内网)。 |
bad_sig | 下载站或镜像上的版本索引签名验不过。 | 稍后重试;用自己的镜像时重新同步。一直出现请联系我们。 |
bad_doc | 版本索引或某个版本的清单内容不对,那个版本被跳过。 | 稍后重试;用自己的镜像时重新同步。 |
behind | 镜像上的版本索引还没有本机现在的版本(镜像没有同步)。 | 稍后重试;用自己的镜像(SYTP_UPDATE_MIRRORS)时先把它同步到最新。 |
replay | 镜像给出的版本索引比这台面板见过的旧(可能是有人拿旧索引冒充),没有采用。 | 稍后重试;一直出现说明镜像或网络被人动过,请联系我们。 |
serial_jump | 镜像给出的版本索引的序号比见过的大太多,没有采用。 | 不要强行升级,请联系我们(Telegram @sytpchannel)。 |
本版的文件与下载
面板核对本机这一版的 release.json 与节点程序(「版本与更新」里显示),以及下载发布包、文档时出的问题。
| 代码 | 含义 | 怎么办 |
|---|---|---|
missing | 要核对的文件不存在(如 sytp verify 给的路径不对,或本机缺少本版的 release.json)。 | 核对文件的路径;面板缺少本版的 release.json 时按「版本与更新」里给出的命令补上(sytp update --reinstall)。 |
dev | 本机的面板是开发构建,没有厂商签名的 release.json。 | 用厂商的发布包重新安装(安装)。 |
version_mismatch | 本机的 release.json 与面板的版本不一致。 | 重新安装本版:sytp update --reinstall <本版的发布包>,能联网时 sytp update --online --reinstall。 |
agents_mismatch | 面板目录里的节点程序与厂商签名的 release.json 不一致(被改动过),节点不能远程更新。 | 重新安装本版:sytp update --reinstall <本版的发布包>,能联网时 sytp update --online --reinstall。 |
too_large | 下载的内容超过了应有的大小。 | 下载站或代理给出的内容不对:稍后重试,或换一个镜像。 |
redirect | 下载时的跳转不合规(跳转太多次,或从 https 跳到 http)。 | 检查代理(「授权与更新」→「网络与诊断」)与内网镜像(离线与内网)的设置。 |
slow | 下载太慢(60 秒内平均低于 20 KiB/s)或超过 30 分钟,已换下一个地址。 | 检查网络与代理;下载一直很慢时可以先在别处下载发布包,再用 sytp update <发布包> 安装(离线与内网)。 |
http:<状态码> | 下载站或镜像回答了错误的 HTTP 状态码(如 404:文件不在)。 | 稍后重试;用自己的镜像时确认它同步了需要的版本。 |