升級與遷移

線上升級（推薦）

後臺左下角會顯示當前版本號，點它就能檢測新版本並一鍵升級。整個過程不用碰伺服器。

升級前先備份資料庫。寶塔使用者在 資料庫 → 備份 點一下就行，幾秒鐘的事，出問題能救命。

Docker 使用者同樣可以在後臺線上升級，不需要換映像 —— 程式檔案在資料卷裡。

手動升級

線上升級失敗時才用這個。必須從你當前的版本開始，一個一個往上升，不能跳版本。

每個升級包解壓後是這樣：

內容	怎麼處理
file/ 資料夾	裡面的檔案複製到網站根目錄，覆蓋同名檔案
update.sql	有這個檔案才需要執行，見下

update.sql 的處理：

1. 用編輯器開啟，把裡面的 __PREFIX__ 全部替換成你的資料庫表字首（預設是 acg_）
2. 到 phpMyAdmin 或資料庫工具裡執行這個 SQL

全部升完後，把 config/app.php 裡的 version 改成升級後的版本號。

手動升級很容易出錯，能用線上升級就別手動。

站點搬家

把整個網站搬到另一臺伺服器：

1. 打包原始碼 —— 整個網站目錄打包帶走
2. 匯出資料庫 —— 用 phpMyAdmin 或 mysqldump 匯出
3. 在新伺服器上按 寶塔安裝 裝好環境（PHP 版本、擴充套件要對得上）
4. 原始碼解壓到新站點根目錄，資料庫匯入
5. 改 config/database.php —— 換成新伺服器的資料庫地址、賬號、密碼
6. 重新配置偽靜態和目錄權限

搬完打不開，按這個順序查：

檢查項	說明
config/database.php	資料庫連線資訊是不是還是舊的
Redis	舊站如果用了 Redis 存會話，新伺服器也得裝上，或者把 PHP 的 session 儲存改回檔案
PHP 擴充套件	bcmath 別漏了
目錄權限	config、runtime、kernel/Install、assets/cache 要可寫
偽靜態	新伺服器要重新配

Docker 換映像

docker pull ghcr.io/lizhipay/acg-faka:latest
docker stop faka && docker rm faka
docker run -d --name faka -p 80:80 -v acg_data:/data --restart unless-stopped ghcr.io/lizhipay/acg-faka:latest

只要 -v acg_data:/data 這個卷名沒變，資料、配置、已裝的外掛全都還在。

升級後出問題

先看網站根目錄的 runtime.log，絕大多數問題的真實原因都在裡面。