更新面板

大约 4 分钟

更新面板

本文档涵盖了 1.x 系列版本中的更新过程。这意味着例如从 1.5.0 更新到 1.6.0。请勿使用本指南从 0.7 开始升级，这会导致你升级失败。

面板的版本要求

翼龙面板的每个版本都有相应最低版本的 Wings。请参阅下表了解有关这些对应版本。在大多数情况下，您的 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	✅	8.1, 8.2, 8.3

Wings 版本

注意：Wings 没有 1.8.x、1.9.x 或 1.10.x 版本。

更新依赖项

PHP 8.1、 8.2 或 8.3 (推荐)

Composer 2.X

在继续之前，请确保您的系统和网络服务器配置已通过运行 php -v 和 composer --version 来确认您的服务器已在 PHP 8.1 和 Composer 2 或更高的版本。您应该会看到类似于以下输出的结果。如果您没有看到 PHP 8.1 和 Composer 2 或更高的版本，您将需要按照我们的 PHP 升级指南进行升级，然后再返回此文档。

vagrant@pterodactyl:~/app$ php -v
PHP 8.1.5 (cli) (built: Apr 21 2022 10:32:13) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.5, Copyright (c) Zend Technologies
    with Zend OPcache v8.1.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 下载新的面板文件。下面的命令将下载翼龙中国最新发布的版本，将其保存在当前目录中，并自动解压到您的当前文件夹中。

国际源

curl -L https://github.com/pterodactyl-china/panel/releases/latest/download/panel.tar.gz | tar -xzv

国内源

curl -L https://ghp.ci/https://github.com/pterodactyl-china/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

数据库更新

您还需要为最新版本的翼龙更新数据库结构。运行下面的命令将更新结构并确保我们发布的默认预设是最新的（并添加我们可能发布的新预设）。请记住，永远不要编辑我们发布的核心预设！它们将被此更新过程所覆盖。

php artisan migrate --seed --force

设置权限

最后一步是将文件的所有者设置为您的网络服务器用户。在大多数情况下是 www-data，但可能因系统而异 — 有时是 nginx、caddy、apache，甚至是 nobody。

# 如果使用 NGINX 或 Apache (并且不在CentOS上)
chown -R www-data:www-data /var/www/pterodactyl/*

# 如果在 CentOS 上使用 NGINX
chown -R nginx:nginx /var/www/pterodactyl/*

# 如果在 CentOS 上使用 Apache
chown -R apache:apache /var/www/pterodactyl/*

重启工作队列

每次更新后，您都应该重新启动工作队列程序，以确保新的代码已加载并使用。

php artisan queue:restart

退出维护模式

现在所有内容都已更新，您需要退出维护模式，以便面板可以继续运行并提供服务。

php artisan up

遥测

从 1.11 开始，Pterodactyl 将收集匿名遥测数据，以帮助我们更好地了解软件的使用情况。要了解有关此功能的更多信息并拒绝此功能，请参阅我们的遥测文档。确保继续其余的安装过程。

最后一步：升级 Wings