插件列表为空或异常时,可依次执行bt 30强制更新索引、清除plugin.json等缓存文件后重启面板、或手动下载替换plugin_list.json并校验重启。

如果您进入宝塔面板首页后发现插件列表为空或显示异常,可能是插件索引缓存损坏或远程插件源未正确加载。以下是刷新插件索引的具体操作步骤:
一、执行插件索引强制更新命令
该方法直接调用面板内置机制,从官方源重新拉取并重建插件索引数据库,适用于网络正常但本地索引失效的场景。
1、通过SSH连接服务器,以root用户身份登录。
2、执行以下命令触发插件索引刷新:
bt 30
3、等待命令执行完成,终端输出插件索引更新成功字样。
4、刷新宝塔面板网页,查看插件列表是否恢复显示。
二、清除插件缓存并重启面板服务
该方法清除本地插件元数据缓存文件,并通过重启服务促使面板重新初始化插件管理模块,适用于缓存文件损坏或版本不一致的情况。
1、执行命令停止宝塔面板:
bt 2
2、删除插件缓存目录:
rm -rf /www/server/panel/data/plugin.json /www/server/panel/data/plugin_list.json
3、启动宝塔面板:
bt 1
4、等待服务完全启动后,重新访问面板首页,观察插件列表是否加载。
三、手动下载并替换插件索引文件
该方法绕过自动更新机制,直接从宝塔官方CDN获取最新插件索引文件,适用于网络策略限制导致bt 30命令失败的环境。
1、执行命令下载最新插件索引:
wget -O /www/server/panel/data/plugin_list.json https://api.bt.cn/api/panel/get_plugin_list
2、校验文件完整性(确保非空且为合法JSON):
head -n 5 /www/server/panel/data/plugin_list.json
3、确认输出中包含类似"code":200,"data":[{的结构化响应。
4、重启面板服务使新索引生效:
bt restart









