Debian 13 教程 / 从Debian 12升级到13并验证软件包、启动与服务
从 Debian 12 升级到 13 时,将仓库切换到 trixie,然后依次执行最小升级和完整升级。完成情况不仅取决于 APT 结束消息,还需要检查新内核的启动、新的 SSH 连接、网络和服务数据,以及临时文件和内核设置的运行情况。
准备访问权限和一个持久的终端会话
此操作针对已完成 升级前检查和恢复准备 工作的 amd64 架构 Debian 12 服务器。如果尚未验证备份恢复、控制台登录或适当重启,请先完成准备工作。对于具有外部仓库、其他架构或数据库/邮件服务器的环境,还需额外查看这些产品的迁移指南。
验证环境是一个运行 Debian 12.15、内核 6.1.0-55-amd64、3 GiB 内存和 30 GiB 虚拟磁盘的独立 VirtualBox 虚拟机。我们进行了两阶段安装和重启。Python 服务代码和数据已备份,并记录了 HTTP 响应作为基线,该环境未用于测试正在运行数据库的主版本升级。
如果 bookworm 中未安装 tmux,请在切换仓库之前使用sudo apt install tmux安装tmux。打开一个独立的控制台,创建以下会话并开始记录。日志可能包含敏感配置,请保密。tmux 可以在网络断开时保持终端会话,而 script 则记录终端输出。
在开始之前检查转录路径是否已存在:script -a 会追加到现有文件。如果需要,请选择一个新的任务专用文件名,以免混淆不相关的运行。在 script 打开的 shell 中运行后续升级命令。
tmux new-session -s debian13-upgrade
umask 077
script -a -f "$HOME/debian13-upgrade.typescript"
一旦 SSH 连接断开,您可以重新连接并返回到 tmux attach-session -t debian13-upgrade。首先,检查 APT 是否正在运行,并且不要重复执行相同的升级。tmux 是为 SSH 断开连接做准备的工具,但不能保证任务在重启或断电后仍然存在。
检查仓库并编写完整的 deb822 配置
此示例适用于一个练习服务器,其中官方的 bookworm 条目只存在于一个文件 /etc/apt/sources.list 中,而 sources.list.d 根本不包含任何文件。首先,读取实际文件,并分别处理现有的外部仓库、后备版本(backports)以及固定设置(pin 设置)。如果下面的先决条件未满足,请根据实际仓库配置进行修改,而不是进行批量字符串替换。
sudo cat /etc/apt/sources.list
sudo find /etc/apt/sources.list.d -maxdepth 1 -type f -print
sudo bash <<'ROOT'
set -euo pipefail
. /etc/os-release
test "$VERSION_ID" = 12
test -z "$(dpkg --audit)"
test -z "$(find /etc/apt/sources.list.d -maxdepth 1 -type f -print -quit)"
test -f /usr/share/keyrings/debian-archive-keyring.gpg
dest=/var/backups/debian13-upgrade
test ! -e "$dest"
install -d -m 700 "$dest"
cp -a /etc/apt/sources.list "$dest/sources.list.bookworm"
mv /etc/apt/sources.list "$dest/sources.list.disabled"
cat > /etc/apt/sources.list.d/debian.sources <<'SOURCES'
Types: deb
URIs: https://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
Types: deb
URIs: https://security.debian.org/debian-security
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
SOURCES
ROOT
sudo apt update
apt-cache policy apt systemd linux-image-amd64 openssh-server
main non-free-firmware 是此虚拟机上使用的配置。如果现有服务器需要 contrib 或 non-free,请检查软件包和策略并添加相应组件。需要 deb-src 的开发环境也应单独考虑。Signed-By 指向实际的 Debian 存档密钥环,您不应添加忽略签名错误的选项。deb822 使用由空行分隔的基于字段的段;.sources 文件使用此格式。格式可以在 Debian sources.list 手册 中找到。
如果带有前置检查的root代码块失败,在 apt update 之前停止,并检查哪些文件已被移动或创建。不要假设多命令示例会自动撤销部分更改。若仓库或签名检查出现错误,请停止,不要使用过时或不可信的元数据继续安装。
确保列表更新完成且没有错误,并且候选版本来自 Trixie 系列。此时,由于 Debian 13 软件包尚未安装,如果您发现存储库选择错误,可以停用新文件并恢复归档的 Bookworm 文件重新更新。启动安装后,不要假设仅仅恢复存储库就能完全恢复系统。
完成最小升级并检查完整升级的更改
apt -s upgrade --without-new-pkgs
sudo apt upgrade --without-new-pkgs
sudo dpkg --audit
apt -s full-upgrade
第一步是更新在不安装新软件包或删除现有软件包的情况下可以更新的内容。剩余的软件包不意味着立即失败。在验证虚拟机上,最小步骤中更新了222个项目,没有进行新的安装或删除。完整步骤所需的库替换将在下一步处理。
将模拟中计划删除的软件包名称与其替换软件包进行比较。例如,在此虚拟机上,有 25 个项目如 libssl3 被列为待删除候选项,随后像 libssl3t64 这样的软件包被新安装。这并不自动证明所有删除都是合理的。如果支持 SSH、网络、存储或应用程序的软件包在没有替代的情况下消失,请停止操作。如 APT 手册 中所述,完全升级可能涉及删除操作。
审查不仅包括删除列表,还包括下载大小、安装后增加的磁盘使用量、待处理的软件包以及外部依赖。如果另一项 APT 操作正在运行,请等待其完成;不要删除锁文件或强制终止软件包进程。
运行完整升级并审查配置文件选择
sudo apt full-upgrade
sudo dpkg --audit
sudo apt-get check
sudo /usr/sbin/sshd -t
systemctl --failed --no-pager
阅读并确认实际的变更摘要是否与已审查列表相符。如果 apt-listchanges 指南打开,请阅读内容,然后关闭以继续安装。当 dpkg 或 ucf 询问如何处理修改过的配置文件时,首先检查它们是哪些文件以及您自己做了哪些更改。
| 选择情况 | 判断及后续验证 |
|---|---|
| 存在预期的本地更改,例如身份验证、端口或网络 | 检查差异并保留必要的更改。验证所保留的语法在新版本中是否仍然有效。 |
| 您没有更改发行版默认设置,或者新版本中有重要更改 | 请查看软件包指南和新默认设置。不要自动将保留现有文件视为正确答案。 |
| 无法确定重要设置的差异 | 检查说明和差异,同时保持控制台和备份。不要急于重启。 |
| 自动安装环境 | 提前测试选择策略。单一的非交互变量无法解决所有问题和兼容性。 |
本课程的验证虚拟机在单独的 tmux 会话中保存日志和退出代码,并设置了一项策略,以在不进行更改的情况下基于最小服务器配置保留现有的自定义设置。上述面向读者的步骤是一个交互式执行过程,在该过程中您阅读问题并进行选择。它不会直接指导将练习的自动批准选项应用于整个生产服务器。
如果安装以错误结束,首先检查日志、磁盘空间和软件包状态。仅在没有正在进行的 APT 操作且问题已解决时,才审查 sudo dpkg --configure -a 或 sudo apt --fix-broken install 提出的更改。不要将安装过程中途重启或大规模删除/强制覆盖作为通用解决方案。
在重启之前检查内核、网络接口和SSH
dpkg-query -W linux-image-amd64 'linux-image-*'
ls -l /vmlinuz /initrd.img
sudo ls -lh /boot
sudo /usr/sbin/sshd -t
ip -brief link
sudo udevadm test-builtin net_setup_link /sys/class/net/enp0s3
sudo efibootmgr -v
enp0s3 是验证虚拟机的接口。将其更改为实际名称,并与 ID_NET_NAME 及当前网络设置接口进行比较。在某些硬件上,名称可能会更改,因此需要控制台。BIOS 系统会检查启动方式和 GRUB 安装状态,而不是使用 efibootmgr。
即使安装了新的内核和 initramfs,当前的 uname -r 仍显示重启前的内核。打开一个新的 SSH 窗口以实际验证身份验证和 sudo 访问权限,不要仅凭一个打开的连接就认为一切正常。验证虚拟机的接口名称没有改变,并且重启前的新 SSH 连接成功。
sudo reboot
如果启动延迟,请在控制台上检查当前处于哪个步骤:引导程序、内核或服务。不要立即断电或禁用主机密钥验证,而应检查实际的启动状态和原始指纹。
验证新操作系统上的服务和数据
cat /etc/os-release
uname -r
sudo dpkg --audit
sudo apt-get check
ip -brief address
ip route
getent ahostsv4 deb.debian.org
systemctl --failed --no-pager
sudo /usr/sbin/sshd -t
在重新连接的虚拟机上,已确认 Debian 13.7 和内核 6.12.117+deb13-amd64。现有服务已启用且处于活动状态,HTTP 内容与预设参考值进行了比较,程序和数据的 SHA-256 完全一致。对于您自己管理的服务,请使用实际的名称、地址和文件进行如下验证。对正确的服务和基准文件使用只读检查;在调整示例时不要删除或覆盖生产数据。
systemctl is-enabled lf-upgrade33.service
systemctl is-active lf-upgrade33.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
sudo sha256sum -c /var/backups/lf-debian13-upgrade33/service-files-before.sha256
上述服务仅存在于用于预检查的验证虚拟机上。在常规服务器上,将比较实际服务的状态、端口、读取响应和数据库连接。对于具有写功能的服务,还会在恢复实际写入之前,使用隔离的测试数据检查写入和重新查询。
检查 /tmp 和 sysctl 配置更改
findmnt --target /tmp -o TARGET,SOURCE,FSTYPE,OPTIONS
df -hT /tmp
sudo /usr/lib/systemd/systemd-sysctl --cat-config
sysctl kernel.printk_ratelimit
重启后,验证虚拟机的/tmp使用了tmpfs(基于内存的文件系统)。tmpfs 的大小限制并不意味着提前保留了这么多内存。之前在上一根文件系统中的 /tmp 中的文件可能会在新的挂载下被隐藏。如果需要查找之前的文件,可以创建一个临时空挂载点,并使用常规绑定挂载只查看根目录。不要使用 --rbind,因为它也会复制覆盖原目录的tmpfs等子挂载,导致仍看不到底层文件。
sudo bash <<'ROOT'
set -euo pipefail
view=$(mktemp -d /mnt/old-root-view.XXXXXX)
trap 'mountpoint -q "$view" && umount "$view"; rmdir "$view"' EXIT
mount --bind / "$view"
find "$view/tmp" -mindepth 1 -maxdepth 2 -printf '%p\n'
umount "$view"
rmdir "$view"
trap - EXIT
ROOT
此命令仅显示列表。在实际服务器上,不要一次性删除整个临时目录;应根据文件的所有者和必要性进行判断。通过根目录的常规bind挂载查看时,验证虚拟机上先前的标记文件也不存在;升级前最后一次启动后并未记录该标记是否仍在,因此不能判断升级导致了文件消失。本身的隐藏原理在一个小的练习目录中得到确认,该目录使用独立的挂载命名空间,其中 tmpfs 覆盖了现有文件,在常规的根绑定视图中,文件是可见的。该受控可见性测试与在实际发行版升级中跟踪升级前标记是分开的。
Debian 13 的 systemd-sysctl 并不会直接读取 /etc/sysctl.conf 。请在各个 /etc/sysctl.d/ 文件中管理本地设置,并将它们的预期值与实际运行时值进行比较。实际上,经过验证,即使在新的内核启动后,kernel.printk_ratelimit=7 的独立配置片段仍被应用;经检查,仅删除了实训专用配置片段,并明确恢复了原始运行时值。仅删除配置文件不会自动恢复当前运行时值。如果不小心重新应用整个设置,可能会影响其他值,例如网络,因此需要定义应用范围。systemd-sysctl 手册 解释了文件选择和应用方法。
完成验证并决定是否需要恢复
验证后,输入 exit 以关闭脚本记录shell,并检查记录是否已保存。只有在确认没有包任务正在运行后,才关闭或分离tmux会话。
如果有监控、计划任务或APT定时器被中断,请将它们恢复到最初记录的状态。在验证虚拟机中,这两个APT定时器已恢复为启用和活动状态。完成全部验证后,再使用apt -s autoremove检查多余软件包的删除计划,不要急于删除以前的内核或正常启动所需的服务依赖项。
如果服务或数据验证失败,将保留失败的日志和证据,而不会继续进行新的写入。如果软件包已经被替换,仅切换到 bookworm 仓库并不能实现恢复。使用完整的预验证状态和服务的备份来确定修复范围,如果切换后有新数据,需要计划单独保存并重新应用。请检查 官方 Debian 升级流程 和 trixie 的已知更改,以及相关服务的迁移文档。




