外观
激活授权
面板装好之后要激活授权才能新增节点、节点组与用户。激活之前与激活之后,已有的转发、计费、登录与老用户续费都照常(开启了域名绑定时,老用户登录之后的页面与续费在授权域名上),不受授权状态影响。
激活只需要做一次:之后面板大约每 6 小时自动与授权站校验一次,续费、升级授权也不用重新激活。
在面板里激活
用管理员账号登录面板,在左侧菜单「管理 · 系统」里打开「授权与更新」。
在「激活授权」里填写授权码(形如
SYTP-XXXXX-XXXXX-XXXXX-XXXXX,短横线、空格与大小写都可以),点「激活」。页面顶部显示「授权正常」与版本、到期日期,就激活好了。
授权的版本决定哪些功能可用(「功能」里写着开或关)与各项的限额;「使用」里受影响的页面在最后的「授权与……」一节写明受影响的是什么,例如节点管理与支付与订单。
还没有授权码时,可以先在同一页的「申请试用」里申请(见下面的试用),或联系我们购买(Telegram @sytpchannel)。
一键安装时填了授权码的,装好后已经自动激活,不用再做这一步。
用命令行激活
在面板服务器上以 root 执行(Docker 安装同样执行 sytp,命令会转给容器里的面板):
bash
sytp license activate它提示「授权码(留空 = 找回本机已有的授权)」:粘贴授权码后回车。授权码在终端里输入,不会进 shell 历史。也可以先把授权码放进一个只有 root 能读的文件:
bash
sytp license activate --key-file /root/key.txt
sytp license status激活成功时显示「激活成功:正常 · 商业版 · 到期 2027-11-12(剩 364 天)」这样的一行;第二条命令显示状态、版本、到期时间与上次校验的时间。不要把授权码直接写在命令行上(会进 shell 历史),命令也会拒绝这样做。
sytp 菜单的第 16 项「授权(状态、激活、试用、诊断)」里有同样的操作:
| 序号 | 操作 | 同一个命令 |
|---|---|---|
| 1 | 状态 | sytp license status |
| 2 | 激活 / 找回 / 迁移 | sytp license activate(迁移加 --migrate) |
| 3 | 立即校验 | sytp license refresh |
| 4 | 申请试用 | sytp license trial |
| 5 | 离线激活:生成请求码 | sytp license offline-request(见离线与内网) |
| 6 | 离线激活:导入授权文件 | sytp license offline-import 文件 |
| 7 | 网络设置 | sytp license network |
| 8 | 诊断 | sytp license diag --copy |
| 9 | 本机解绑 | sytp license deactivate |
| 10 | 重建实例身份 | sytp license reset-instance |
| 11 | 授权域名 | sytp license domain(先显示,再问要不要更换;见授权域名) |
sytp license status 在授权受限时退出码为 3,方便写进监控脚本;--brief 只输出一行。
激活要持有人确认时
一个授权码同一时间只能用在一台面板上。授权码正在另一台面板上使用(比如换了服务器而旧的还在运行)时,激活不会立即生效,页面显示「等待授权的持有人确认」和一个确认码:
- 授权的持有人(购买授权的邮箱;绑定了 Telegram 的同时收到消息)会收到一封确认邮件;
- 打开邮件里的链接,在确认页输入新面板上显示的确认码并批准;
- 新面板自动完成激活,旧面板约 24 小时后暂停新增(它上面已有的转发照常)。
确认码只显示在面板上,邮件里没有;确认请求 30 分钟内有效,输错 5 次按拒绝处理。没收到邮件时先查垃圾邮件,再点「查看确认进度」;仍然没有时联系售后并报上确认码,售后可以代为确认。
在同一台服务器上用原来的数据(或它的备份)重装了面板、公网 IP 没变时,不需要持有人:页面显示「确认把授权转到这台面板」,在本机确认即可。
试用
- 在「授权与更新」的「申请试用」里填写邮箱,点「申请试用」(命令行:
sytp license trial --email 你的邮箱); - 几分钟内收到试用授权码(请同时查看垃圾邮件),在「激活授权」里输入它激活。
- 试用期从第一次激活开始计算;试用的期限与限额以申请时的说明为准,页面上显示「试用」。
- 试用授权码发出之后有有效期,收到后请尽快激活。
- 购买正式授权后,同一个授权码就地转正,不用重新激活。
- 试用授权不能换到别的服务器(同一台服务器重装后可以迁移)。
一键安装脚本里同样可以申请试用:授权码留空时它会问「没有授权码:申请试用?」。
授权域名(域名绑定)
授权绑定的是这台面板的实例身份(数据目录里的 instance.key)。有的授权另外开启了域名绑定:你的用户只能在授权域名上打开网站。
有没有开启,看「授权与更新」里的「授权域名」(开启了的紧接在状态卡下面;没开启的只有一行,在页面下方「绑定信息」之前;命令行 sytp license domain)。写着「未开启域名绑定」的,本节下面的都不用管:换域名时只要在「系统设置 · 站点信息」里改站点地址,授权照常。
开启了域名绑定时:
- 用户只能在授权域名上打开网站:首页、注册、登录之后的页面、续费与自己规则的增删改都是。在别的地址上——包括服务器的 IP——用户只看到一页「这个网址无法访问,请使用本站的正式网址访问。」,接口返回 403(代码
site_unavailable);普通用户的 API Token 经这样的地址调用同样被拒。登录页本身在任何地址上都能打开(给管理员用),用户在那里登录之后同样只看到这一页——用户说「能登录,登录之后就显示无法访问」就是这种情况。 - 管理员在任何能打开面板的地址上都照常登录(登录页
/login)、进后台与「授权与更新」,包括还没有绑定的新域名。用户与管理员平常用的是同一个网址(后台在/console/admin);这一条是为了授权域名被墙或者写错时,你换个地址还能进来更换它。 - 从不受影响:节点与面板的连接、已有的转发、流量计费、支付回调与自动续费、Telegram 机器人。
授权域名缺省按主域名计:授权域名 example.com 包括 panel.example.com、www.example.com 等所有子域名,列表里写着「(含所有子域名)」。有的授权按完整主机名计,只认列出的那一个(主域名另认带 www. 的,写着「(含 www)」)。用哪种计法、能绑定几个域名(「可绑定的域名数」)都由授权决定,以「授权域名」里显示的为准。
第一个授权域名
- 购买时填了域名的,授权域名就是它。
- 没填的,开启绑定之后,面板下一次校验时上报的站点地址(「系统设置 · 站点信息」里的「站点地址」)就成为授权域名——所以先把站点地址填成你的正式域名,再点「授权与更新」的「立即校验」。IP、
localhost与github.io这样人人都能申请子域名的公共后缀不能绑定。 - 开启了还没有授权域名时,「授权域名」写着从哪一天起执行(目前是开启之后 7 天)。到那时还没有授权域名,用户在任何地址上都打不开网站(管理员照常),所以请在那之前把站点地址改成你的域名。
- 绑错了:用一次更换改正。
更换与添加授权域名
在「授权与更新」的「授权域名」里:
- 更换授权域名:输入新域名,看清对话框里大字显示的域名再确认。换好之后用户立即能在新域名上打开网站,旧域名再保留 24 小时(列表里写着保留到什么时候),之后只有管理员能用。按主域名计时,填
panel.new.com绑定的是new.com。新域名已经在授权域名里时(比如同一个主域名下的另一个子域名)不用更换,也不占次数。 - 换好之后改站点地址:「系统设置 · 站点信息」里的站点地址还是旧域名的,把它改成新域名(「授权域名」里那一行写着「站点地址还是换下的 …」,旁边有「去改站点地址」)。不要点「换成」把旧域名换回来:那会再用掉一次更换。
- 添加授权域名:只在授权可以绑定的域名还有没用过的空位时出现(「可绑定的域名数」写着已用与上限)。添加不占次数。要多绑定一个域名,联系售后加购域名。
把 example.net 换成 example.com 之后:新的立即生效,旧的写着保留到什么时候。域名数与次数是测试授权的,以你的「授权与更新」上显示的为准。
命令行同样可以。更换、添加之前先显示要换成什么、问你确认,等授权站回答之后才结束:
bash
sytp license domain # 显示授权域名与剩余次数
sytp license domain change new.example.com # 更换
sytp license domain add new.example.com # 添加
sytp license domain check new.example.com # 只检查,不改动有不止一个授权域名时,更换要指明换下哪一个:sytp license domain change 新域名 --from 旧域名。check 的退出码:0 = 在授权域名里或没有开启绑定,3 = 开启了绑定而它不在里面,方便写进脚本。
每次更换计一次域名更换次数(与迁移用的换绑次数是两回事):目前每 30 天免费 1 次,用完之后用向售后购买的付费次数(不过期)。剩余的次数与下一次恢复的时间写在「授权域名」里,以那里显示的为准。免费与付费的都用完了还急着换时(比如半夜被墙),授权站目前允许先应急更换一次,「授权域名」里写着「欠 1 次」,请之后联系售后结清;欠着的时候不能再换。
授权站那边对授权域名的收紧(给已经在用的授权开启绑定、删掉授权域名)会提前通知授权的持有人,「授权域名」里写着从什么时候起执行。面板收到变窄的授权域名之后,至少 24 小时之后才执行,这期间新旧授权域名都照样能用(给已经在用的授权开启绑定时至少 72 小时)。
反向代理要转发 Host
面板按浏览器访问的域名(请求里的 Host)判断是不是授权域名。一键安装配的 Caddy、Nginx 与发布包里的 nginx.conf 都原样转发 Host;自己配反向代理(安装时选「跳过」、宝塔、CDN)时要同样做到:
- Nginx 要有
proxy_set_header Host $host;(缺省转发的是上游的地址,面板看到的是127.0.0.1,用户就全都打不开); - 宝塔的反向代理:「发送域名」填
$host; - CDN 与别的代理不要改写回源的 Host。
Host 没有转给面板时,「授权域名」里会提示「反向代理没有把 Host 转给面板」(近 24 小时有用户页面经本机地址打开过)。只是自己在服务器上或经 SSH 隧道用 127.0.0.1 打开过的,可以不管。
只用 IP 访问的面板
开启了域名绑定的授权必须用域名:IP 不能成为授权域名,经 IP 打开时用户只看到「这个网址无法访问」(管理员照常)。站点地址还是 IP 的,在开始执行之前改成域名(一键安装脚本的「重新配置反代与证书」可以一并配好 HTTPS,见域名被墙了怎么办的第 2 步)。
出了问题看哪里
「授权与更新」的「授权域名」写着:
- 站点地址在不在授权域名里;不在时有「换成 …」的按钮(点了先确认,用一次更换);
- 你现在打开面板用的地址是不是授权域名;
- 近 24 小时被拒的域名与次数(只是这个面板进程的记录),以及经 IP 或本机地址被拒的次数。
站点地址不在授权域名里时,页面顶部另有红色横幅,管理员也会收到「系统服务提醒」;「系统设置 · 站点信息」里填的站点地址不在授权域名里时,旁边同样提示。
用户说打开网站只看到「这个网址无法访问」,而你打开一切正常:多半是用户用的地址不是授权域名(旧域名的保留期过了、收藏的是 IP、反向代理没有转发 Host),让用户换成授权域名,或把那个地址换成授权域名。
迁移与换域名
授权域名跟着授权走:迁移到新服务器之后照样生效。迁移的同时换了域名的,先按迁移到新服务器迁好,再更换授权域名。
域名被墙了怎么办
用户打开网站用的域名被墙了(或者你想换一个域名),按下面做。没有开启域名绑定的授权只做第 1、2 步(自己配反向代理、没有用脚本的,再做第 3 步的前半:配好新域名、改站点地址)。
准备一个新域名,解析到这台服务器(与原来的一样建 A 记录)。
在服务器上以 root 运行一键安装脚本,选「重新配置反代与证书」,填新域名:
bashbash sytp-install.sh脚本重新配置 Caddy 或 Nginx 并申请证书、把站点地址改成新域名。新域名不在授权域名里时,它接着说明用户在新域名上会打不开网站,问要不要同时把授权域名换成新域名(括号里写着剩余的更换次数):直接回车就换。免费与付费的次数都用完时,它先说明这次会按应急更换(先换后补)生效、之后要联系售后付费结清,这时直接回车是不换,要换就输入
y。没有用脚本配反向代理的:自己把新域名配好(要转发 Host),在「系统设置 · 站点信息」改站点地址;再用新域名打开面板、以管理员登录(还没绑定的新域名上管理员照常能登录),在「授权与更新」的「授权域名」点「更换授权域名」,或在服务器上执行
sytp license domain change 新域名。换好之后用户马上能在新域名上打开网站;旧域名保留 24 小时,之后只有管理员能用。
换不成时:
- 更换次数都用完了:「授权域名」的「域名更换次数」写着本月免费还剩几次、什么时候恢复一次,以及付费次数。免费与付费的都用完时,授权站目前允许先应急更换一次(之后联系售后付费结清);已经欠着一次时,更换会提示「上一次的应急更换还没结清」。这两种情况都联系售后(Telegram @sytpchannel),报上「绑定信息」里的授权 ID:售后收款后加次数、结清,或代为更换。
- 离线的面板(离线激活的):联系售后更换授权域名,再导入售后发来的续期文件。
- 连不上授权站:授权域名没有更换,稍后再试;先在「授权与更新」的「网络与诊断」里点「诊断」,看是哪一步连不上。
换了域名之后,另外:
- 节点连接面板用的是对接时的地址:旧域名在节点那里也打不开时,在节点上执行
sytp-agent panel,改成新的面板地址; - 用 Telegram 机器人 Webhook 的,在「系统设置」→「Telegram」里重新点「设置 Webhook」(开着 Mini App 的再保存一次):它们用的是当时的站点地址;
- 告诉你的用户新的网址。
迁移到新服务器
授权跟着实例身份走,而实例身份不在 sytp backup 的备份里,所以把面板搬到新服务器之后要把授权迁移过去。三种做法:
用备份迁移(推荐)
- 旧服务器上
sytp backup,把备份文件拷到新服务器(如/root); - 新服务器上运行一键安装脚本,「从备份恢复数据?」选是并填写备份文件的路径;之后问「备份里的面板如果激活过授权,装好后迁移到本机?」时回答是;
- 装好后脚本自动迁移。没有自动迁移的,在新面板「授权与更新」点「迁移到本机」,或执行:
bash
sytp license activate --migrate迁移之后,旧服务器上的面板约 24 小时后暂停新增(它上面已有的转发照常);确认新面板正常之后再停掉旧的。迁移的同时换了域名、而授权开启了域名绑定的,迁好之后更换授权域名。
先解绑、再激活:旧服务器上在「授权与更新」的「危险操作」里点「本机解绑」(或 sytp license deactivate),再在新服务器上用授权码激活。
整个数据目录搬过去(旧服务器已经停掉):实例身份跟着数据目录一起过去,什么也不用做。
恢复了备份、还没有迁移的面板处于「待迁移」:72 小时内(最晚到旧授权这次校验的有效期结束)一切照旧,页面上写着「迁移期限」;过了期限暂停新增,迁移之后恢复。
换绑次数
迁移与换到新服务器按滚动 30 天计换绑次数(目前付费授权每 30 天 3 次,试用授权不能换绑)。同一台服务器、同一个公网 IP 上的迁移不占次数,否则可能占用一次。剩余次数与下一次恢复的时间写在「授权与更新」的「最近的操作」里(「换绑次数:30 天内还剩 N 次」)。次数用完时等它恢复,或联系售后加次数。
在同一台面板上换成另一个授权码(「授权与更新」的「换授权码 · 离线续期」里输入新的授权码,点「换成这个授权码」),原来的授权随即释放,不占它的换绑次数。
换绑次数只管授权换到哪一台面板。开启了域名绑定的授权另有域名更换次数,只在更换授权域名时计,写在「授权域名」里:两种次数各算各的,迁移不占域名更换次数,更换授权域名也不占换绑次数。
一键安装的「清空后全新安装」
重新运行一键安装脚本、选择清空已有数据时,脚本会把本机的实例身份与授权状态拷回新的数据目录,授权保留、不占换绑次数。
授权码丢了
面板不保存授权码(「绑定信息」里只显示末 4 位),已经激活的面板不需要授权码就能照常校验、续期。授权码丢了或泄露时,联系售后(Telegram @sytpchannel),报上「绑定信息」里的「授权 ID」:售后核对之后重置授权码、把新的授权码发给你,旧的随即作废。正在使用的面板不受影响;以后迁移到新服务器时用新的授权码。
续费与升级授权
续费、升级授权之后不用重新激活:付款后在「授权与更新」点「立即校验」(或执行 sytp license refresh)即可生效。门户上线之前,续费与升级请联系 Telegram @sytpchannel。
到期与连不上授权站时
授权到期、或面板长时间连不上授权站时,面板先提醒、再给宽限,宽限过后只暂停「新增」:
| 暂停的操作 | 照常的 |
|---|---|
| 接入新节点、新建节点组或修改类型、新建用户、新建礼品卡模板与生成卡密 | 已有节点的转发、流量计费、全部用户登录 |
| 用户注册、新客户购买 | 老用户续费(开启了域名绑定时,在授权域名上)、已有的节点、节点组、用户与规则 |
「授权与更新」的「受限说明」逐项写着哪些暂停了、从什么时候起;恢复之后自动解除,不用改任何设置。
到期:到期之后有一段宽限(目前个人版与商业版 7 天、旗舰版 14 天、试用 3 天),「授权与更新」上写着「宽限至」的日期;宽限过后上面两行一起暂停。续费之后自动恢复。
连不上授权站:面板每次成功校验拿到的授权有效 7 天,过期之后还有 14 天宽限(旗舰版 30 天)——也就是最后一次成功校验之后约 21 天内一切照常(试用授权约 15 天);页面上的「联网期限」是确切的时刻。过了联网期限先暂停新增节点、节点组、用户与礼品卡,再过 14 天暂停用户注册与新客户购买。连上之后自动恢复。不论授权怎样设置,面板保证最后一次成功校验之后至少 14 天内不会因为连不上而受限。
连续 24 小时没连上时,「授权与更新」与管理员通知会提醒;先在「授权与更新」的「网络与诊断」里点「诊断」(或执行 sytp license diag),看是哪一步连不上;长期不能联网的面板改用离线激活。
没有激活的面板:新装、还没激活过的面板一开始就按上表暂停新增。它另外按最低的版本运行,「授权与更新」的功能表里各项都是「关」:邀请返利对所有用户关闭(不再产生新的返利,已冻结的照常到期入账、提现照常),在线充值关闭(礼品卡充值照常),老客户只能续费原来的套餐,也不能新建支付通道。激活之后立即按你的版本恢复。
本机解绑之后:立即暂停新增节点、节点组与用户,72 小时后暂停用户注册与新客户购买。

