外观
离线与内网
服务器连不上厂商的下载站、授权站或容器镜像仓库时按本页操作。离线用的发布包就是下载站上的同一个包,自带厂商的签名:可信与否只看签名与 sha256,不看它是从哪里拷来的。
下文的 <V> 是面板的版本号(如 1.1.0),<AV> 是节点程序的版本号,<arch> 是服务器的架构:uname -m 为 x86_64 时是 amd64,aarch64 时是 arm64。
要准备的文件
在一台能联网的机器上,从 https://dl.ikitten.net/sytp/<V>/ 下载:
| 文件 | 用途 |
|---|---|
sytp-pro-<V>-linux-<arch>.tar.gz | 面板的发布包 |
SHA256SUMS | 核对:sha256sum -c --ignore-missing SHA256SUMS,再与安全核对公布的 sha256 比一次 |
sytp-install.sh | 这个版本的一键安装脚本(写着发布包的 sha256,离线安装时照样核对) |
release.json、release.json.sig、sytp-agent-<AV>-linux-<arch> | 节点程序的离线更新(见节点) |
拷到服务器上(如 /root),不要改文件名:脚本与 sytp-agent update 按名字找同一个目录里的签名与 SHA256SUMS。
全新安装
普通安装(用发布包里的安装脚本):
bash
sha256sum sytp-pro-<V>-linux-amd64.tar.gz # 与公布的相同
tar -xzf sytp-pro-<V>-linux-amd64.tar.gz && cd sytp && bash install.sh一键安装脚本(普通或 Docker)用本机的包:脚本照样按它写着的 sha256 与大小核对,不符就停下。{arch} 原样写,脚本会换成本机的架构:
bash
SYTP_RELEASE_URL='file:///root/sytp-pro-<V>-linux-{arch}.tar.gz' bash sytp-install.shDocker 安装另要准备好 Docker 与 Docker Compose,以及四个容器镜像(Redis、Alpine,用 PostgreSQL 时的 PostgreSQL,用 Caddy 时的 Caddy)。脚本按 sytp-install.sh 里 LIC_IMAGES 一行写着的摘要使用它们,本机已有同一份内容时不拉取。在能联网的机器上按摘要拉取、导出服务器架构的,再拷过去导入:
bash
# 能联网的机器上(服务器 uname -m 是 x86_64 时为 linux/amd64,aarch64 时为 linux/arm64)
docker pull --platform linux/amd64 redis:8-alpine@sha256:<LIC_IMAGES 里 redis:8-alpine 的索引摘要>
docker tag redis@sha256:<同上> redis:8-alpine
docker save --platform linux/amd64 -o redis.tar redis:8-alpine # docker save 的 --platform 要 Docker 28 起
# alpine:3.24、postgres:16-alpine、caddy:2-alpine 同样(没用 PostgreSQL 或不用 Caddy 时可以不要)
# 服务器上
docker load -i redis.tar
docker image inspect -f '{{.Id}} {{.Os}}/{{.Architecture}}' redis:8-alpine用了镜像加速前缀(IMAGE_PREFIX;安装脚本问镜像加速时回答是,缺省是 docker.m.daocloud.io/)时,导入之后再给镜像加上前缀的名字,如 docker tag redis:8-alpine docker.m.daocloud.io/redis:8-alpine。构建面板镜像时还要从 Alpine 的软件源安装 ca-certificates 与 tzdata:服务器要能连上软件源(安装时开启了镜像加速的,用的是阿里云的源),或在内网放一个软件源的镜像。
离线激活
不能联网的面板用离线激活:面板生成一个离线请求码,厂商据此签发授权文件,导入之后激活。
生成请求码。面板里:「授权与更新」→「离线激活(内网或连不上授权服务时)」→「生成离线请求码」,再点「复制请求码」。命令行:
bashsytp license offline-request --out /root/req.txt把请求码(
req.txt的内容)发给售后:Telegram @sytpchannel,同时说明是哪一份授权——购买时的邮箱与授权码的末 5 位,或「授权 ID」。不要发完整的授权码:谁拿到它都能拿去激活。售后签好授权文件发回给你。(命令输出里说的「门户」上线之前,都经售后办理。)导入授权文件。面板里:同一处的「导入授权文件」,「选择文件」或「粘贴文件内容」后点「导入」。命令行:
bashsytp license offline-import /root/license-file.txt sytp license status
Docker 安装的命令相同(宿主上的文件由管理命令传进容器);sytp 菜单第 16 项的第 5、6 项就是这两步。
关于离线授权:
- 有效期最长 30 天。到期之前再导入一个续期文件即可延长(向售后要,不用重新生成请求码);到期之后还有 7 天宽限,之后暂停新增节点、节点组、用户与礼品卡,再过 14 天暂停用户注册与新客户购买(转发、计费与登录照常,见到期与连不上授权站时)。「授权与更新」上写着导入新文件的截止时刻。
- 新实例的离线激活每 30 天最多一次,并计入换绑次数(见换绑次数);给已经激活的这台面板续期不受这个限制。
- 请求码 30 天内有效、只能用一次;面板最多同时保留 5 个没用过的请求码。
- 离线授权只支持单机部署:它绑定这台机器的指纹(有
/etc/machine-id时由它算出,没有时由实例身份算出)。Docker 安装激活之后不要再改/etc/machine-id的挂载,指纹变了离线授权会失效。 - 面板以后能联网时,在「授权与更新」点「立即校验」,离线授权就换成在线授权(之后自动续期)。
- 授权域名:授权开启了域名绑定时,授权文件与续期文件里带着授权域名,不联网的面板同样按它执行(用户只能在授权域名上打开网站)。还没有授权域名的,售后按请求码里的站点地址登记第一个,所以生成请求码之前先在「系统设置 · 站点信息」把站点地址填成你的域名。离线的面板要更换授权域名时联系售后:售后换好之后发来续期文件,导入即生效(「更换授权域名」按钮要连得上授权站)。
离线升级
把新版本的发布包拷到服务器上,执行:
bash
sytp update /root/sytp-pro-<V>-linux-amd64.tar.gz # 普通安装与 Docker 管理命令相同- 验签用程序内置的厂商根公钥,不需要联网;过程、回滚与退出码同升级。
- 不联网的面板看不到厂商的撤回:面板联网检查过、存下的版本信息标了撤回时要加
--allow-yanked;从没联网检查过时照装——先在安全核对确认这个版本没有被撤回。 - 面板缺少本版的
release.json时(「版本与更新」里会说明),执行sytp update --reinstall <本版的发布包>。
节点
全新安装:在面板「节点组」点「对接」→「手动安装」→「离线部署」→「下载离线包」(sytp-agent-offline.tar.gz),按那里给出的命令拷到节点上安装。安装时按包里的 SHA256SUMS 核对节点程序。
离线更新:sytp-agent update <文件> 要求同一个目录里有 release.json 与 release.json.sig(厂商的签名):
- 「下载离线包」里带着这两个文件(面板本版的发布文档正常时);
- 或从
https://dl.ikitten.net/sytp/<V>/下载release.json、release.json.sig与sytp-agent-<AV>-linux-<arch>,放进同一个目录再执行。
同目录有 SHA256SUMS 时照样核对,--sha256 指定的值也必须与签名的相同。没有签名的离线文件一律拒绝。
内网镜像
服务器连得上内网、连不上厂商的下载站时,把下载站的内容同步到内网的一个 HTTP 服务(只要能提供静态文件),面板就从那里检查更新、sytp update --online 从那里下载。镜像本身不需要可信:内容一律按厂商的签名核对,被改过的不会被接受。
要同步的文件(相对 https://dl.ikitten.net/sytp):
text
channels/stable.json channels/stable.json.sig channels/beta.json channels/beta.json.sig
keys.json
<V>/manifest.json <V>/manifest.json.sig <V>/release.json <V>/release.json.sig <V>/SHA256SUMS <V>/sytp-install.sh
<V>/sytp-pro-<V>-linux-amd64.tar.gz <V>/sytp-pro-<V>-linux-arm64.tar.gz
<V>/sytp-agent-<AV>-linux-amd64 <V>/sytp-agent-<AV>-linux-arm64channels/ 与 keys.json 每次都同步(它们会更新,也防止回放旧的版本信息);版本目录只同步要用的版本,同步之后不再改动。例如在能同时连上下载站与内网的机器上:
bash
base=https://dl.ikitten.net/sytp; dst=/srv/mirror/sytp; V=<V>
mkdir -p "$dst/channels" "$dst/$V"
for f in channels/stable.json channels/stable.json.sig channels/beta.json channels/beta.json.sig keys.json; do
curl -fsSL -o "$dst/$f" "$base/$f?r=$(date +%s)" # 带随机查询串,绕开下载站的缓存
done
curl -fsSL -o "$dst/$V/SHA256SUMS" "$base/$V/SHA256SUMS" # 列着版本目录里其余的全部文件
for f in $(awk '{print $2}' "$dst/$V/SHA256SUMS"); do
curl -fsSL -o "$dst/$V/$f" "$base/$V/$f"
done
(cd "$dst/$V" && sha256sum -c SHA256SUMS)然后在面板的配置里设 SYTP_UPDATE_MIRRORS(多个用空格或逗号分隔;可以是 http://),面板就只用这些镜像:
bash
sytp config # 普通安装:/etc/sytp/sytp.env,保存后 sytp restart;Docker:/opt/sytp/.env,保存后自动重建容器
# 加一行:SYTP_UPDATE_MIRRORS=http://mirror.intra/sytp设了它之后面板不再连厂商的下载站;以 root 运行的 sytp update --online 同样按配置文件读它。写错了(一个合规的地址都没有)时面板不会退回去连公网,「版本与更新」会显示连不上镜像。
关闭检查更新
不想让面板联网检查更新时,在配置里加一行 SYTP_UPDATE_CHECK=off(同样用 sytp config),或在「版本与更新」里关掉自动检查。关掉之后「版本与更新」不再提示新版本与安全更新:请定期到安全核对看最新版本。