# 程序安裝
[TOC]
## 程序授權
本程序為授權使用，一個授權資格只能應用一臺搭建寶塔面板的服務器，請確保服務器具備公網訪問能力
授權地址：[https://auths.yum6.cn](https://auths.yum6.cn)
活動通知：btHost預覽版可長期免費授權，解釋權歸屬作者！
授權模式：靜默授權，授權域名處填寫 **`服務器公網IP`**，不要填寫域名！！！
離線授權碼：`授權站用戶中心` => `授權列表` => `點擊顯示` => `復制授權碼`
>[warning] 授權更換IP、續費授權碼都會變動，刪除`/application/extra/auth.php`文件，或修改`code`參數為空，重新請求即可在線授權獲取離線授權碼
>[info] 如服務器無固定公網IP，且公網IP頻繁變動請等待后續優化
## 安裝包獲取
>[success] 程序授權后，授權列表右側按鈕進行下載
## 環境要求
~~~
PHP >= 7.1 且 < 7.3 (推薦PHP7.2版本，禁opcache插件)
Mysql >= 5.5.0 (需支持innodb引擎)
Apache 或 Nginx 或 IIS
PDO PHP Extension
MBstring PHP Extension
CURL PHP Extension
禁用防篡改
~~~
## 程序部署
>[danger] 本程序僅支持部署到運行寶塔面板的服務器中，不支持外部web空間安裝和使用
### **常規部署**
1. 上傳源代碼包到網站根目錄中（必須安裝在寶塔面板服務器中）
2. 解壓到網站根目錄
3. 設置運行目錄為public
>[warning] 請打開防跨站開關
4. 設置偽靜態為thinkphp
5. 設置PHP版本 PHP >= 7.1 且 < 7.3
### **一鍵部署**
1. 找到寶塔面板中的軟件管理
2. 點擊一鍵部署
3. 搜索項目名稱`bthost`
4. 點擊一鍵部署
5. 填寫域名、選擇PHP版本號等信息后提交
## 程序安裝
#### **在線安裝**
程序安裝地址：`/install.php`
1. 填寫數據庫信息
2. 填寫寶塔API密鑰、寶塔面板端口、面板Url協議
>[info] 寶塔API密鑰獲取地址：`寶塔面板` - `面板設置` - `API接口` - `接口密鑰`
> 將`127.0.0.1`和服務器公網IP加入IP白名單中保存并開啟API接口
> 
>>[danger] `1.3.0`版本請注意：如已添加127.0.0.1還是提示該錯誤，請刪除`/runtime`目錄重試即可
>[warning] 如遇授權檢查失敗，請多次嘗試授權即可，也可以在授權中獲取離線授權碼進行授權
3. 填寫管理員信息
4. 填寫網站信息
#### **手動安裝**
- 手動導入數據庫文件，位于`application\admin\command\Install\bthost.sql`（使用phpMyAdmin可能還是會超時502，建議使用第三方數據庫管理工具進行導入，如`/adminer.php`，`Navicat`，`SQL_Front`等等
- 手動寫入數據庫連接配置，位于`application\database.php`
- 手動寫入安裝鎖文件，位于`application\admin\command\Install`創建一個空文件`install.lock`
- 手動配置離線授權碼，位于`application\extra\auth.php`，填寫授權站獲取的離線授權碼
以上操作可完成程序安裝，安裝后進入后臺`/admin.php`，初始帳號密碼如下
帳號：`admin`
密碼：`admin000`
進入后臺后，請盡快按照 [初始化](初始化.md) 流程進行服務器配置（要不然會提示連讀20次驗證失敗封禁一小時），即可正常使用！
## 常見問題
1. 如果提示`當前權限不足，無法寫入配置文件application/database.php`，請檢查`database.php`是否可讀，還有可能是當前安裝程序無法訪問父目錄，請檢查PHP的`open_basedir`配置，請檢查是否已禁用`防篡改`
2. 如果提示`找不到bthost.bth_admin`表或表不存在，請檢查你的MySQL是否開啟了支持`innodb`
3. 更多問題請移步 [常見問題](常見問題.md)
