# 常见问题
### **IP效验失败，您的访问IP为[127.0.0.1]**
如安装或使用中出现该提示，请将提示IP加入宝塔面板API接口IP白名单中
>[danger] `1.3.0`版本请注意：如已添加127.0.0.1还是提示该错误，请删除`/runtime`目录重试即可
### **服务器连接失败**
存在诸多因素，请自行判断
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(调试模式)？**
如果在程序使用中出现一些意外的报错或者不符合正常使用情况的可参考以下方式打开调试模式
1. 修改路径`application/config.php` 中 `'app_debug' => Env::get('app.debug', false),`为`'app_debug' => Env::get('app.debug', true),`
2. 打开网站后台中基础配置，打开调试模式
>[warning] 开启调试模式后静态资源将动态加载，正常运行情况下请勿打开，会影响网站加载速度
### **升级出现问题**
升级日志：`/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
**所以我们应该在服务器中打开20/39000-40000端口，才能正常使用FTP服务**
连接FTP时建议选择被动模式连接
也可以尝试使用这个插件
[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），切换防火墙插件，切换防篡改插件、主机同步等
### **后台登录地址跳转404**
> 在确认访问后台地址无误的情况下，访问后跳转404，可通过修改站点php版本解决，PHP运行环境范围（PHP >= 7.1 且 < 7.3）
### **更多**
>[success] 可以到社区进行反馈[bbs.btye.net](https://bbs.btye.net)
待整理……
