宝塔面板博客官方技术博客
宝塔面板

宝塔安装脚本下载失败或太慢怎么办?先确认下载源可达再排查服务器网络

安装宝塔面板的第一步,是把 install_panel.sh 从 download.bt.cn 下载下来再执行。如果这一步就卡住、报错或慢到几乎不动,别急着怀疑宝塔官网挂了——多数时候下载源本身是好的,问题出在你的服务器到下载源这条链路上。

我用宝塔拨测(t.bt.cn)对 download.bt.cn 做了一次全国 HTTP 探测,结果能说明问题:305 个参与节点里 302 个成功返回 HTTP 200(成功率 99%),覆盖 42 个省份(大陆 31 个 + 港澳台及海外 11 个地区)。下载源在全国范围基本都能正常访问,所以「脚本下载不下来」几乎可以锁定是服务器侧的网络、DNS、hosts 或代理问题。

先确认:下载源本身可达吗?

面板的安装命令、修复脚本、卸载脚本都走 download.bt.cn 这个下载源:

# 正式版安装命令(官方文档)
if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh docscenter

对 download.bt.cn 做一次全国多节点拨测,就能从全局视角判断它是否可达。我在 2026-09-20 实测了一次:

指标 实测结果
参与探测节点 305 个
成功 / 失败 302 / 3(成功率 99%)
HTTP 状态码 全部 200
覆盖范围 42 个省份(大陆 31 + 港澳台及海外 11)
平均响应 128.4 ms
中位数 / p95 93.5 ms / 224.8 ms
运营商分布 电信 114、移动 86、联通 71、多线 12、广电 3、港澳台 3、海外 13

download.bt.cn 全国拨测结果

从失败的那 3 个节点也能看出端倪:失败原因都不是「目标服务器挂了」,而是检测节点自己的解析或线路问题——安徽滁州联通报 DNS 解析失败(NXDOMAIN)、江苏宿迁移动报目标地址被阻断、香港 BGP3 报超时。这正好说明:下载失败要往「访问者的网络/DNS」找原因,而不是先怀疑宝塔下载源。

排查顺序:网络 → DNS → hosts → 代理

1. 测基础网络连通性

在服务器上先看能不能访问公网:

ping -c 4 baidu.com
ping -c 4 download.bt.cn

ping baidu.com 都超时,说明服务器本身网络不通(机房线路、云安全组出站、本地防火墙),先解决网络;ping baidu.com 正常但 ping download.bt.cn 失败,说明是宝塔域名解析或线路问题,进入下一步。

2. 排查 DNS 解析

curl -vvv download.bt.cn 若提示 Could not resolve host,就是 DNS 解析失败:

cat /etc/resolv.conf

配置为空或有误时,写入公用 DNS 再重试:

echo "nameserver 223.5.5.5" > /etc/resolv.conf
echo "nameserver 114.114.114.114" >> /etc/resolv.conf
echo "nameserver 8.8.8.8" >> /etc/resolv.conf

3. 检查 hosts 是否绑错 IP

cat /etc/hosts

若里面把 download.bt.cn 等宝塔域名错误绑到了其他 IP,注释或删除对应行,再 ping download.bt.cn 确认解析回正确地址。

4. 检查代理设置

echo $HTTP_PROXY
echo $HTTPS_PROXY
echo $http_proxy
echo $https_proxy

正常应输出为空。有代理时,去 /etc/profile 注释或删除 export http_proxy=... 这类行,source /etc/profile 生效后重试。

换 wget 或手动下载兜底

排查完仍下载慢,可以换 wget 断点续传,或手动下载脚本再执行:

wget https://download.bt.cn/install/install_panel.sh
bash install_panel.sh docscenter

只要 download.bt.cn 本身可达(拨测已经证明),这条链路打通后,下载和安装通常就能顺利完成。

小结

安装脚本下载失败/太慢,先别怀疑宝塔官网挂了:download.bt.cn 在全国 42 个省份的拨测成功率是 99%,下载源本身是好的。真正要查的是服务器侧的网络连通性 → DNS → hosts → 代理四步,多数情况几分钟就能定位并恢复。

本文所述安装命令、排查命令以宝塔官方文档「安装面板」与「面板无法连接官网问题排查」为准;拨测数据为 2026-09-20 一次实测,节点池与线路动态变化,仅供参考。

常见问题

安装宝塔面板时脚本下载失败,是宝塔官网挂了吗?

大概率不是。用宝塔拨测实测 download.bt.cn 在全国 42 个省份的 302/305 个节点成功返回 HTTP 200,下载源本身可达。下载失败几乎都出在服务器到下载源的链路,按网络连通性、DNS、hosts、代理的顺序逐项排查。

curl 下载 install_panel.sh 提示 Could not resolve host 怎么办?

这是 DNS 解析失败。先 cat /etc/resolv.conf 查看当前 DNS,把 223.5.5.5、114.114.114.114、8.8.8.8 写入 resolv.conf 后再 curl -vvv download.bt.cn 验证解析是否恢复。

服务器能 ping 通外网但下载脚本还是超时怎么办?

先确认 ping 的是不是 download.bt.cn 本身。若 ping baidu.com 正常但 ping download.bt.cn 失败,是宝塔域名解析或线路问题;检查 /etc/hosts 是否把 bt.cn 相关域名绑错了 IP,并检查是否设置了 HTTP/HTTPS 代理。

下载很慢、半天才几个字节怎么办?

可以用 wget 替代 curl 断点续传,或先手动下载 install_panel.sh 再执行。下载慢多为服务器出口带宽或到下载源线路问题,可在服务器上 curl -vvv download.bt.cn 看耗时与解析结果定位。

安装脚本下载超时,换 wget 会好一点吗?

可以一试。正式版安装命令里本就内置了 curl/wget 二选一的回退:有 curl 用 curl -sSO,否则 wget -O。单独用 wget 下载 install_panel.sh 再执行 bash install_panel.sh docscenter,同样能完成安装。