1. 同步 Armbian#

在开始升级之前，必须先执行这两条命令同步 Armbian 软件源和升级现有软件包。

这两条命令在后续的 Armbian 维护中也会经常用到。

armbian-sync
armbian-upgrade

2. 升级 Debian#

这是升级过程的核心步骤，需要修改软件源并执行系统升级：

需要网络能直接访问 debian 的官方源，否则需要配置代理。

# 查看当前 hold 的软件包
apt-mark showhold

# OECT 设备需要忽略这三个更新，避免更新 uboot 导致设备无法启动
apt-mark hold initramfs-tools initramfs-tools-core armbian-bsp-cli-odroidn2-current

# 新版本不需要 sources.list 文件，备份一下
mv /etc/apt/sources.list /etc/apt/sources.list.bak

# 将软件源从 bookworm (Debian 12) 修改为 trixie (Debian 13)
sed -i -e 's/bookworm/trixie/g' /etc/apt/sources.list.d/*

# 更新软件包索引
apt-get update

# 执行完整升级
apt-get full-upgrade

# 清理不需要的软件包
apt-get autoremove

# 重启系统
reboot

3. 更新版本号#

由于 armbian 的 base-files 尚未更新，需要手动更新版本信息，等正式更新后，可以使用 1. 同步armbian 这一步骤再次执行。

NOTE

armbian 的 base-files 已经更新，不需要手动更新/etc/os-release、/etc/issue、/etc/debian_version 文件。执不执行都 ok。再次更新 1. 同步armbian

系统重启后，需要手动更新各个配置文件中的版本信息：

# 更新 ophub-release 文件，这个需要更新
sed -i -e 's/bookworm/trixie/g' /etc/ophub-release

# 更新 os-release 文件,当前 armbian 的 base-files 已经更新，不需要手动更新
sed -i -e 's/bookworm/trixie/g' /etc/os-release

# 更新 issue 文件，当前 armbian 的 base-files 已经更新，不需要手动更新
sed -i -e 's/Bookworm/Trixie/g' /etc/issue

# 更新 Debian 版本号，当前 armbian 的 base-files 已经更新，不需要手动更新
echo '13.0' > /etc/debian_version

# 更新 os-release 中的版本 ID，当前 armbian 的 base-files 已经更新，不需要手动更新
sed -i -e 's/VERSION_ID="12/VERSION_ID="13/g' /etc/os-release
sed -i -e 's/VERSION="12/VERSION="13/g' /etc/os-release

# 再次重启系统以确保所有更改生效
reboot

现在仍然需要更新 ophub-release 文件，这个文件是 ophub 的发行版信息，需要更新。

sed -i -e 's/bookworm/trixie/g' /etc/ophub-release

4. 验证升级结果#

升级完成后，可以通过以下命令验证系统版本：

# 查看系统发行版信息
lsb_release -a

# 查看 Debian 版本
cat /etc/debian_version

# 查看系统信息
cat /etc/os-release

如果升级成功，你应该看到类似以下的输出：

No LSB modules are available.
Distributor ID: Debian
Description:    Debian GNU/Linux 13 (trixie)
Release:        13
Codename:       trixie