document.writeln('');
寶塔插件安裝失敗主因是系統(tǒng)網(wǎng)絡源失效或DNS解析異常,需先驗證curl -I https://www.bt.cn/api/plugin連通性,再檢查DNS污染、SSL證書、安全組及掛載參數(shù)等底層問題。

寶塔面板插件安裝失敗,90% 不是授權(quán)或賬號問題,而是云服務器的 DNS 解析異?;蛳到y(tǒng)網(wǎng)絡源(yum/apt)本身已失效——面板只是暴露了底層網(wǎng)絡鏈路斷裂。
這是“元數(shù)據(jù)層”斷連,說明面板根本拿不到插件列表。不是服務器不能上網(wǎng),而是請求被攔截、DNS 污染,或 HTTPS 證書校驗失敗。
curl -I https://www.bt.cn/api/plugin,若卡住或報 SSL certificate problem,臨時繞過驗證:編輯 /www/server/panel/data/panelConfig.conf,把 ssl_verify 改為 0,再運行 bt restartnslookup www.bt.cn 解析出非官方 IP(如 123.123.123.123),說明 DNS 被污染,直接綁定可信地址:echo "103.224.251.67 www.bt.cn" >> /etc/hosts/etc/resolv.conf——寶塔部分請求走 IP 直連,DNS 無效;重點檢查安全組是否放行 outbound 的 443 端口說明元數(shù)據(jù)拿到了,但拼出的腳本 URL(如 https://download.bt.cn/install/plugin/nginx/install.sh)無法訪問。這個環(huán)節(jié)常被 CDN 限流、域名劫持或路徑失效卡住。

創(chuàng)建或更新經(jīng)過代理的 Cloudflare DNS A 記錄,用于通過編程方式將子域名指向 IP 地址。輸入?yún)?shù)為記錄名稱、區(qū)域名稱和 IP 地址。
pending 或返回 403 的 install.sh 請求,復制完整 URLwget -S [復制的URL],看是否返回 403 Forbidden 或 404 Not Founddownload.bt.cn 問題后,手動替換域名:把 URL 中的 download.bt.cn 換成 ghproxy.com/https://raw.githubusercontent.com/btpanel/bt-plugin/master/(注意保留原始路徑,如 /plugin/nginx/install.sh)插件安裝卡在“正在下載”或報 Connection refused,尤其是 CentOS 8+、Rocky/AlmaLinux 用戶——mirrors.centos.org 已下線,官方源不可達,系統(tǒng)級包管理器根本跑不動。
mv /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.repo,再執(zhí)行 yum clean all && yum makecachecurl -sSO https://download.bt.cn/install/install_6.0.sh && bash install_6.0.sh(該腳本已內(nèi)置 Stream 兼容邏輯)curl -I https://mirrors.aliyun.com 驗證本地網(wǎng)絡通不通;若超時或報 Could not resolve host,優(yōu)先修 DNS 或換鏡像腳本真正容易被忽略的是:插件安裝失敗往往不是寶塔的問題,而是系統(tǒng)級網(wǎng)絡源或掛載參數(shù)出了問題。比如 /www 分區(qū)被掛載為 noexec 或 ro,或者 SELinux 啟用后靜默拒絕寫入——這些都會讓安裝腳本下載成功卻執(zhí)行失敗,現(xiàn)象和網(wǎng)絡問題高度相似,排查時得一層層拆開看。