宝塔面板安装脚本不支持断点续传,因其下载与执行为单次非幂等流程,无状态记录和校验;需手动分步:断点下载→哈希校验→清理残留→执行,并优先解决网络连通性问题。

宝塔面板安装脚本不支持断点续传,网络中断后直接重跑 curl -sSO 命令会从头开始,浪费时间且可能因环境变化失败。
为什么原安装命令无法续传
宝塔官方安装脚本(如 curl -sSO http://download.bt.cn/install/install_6.0.sh)本质是下载并立即执行的单次流程:它先用 curl 把脚本拉到内存或临时文件,再用 bash 执行。过程中没有检查已下载内容、不校验中间状态、也不保存进度。一旦网络断开,curl 返回非零退出码,后续命令不执行,整个流程终止——没有“已装到哪一步”的记录。
更关键的是,安装脚本本身不是幂等的:重复运行可能重复创建服务、冲突绑定端口、或因残留进程报错(比如提示 panel is running 却实际没起来)。
手动分步 + 断点判断才是可行路径
把“下载 → 校验 → 执行”拆开,每步可独立验证和重试:
- 用
curl -C - -o install.sh http://download.bt.cn/install/install_6.0.sh下载(-C -启用断点续传) - 下载完成后,用
sha256sum install.sh对比官网公布的哈希值(通常在文档页或 GitHub README 中),避免中间被篡改 - 确认无误后,再执行
bash install.sh;若安装中途失败,先运行ps aux | grep bt查看是否有残留进程,必要时killall -9 bt清理 - 如果卡在“正在安装 Python 依赖”,大概率是 pip 源问题,可提前运行
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
安装卡在“正在获取系统信息”或“连接服务器超时”
这不是网络中断导致的续传问题,而是宝塔后台接口(http://www.bt.cn 或 https://api.bt.cn)访问失败。常见于:
- 服务器 DNS 解析异常(试试
ping www.bt.cn是否通,不通则换echo "nameserver 8.8.8.8" > /etc/resolv.conf) - 防火墙或安全组屏蔽了出站 HTTPS(检查
iptables -L -n或云厂商控制台) - 国内部分网络对 SNI 域名识别有问题,可临时加 hosts:
echo "121.40.176.105 www.bt.cn" >> /etc/hosts(IP 以官网最新为准)
这类情况重跑脚本无效,必须先解决连通性,否则即使下载完成,执行时仍会 hang 在第一步。
真正需要“续传”的其实是面板升级而非初始安装
初始安装失败后,最稳妥的做法是清理再重来:curl -sSO http://download.bt.cn/install/bt-uninstall.sh && bash bt-uninstall.sh。而日常使用中,真正频繁遇到断点需求的是 bt upgrade 或插件更新——这些操作内部已自带重试逻辑,但依赖 /www/server/panel/data/upgrade.pl 状态文件。如果升级中断,可手动检查该文件是否存在、内容是否为 1,存在则删掉再试,否则可能被判定为“升级中”而拒绝操作。
别迷信“一键续传脚本”,宝塔没开放安装状态持久化接口,所有号称能续传的第三方脚本,本质都是绕过校验或强行跳过检测——容易导致面板功能缺失或权限错乱。
















