宝塔面板更新失败、软件商店装不上软件怎么排查？

宝塔面板点更新没反应、软件商店装了软件一直装不上，很多人的第一反应是「宝塔官方服务器是不是挂了」。多数情况下不是——我用宝塔拨测对下载源 download.bt.cn 做了一次全国探测，315/319 个节点成功（98.7%）、覆盖 42 个省份、全部返回 HTTP 200，下载源本身是通的。问题通常出在你服务器到下载源的链路，或账号权益没刷新，而不是官方挂了。

下面按「服务器连通性 → 更新源/下载源 → 账号权益 → 面板修复」四步排查，几分钟就能定位。

先确认：下载源本身可达吗？

面板更新、软件商店装软件，都要从 download.bt.cn 拉数据。判断「官方挂了」还是「你的服务器连不过去」，可以用宝塔拨测（https://t.bt.cn/）对 download.bt.cn 做一次全国探测。我这次实测的结果：

• 节点：选中 319，成功 315（成功率 98.7%）
• 覆盖：42 个省份（大陆 31 个 + 港澳台及海外 11 个）
• 状态码：全部返回 HTTP 200
• 耗时：中位数 90.3ms，p95 301.2ms，官方聚合平均 143.8ms
• 失败 4 个节点均为检测节点侧问题：江苏宿迁移动（目标地址被阻断）、香港 BGP3（超时）、安徽滁州联通（DNS 解析失败）、美国节点（IPv6 网络不可达）

结论很清楚：下载源全国可达，更新/装软件失败要往你自己服务器这一侧找原因。

第一步：确认服务器到下载源的连通性

在服务器命令行执行，看能不能访问到下载源：

curl -vvv download.bt.cn

• 提示 Could not resolve host：DNS 解析失败。执行 cat /etc/resolv.conf 检查配置，把公用 DNS（223.5.5.5、114.114.114.114、8.8.8.8）写入后重试。
• 能解析但连接超时：检查服务器出口网络、云安全组是否放行 80/443 出站，以及本地防火墙是否拦截了出站流量。
• 能访问但被劫持：检查 /etc/hosts 是否把 download.bt.cn 等域名错误绑定到了别的 IP，有就删除对应行。

服务器开了代理也可能导致异常，执行 echo $HTTP_PROXY、echo $HTTPS_PROXY 看是否有代理配置，有就在 /etc/profile 里注释掉再 source /etc/profile 生效。

第二步：区分是「面板更新失败」还是「软件安装失败」

这两个场景虽然都走下载源，但排查重点不一样：

面板更新失败——面板首页右上角点「更新」按钮即可在线更新；进不去面板或更习惯命令行时，SSH 执行 bt 34 按提示选择更新源完成升级。更新只影响面板程序，不影响网站、数据库等用户数据。

软件商店装软件失败——按「软件商店 → 找到软件 → 安装 → 立即安装」的流程操作。如果软件是专业版/企业版的权益软件、却一直装不上，先点软件商店页面右上角的**「更新软件列表和支付状态」**按钮，让系统同步账号权益，同步后即可安装对应权益软件。

第三步：面板更新一直失败，走「修复」彻底处理

更新反复失败时，有两个由浅入深的修复办法：

1. 面板内修复：面板首页右上角点「修复」按钮，在弹窗里点「继续修复」，等待完成即可。
2. 脚本重装面板 Python 环境：若面板都进不去了，SSH 先备份旧环境，再重新执行更新脚本：

mv /www/server/panel/pyenv/ /www/backup/pyenv_backup
curl https://download.bt.cn/install/update_panel.sh | bash

命令执行完后面板会恢复到最新版本，重新访问面板地址验证即可。这个操作只针对面板使用的 Python 环境，不影响网站、数据库数据。

第四步：检查是否开了离线模式

面板的离线模式会完全切断与宝塔官网的连接，导致软件商店、面板更新、插件市场等依赖官网的功能全部失效。在面板设置里检查并关闭离线模式后重试。

排查逻辑参考官方文档：面板无法连接官网排查（https://docs.bt.cn/faq/connect-error）、如何更新宝塔面板（https://docs.bt.cn/getting-started/update-panel）、如何修复面板（https://docs.bt.cn/getting-started/fix-panel）、软件商店一键安装软件（https://docs.bt.cn/user-guide/soft/install）。