宝塔面板不自动识别手动安装软件，因其软件列表仅依赖后台索引文件（softlist.json）和模块注册状态，而非扫描系统路径；手动安装未触发面板元数据写入或初始化探测，故不会显示。
宝塔面板不会自动识别手动安装的软件，因为它的软件列表完全依赖后台索引数据（softList.json）和运行时模块注册状态，而非系统全局的二进制路径扫描。
为什么手动安装的软件不进软件列表
宝塔的“软件管理”模块只显示两类东西：一是通过面板点击安装的软件（会写入数据库、生成 service 文件、注册到 /www/server/panel/data/ 下的元数据）；二是部分预装环境（如 CentOS 7 自带的 mariadb）在首次启动面板时被自动探测并录入——但这个探测仅发生在面板初始化阶段，后续手动装的完全不触发。
常见误操作包括：apt install nginx、yum install mysql-community-server、或源码编译后直接 make install，这些都不会让宝塔知道“这玩意儿存在”。
- 面板不读取
which nginx或systemctl list-units | grep mysql - 它只查自己维护的
/www/server/panel/data/下的serverStatus.json、softList.json和数据库表soft - 即使你把二进制软链到
/www/server/nginx，没走安装流程，面板仍当它不存在
用导入功能关联现有环境的前提条件
“导入”不是万能挂钩，它只支持有限的软件类型，且要求目录结构、配置文件路径、进程名严格匹配面板内置规则。目前明确支持导入的只有：nginx、apache、mysql、php、pure-ftpd、redis（部分版本）、memcached。
执行导入前必须满足：
- 服务已正常运行（
systemctl is-active nginx返回active） - 主程序路径符合约定，例如 Nginx 必须在
/usr/sbin/nginx或/www/server/nginx/sbin/nginx - 配置文件路径可被识别，如 Nginx 配置需在
/etc/nginx/nginx.conf或/www/server/nginx/conf/nginx.conf - 没有同名服务已被面板管理（比如已用面板装过一次 nginx，再导入会失败）
不满足任一条件，点击“导入”按钮后界面无反应，或提示“未检测到可用服务”。
导入操作的具体步骤与易错点
进入「软件管理」→ 右上角「导入」按钮 → 勾选目标软件 → 点击「确定」。实际生效靠的是后台命令 bt 28（导入 Nginx）、bt 29（导入 MySQL）等，但用户不可见。
容易踩的坑：
- MySQL 导入失败常因 socket 路径不对：面板默认找
/tmp/mysql.sock，而手动安装可能在/var/lib/mysql/mysql.sock，需先软链或修改my.cnf - PHP 导入后站点 502，大概率是 php-fpm.sock 路径不一致，要检查
php-fpm.conf中的listen值是否匹配面板预期 - 导入成功后，软件列表里图标是灰色的，说明状态未同步，需手动执行
bt 19重载软件管理模块 - 导入不等于接管：日志路径、备份策略、SSL 自动续签等功能仍需手动配置，面板不会自动迁移
导入后仍不显示？检查 softList.json 是否加载
导入只是把服务信息写进数据库和 /www/server/panel/data/ 下的运行时文件，但如果 softList.json 损坏或为空，前端依然渲染不出卡片。此时不能只刷网页，得确认后端数据就绪：
- 执行
ls -l /www/server/panel/data/softList.json，确保文件存在且非空 - 若为空或 0 字节，手动拉取：
curl -sS https://api.bt.cn/api/softlist > /www/server/panel/data/softList.json - 再执行
bt 19，然后强刷浏览器（Ctrl + Shift + R） - 如果还是空白，看
/tmp/panelBoot.pl日志里有没有softList load failed类报错
真正卡住的地方往往不是“怎么导入”，而是导入之后那一层缓存没清、索引没重载、或者前端压根没拿到 JSON 数据——这些环节松散耦合，缺一不可。
