宝塔面板插件下载中断可采取四步解决:一、SSH执行带-c参数的wget命令启用断点续传;二、修改plugin.json将源换为国内CDN镜像并重启面板;三、临时关闭防火墙及开放云安全组80/443端口;四、离线下载插件包上传后解压安装。

如果您在宝塔面板中下载插件时因网络波动导致中断,可能表现为进度卡住、提示“连接超时”或下载文件不完整。以下是解决此问题的步骤:
一、手动重试并启用断点续传机制
宝塔面板底层使用wget进行插件下载,部分版本支持断点续传。通过命令行强制启用该机制可避免重复下载全部内容。
1、通过SSH登录服务器,切换至root用户。
2、执行命令:cd /www/server/panel/class && python tools.pyc downloadPlugin 安装包名(将“安装包名”替换为实际插件英文标识,如phpmyadmin)。
3、若仍失败,改用带断点续传参数的wget命令:wget -c -O /www/server/panel/plugin/插件名.zip http://download.bt.cn/plugin/插件名.zip。
二、更换插件源地址为国内镜像
默认源位于境外服务器,受DNS解析与跨境链路影响较大。切换至宝塔官方提供的国内CDN镜像可显著提升稳定性。
1、编辑插件源配置文件:vi /www/server/panel/data/plugin.json。
2、将其中所有"url": "http://download.bt.cn"替换为"url": "https://ghproxy.net/https://raw.githubusercontent.com/bt-cn/btpanel-plugin/main"(注意保留引号)。
3、保存退出后,执行:rm -f /www/server/panel/data/plugin.json.cache && systemctl restart bt。
三、临时禁用防火墙与安全组限制
部分云服务商安全组或本地iptables规则会误判高频HTTP请求为攻击行为,主动中断连接。临时放开相关策略有助于完成下载。
1、关闭系统防火墙:systemctl stop firewalld(CentOS 7)或ufw disable(Ubuntu/Debian)。
2、检查云平台安全组入站规则,确保80、443端口对0.0.0.0/0开放。
3、执行插件下载操作后,再按需恢复防火墙服务。
四、使用离线安装包手动部署
当网络持续不稳定时,可在网络良好的设备上预先下载完整插件包,并通过SFTP上传至服务器指定路径,跳过在线下载环节。
1、访问https://github.com/bt-cn/btpanel-plugin/releases,找到对应插件最新版zip包并下载。
2、使用SFTP工具将zip文件上传至/www/server/panel/plugin/目录。
3、解压并赋予执行权限:unzip 插件名.zip -d /www/server/panel/plugin/插件名 && chmod +x /www/server/panel/plugin/插件名/install.sh。
4、运行安装脚本:bash /www/server/panel/plugin/插件名/install.sh install。










