# 更新面板
本文檔涵蓋了 1.x 系列版本中的更新流程。這意味著更新自
— 例如 — 1.5.0 到 1.6.0 。 **請勿使用本指南從 0.7 升級。 **
# 面板版本要求
每個版本的 Pterodactyl Panel 也有對應的最低版本的 Wings， 它需要運行。請參考下表以了解這些版本的排列方式。在 大多數情況下，您的基本 Wings 版本應與您的面板版本相符。
| 面板版 | 翅膀版 | 支援 | PHP 版本 |
|---|---|---|---|
| 1.0.x | 1.0.x | 7.3, 7.4 | |
| 1.1.x | 1.1.x | 7.3, 7.4 | |
| 1.2.x | 1.2.x | 7.3, 7.4 | |
| 1.3.x | 1.3.x | 7.4、8.0 | |
| 1.4.x | 1.4.x | 7.4、8.0 | |
| 1.5.x | 1.4.x | 7.4、8.0 | |
| 1.6.x | 1.4.x | 7.4、8.0 | |
| 1.7.x | 1.5.x | 7.4、8.0 | |
| 1.8.x | 1.6.x | 7.4、8.0、8.1 | |
| 1.9.x | 1.6.x | 7.4、8.0、8.1 | |
| 1.10.x | 1.7.x | 7.4、8.0、8.1 | |
| 1.11.x | 1.11.x | ||
| 1.12.x | 1.12.x | ✅ | 8.2，8.3 |
::: 提示 Wings 版本 Wings 沒有 1.8.x、1.9.x 或 1.10.x 版本。 :::
# 更新依賴項
- PHP
8.2或8.3（建議） - 作曲家
2.X
繼續之前，請確保您的系統和 Web 伺服器設定已透過執行 php -v 升級到至少 PHP 8.2，並透過執行 composer --version 升級到 Composer 2。你
應該會看到類似以下結果的輸出。如果您沒有看到至少 PHP 8.2 和 Composer 2，則需要透過以下方式升級
我們的 PHP Upgrade Guide 並隨後返回此文件。
vagrant@pterodactyl:~/app$ php -v
PHP 8.2.5 (cli) (built: Dec 21 2022 10:32:13) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.5, Copyright (c) Zend Technologies
with Zend OPcache v8.2.5, Copyright (c), by Zend Technologies
vagrant@pterodactyl:~/app$ composer --version
Composer version 2.3.5 2022-04-13 16:43:00
# 自我升級
：：： 警告 由於我們使用的某些依賴項存在問題，因此自我升級目前無法操作。 暫時請執行手動升級，直到問題解決。 :::
# 手動升級
如果您不想執行自動自行升級，或需要參考您可以遵循的任何升級步驟 下面的文檔。
：：： 警告 如果您已成功執行自行升級，則無需在此頁面上執行任何其他操作。 :::
# 進入維護模式
每當您執行更新時，您應該確保將面板置於維護模式。這將防止 用戶遇到意外錯誤並確保在用戶遇到錯誤之前可以更新所有內容 潛在的新功能。
cd /var/www/pterodactyl
php artisan down
# 下載更新
更新過程的第一步是從 GitHub 下載新的面板檔案。下面的命令將下載 Pterodactyl最新版本的發布存檔，保存在目前目錄下，會自動 將存檔解壓縮到目前資料夾。
curl -L https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz | tar -xzv
下載完所有檔案後，我們需要對快取和儲存目錄設定正確的權限，以避免 任何與網頁伺服器相關的錯誤。
chmod -R 755 storage/* bootstrap/cache
# 更新依賴項
下載所有新檔案後，您將需要升級面板的核心元件。為此， 只需運行以下命令並按照任何提示進行操作即可。
composer install --no-dev --optimize-autoloader
# 清除編譯模板快取
您還需要清除已編譯的模板緩存，以確保新的和修改的模板正確顯示 用戶。
php artisan view:clear
php artisan config:clear
# 資料庫更新
您還需要更新最新版本的 Pterodactyl 的資料庫架構。運行下面的命令 將更新架構並確保我們提供的預設 Egg 是最新的（並添加我們可能擁有的任何新 Egg）。只是 請記住，永遠不要編輯我們運送的核心蛋！它們將被此更新過程覆蓋。
php artisan migrate --seed --force
# 設定權限
最後一步是將檔案的正確擁有者設定為運行網頁伺服器的使用者。大多數情況下這
是 www-data 但可能因係統而異 — 有時是 nginx 、 caddy 、 apache ，甚至是 nobody 。
# If using NGINX or Apache (not on CentOS)
chown -R www-data:www-data /var/www/pterodactyl/*
# If using NGINX on CentOS
chown -R nginx:nginx /var/www/pterodactyl/*
# If using Apache on CentOS
chown -R apache:apache /var/www/pterodactyl/*
# 重新啟動佇列工作者
每次更新後，您應該重新啟動佇列工作程序以確保新程式碼已載入並使用。
php artisan queue:restart
# 退出維護模式
現在一切都已更新，您需要退出維護模式，以便麵板可以恢復接受 連接。
php artisan up
# 遙測
從1.11開始，Pterodactyl將收集匿名遙測數據，以幫助我們更了解 正在使用軟體。若要了解有關此功能的更多資訊並選擇退出，請參閱我們的Telemetry 文件.請記住繼續其餘的升級。
受保護_0