如何解决宝塔面板安装插件一直显示请求中的问题_清理浏览器缓存或切换面板通信节点

夜晨同学_9181

夜晨同学_9181

2026-04-10

895人浏览

原创

插件安装卡在“请求中”是前端假死,需强制刷新绕过缓存、检查Network面板请求状态、修正/etc/hosts绑定可用IP、用wget -S直测下载链路。

如何解决宝塔面板安装插件一直显示请求中的问题_清理浏览器缓存或切换面板通信节点

插件安装卡在“请求中”是前端假死,不是后端没响应

宝塔面板里点安装插件后长时间停在“请求中”,大概率不是服务器没干活,而是浏览器没收到响应或反复重试失败请求。这个状态通常意味着 AJAX 请求发出去了,但没拿到有效返回(比如 200、400 或超时错误),前端就一直转圈。真实原因往往藏在 Network 面板里——你得自己去看那个 install 请求到底卡在哪一环。

强制刷新浏览器缓存比清 Cookie 更关键

很多用户只清 Cookie 或点“清除浏览数据”,结果无效。宝塔前端 JS 文件(如 /static/js/soft.js)一旦被缓存,可能仍调用旧版接口逻辑,导致请求地址拼错或参数缺失。必须硬性刷新绕过所有本地缓存:

  • Windows/Linux:按 Ctrl + Shift + R
  • macOS:按 Cmd + Shift + R
  • 别依赖右键“重新加载”或 F5 —— 它们不强制更新 JS/CSS

刷新后打开开发者工具 → Network 标签 → 点安装插件 → 找到状态为 pending 或 failed 的请求,看 URL 和 Response 标签页内容。

面板通信节点被 CDN 劫持时,改 /etc/hosts 比换 DNS 有效

宝塔部分请求(如插件元数据、安装脚本下载)走的是域名直连,DNS 设置对它们无效。如果 api.bt.cn 或 download.bt.cn 被污染或指向故障节点,ping api.bt.cn 可能通,但 curl -I https://api.bt.cn/api/plugin 会卡住或返回 403。这时直接绑定可用 IP 最快:

  • 查可用 IP:dig api.bt.cn +short 或参考社区已验证的 IP(如 103.219.118.174)
  • 临时写入 hosts:echo "103.219.118.174 api.bt.cn" >> /etc/hosts
  • 确认无重复条目:grep -i 'bt\.cn' /etc/hosts,删掉其他冲突行
  • 改完不用重启网络服务,但要执行 bt restart 让面板重读配置

注意:不要加 www.bt.cn 或 download.bt.cn 到同一行,每个域名单独一行;IP 写错一个数字就会彻底断联。

page-agent 浏览器控制(CDP)
page-agent 浏览器控制(CDP)

使用 page-agent CLI(CDP)控制浏览器;CLI只能通过 GitHub Release 的 .tgz 安装,npm 官方包暂未发布。

下载

手动触发安装脚本下载失败时,用 wget -S 测试真实链路

Network 面板里看到 install.sh 请求卡在 pending,复制完整 URL(形如 https://download.bt.cn/install/plugin/mysql57/install.sh),粘贴到终端执行:

wget -S https://download.bt.cn/install/plugin/mysql57/install.sh

观察输出:

  • 若返回 HTTP/1.1 403 Forbidden:CDN 层拦截,需替换域名,例如把 download.bt.cn 改成 ghproxy.com/https://raw.githubusercontent.com/btpanel/bt-plugin/master/
  • 若卡住几秒后报 Connection timed out:出口 IP 被拉黑或防火墙未放行 443 出站
  • 若返回 HTTP/1.1 200 OK 但文件为空:脚本路径已失效,说明插件源元数据过期,需执行 bt 19 重载软件管理

这一步跳过了面板封装逻辑,直击下载链路本身,能快速区分是面板 bug 还是基础设施问题。

相关专题

更多
宝塔面板部署ThinkPHP6项目与LNMP环境配置实践
宝塔面板部署ThinkPHP6项目与LNMP环境配置实践

本专题围绕宝塔面板在 ThinkPHP6 项目部署中的实际应用展开,系统讲解 LNMP 环境一键搭建、站点创建、域名绑定、伪静态配置以及 PHP 版本切换等关键操作。内容还包括数据库配置、项目上传部署、运行目录设置及常见部署问题排查。通过完整上线流程演示,帮助开发者快速实现 ThinkPHP 项目的服务器部署与稳定运行,提升网站上线效率与运维能力。

2026.03.23

655

15

宝塔面板网站安全加固与防攻击配置实践
宝塔面板网站安全加固与防攻击配置实践

本专题围绕宝塔面板在网站安全防护中的应用展开,系统讲解防火墙配置、SSH 安全策略、登录保护、端口管理及恶意访问拦截机制。内容涵盖 CC 攻击防护、文件权限设置、敏感目录保护及安全日志分析,帮助用户全面提升服务器安全性。

2026.03.25

92

17

宝塔面板多站点管理与虚拟主机配置实践
宝塔面板多站点管理与虚拟主机配置实践

本专题讲解如何通过宝塔面板实现多站点部署与统一管理,包括站点创建、域名绑定、子站配置及资源隔离策略。通过实战案例,帮助用户高效管理多个网站项目,提高服务器利用率。

2026.03.25

179

21

宝塔面板Nginx性能优化与高并发配置实践
宝塔面板Nginx性能优化与高并发配置实践

本专题围绕宝塔环境下的 Nginx 优化展开,深入讲解缓存策略、连接数调优、Gzip 压缩、静态资源加速及反向代理配置。帮助用户提升网站访问速度与并发处理能力。

2026.03.25

976

29

宝塔面板数据库管理与MySQL性能调优实践
宝塔面板数据库管理与MySQL性能调优实践

本专题讲解宝塔面板中数据库管理与优化技巧,包括数据库备份恢复、慢查询日志分析、索引优化及连接数配置。通过实际案例,帮助用户提升数据库运行效率。

2026.03.25

241

25

宝塔面板SSL证书部署与HTTPS配置实践
宝塔面板SSL证书部署与HTTPS配置实践

本专题围绕网站 HTTPS 部署展开,讲解 SSL 证书申请、自动续签、强制 HTTPS 跳转及混合内容问题解决方案,提升网站安全与 SEO 表现。

2026.03.25

649

25

宝塔面板定时任务与自动化运维实践
宝塔面板定时任务与自动化运维实践

本专题讲解宝塔定时任务功能的使用,包括计划任务创建、Shell 脚本执行、日志管理及自动备份策略,帮助用户实现服务器自动化运维。

2026.03.25

207

23

宝塔面板FTP与文件权限管理实践
宝塔面板FTP与文件权限管理实践

本专题围绕文件管理与权限控制展开,讲解 FTP 创建、用户权限分配、文件读写控制及安全上传策略,保障网站文件安全。

2026.03.25

172

19

宝塔面板PHP环境配置与多版本切换实践
宝塔面板PHP环境配置与多版本切换实践

本专题讲解宝塔中 PHP 环境的配置方法,包括版本切换、扩展安装、运行参数优化及错误日志分析,适用于多项目运行场景。

2026.03.25

346

25

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
宝塔入门指引手册
宝塔入门指引手册

共0课时 | 0人学习

宝塔官方实践教程
宝塔官方实践教程

共0课时 | 0人学习