Debian 13 教程 / 从Debian 12升级前检查软件包、备份与恢复通道

在从 Debian 12 升级到 Debian 13 之前,您应该稳定当前系统,并准备一个可恢复的备份,同时配备一个即使 SSH 断开也能访问的控制台。不要仅通过保存软件包列表或创建虚拟机快照来完成准备工作;还要验证服务数据的恢复以及重启后的访问。

定义升级范围和停止条件

本文介绍了用于 amd64 Debian 12 精简服务器的准备步骤。它不会将软件源更改为 trixie,也不会安装 Debian 13 的软件包。像 Debian 11 这样的旧版本需要单独的步骤先升级到 Debian 12。不要使用此步骤在 i386 服务器上进行原地升级:Debian 13 不再提供官方的 i386 内核或安装程序。请评估在兼容硬件上进行全新 amd64 安装或考虑淘汰旧设备。

在 VirtualBox 7.2 中使用了一个单独的虚拟机进行练习。安装了 Debian 12.15,分配了 3 GiB 内存、30 GiB 虚拟磁盘、UEFI、ext4 根分区和一个单独的 EFI 分区。更新 bookworm 后,内核为 6.1.0-55-amd64。这是观察环境,不代表所需容量的一般指南。Debian 12.15发布公告说明 ,该次小版本更新是 Debian 12 的最后一次常规更新,未来的支持需要检查长期支持(LTS,Long Term Support)的 架构和软件包范围。

继续操作的条件 需要先停止并解决的状态
控制台登录、sudo 和新 SSH 连接均可正常使用 仅依赖一个现有的 SSH 会话或没有恢复介质
软件包审计正常,已识别被设置hold的软件包与外部软件包的原因 未配置的软件包、原因不明的hold、混合仓库
备份的实际恢复和服务读取验证已完成 仅验证文件存在或校验和
已同意服务停机、数据写入停止和恢复点 升级后,新数据将被旧快照覆盖

记录当前版本、软件包和仓库状态

将结果文件存储在只有 root 可以读取的目录中。下面的命令是第一次运行的示例;如果相同的目录已经存在,它将停止而不会覆盖。在实际操作中,应根据任务日期或修订号区分名称。

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/debian13-preflight
test ! -e "$dest"
install -d -m 700 "$dest"
cat /etc/os-release > "$dest/os-release.txt"
uname -a > "$dest/kernel.txt"
dpkg --print-architecture > "$dest/architecture.txt"
dpkg-query -W -f='${binary:Package}\t${Version}\t${db:Status-Abbrev}\n' > "$dest/packages.tsv"
dpkg --get-selections '*' > "$dest/selections.txt"
apt-mark showmanual > "$dest/manual.txt"
apt-mark showhold > "$dest/holds.txt"
apt-cache policy > "$dest/apt-policy.txt"
dpkg --audit > "$dest/dpkg-audit.txt"
test ! -s "$dest/dpkg-audit.txt"
apt-get check
ROOT

dpkg --audit 通常在没有问题时不会输出任何内容。如果有结果,请阅读内容,查明原因,然后再次检查。如果 apt-get check 以依赖性错误结束,请不要开始发行版升级。不要无条件解除hold;请检查hold的原因以及该软件包是否在 Debian 13 上受支持。

sudo grep -R -nE '^(deb |deb-src |Types:|URIs:|Suites:|Components:|Signed-By:)' /etc/apt/sources.list /etc/apt/sources.list.d
apt list '?narrow(?installed, ?not(?origin(Debian)))'
dpkg --print-foreign-architectures

Grep 错误可能会因为不存在 sources.list 而出现。检查所有现有的 .list 和 .sources,并且还要验证除了 bookworm、bookworm-updates 和 bookworm-security 之外,是否存在backports、第三方仓库或pin优先级设置。如果 URI 包含认证信息,请不要发布结果。外部源查询是基于当前的 APT 元数据,所以缺少输出并不证明所有安装文件的来源。

更新 Debian 12 并在重启后验证访问权限

在确认当前仓库指向 bookworm 后,更新软件包列表并查看预期更改。同时,检查内核元软件包是否已安装。请先检查模拟中的删除计划,并准备处理实际升级时的配置文件询问;不要直接添加自动确认选项。

sudo apt update
apt -s full-upgrade
apt-cache policy linux-image-amd64 openssh-server
sudo apt full-upgrade
sudo /usr/sbin/sshd -t
sudo reboot

仅在 apt 成功完成且 sshd -t 成功后才进行重启。如果任一操作失败,请保留会话,并使用控制台在重启前解决错误。

重启完成后,不要重复使用现有窗口,而是创建新的 SSH 连接,并检查是否也可以从控制台登录。在练习中,更新后的软件包审核是正常的,而 bookworm 的完整升级模拟中涉及的需要更改的软件包为 0 个。对于远程升级,请查看 trixie 发布说明和已知问题中的 OpenSSH 条件;在尝试发行版升级前先更新 bookworm。

记录磁盘、网络和服务基线

findmnt --target / -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /boot -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /boot/efi -o TARGET,SOURCE,FSTYPE,OPTIONS
findmnt --target /tmp -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT / /boot /var
df -i / /boot /var
ip -brief address
ip route
readlink -f /etc/resolv.conf
cat /etc/resolv.conf
sudo ss -lntup
systemctl --failed --no-pager

区分 /boot 是独立的文件系统还是根的一部分,并检查其容量和 inode。在没有 EFI 的 BIOS 系统上,可以跳过检查 /boot/efi。如果磁盘空间较小,除了下载缓存外,还要考虑新内核、initramfs 以及安装过程中临时空间的需求,并且不要删除当前正在启动的内核或唯一可用的内核以释放空间。

不仅要记录地址,还要包括接口名称、默认路由、管理域名系统(DNS,Domain Name System)解析器文件的组件,以及服务的监听地址和端口。对于 Web 服务,要包括 HTTP 状态和响应内容;对于数据库,要包括如何暂停写入以及作为基线的一部分的逻辑备份和恢复命令。仅仅 systemctl is-active 处于活动状态并不意味着数据是正常的。

在 Debian 13 中,默认的 /tmp 存储方法和 sysctl 配置读取路径将发生变化。在此之前,检查是否错误地将持久数据放在 /tmp 中,以及必要的设置是否在 /etc/sysctl.d/*.conf 中。在升级之前记录当前的 findmnt --target /tmp 结果和本地 sysctl 片段,然后在重启后进行比较。升级前的记录并不能证明旧的临时标记是否存活或后来被隐藏;任何此类测试都需要单独记录的标记和受控观察。

将系统状态备份与恢复测试分开

备份设置/软件包状态和备份服务数据的目的不同。以下命令将系统状态存储到先前创建的安全目录中。此 tar 文件不是完整的磁盘镜像,也不是正在运行数据库的一致性备份。必须单独应用特定服务的转储或写入停止程序。

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/debian13-preflight
test -d "$dest"
test ! -e "$dest/system-state.tar"
tar --acls --xattrs --numeric-owner -cpf "$dest/system-state.tar" -C / etc var/lib/dpkg var/lib/apt/extended_states
cd "$dest"
sha256sum system-state.tar > system-state.sha256
sha256sum -c system-state.sha256
ROOT

/etc 可能包含私钥或身份验证信息。限制读取权限,并在存储到独立设备或服务器时应用加密和访问控制。如果备份路径仅在同一根磁盘上,损坏可能导致原始数据和备份数据同时丢失。相反,仅用较旧版本覆盖软件包状态目录并不是降级操作系统的方法。

为了直接练习恢复过程,请使用以下独立小文件,而不是业务数据。将原始文件移到其他位置,从归档中恢复它们,并比较内容、所有者和权限。例子中使用的数字用户ID(UID,User ID)为1000,组ID(GID,Group ID)为1000。使用 id 检查这两个值,如果您的实训账户不同,请调整每个所有者/组值。

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/debian13-preflight
test -d "$dest"
test ! -e /var/lib/preflight-demo
test ! -e "$dest/demo.tar"
install -d -m 750 -o 1000 -g 1000 /var/lib/preflight-demo
printf 'upgrade backup sample\n' > /var/lib/preflight-demo/message.txt
chown 1000:1000 /var/lib/preflight-demo/message.txt
chmod 640 /var/lib/preflight-demo/message.txt
stat -c '%u:%g:%a' /var/lib/preflight-demo/message.txt > "$dest/demo-mode.txt"
sha256sum /var/lib/preflight-demo/message.txt > "$dest/demo-data.sha256"
tar --acls --xattrs --numeric-owner -cpf "$dest/demo.tar" -C / var/lib/preflight-demo
mv /var/lib/preflight-demo/message.txt "$dest/demo-held.txt"
tar --acls --xattrs --numeric-owner --same-owner -xpf "$dest/demo.tar" -C / var/lib/preflight-demo/message.txt
cmp "$dest/demo-held.txt" /var/lib/preflight-demo/message.txt
test "$(stat -c '%u:%g:%a' /var/lib/preflight-demo/message.txt)" = "$(cat "$dest/demo-mode.txt")"
sha256sum -c "$dest/demo-data.sha256"
ROOT

预期结果是比较命令完成时没有错误,并且 OK 出现在 SHA-256 检查中。

为了实际验证,我们以这种方式传输了练习 HTTP 服务的数据,从备份中恢复,并比较了文件哈希值、UID、GID、权限和 HTTP 响应。只有三个不含敏感信息的实训文件被单独复制到虚拟机外以检查它们的哈希值和内容,而完整的系统配置归档则保留在虚拟机内。因此,本实训未验证丢失整台主机后的完整系统恢复。

为了仅清理小文件练习,在确认恢复成功后,运行 sudo rm -- /var/lib/preflight-demo/message.txt 和 sudo rmdir -- /var/lib/preflight-demo。保留备份直到升级结果确认,并且不要将其与实际服务文件混淆。

确认控制台访问、冷启动和回滚边界

在 VirtualBox 管理器中,选择目标虚拟机,打开控制台,并测试登录和 sudo。您还应该能够检查安装 ISO 或救援入口方法、根/EFI 分区识别信息以及 不依赖SSH即可获知的备份位置。正常关机的虚拟机快照是快速返回当前状态的一种方法,但它们依赖于相同的主机和存储。

  1. 在开始升级前停止写入,并最后一次备份服务数据。
  2. 在正常关闭来宾系统后,从虚拟机快照菜单中保存更改前的状态。不要假设快照本身能够保证运行中数据库的一致性。
  3. 打开虚拟机并检查自动启动、新的 SSH 连接、服务响应和数据哈希。
  4. 如果失败,记录谁将打开控制台、将恢复哪个备份以及如何保留新创建的数据。

在演练中,我们在最终启动检查中发现了一个问题:引导加载程序存在于 EFI 目录中,但未注册在启动顺序中。我们在控制台上选择了 EFI/debian/shimx64.efi 进行启动,验证了实际的 UEFI 条目,纠正了顺序,然后在冷重启后再次确认自动启动、新的 SSH 连接和服务响应。由于启动条目编号因设备而异,请不要从另一系统复制并应用 efibootmgr 号。

在升级后恢复写入操作时,如果回退到旧快照,则在此期间创建的数据可能会丢失。为软件包安装失败、启动失败和服务数据错误制定是否继续修复或恢复整个状态的标准。请阅读 Debian 官方升级指南 以及您自己的服务文档,并且仅在没有未解决事项时才开始仓库切换。