# 常見問題
### **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)
待整理……
