宝塔插件安装失败主因是系统网络源失效或DNS解析异常，需先验证curl -I https://www.bt.cn/api/plugin连通性，再检查DNS污染、SSL证书、安全组及挂载参数等底层问题。
宝塔面板
插件安装失败，90% 不是授权或账号问题，而是
云服务
器的 DNS 解析异常或系统网络源（yum/apt）本身已失效——面板只是暴露了底层网络链路断裂。
curl -I https://www.bt.cn/api/plugin 返回超时或 SSL 错误
这是“元数据层”断连，说明面板根本拿不到插件列表。不是服务器不能上网，而是请求被拦截、DNS 污染，或 HTTPS 证书校验失败。
先执行
，若卡住或报
，临时绕过验证：编辑
，把
改为
，再运行
若
解析出非官方 IP（如 123.123.123.123），说明 DNS 被污染，直接绑定可信地址：
别只改
——宝塔部分请求走 IP 直连，DNS 无效；重点检查安全组是否放行 outbound 的 443 端口
插件列表能显示，但点安装后卡在“正在下载安装脚本”
说明元数据拿到了，但拼出的脚本 URL（如
）无法访问。这个环节常被 CDN 限流、域名劫持或路径失效卡住。
云锁服务器端
云锁服务器端
下载
打开浏览器开发者工具（F12），切到 Network 标签，点击安装，找到状态为
或返回
的
请求，复制完整 URL
在终端执行
，看是否返回
或
确认是
问题后，手动替换域名：把 URL 中的
换成
（注意保留原始路径，如
）
yum 或 apt 本身已瘫痪，导致依赖拉不下来
插件安装卡在“正在下载”或报
，尤其是 CentOS 8+、Rocky/AlmaLinux 用户——
已下线，官方源不可达，系统级包管理器根本跑不动。
CentOS 7 用户：换阿里云 vault 源：
，再执行
CentOS 8 Stream / Rocky 8 / AlmaLinux 8 用户：不能硬套 CentOS 7 的 repo 文件，必须用宝塔官方适配脚本：
（该脚本已内置 Stream 兼容逻辑）
执行
验证本地网络通不通；若超时或报
，优先修 DNS 或换镜像脚本
真正容易被忽略的是：插件安装失败往往不是宝塔的问题，而是系统级网络源或挂载参数出了问题。比如
分区被挂载为
或
，或者 SELinux 启用后静默拒绝写入——这些都会让安装脚本下载成功却执行失败，现象和网络问题高度相似，排查时得一层层拆开看。
curl -I https://www.bt.cn/api/pluginSSL certificate problem/www/server/panel/data/panelConfig.confssl_verify0bt restartnslookup www.bt.cnecho "103.224.251.67 www.bt.cn" >> /etc/hosts/etc/resolv.confhttps://download.bt.cn/install/plugin/nginx/install.shpending403install.shwget -S [复制的URL]403 Forbidden404 Not Founddownload.bt.cndownload.bt.cnghproxy.com/https://raw.githubusercontent.com/btpanel/bt-plugin/master//plugin/nginx/install.shConnection refusedmirrors.centos.orgmv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.bak && curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-vault-7.9.2009.repoyum clean all && yum makecachecurl -sSO https://download.bt.cn/install/install_6.0.sh && bash install_6.0.shcurl -I https://mirrors.aliyun.comCould not resolve host/wwwnoexecro