安装插件前须确认架构（x86_64/aarch64）、宝塔版本≥7.9.0、网络可用性（推荐离线安装）；否则易因架构错配、版本过低或下载失败导致安装中断。
插件安装前必须确认的三件事
宝塔面板装插件不是点一下就完事，很多失败都卡在前期准备上。最常被忽略的是架构、权限和网络——这三个没对齐，后面全白忙。
- 先跑
uname -m看清服务器是x86_64还是aarch64（比如树莓派或国产ARM服务器），离线包选错架构直接启动失败 - 宝塔面板得是
7.9.0及以上版本，老版本（如 7.7.x）装 Frp、FSS 这类第三方插件会报module 'panel' has no attribute 'get_plugin_list' - 国内服务器别信“在线一键安装”，尤其装 GitHub 源的插件时，
curl: (7) Failed to connect是常态；建议本地下载好.zip包，再通过面板「离线安装」上传
离线安装失败的典型报错与修复
上传压缩包后提示「安装失败」或「依赖检测不通过」，基本就两类原因：系统级依赖缺失，或插件目录权限锁死。
- 如果日志里出现
openssl-devel: No such package或libssl-dev: unable to locate package，说明 OpenSSL 开发头文件没装：
CentOS/Alibaba Cloud Linux 执行yum install -y openssl-devel，Ubuntu/Debian 改用apt-get install -y libssl-dev - 安装后插件图标灰掉、点不开，大概率是权限问题：
chmod -R 755 /www/server/panel/plugin/frp（把frp换成你实际装的插件名，比如fss、nginx_firewall） - 极少数情况是 SELinux 拦着了，临时关一次验证：
setenforce 0；若确认是它导致，再按需调整策略，别长期关闭
插件配置后不生效？检查服务状态和端口冲突
比如装完 Frp 插件，填了 bind_port = 7000 却连不上；或装了 Nginx 防火墙，但攻击日志空空如也——往往不是配置错，而是服务根本没跑起来。
- 进宝塔「安全」页，确认
7000、7500（Frp dashboard）、888（宝塔自身）这些端口没被云厂商安全组拦截（腾讯云/阿里云控制台要手动放行） - 在终端执行
ps aux | grep frpc或systemctl status bt-frp，看进程是否存在；没有就说明插件只装了壳，没启服务 - 多个插件共用同个端口会互顶，例如 Frp 和某个自建 Web 服务都占
80，宝塔不会报错，但后者必然 502；改配置前先netstat -tuln | grep :80扫一遍
已安装插件无法升级或卸载怎么办
点「卸载」按钮没反应，或者升级后功能异常（比如防篡改插件开启后网站全 500），通常是因为插件残留了运行时状态或配置钩子。
- 别直接删
/www/server/panel/plugin/xxx目录——这会导致宝塔前端菜单还在，但点击就报KeyError: 'xxx' - 正确做法是先停服务：
bash /www/server/panel/plugin/xxx/index.sh stop，再点面板里的卸载按钮；如果按钮灰了，就手动执行rm -f /www/server/panel/data/plugin.json && bt reload - 升级失败后页面错乱，大概率是前端缓存没刷，强制刷新无效时试试清空浏览器中
https://你的IP:8888的全部 Cookie 和缓存，或者换无痕窗口重登
uname -m 和 bt status，比装完再折腾两小时强得多。 
