本页内容

  • 前置条件
  • 1. 将系统从 Ubuntu 20.04 升级到 Ubuntu 22.04
  • 2. 清理 mailman
  • 3. 安装缺失的 PHP 软件包
  • 4. 对 ISPConfig 执行强制更新
  • 5. 更新路径以使用 PHP 8.1 作为默认 PHP 版本
  • 6. 更新 phpMyAdmin(可选)

本教程将带你逐步将一台由 ISPConfig 管理的服务器从 Ubuntu 20.04(Focal Fossa)升级到 Ubuntu 22.04(Jammy Jellyfish)。本指南同时适用于单服务器和多服务器部署,只需在每台服务器上重复相同的步骤即可。

警告:mailman2 在 Ubuntu 22.04 中不受支持,而 mailman3 目前尚不被 ISPConfig 支持。请注意,升级过程可能会导致部分停机时间。

前置条件

  • 请确保你以 root 用户身份登录

1. 将系统从 Ubuntu 20.04 升级到 Ubuntu 22.04

请先按照关于升级 Ubuntu 系统本身的官方指南进行操作。

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 软件包

Ubuntu 22.04 默认搭载 PHP 8.1 作为默认 PHP 版本,因此我们需要安装它(同时安装后续所需的 curl):

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

如有必要,别忘了调整 PHP 配置文件。

如果你仍想为部分网站使用 PHP 7.4,可将其作为附加版本另行安装。

4. 对 ISPConfig 执行强制更新

为了重新配置各项服务,使其正确适配 Debian 11,我们需要运行 ISPConfig 的更新脚本并让其重新配置服务。通过命令行使用以下方式运行该脚本:

ispconfig_update.sh --force

逐步完成更新流程。当被问到是否要重新配置服务时,按回车键确认。如果回答“否”跳过此步骤,ISPConfig 将不会针对 Ubuntu 22.04 配置你的服务,部分服务可能会出现故障。

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

由于 PHP 8.1 是 Ubuntu 22.04 自带的默认 PHP 版本,我们需要更新 ISPConfig 中的 PHP 路径。

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

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

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

请注意,本服务器上所有使用“Default”作为 PHP 版本的网站,现在都将使用 PHP 8.1 而不是旧版本。

我们还需要让系统将 PHP 8.1 作为非 ISPConfig 操作的默认 PHP 处理器。为此,运行:

update-alternatives --config php

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

update-alternatives --config php-cgi

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

update-alternatives --config php-fpm.sock

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

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

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

6. 更新 phpMyAdmin(可选)

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

运行以下命令来执行我们的 phpMyAdmin 更新脚本:

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

从现在起,你可以使用该脚本来自动保持 phpMyAdmin 为最新版本。

大功告成!如果你遇到任何问题,请在论坛上开一个主题。