本教程适用于以下操作系统版本

  • Debian 11 (Bullseye)
  • Debian 10 (Buster)

本页内容

  • 先决条件
  • 1. 将系统从 Debian 10 升级到 Debian 11
  • 2. 清理 mailman
  • 3. 安装缺失的 PHP 软件包
  • 4. 强制更新 ISPConfig
  • 5. 更新路径以使用 PHP 7.4 作为默认 PHP 版本
  • 6. 更新 phpMyAdmin(可选)

本教程将带你完成将由 ISPConfig 管理的服务器从 Debian 10(buster)升级到 Debian 11(bullseye)的过程。本指南适用于单服务器和多服务器部署。只需在每台服务器上重复相同的步骤即可。

警告:Debian 11 不支持 mailman2,而 mailman3 尚未被 ISPConfig 支持。请注意,更新过程可能会导致一些停机时间。

先决条件

  • 确保你以 root 用户身份登录
  • 如果你之前在使用 incron(例如用于自动续订面板或邮件服务器的证书),请在继续之前参考相关迁移说明,以 systemd 定时器替代 incron。

1. 将系统从 Debian 10 升级到 Debian 11

按照升级 Debian 系统本身的官方指南完成版本升级。

2. 清理 mailman

如果安装了 mailman2,我们必须重命名数据目录,以防止任何邮件传输冲突。

mv /var/lib/mailman /var/lib/mailman-bk

然后运行以下命令:

mkdir -p /var/lib/mailman/data/
touch /var/lib/mailman/data/{aliases,transport-mailman,virtual-mailman}
postmap /var/lib/mailman/data/{aliases,transport-mailman,virtual-mailman}

以创建一些空文件来替代。

3. 安装缺失的 PHP 软件包

Debian 11 默认附带 PHP 7.4 作为默认 PHP 版本,因此我们必须安装它(以及后续需要的 curl):

apt -y install php7.4 php7.4-common php7.4-gd php7.4-mysql php7.4-imap php7.4-cli php7.4-cgi php7.4-curl php7.4-intl php7.4-pspell php7.4-sqlite3 php7.4-tidy php7.4-xmlrpc php7.4-xsl php7.4-zip php7.4-mbstring php7.4-soap php7.4-fpm php7.4-opcache php7.4-json php7.4-readline php7.4-xml curl

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

如果你仍想为某些网站使用 PHP 7.3,请参考对应的 PHP 多版本安装说明将其作为附加版本安装。

4. 强制更新 ISPConfig

为了重新配置服务,使其正确适配 Debian 11,我们需要运行 ISPConfig 更新脚本并让它重新配置服务。从命令行运行该脚本,使用

ispconfig_update.sh --force

按照更新步骤操作。当被问及是否要重新配置服务时,按回车键。如果你通过回答 "no" 跳过此步骤,ISPConfig 将不会为 Debian 11 配置你的服务,某些服务可能会损坏。

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

由于 PHP 7.4 是 Debian 11 自带的默认 PHP 版本,我们需要更新 ISPConfig 中的 PHP 路径。

以 admin 用户身份登录面板,然后进入 System -> Server Config -> server1.example.com(你的服务器的主机名)-> Web -> PHP Settings

将对 7.3 的引用替换为 7.4,使其如下所示:

Apache php.ini path: /etc/php/7.4/apache2/php.ini
CGI php.ini path: /etc/php/7.4/cgi/php.ini
PHP-FPM init script: php7.4-fpm
PHP-FPM php.ini path: /etc/php/7.4/fpm/php.ini
PHP-FPM pool directory: /etc/php/7.4/fpm/pool.d
PHP-FPM socket directory: /var/lib/php7.4-fpm

请注意,此服务器上使用 PHP 版本 "Default" 的所有网站现在将使用 PHP 7.4 而不是旧版本。

我们还必须让系统使用 PHP 7.4 作为非 ISPConfig 操作的默认 PHP 处理程序。为此,运行:

update-alternatives --config php

如果需要选择 PHP 版本,请选择 PHP 7.4。然后,运行

update-alternatives --config php-cgi

如果需要选择 PHP 版本,同样选择 PHP 7.4。最后,运行

update-alternatives --config php-fpm.sock

如果需要选择 PHP 版本,再次选择 PHP 7.4。

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

a2disconf php7.3-fpm
a2enconf php7.4-fpm
systemctl restart apache2

6. 更新 phpMyAdmin(可选)

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

运行此命令以运行我们的 phpMyAdmin 更新脚本:

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

从现在起,你可以使用同一个脚本让 phpMyAdmin 自动保持更新。有关更多信息,请参阅相关的自动更新说明文档。

我们完成了!如果你遇到任何问题,请在论坛上开一个帖子。