aaPanel（寶塔）面板安裝

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

aaPanel 的介面是英文的。下面提到的選單和按鈕都照介面原樣寫英文，第一次出現時在括號裡註明意思。

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

第一步：裝 aaPanel

伺服器系統推薦 Ubuntu 22.04（aaPanel 官方推薦），也支援 CentOS 7、Debian 10/11/12、Ubuntu 18.04/20.04、AlmaLinux 8/9、Rocky Linux 8。配備最低 1 核心、512 MB 記憶體，建議 1 GB 以上。最好用一臺剛重灌、沒裝過其他環境的伺服器。

用 SSH 以 root 身分連上伺服器，執行這條命令安裝免費版：

URL=https://www.aapanel.com/script/install_panel_en.sh && if [ -f /usr/bin/curl ];then curl -ksSO $URL ;else wget --no-check-certificate -O install_panel_en.sh $URL;fi;bash install_panel_en.sh

命令以官網 https://www.aapanel.com/new/download.html 為準，官網換了就照官網的來。

安裝要幾分鐘，裝完畫面會顯示面板網址、使用者名稱和密碼，先抄下來。

第二步：裝執行環境

第一次登入面板會跳出推薦的軟體套件，選 LNMP（Nginx + MySQL + PHP），然後按下面選版本：

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

點安裝，等它裝完（大約 10 分鐘，可以先做別的事）。

aaPanel 的 PHP 已經內建 bcmath（程式所有的金額計算都靠它），不用另外裝；gd、curl、zip、pdo_mysql 一般也都有。

安裝嚮導第一步會自動體檢，萬一缺了哪個擴充套件會直接列出來。到 App Store（軟體商店）→ 你裝的 PHP 版本 → Setting（設定）→ Install extensions（安裝擴充套件）裡裝上，重新整理即可。

第三步：建立網站

1. 左側選單 → Website（網站）→ Add site（新增網站）
2. 域名填你的域名（還沒域名就填伺服器 IP）
3. 根目錄保持預設的 /www/wwwroot/你的域名 就好
4. Database（資料庫）選 MySQL，資料庫名稱、使用者名稱、密碼會自動產生，記下來
5. PHP version（PHP 版本）選你剛裝的那個
6. 送出

第四步：上傳原始碼

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

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

第五步：設定偽靜態

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

Website → 點你的網站 → URL rewrite（偽靜態），把 nginx 偽靜態規則 整段貼進去，儲存。

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

第六步：設定目錄權限

在 Files 裡選取網站根目錄 → Permission（權限）→ 所有者填 www，並套用到子目錄。

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

第七步：開始安裝

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

1. 環境檢測 —— 有紅叉就照著提示裝擴充套件或改權限
2. 資料庫 —— 填第三步 aaPanel 產生的資料庫名稱、使用者名稱、密碼，地址填 127.0.0.1
3. 站長帳號 —— 設定後臺的郵箱和密碼
4. 點安裝，等它跑完

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

接下來

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

常見問題

現象	原因
只有首頁能開啟，點啥都 404	偽靜態沒配，回第五步
白屏 / 500	先看網站根目錄的 runtime.log，真正的錯誤訊息通常都在裡面；還沒裝完的話，看安裝嚮導的環境檢測有沒有紅叉
安裝嚮導提示目錄不可寫	權限沒給，回第六步
資料庫連線失敗	地址填 127.0.0.1，使用者名稱和密碼用 aaPanel 產生的那組

更多見 常見問題。