宝塔面板安装插件提示网络连接超时，通常是因为服务器无法解析宝塔官方域名或出站端口被防火墙拦截。优先检查服务器 DNS 配置和安全组出站规则，不要盲目重装面板。

命令速用版

ping www.bt.cn
curl -I https://www.bt.cn
bt 14

上述命令分别用于测试域名连通性、检查 HTTP 响应头和查看面板版本。

为什么会这样

插件安装依赖服务器主动连接宝塔官方更新服务器，DNS 解析失败或 TCP 连接被阻断都会导致超时。

宝塔面板插件列表和安装包存储在官方 CDN 节点，服务器需要解析域名并建立 HTTPS 连接。如果本地 DNS 污染或云厂商安全组默认禁止出站流量，请求会在握手阶段丢弃。

分步处理

步骤 1：检查网络连通性

在 SSH 终端执行 ping www.bt.cn。如果出现 unknown host 或 100% packet loss，说明 DNS 或网络链路异常。

步骤 2：修改 DNS 配置

编辑 /etc/resolv.conf 文件，将 nameserver 改为 114.114.114.114 或 8.8.8.8。保存后执行 systemctl restart network 或重启服务器。

步骤 3：检查安全组规则

登录云控制台，检查安全组出站规则（Outbound）。确保 TCP 协议的 80 和 443 端口允许放行。部分云厂商默认禁止所有出站流量。

步骤 4：离线安装插件

如果在线安装持续失败，可在宝塔官网下载插件安装包（.zip 或 .sh），上传至服务器后通过面板“本地安装”功能导入。

怎么验证是否生效

刷新宝塔面板插件商店页面，查看插件列表是否正常加载。尝试安装一个小型插件（如 Nginx 防火墙免费版），观察进度条是否走完且无报错。

检查安装日志 /tmp/bt_install.log 或面板日志 /www/wwwlogs/ 下是否有 connection timed out 错误。

常见坑

• IPv6 优先导致解析慢：部分服务器 IPv6 配置不当，建议在 /etc/gai.conf 中禁用 IPv6 优先策略。
• 面板版本过低：旧版本面板接口地址可能变更，使用命令 bt update 升级到最新版。
• 本地 hosts 污染：检查 /etc/hosts 是否有关于 bt.cn 的异常绑定记录。

常见问题

插件安装一半失败怎么办

检查服务器磁盘空间是否不足，使用 df -h 查看根分区使用率。空间不足会导致解压失败从而报超时或错误。

能否手动修改插件下载源

不建议手动修改官方下载源地址，容易导致签名验证失败。优先解决网络连通性问题，或使用离线安装包。

重装面板能解决超时吗

不能。超时是网络层面的问题，重装面板不会改变服务器的 DNS 或安全组配置，反而会增加数据迁移风险。