本教程适用于以下操作系统版本
- 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 自动保持更新。有关更多信息,请参阅相关的自动更新说明文档。
我们完成了!如果你遇到任何问题,请在论坛上开一个帖子。