寶塔面板安裝

適合有一臺 Linux 伺服器、想用圖形介面管理的人。全程大約 15 分鐘。

想省事的話看 Docker 安裝，三分鐘跑起來，也不用裝資料庫。

第一步：裝寶塔面板

伺服器系統推薦 CentOS 7+ / Debian 11+ / Ubuntu 20.04+。用 SSH 連上伺服器，按 https://www.bt.cn/new/download.html 上對應系統的一行命令安裝。

裝完螢幕會列印面板地址、賬號、密碼，先抄下來。

第二步：裝執行環境

第一次登入面板會彈出推薦套件，選 LNMP，然後按下面選版本：

元件	選什麼
Nginx	任意版本
MySQL	5.7 或以上
PHP	8.0 以上，推薦 8.2

點「一鍵安裝」，等它裝完（大約 10 分鐘，可以先幹別的）。

第三步：裝 bcmath 擴充套件（關鍵，別跳過）

寶塔預設不裝 bcmath，而程式所有的金額計算都靠它，缺了會直接白屏報致命錯誤。

1. 左側選單 → 軟體商店 → 找到你裝的 PHP 版本 → 點 設定
2. 切到 安裝擴充套件 標籤
3. 找到 bcmath，點安裝

順便確認這幾個也在：gd、curl、zip、pdo_mysql。寶塔一般預設帶了。

安裝嚮導第一步會自動體檢，缺哪個擴充套件會直接列出來，裝完重新整理即可。

第四步：建站點

1. 左側選單 → 網站 → 新增站點
2. 域名填你的域名（還沒域名就填伺服器 IP）
3. 資料庫選 MySQL，賬號密碼它會自動生成，記下來
4. PHP 版本選你剛裝的那個
5. 提交

第五步：上傳原始碼

1. 從 https://faka.wiki/download.php 下載壓縮包（訪問 GitHub 順暢的話也可以直接從倉庫下）
2. 在寶塔 → 檔案 → 進入網站根目錄（一般是 /www/wwwroot/你的域名）
3. 上傳壓縮包，右鍵 解壓
4. 解壓後如果多了一層資料夾（比如 acg-faka-main），進去把裡面的檔案全選剪下到網站根目錄，讓 index.php 直接躺在根目錄下

根目錄下能直接看到 index.php、app、kernel、config 這些，就對了。

第六步：配置偽靜態

這一步不做，網站只有首頁能開啟，點任何連結都是 404。

網站 → 點你的站點 → 偽靜態，把 nginx 偽靜態規則 整段粘進去，儲存。

用 Apache 的話不用配，程式根目錄的 .htaccess 已經寫好了。

第七步：設定目錄權限

網站 → 點你的站點 → 網站目錄 → 把所有者設為 www，或者在 檔案 裡選中網站根目錄 → 右鍵 權限 → 所有者填 www，勾上「應用到子目錄」。

程式需要寫這四個地方：config、runtime、kernel/Install、assets/cache。

第八步：開始安裝

瀏覽器開啟你的域名，會看到安裝嚮導：

1. 環境檢測 —— 有紅叉就照著提示裝擴充套件或改權限
2. 資料庫 —— 填第四步寶塔給你的資料庫名、賬號、密碼，地址填 127.0.0.1
3. 站長賬號 —— 設定後臺的郵箱和密碼
4. 點安裝，等它跑完

裝完後臺地址是 https://你的域名/admin。

接下來

• 繫結域名、上 HTTPS、綁多個域名：見域名與 HTTPS 證書
• 讓店鋪快起來：效能最佳化（裝 Redis，效果非常明顯）
• 開始用：快速上手

常見問題

現象	原因
只有首頁能開啟，點啥都 404	偽靜態沒配，回第六步
白屏 / 500	多半缺 bcmath，回第三步；也看下網站根目錄的 runtime.log
安裝嚮導提示目錄不可寫	權限沒給，回第七步
資料庫連線失敗	地址填 127.0.0.1，賬號密碼用寶塔生成的那組

更多見 常見問題。