面板任務
面板任務顯示 AcePanel 執行的背景任務，例如應用程式安裝、環境安裝等。
任務 頁面有兩個分頁：排程任務（預設顯示）與 面板任務。 本頁僅介紹 面板任務。 若是以時間為基準的工作（例如定時備份或腳本），請參閱 排程任務。
任務清單
前往 任務 > 面板任務 分頁即可檢視面板任務清單。
清單會顯示以下資訊：
- 任務名稱：任務描述
- 狀態：等待中/執行中/已完成/失敗
- 建立時間：任務建立時間
- 完成時間：任務結束時間
- 操作：檢視記錄、刪除
任務狀態
| 狀態 | 說明 |
|---|---|
| 等待中 | 任務已排入佇列，尚未開始 |
| 執行中 | 任務正在執行 |
| 已完成 | 任務執行成功 |
| 失敗 | 任務執行失敗 |
常見任務類型
應用程式安裝
安裝應用程式時會建立安裝任務：
- 安裝應用程式 Nginx
- 安裝應用程式 MySQL
- 安裝應用程式 Docker
應用程式解除安裝
解除安裝應用程式時會建立解除安裝任務：
- 解除安裝應用程式 MariaDB
- 解除安裝應用程式 Redis
應用程式更新
更新已安裝的應用程式時會建立更新任務：
- 更新應用程式 Gitea
- 更新應用程式 Grafana
環境安裝
安裝、解除安裝或更新執行環境時會建立任務：
- 安裝環境 PHP 8.4
- 安裝環境 Node.js 20
- 更新環境 Go 1.24
檢視記錄
點選 記錄 按鈕即可檢視任務的詳細執行記錄，包含：
- 命令輸出
- 錯誤訊息
記錄會即時串流，因此你可以追蹤執行中任務的進度。 你也可以在記錄視窗內清除目前的記錄。 當任務仍處於 等待中 狀態時，記錄 按鈕無法使用。
記錄對於排查任務失敗的原因非常有用。
提示
如果記錄載入失敗，請停用瀏覽器中的所有廣告攔截器。
刪除任務
只有已完成或失敗的任務才能刪除。 等待中與執行中的任務無法刪除。
提示
刪除任務只會從清單中移除記錄，並不會影響已安裝的應用程式或環境。
處理任務失敗
如果任務失敗：
- 點選 記錄 檢視錯誤訊息
- 根據錯誤訊息排查問題
- 解決問題後重新執行操作
常見失敗原因：
- 網路問題導致下載失敗
- 磁碟空間不足
- 缺少相依套件
- 連接埠已被佔用
重新啟動後被標記為失敗的任務
當面板重新啟動時（例如更新後或伺服器重新開機後），任何仍處於 執行中 狀態的任務都會自動被標記為 失敗。 這可以避免在執行任務的行程被中斷時，任務永久卡在 執行中 狀態。 如果你在重新啟動後發現某個任務被標記為 失敗，只要重新執行原本的操作即可。
清除卡住的任務
在極少數情況下，任務可能會卡在 等待中 或 執行中 狀態，並阻擋同類型的新任務。 你可以從伺服器命令列強制清空佇列：
bash
acepanel clear-task這會將所有等待中與執行中的任務標記為 失敗，藉此解除佇列的阻擋。 詳情請參閱 CLI 工具，並請僅在指導下使用此操作。
注意事項
- 安裝任務可能需要較長時間，請耐心等候
- 任務執行期間可以關閉瀏覽器
- 如果任務長時間沒有回應，可以重新整理頁面以檢視狀態
- 建議定期清理已完成的任務記錄
- 當前一個任務仍處於等待中或執行中時，提交相同的任務會遭到拒絕，請先等候前一個任務完成