进阶 hestiacp.com 2026-11-15 08:32:00 · 7 阅读

第14章 操作系统升级

操作系统升级

危险提示 在升级操作系统之前,请务必先创建备份!我们不为损坏的操作系统安装提供支持。仅当遇到升级过程中可能出现的 Hestia 相关问题时,我们才提供此页面作为参考信息。

通用信息 请确认 MariaDB 是否运行在新操作系统支持的版本上。如果没有,请在升级操作系统之前先将 MariaDB 更新到受支持的版本!

完成备份后,将 Hestia 更新到最后一个受支持的版本: bash apt update && apt upgrade

按照系统说明升级你的操作系统。完成后,务必检查 /etc/apt/sources.list.d 目录下的文件是否被注释掉(以 # 开头)。如果已被注释,请移除注释符,并再次运行 apt update && apt upgrade。

Debian 12 Bookworm 升级到 Debian 13 Trixie

重要说明(需以 root 用户运行) 本指南中的所有命令都必须以 root 用户身份执行。你可以直接以 root 身份登录,或者在运行命令前使用 sudo -i。

更新当前系统 首先,确保你的当前系统已完全更新。 bash apt-get update apt-get -y full-upgrade

升级 MariaDB 在升级到 Debian 13 之前,请确保 MariaDB 已升级到至少 11.8 版本,因为 MariaDB 官方仓库不支持在 Debian 13 上使用 11.4 版本。 bash sed -i -E 's|mariadb-server/[0-9]+\.[0-9]+/repo/|mariadb-server/11.8/repo/|' /etc/apt/sources.list.d/mariadb.list apt-get update apt-get -y full-upgrade

更新 APT 软件源 完成上述步骤后,将你的 APT 软件源更新到 Debian 13: bash sed -i 's/bookworm/trixie/g' /etc/apt/sources.list sed -i 's/bookworm/trixie/g' /etc/apt/sources.list.d/*.list sed -i 's/bookworm/trixie/g' /etc/apt/sources.list.d/*.sources apt-get update

检查本地修改过的配置文件 在继续之前,你可能希望生成一份列表,列出那些有新版本可用但系统当前使用的是本地修改版本的配置文件。这便于你在升级后对比列表,以便在需要时进行手动调整。 bash find / -path /root -prune -o -type f -regex '.*\.\(dpkg\|ucf\)-dist$' -print

执行系统升级 现在开始升级: bash DEBIAN_FRONTEND=noninteractive UCF_FORCE_CONFFOLD=1 apt-get -y full-upgrade -o Dpkg::Options::="--force-confdef" -o Dpkg::Options::="--force-confold"

迁移服务配置文件 某些服务(如 Dovecot 或 BIND)可能因仍在使用不再兼容的配置文件而启动失败。即使看起来没有服务失败,你也应该运行以下脚本。它会自动检测是否需要进行配置更改,并在必要时应用这些更改。 bash /usr/local/hestia/install/upgrade/manual/migrate_conf_to_debian_13.sh

审阅新的配置文件 此时,你可以再次运行以下命令来检查新的配置文件: bash find / -path /root -prune -o -type f -cmin -120 -regex '.*\.\(dpkg\|ucf\)-dist$' -print

你可能会看到列出的几个文件,但大多数应该忽略。由 Hestia 管理或修改的配置文件(如 sshd, dovecot, bind, exim4 等)始终应被忽略。如果你不确定某个文件是否需要审阅或合并,最安全的做法是保持其不变。

重启系统 最后,重启系统: bash reboot

清理 系统重新启动后,更新软件包列表,安装剩余的软件包升级,并移除不再需要的软件包: bash apt-get update apt-get -y full-upgrade apt-get autoremove apt-get clean

升级现已完成。

Debian 11 Bullseye 升级到 Debian 12 Bookworm

Exim 配置 bash rm -f /etc/exim4/exim4.conf.template cp -f /usr/local/hestia/install/deb/exim/exim4.conf.4.95.template /etc/exim4/exim4.conf.template

Debian 10 Buster 升级到 Debian 11 Bullseye

SHA512 密码加密 bash sed -i "s/obscure yescrypt/obscure sha512/g" /etc/pam.d/common-password

Exim4 配置 bash rm -f /etc/exim4/exim4.conf.template cp -f /usr/local/hestia/install/deb/exim/exim4.conf.4.94.template /etc/exim4/exim4.conf.template

ProFTPD 注释掉 /etc/proftp/proftpd.conf 中的第 29 行。

Debian 9 Stretch 升级到 Debian 10 Buster

过去未发现有相关问题。

Ubuntu 24.04 Noble 升级到 Ubuntu 26.04 Resolute

重要说明(需以 root 用户运行) 本指南中的所有命令都必须以 root 用户身份执行。你可以直接以 root 身份登录,或者在运行命令前使用 sudo -i。

更新当前系统 首先,确保你的当前系统已完全更新。 bash apt-get update apt-get -y full-upgrade

升级 MariaDB 在升级到 Ubuntu 26.04 之前,请确保 MariaDB 已升级到至少 11.8 版本,因为 MariaDB 官方仓库不支持在 Ubuntu 26.04 上使用 11.4 版本。 bash sed -i -E 's|mariadb-server/[0-9]+\.[0-9]+/repo/|mariadb-server/11.8/repo/|' /etc/apt/sources.list.d/mariadb.list apt-get update apt-get -y full-upgrade

替换 Ondřej Surý PPA 完成后,你必须移除 Ondřej Surý 的 PPA。Ubuntu 26.04 不再通过 Launchpad PPA 提供支持,PHP 软件包现在仅通过官方 Sury APT 仓库分发。 bash while read -r source; do rm -f "$source"; done < <(grep -rl ondrej /etc/apt/sources.list.d) echo "deb [arch=$(arch | sed -e 's/x86_64/amd64/' -e 's/aarch64/arm64/') signed-by=/usr/share/keyrings/sury-keyring.gpg] https://packages.sury.org/php/ resolute main" > /etc/apt/sources.list.d/php.list curl -s https://packages.sury.org/php/apt.gpg | gpg --dearmor | tee /usr/share/keyrings/sury-keyring.gpg > /dev/null 2>&1

更新 APT 软件源 现在,将你的 APT 软件源更新到 Ubuntu 26.04: bash sed -i 's/noble/resolute/g' /etc/apt/sources.list sed -i 's/noble/resolute/g' /etc/apt/sources.list.d/*.list sed -i 's/noble/resolute/g' /etc/apt/sources.list.d/*.sources apt-get update

检查本地修改过的配置文件 在继续之前,你可能希望生成一份列表,列出那些有新版本可用但系统当前使用的是本地修改版本的配置文件。这便于你在升级后对比列表,以便在需要时进行手动调整。 bash find / -path /root -prune -o -type f -regex '.*\.\(dpkg\|ucf\)-dist$' -print

执行系统升级 现在开始升级: bash DEBIAN_FRONTEND=noninteractive UCF_FORCE_CONFFOLD=1 apt-get -y full-upgrade -o Dpkg::Options::="--force-confdef" -o Dpkg::Options::="--force-confold"

迁移服务配置文件 某些服务(如 Dovecot 或 BIND)可能因仍在使用不再兼容的配置文件而启动失败。即使看起来没有服务失败,你也应该运行以下脚本。它会自动检测是否需要进行配置更改,并在必要时应用这些更改。 bash /usr/local/hestia/install/upgrade/manual/migrate_conf_to_ubuntu_26.04.sh

审阅新的配置文件 此时,你可以再次运行以下命令来检查新的配置文件: bash find / -path /root -prune -o -type f -cmin -120 -regex '.*\.\(dpkg\|ucf\)-dist$' -print

你可能会看到列出的几个文件,但大多数应该忽略。由 Hestia 管理或修改的配置文件(如 sshd, dovecot, bind, exim4 等)始终应被忽略。如果你不确定某个文件是否需要审阅或合并,最安全的做法是保持其不变。

重启系统 最后,重启系统: bash reboot

清理 系统重新启动后,更新软件包列表,安装剩余的软件包升级,并移除不再需要的软件包: bash apt-get update apt-get -y full-upgrade apt-get autoremove apt-get clean

升级现已完成。

Ubuntu 22.04 Jammy 升级到 Ubuntu 24.04 Noble

提示 确认 MariaDB 是否运行在至少 11.4 版本。如果没有,请首先在当前操作系统中升级到该版本!之后,注释掉 /etc/apt/sources.list.d/mariadb.list 中的相关行,然后升级你的操作系统。

Exim4 配置 bash rm -f /etc/exim4/exim4.conf.template cp -f /usr/local/hestia/install/deb/exim/exim4.conf.4.95.template /etc/exim4/exim4.conf.template

Ubuntu 20.04 Focal 升级到 Ubuntu 22.04 Jammy

提示 确认 MariaDB 是否运行在至少 10.6 版本。如果没有,请首先在当前操作系统中升级到该版本!之后,注释掉 /etc/apt/sources.list.d/mariadb.list 中的相关行,然后升级你的操作系统。

SHA512 密码加密 bash sed -i "s/obscure yescrypt/obscure sha512/g" /etc/pam.d/common-password

Exim4 配置 bash rm -f /etc/exim4/exim4.conf.template cp -f /usr/local/hestia/install/deb/exim/exim4.conf.4.94.template /etc/exim4/exim4.conf.template

ProFTPD 注释掉 /etc/proftp/proftpd.conf 中的第 29 行。

Ubuntu 18.04 Bionic 升级到 Ubuntu 20.04 Focal

过去未发现有相关问题。

旧版本

我们尚未测试从 Ubuntu 16.04 升级到 Ubuntu 20.04,或从 Debian 8 Jessie 升级到 Debian 10 的路径。

评论 (0)