将 ISPConfig Perfect 服务器从 Debian 11 更新到 Debian 12

发表 admin at 2025年2月28日

类别

未分类

标签

本教程将引导您将 ISPConfig 管理的服务器从 Debian 11 (bullseye) 更新到 Debian 12 (bookworm)。本指南适用于单服务器和多服务器设置。只需在每台服务器上重复相同的步骤即可。

请注意，更新过程可能会导致一些停机时间。

先决条件

确保您以 root 用户身份登录

1.将系统从Debian 11更新到Debian 12

请先阅读有关更新 Debian 本身的指南：https://linux教程/how-to-upgrade-from-debian-11-to-debian-12/

2.安装缺少的PHP包

Debian 12 附带 PHP 8.2 作为默认 PHP 版本，因此我们必须安装它：

apt-get install php8.2 php8.2-cli php8.2-cgi php8.2-fpm php8.2-gd php8.2-mysql php8.2-imap php8.2-curl php8.2-intl php8.2-pspell php8.2-sqlite3 php8.2-tidy php8.2-xsl php8.2-zip php8.2-mbstring php8.2-soap php8.2-opcache libonig5 php8.2-common php8.2-readline php8.2-xml curl

如有必要，不要忘记调整 PHP 配置文件。

如果您仍想在某些网站上使用 PHP 7.4，请按照 https://linux教程/ispconfig-php-debian/ 将其安装为附加版本

4. 强制更新 ISPConfig

要重新配置服务以便为 Debian 12 正确配置它们，我们需要运行 ISPConfig 更新脚本并让它重新配置服务。从命令行运行脚本

ispconfig_update.sh --force

完成更新步骤。当询问您是否要重新配置服务时，请按 Enter 键。如果您回答“否”来跳过此步骤，ISPConfig 将不会为 Debian 12 配置您的服务，并且某些服务可能会损坏。

5.更新路径以使用 PHP 8.2 作为默认 PHP 版本

由于 PHP 8.2 是 Debian 12 附带的默认 PHP 版本，因此我们需要更新 ISPConfig 中的 PHP 路径。

以管理员用户身份登录面板，然后转到系统 -> 服务器配置 -> server1.example.com（服务器的主机名） -> Web -> PHP 设置

将 7.4 的引用替换为 8.2，因此看起来像这样：

Apache php.ini path: /etc/php/8.2/apache2/php.ini
CGI php.ini path: /etc/php/8.2/cgi/php.ini
PHP-FPM init script: php8.2-fpm
PHP-FPM php.ini path: /etc/php/8.2/fpm/php.ini
PHP-FPM pool directory: /etc/php/8.2/fpm/pool.d
PHP-FPM socket directory: /var/lib/php8.2-fpm

请注意，此服务器上使用 PHP 版本“默认”的所有网站现在都将使用 PHP 8.2，而不是旧版本。

我们还必须让系统使用 PHP 8.2 作为非 ISPConfig 操作的默认 PHP 处理程序。为此，请运行：

update-alternatives --config php

如果需要选择PHP版本，请选择PHP 8.2。然后，运行

update-alternatives --config php-cgi

如果需要选择 PHP 版本，请同时选择 PHP 8.2。最后，运行

update-alternatives --config php-fpm.sock

如果需要选择PHP版本，请再次选择PHP 8.2。

对于安装了 Apache2 的服务器，我们必须禁用 PHP-FPM 7.4 作为默认 PHP 处理程序，并通过运行以下命令启用 PHP-FPM 8.2：

a2disconf php7.4-fpm
a2enconf php8.2-fpm
systemctl restart apache2

6.更新phpMyAdmin（可选）

如果您安装了 phpMyAdmin，我们建议您更新您的安装，因为许多用户安装了过时的版本。

运行此命令来运行我们的 phpMyAdmin 更新脚本：

curl https://git.ispconfig.org/ispconfig/tools/-/raw/master/auto_update_phpmyadmin.sh -sL | sh

从现在开始，您可以使用相同的脚本让 phpMyAdmin 自动更新。有关更多信息，请参阅此论坛帖子：https://linux教程/community/threads/keep-your-phpmyadmin-installation-up-to-date-automatically.88495/

我们完成了！如果您有任何问题，请在论坛上开帖。