外观
安全核对
每个版本都由厂商在一台不联网的机器上签名。面板、sytp update 与节点程序只安装签名核对通过的文件(唯一的例外要在服务器的终端里以 root 明确确认,见下面仍然存在的风险)。本页列出根公钥的指纹、各版本文件的 sha256 与最新版本,供你自己核对;也说明签名防得住什么、防不住什么。
自己核对下载的文件
核对 sha256:在下载文件的那台机器上算出 sha256,与本页各版本的文件里的相同:
bash
sha256sum sytp-install.sh sytp-pro-<V>-linux-amd64.tar.gz也可以用版本目录里的 SHA256SUMS 一次核对全部下载的文件(它与本页列的值相同):
bash
sha256sum -c --ignore-missing SHA256SUMS厂商另在 Telegram 频道 @sytpchannel 公布每个版本的安装脚本与发布包的 sha256。两处对得上更放心:本站与下载站在同一台服务器上,频道是另一条渠道。
核对签名:已经装好的面板可以直接核对发布包的签名(只核对,不解开、不执行包里的程序):
bash
sytp verify sytp-pro-<V>-linux-amd64.tar.gz核对内置的根公钥:在面板服务器上运行 sytp version --json(Docker 安装的管理命令只显示版本号,用宿主上的同一个程序 /opt/sytp/app/sytp version --json),输出里 trust 的 root_fps 应与下面根公钥一节列的指纹逐个相同;节点上 sytp-agent version --json 同样列出它内置的根公钥。
根公钥与 keys.json
面板与节点程序只认这些根公钥签发的签名。在服务器上运行 sytp version --json(Docker 安装:/opt/sytp/app/sytp version --json),输出里 trust 的 root_fps 应与下表的指纹逐个相同:
| 根 | 指纹 |
|---|---|
r1 | af9ae4864df59e51 |
r2 | 703a81fcaae299f2 |
roots.json 的 sha256(同 trust 的 roots_sha256):17394b3fa11b888a467cc4bef52050c3df0da24807ff927dcf35851dcea414a7
下载站上的 keys.json(签名密钥的目录,第 1 份)的 sha256:e9199e8f1c52914ca36d180478bf96ad94b095c872ee04f106ad26412f16dd7b。面板随版本内置的那一份记在 trust 的 keys_sha256,目录更新之后两者可以不同。
最新版本
还没有发布过授权版。
各版本的文件
还没有发布过授权版。
签名是怎样串起来的
- 根密钥:厂商有两把根密钥,一直离线保存;它们的公钥内置在面板与节点程序里。
- 发布密钥:根密钥给发布密钥签发证书(写明用途与有效期)。证书、吊销名单与下载站的地址都在签名的密钥目录
keys.json里。发布密钥同样只在不联网的机器上使用。 - 每个版本的三份签名文档:版本索引
channels/<渠道>.json(每个渠道有哪些版本、哪些撤回了)、版本说明manifest.json(级别、更新说明、各文件的 sha256)、文件清单release.json(发布包里每个文件的路径、大小、sha256 与权限),各带一个.sig签名文件。 - 核对:面板与节点程序依次核对「签名 → 发布密钥的证书 → 内置的根公钥」,再逐个核对文件的 sha256;任何一环不对就拒绝,并给出错误码。
- 防止退回旧的信息:版本索引带递增的序号,面板记住见过的最大序号,不接受更旧的——拿旧的索引冒充、想让你看不到新版本或撤回,会被拒绝。
- 第一次安装:服务器上还没有装好的授权版程序来核对签名,靠的是一键安装脚本里写着的发布包 sha256,所以要先核对安装脚本本身的 sha256(见安装)。
已撤回与建议暂缓
已撤回:厂商发现某个版本有严重问题时,在签名的版本索引里把它标为撤回,写明理由。
sytp update不再安装它:确实要装时要加--allow-yanked,并在终端里看过理由、输入版本号确认;- 正在运行这个版本的面板,「版本与更新」显示红点与「当前版本 vX 已被撤回」、撤回理由与处理办法(升级到修好的版本,没有时
sytp update --rollback回到上一版);已经在运行的面板不会因此停下; - 本页各版本的文件里同样标着「已撤回」与理由。
建议暂缓:授权站对某个版本的提醒,不在签名的版本索引里。「版本与更新」里那个版本旁边写着「厂商建议暂缓」,正在运行它时提示「厂商建议暂缓使用当前版本」。它只是提醒,不拦安装:没有急事就先别升到这个版本,已经在用的有更新的版本时尽快升级。
版本索引已 N 天没有更新:厂商即使没有新版本,也会定期重新签发版本索引(间隔比 45 天短)。面板发现它取到的索引已经 45 天以上没有更新时在「版本与更新」里提示这一句。核对的办法:「版本与更新」里写着「版本索引 #N · 生成于 …」,与本页最新版本表里「版本索引签发于 …(第 N 份)」比较:
- 本页的份数更大、日期更新:你的面板取到的是旧的索引——你用的下载站或镜像可能被冻结在旧的索引上(有人想让你看不到新版本与撤回)。检查
SYTP_UPDATE_MIRRORS与网络,或联系我们; - 两边相同:厂商没有按时重新签发,请告诉我们。
仍然存在的风险
签名把住了经网络传来的程序与版本信息,但下面这些它管不到:
- 第一次安装:服务器上还没有能核对签名的授权版程序。用一键安装脚本时靠 HTTPS 与脚本里写着的发布包 sha256(所以要先按安装核对脚本本身);用发布包里的
install.sh手动安装时,只靠你自己先核对发布包的 sha256(离线与内网)。下载站根目录的sytp-install.sh本身不在签名里(它与版本目录里同名的那一份逐字节相同,可以对照本页核对)。 - 下载站的上传账号:拿到它的人能改写下载站上可以更新的文件(版本索引、
keys.json、根目录的安装脚本),也能上传新的版本目录;本站也用同一个账号发布,本站公布的 sha256 同样可能被改。已经装好的面板只认签名,不受影响;全新安装会受影响。所以请再到 Telegram 频道对一次 sha256,那是另一条渠道。 - 容器镜像:一键 Docker 安装用的 PostgreSQL、Redis、Caddy 与面板的基础镜像来自 Docker Hub(或你选的镜像加速站),不归厂商签名。全新安装与授权版之间的升级按写死的摘要拉取(内容被换了就拉不下来);Docker 的安装脚本、Caddy 与 acme.sh 的下载也没有哈希核对。
- Docker 的面板容器被攻破时:宿主上的程序照样只认自己核对过的签名,但它从数据目录读到的吊销、撤回与已见过的版本信息可能是伪造的,这台服务器上的撤回与防退回会失效。
- 发布密钥被盗:在厂商发现并吊销它之前,攻击者能签出面板接受的版本索引;吊销之后(新的
keys.json)不再被接受,厂商会用新的密钥发布修订版本。 - 不联网的面板:看不到它没见过的撤回与吊销,也发现不了镜像被冻结,只有「版本索引已 N 天没有更新」这一个提示:请定期来本页核对最新版本。
- 授权站被攻破时:它只能显示「镜像未同步」「厂商建议暂缓」这类提示、把常规版本的更新服务期提前(安全更新照常能装),最多在 24 小时之后暂停新增类操作;它不能伪造版本、不能阻止安全更新,也停不了转发、计费、登录与续费(域名绑定的情形见下一条),删不了数据。
- 授权站被攻破或配错时的域名绑定:不论你的授权开没开启域名绑定(攻破授权站的人可以替它开启),最快 24 小时之后,用户在它写的授权域名之外的地址上打不开网站(它把授权域名清空时,用户在哪个地址上都打不开,也就不能在网站上续费);替没开启绑定的授权开启时,面板至少等 72 小时之后才拦用户。这些时间从面板收到那一份授权算起,改不了。管理端、转发、流量计费、节点、支付回调与自动续费照常。授权站自己发起的收紧本来会提前通知,攻破它的人却可以不通知。厂商发现之后在不联网的机器上签发新的密钥目录(
keys.json),在里面作废那个签名密钥签出的授权;面板取到新目录之后就不再按那些授权域名拦用户。 - 节点信任面板:面板被攻破时,攻击者能经网页终端在节点上执行命令、在节点第一次安装时下发别的程序、把节点降到更早的厂商版本。请保护好面板的管理员账号与服务器。
- root 能强行安装没有签名的包:普通安装的
sytp update有一个不列在帮助里的排障参数,在服务器的终端里以 root 运行、输入UNSIGNED确认之后,不核对签名、按原版的规则安装(记进审计)。它要有服务器的 root 终端才能用,面板与网络上触发不了;Docker 安装的管理命令没有它。 - 服务器本身被控制:有 root 权限的人本来就能替换程序。签名防的是经网络下发的程序被换,不防服务器自己被攻破。