外观
安装
一键安装脚本在一台 Linux 服务器上装好面板(Docker 或普通安装二选一)并配好 HTTPS;安装时填了授权码的,装好后自动激活。整个过程以 root 执行,脚本先问完全部问题、你确认之后才开始改动服务器。
准备一台服务器
| 项目 | 要求 |
|---|---|
| 系统 | Debian、Ubuntu、CentOS、Rocky Linux 或 AlmaLinux(脚本用 apt、dnf 或 yum 安装依赖,别的系统不支持) |
| 架构 | x86_64(amd64)或 aarch64(arm64),用 uname -m 查看 |
| 权限 | root(普通用户先 sudo -i) |
| 内存 | 普通安装:面板本身约 30–60 MB;Docker 安装:内存低于 512 MB 时脚本会建议改用普通安装 |
| 服务管理 | 普通安装用 systemd 管理面板;Docker 安装时没有装 Docker 的,脚本会自动安装 |
| 网络 | 能连上厂商的下载站与授权站;Docker 安装还要能拉取容器镜像(服务器连不上 Google 时,脚本会问要不要用镜像加速) |
| 域名与端口 | 推荐准备一个已解析到这台服务器的域名,脚本用 Caddy 或 Nginx 自动申请 HTTPS 证书,这时 80 与 443 端口要空着;没有域名时也能用 http://IP:端口 访问(只适合测试)。授权开启了域名绑定时必须用域名:用户在 IP 上打不开网站 |
| 授权码 | 可以先没有:安装时可以留空或申请试用,装好后再激活 |
不能联网的服务器见离线与内网。
下载、核对、执行
以 root 执行。推荐分三步:先下载安装脚本,核对它的 sha256 与本站公布的相同,再执行它。
还没有发布授权版。第一个授权版发布之后,这里给出它的安装脚本的 sha256 与核对的命令,形如:
bash
curl -fsSLo sytp-install.sh https://dl.ikitten.net/sytp/<V>/sytp-install.sh
echo '<sha256> sytp-install.sh' | sha256sum -c -
bash sytp-install.sh核对通不过就不要执行:可能是下载不完整,也可能是文件被换过。还可以在 Telegram 频道 @sytpchannel 再对一次厂商公布的 sha256;各版本的安装脚本与发布包的 sha256 都列在安全核对。
脚本会问什么
按顺序回答(方括号里是直接回车时的选择):
| 问题 | 说明 |
|---|---|
| 安装方式 | Docker(推荐):面板、PostgreSQL、Redis、Caddy 都在容器里,升级迁移最省事;普通安装:systemd 服务,内存占用最少,适合小内存机器或已有宝塔、Nginx 的 |
| 镜像加速 | 只在 Docker 安装、服务器 4 秒内连不上 Google 时问:安装 Docker 与拉取容器镜像时用不用镜像加速[是]。回答是之后另问「容器镜像加速前缀(输入 - 不加速)」[docker.m.daocloud.io/];已经用环境变量 IMAGE_PREFIX 给了前缀时不再问 |
| 从备份恢复数据?[否] | 从旧服务器迁移时选是,填写 sytp backup 生成的备份文件路径(管理员、用户、订单等全部沿用备份) |
| 监听端口[8088] | 面板只在本机监听这个端口,由反向代理对外提供 80 / 443 |
| 数据库[SQLite] | SQLite 单文件、免维护;用户多、节点多时选 PostgreSQL |
| 已有数据 | 本机装过面板、数据还在时:沿用,或清空后全新安装(清空时旧数据另存一份备份) |
| 启用 Redis?[是] | 可选 |
| 管理员与站点 | 管理员邮箱、密码(至少 8 位,直接回车随机生成)、站点名称;从备份恢复或沿用已有数据时不问 |
| 反向代理与 HTTPS 证书[Caddy] | Caddy 自动申请并续期证书;Nginx + acme.sh;跳过(自己配,脚本给出配置示例;要把访问的域名原样转给面板,见反向代理要转发 Host);不使用域名(http://IP:端口,只适合测试)。用域名时另问域名与证书邮箱 |
| 授权码 | 可以留空:装好后在面板里激活。脚本先把它发给授权站核对(留空也发),连不上授权站时不拦。授权码留空时可以申请试用:填写邮箱,试用授权码发到邮箱后粘贴回来 |
| 迁移授权 | 只在从备份恢复或沿用已有数据时问「…装好后迁移到本机?」:回答是,装好后把备份里的授权迁移到这台服务器(见迁移到新服务器) |
最后显示「确认安装」,列出全部选择,回答「开始安装?」之后才开始。授权码只显示末 5 位,不写进安装日志。
装好的时候脚本会核对面板确实在运行,然后用填写的授权码激活(激活要持有人确认时,屏幕上显示确认码与链接,见激活要持有人确认时)。
特殊网络与自动安装
安装脚本没有命令行参数,特殊情况用环境变量(写在 bash sytp-install.sh 的前面):
| 环境变量 | 作用 |
|---|---|
SYTP_LICENSE_KEY_FILE | 值是一个文件的路径:授权码从这个文件读(不超过 1 KiB 的普通文件),不再询问 |
SYTP_LICENSE_SKIP | 设为 1:不问任何授权问题,装好后再激活 |
SYTP_LICENSE_PROXY | 只给连授权站用的代理地址 |
SYTP_RELEASE_URL | 发布包从这个地址取(内网地址或 file:///root/…),照样按脚本里写着的 sha256 核对(见离线与内网) |
IMAGE_PREFIX | 容器镜像的加速前缀,以 / 结尾 |
例如用文件里的授权码安装:
bash
SYTP_LICENSE_KEY_FILE=/root/key.txt bash sytp-install.sh装好之后
脚本最后显示「安装完成」,列出访问地址、管理员、密码、站点名称、安装方式与版本、HTTPS 证书的状态、目录与授权状态,同样的内容存在 /root/sytp-install-info.txt(只有 root 能读)。密码是自动生成的,请先把它保存好。
第一次登录:
- 用浏览器打开「访问地址」(用了域名的是
https://你的域名;刚装好时证书可能还在申请,打不开就等 30 秒再刷新); - 用管理员邮箱与密码登录;
- 左侧菜单「管理 · 系统」→「授权与更新」:确认授权正常,没有激活的在这里激活(见激活授权);
- 「系统设置」里配置 SMTP(注册与找回密码的邮件,见公告与通知);
- 「节点组」里添加入口组、出口组,点「对接」复制安装命令到节点上执行(一步一步见快速上手)。
忘记管理员密码时在服务器上执行 sytp reset-password 管理员邮箱。
文件在哪里
普通安装
- 程序:
/opt/sytp/sytp,节点程序在/opt/sytp/agents/ - 配置:
/etc/sytp/sytp.env - 数据(数据库、实例身份、授权状态):
/var/lib/sytp
Docker 安装
- 程序:
/opt/sytp/app/sytp,节点程序在/opt/sytp/app/agents/ - 配置:
/opt/sytp/.env、/opt/sytp/docker-compose.yml - 数据(数据库、实例身份、授权状态):
/opt/sytp/data
两种安装都是
- 备份:
/var/backups/sytp - 安装信息:
/root/sytp-install-info.txt;安装日志:/var/log/sytp-install.log
数据目录里的 instance.key 是这台面板的实例身份,授权绑定在它上面:不要删、不要拷给别的面板。它不在 sytp backup 的备份里,换服务器时按迁移到新服务器把授权迁过去。
常用命令
两种安装的命令相同(Docker 安装的 sytp 是管理命令,操作容器里的面板):
| 命令 | 作用 |
|---|---|
sytp | 打开管理菜单 |
sytp status | 运行状态 |
sytp restart | 重启面板 |
sytp log | 实时日志 |
sytp config | 编辑配置(普通安装改完执行 sytp restart;Docker 安装保存后自动重建容器) |
sytp backup | 备份数据到 /var/backups/sytp |
sytp update | 升级(见升级) |
sytp license status | 授权状态(见激活授权) |
sytp version | 版本号 |
再次运行一键安装脚本(bash sytp-install.sh)时,它认出已经装好的面板,让你选「升级到最新版本」「重新配置反代与证书」「查看安装信息」或「卸载」。用「重新配置反代与证书」换域名时,授权开启了域名绑定、新域名又不在授权域名里的,它会问要不要同时更换授权域名(见域名被墙了怎么办)。
卸载
再次运行一键安装脚本(bash sytp-install.sh),选「卸载」;普通安装也可以直接执行 sytp uninstall,Docker 安装执行管理命令的 sytp uninstall。卸载时会问是否同时删除全部数据。
解绑授权:卸载时面板会在授权站上解绑本机,把名额释放出来,之后在别的服务器上可以直接激活:
- 选了删除全部数据、数据库也随卸载一起删除(本机的 SQLite、一键 Docker 安装自带的 PostgreSQL,或普通安装时选了「同时删除 PostgreSQL 中的 sytp 数据库与用户」)、也没有别的面板进程共用这个授权时,自动解绑;
- 其余情况(保留数据、数据库不随卸载删除等)会问「同时解绑授权?」,直接回车为不解绑——打算在这台服务器上重装、沿用数据的,不要解绑;
- 连不上授权站时卸载照常完成,名额仍被占用:请联系售后解绑。
不卸载、只想把授权让给别的服务器时,在「授权与更新」的「危险操作」里点「本机解绑」,或执行 sytp license deactivate。
卸载不会删除 Caddy、Nginx、PostgreSQL、Redis 与 Docker 等组件,不需要时请自己移除。