国内服务器安装 s-ui 完整教程(解决下载慢/卡住问题)
s-ui 是一款基于 sing-box 内核的面板工具,官方提供了一键安装脚本,但如果你的服务器在国内(或者出海线路不好),直接跑官方脚本经常会卡在下载 GitHub Release 包这一步,进度条几十 KB/s 甚至直接卡死不动。
这篇文章记录一下用镜像加速 + 手动安装的方式,绕开这个问题。
问题现象
直接执行官方一键命令:
bash <(curl -Ls https://raw.githubusercontent.com/alireza0/s-ui/master/install.sh)脚本本身能跑起来,检测系统、装依赖都没问题,但走到这一步就会卡住:
Got s-ui latest version: v1.5.5, beginning the installation...
--2026-08-20 01:22:53-- https://github.com/alireza0/s-ui/releases/download/v1.5.5/s-ui-linux-amd64.tar.gz
...
Connecting to release-assets.githubusercontent.com|185.199.108.133|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 34458028 (33M)
/tmp/s-ui 11%[==> ] 3.82M 12.6KB/s eta 34m 17s原因很简单:脚本内部下载 release 包时用的是 GitHub 官方地址(github.com 会跳转到 release-assets.githubusercontent.com),这两个域名在国内访问速度都不稳定,经常几十 KB/s,等 34 分钟都不一定能下完。
解决思路
分两步走:
- 用 GitHub 加速镜像手动下载 release 包(而不是让脚本自己去下载);
- 把安装脚本里"下载"之后的步骤自己跑一遍(解压、复制文件、注册 systemd 服务)。
第一步:用镜像下载 release 包
先确认当前 release 版本号,去 s-ui 的 GitHub Releases 页面 看一下最新版本号,比如 v1.5.5。
用 GitHub 加速镜像下载(镜像站时效性比较强,下面几个可以挨个试,哪个连得上用哪个):
cd /tmp
wget "https://ghfast.top/https://github.com/alireza0/s-ui/releases/download/v1.5.5/s-ui-linux-amd64.tar.gz" -O s-ui-linux-amd64.tar.gz如果这个镜像连不上或者很慢,换其他几个试试:
# 备用镜像1
wget "https://gh-proxy.com/https://github.com/alireza0/s-ui/releases/download/v1.5.5/s-ui-linux-amd64.tar.gz" -O s-ui-linux-amd64.tar.gz
# 备用镜像2
wget "https://ghproxy.net/https://github.com/alireza0/s-ui/releases/download/v1.5.5/s-ui-linux-amd64.tar.gz" -O s-ui-linux-amd64.tar.gz这类镜像站是第三方维护的公益服务,域名会不定期变化或失效,如果上面几个都不通,搜索「github 加速 镜像 2026」找一个当前可用的替换即可,用法都一样:把原始 GitHub 下载链接拼在镜像域名后面。
下载完确认一下文件大小是否正常(应该在 30M+ 左右,太小说明下载失败了):
ls -lh s-ui-linux-amd64.tar.gz第二步:手动完成安装
架构根据你服务器 CPU 类型选择,常见的 x86_64 服务器对应 amd64。下面以 amd64 为例:
# 解压到 /usr/local/s-ui
mkdir -p /usr/local/s-ui
tar zxvf s-ui-linux-amd64.tar.gz -C /usr/local/s-ui --strip-components=1
cd /usr/local/s-ui
# 赋予执行权限
chmod +x sui s-ui.sh
# 把 s-ui.sh 复制为命令行工具,以后可以直接敲 s-ui 打开管理菜单
cp s-ui.sh /usr/bin/s-ui
# 把 systemd 服务文件复制到位
cp -f s-ui.service /etc/systemd/system/
# 数据库迁移(首次安装也需要跑这一步)
/usr/local/s-ui/sui migrate
# 重新加载 systemd 配置,并启用 + 启动服务
systemctl daemon-reload
systemctl enable s-ui --now检查服务状态,看到 active (running) 就说明启动成功了:
systemctl status s-ui第三步:初始配置
修改管理端口(默认端口容易被扫描,建议改成自定义端口),比如改成 54321:
/usr/local/s-ui/sui setting -port 54321也可以顺便改一下访问路径,比如把路径改成 /mypanel:
/usr/local/s-ui/sui setting -port 54321 -path /mypanel设置管理员账号密码,比如用户名设为 admin、密码设为 YourStrongPassw0rd!:
/usr/local/s-ui/sui admin -username admin -password YourStrongPassw0rd!上面的用户名密码只是示例,实际使用时请换成自己的复杂密码,不要照抄。
改完重启服务生效:
systemctl restart s-ui查看访问链接:
/usr/local/s-ui/sui uri如果懒得记命令,也可以直接敲 s-ui 呼出交互菜单,里面有图形化的选项可以改配置。
安全建议
- 不要用
admin/admin这种弱密码长期挂在公网,很容易被扫描器爆破,务必换成复杂密码; - 面板端口尽量不要用默认端口,改成不常见的端口能减少一部分自动化扫描;
- 如果服务器支持安全组/防火墙,建议把管理端口限制成只有自己的 IP 能访问;
- 装完之后记得用
ufw或云厂商的安全组规则,把不需要暴露的端口都关掉。
小结
国内服务器装 s-ui 卡住,本质是官方脚本里下载 release 包这一步走的是原始 GitHub 地址,被限速了。解决办法就是把这一步单独拆出来,用国内能连通的镜像站手动下载,再照着官方脚本的逻辑自己跑一遍安装步骤即可,整个过程不复杂,就是多了几条命令。