# 常见问题 ### **IP效验失败,您的访问IP为[127.0.0.1]** 如安装或使用中出现该提示,请将提示IP加入宝塔面板API接口IP白名单中 >[danger] `1.3.0`版本请注意:如已添加127.0.0.1还是提示该错误,请删除`/runtime`目录重试即可 ![](https://img.kancloud.cn/a1/65/a165b3fc9a8070a8c5e42cfd9f2a4c55_512x399.png) ### **服务器连接失败** 存在诸多因素,请自行判断 1. 服务器内部禁止127.0.0.1访问 解除该防火墙即可 2. 宝塔面板绑定域名 目前宝塔机制如此,等待后续优化,可取消宝塔面板域名绑定,改为IP访问面板 3. 宝塔面板IP白名单未添加 宝塔面板API接口需要添加`127.0.0.1`到IP白名单中 4. 授权站通讯失败 `ping auths.yum6.cn` `curl https://auths.yum6.cn` 测试两个命令看看服务器对授权站通讯是否异常,如有异常请自行处理 5. 面板通讯协议错误 默认使用http://协议进行通信,如果你的宝塔面板开启了面板ssl,请尝试选择使用https协议进行通讯 bthost后台 `常规管理` => `服务器配置` => `宝塔面板url协议` 进行切换 ### **Token验证错误!** 为保证系统框架运行安全,采用一次访问一次token的机制 当你打开A页面后,操作或打开B页面,A页面的token将会失效,故提示《Token验证错误!》 解决方案:触发后重新请求即可重置token ### **Windows Defender** 由于系统中存在部分加密代码,被Windows Defender识别为病毒文件自动删除,需要手动将这些文件加入白名单或关闭该防火墙,才能在Windows系统中正常安装和使用 ### **xxxx授权信息不正确/授权信息错误** ### **授权站已更换IP或续费授权后,提示授权过期或不正确等** ~~删除路径文件夹`/runtime/cache`后重试~~ `1.3.0`版本后更新授权码的方式如下三种 - 后台执行`一键清除缓存`(右上角) - 授权站手动获取离线授权码,填写到文件`/application/extra/auth.php`的`code`参数中 - 删除`/application/extra/auth.php`文件,或修改`code`参数为空,重新请求即可在线授权获取离线授权码 ### **后台地址** 找到文件路径`/public`下的`xxxxxxx.php`(随机文件名)就是你的后台地址,也可以修改任意文件名.php重新设置个性后台地址 ### **SEO搜索引擎抓取** 本系统特性为系统管理功能使用,已禁止所有搜索引擎抓取内容,常规下不会被搜索引擎所收录 如需允许搜索引擎抓取和收录,请删除网站目录文件`/public/robots.txt` ### **如何正确DEBUG(调试模式)?** 如果在程序使用中出现一些意外的报错或者不符合正常使用情况的,可以参考《[如何正确的Debug](https://bbs.btye.net/d/51)》进行功能调试,或打开后台网站配置中打开调试模式 ### **升级出现问题** 升级日志:`/update.log` 数据库备份:`/Data/` 如有必要请使用备份文件进行数据库恢复 ### **临时目录logs**' 此目录用于宝塔面板通讯缓存及控制台站点上传文件临时中转,可定期清理该目录文件,防止占用存储空间 ### **连续20次验证失败,禁止1小时** 这是由宝塔面板API验证发起的风险控制拦截,非btHost程序提示,可能出现以下原因 1、未将验证IP加入IP白名单 2、宝塔面板API接口密钥错误或重置过 完成以上检查等待一个小时后再次访问程序就能正常使用了 ### **你所浏览的页面暂时无法访问** 一般该提示说明你访问的页面或正在执行的操作存在报错,请阅读上面的`如何正确DEBUG(调试模式)?` 打开debug后再次访问查看具体报错内容,反馈或提交到[社区](https://bbs.btye.net)中 ### **系统更新后配置未更新/未生效** 由于系统框架局限,所以程序更新个别配置项未生效/未更新 请手动保存一次即可更新配置 ### **xxxxx控制器模块不存在** 存在以下问题: 1、浏览器对thinkphp框架不友好导致(更换浏览器访问) 2、由于系统部分代码加密,所以被杀毒软件误报后自动清除某些文件(关闭杀毒软件运行或将文件或路径加入白名单运行) ### **非白名单IP不允许请求** `系统配置`->`通信配置`->`IP允许名单` 修改或清空文本框中的IP ### **签名错误** 为了保证API接口通信安全性,签名有效期为10秒,所以需要保证服务器A与服务器B的时间及时区一致,尽可能保证小的误差 1. 将系统时间同步为硬件时间 ~~~ clock && date hwclock --hctosys ~~~ 2. 先同步服务器网络时间为系统时间,再将系统时间同步为硬件时间 ~~~ yum -y install ntp ntpdate ntpdate cn.pool.ntp.org hwclock --systohc ~~~ 以上两种方法是同步服务器时间的方法,也可以使用宝塔面板中的`Linux工具箱`进行时区同步(但不保证服务器时间能精确同步 ### **域名编号不正确** 请按照 [域名智能解析](域名智能解析.md) 配置完成 1. 如果你要使用dnspod智能解析,请删除`域名管理`中原域名重新添加,添加时一定要将`Dnspod智能解析`选择为`启用` 2. 如果你不使用dnspod智能解析,请修改`域名管理`中域名`Dnspod智能解析`为禁用 ### **该插件没有扩展方法** - 开通时出现,请在资源套餐中找到`vsftpd插件`选择不开启 - 控制面板中出现,请在宝塔面板中安装对应模块插件 ### **FTP不能登录** FTP存在主动与被动连接模式,两者使用的端口都是不同的 服务器安全组/宝塔安全端口中都应该加入如下端口的规则 主动:20端口 被动:39000-40000 ![](https://img.kancloud.cn/0f/89/0f8900838c589170560d639920fa6bfb_1055x275.png) ![](https://img.kancloud.cn/4d/14/4d14b7af41f1f8c40d47f5d0f19a4017_1901x539.png) **所以我们应该在服务器中打开20/39000-40000端口,才能正常使用FTP服务** 连接FTP时建议选择被动模式连接 ![](https://img.kancloud.cn/f6/27/f6272297548407d65a30604c4b4f998b_693x512.png) 也可以尝试使用这个插件 [https://www.bt.cn/bbs/forum.php?mod=viewthread&tid=23952](https://www.bt.cn/bbs/forum.php?mod=viewthread&tid=23952) ### **btHost迁移** 由于本程序仅支持运行在宝塔面板中,所有数据都是该服务器独有,所以迁移意义不大,且容易造成数据紊乱,不建议迁移。 如特殊情况需要迁移,请按照以下流程进行操作 1. 删除文件application/extra/auth.php并重新进行程序授权 2. 修改btHost后台`系统配置`=>`服务器配置`=>`宝塔面板接口密钥`为当前面板的API接口密钥(请确保API接口IP已白名单加入127.0.0.1 3. btHost后台`主机列表`全部都需要执行`同步`操作才能正常使用 4. 更换FTP、数据库管理地址为当前服务器的 5. `计划任务`重新执行`一键监控` ### **面板中没有文件但占用很大** 如清除缓存后依然如此,请阅读下文 本程序因安全问题隐藏了所有非www用户组的文件,可能站点中存在许多非www权限组的文件,如上传的临时文件、远程下载的文件等 可用以下方式进行处理: 1. 管理员进行手动处理 2. 使用在线文件管理(FTP)进行处理 3. 使用站点重置功能进行一键重置 ### **安装时出现502 Bad Gateway** 初步排查是由于安装时写入数据库超时引起(服务器硬盘读写瓶颈),可参考[程序安装](程序安装.md)中的手动安装流程操作 ### **PHP版本列表** 问题描述:已经在宝塔面板中安装了很多PHP版本,但在控制面板中不显示 问题处理:基本是由程序缓存逻辑导致,执行以下选其一操作即可 1、后台右上角一键清除缓存 2、前台控制面板右上角清除缓存 3、删除cache目录清除缓存 Ps:还有更多场景需要执行清除缓存操作,如:切换运行环境(Nginx/Apche),切换防火墙插件,切换防篡改插件、主机同步等 ### **更多** >[success] 可以到社区进行反馈[bbs.btye.net](https://bbs.btye.net) 待整理……