树莓派操作系统的最新主要版本现已推出。如果您仍在使用旧版系统，本文将为您提供一套完整的升级方案，帮助您从Bookworm或更早版本顺利过渡到Trixie。
将树莓派操作系统升级到新主版本时，推荐的做法是在新的SD卡上进行干净安装。旧SD卡可以作为备份使用，待新系统正常运行后，再将重要文件迁移过去。
首先，我们会简要提及一种快速方法，但本文的核心在于详细展示正确升级的完整流程。
目录
概述：选择最佳升级策略第一步：为系统迁移做好旧设备准备第二步：执行干净安装最新版树莓派操作系统第三步：恢复备份数据与配置高级技巧：主版本升级的额外建议概述：选择最佳升级策略
需要明确的是：本指南并非针对常规应用程序的版本更新。
本次升级涉及主版本变更，即对整个操作系统进行全方位更新，从树莓派操作系统（Bookworm或更早版本）升级到树莓派操作系统（Trixie）。
主版本升级意味着操作系统底层组件将发生根本性变化，这包括引入新功能，也可能导致旧的配置失效。
那么，执行版本升级的最佳方法是什么呢？
此前已提及一种快捷方式，有时被称为“就地升级”，即通过更换软件源并更新整个系统来完成。但事实上，这种方法并不推荐，因为它极有可能导致系统不稳定甚至崩溃。
https://raspberrytips.com/upgrade-raspberry-pi-os-bookworm/
最新版树莓派操作系统（Trixie）在显示服务器、音频管理和网络配置等方面进行了大量革新，这些变化使得就地升级的风险比以往更高。
让我们听听树莓派基金会的官方建议：
对于所有主要版本升级，我们不建议也不支持尝试升级正在运行的镜像。……推荐的方法是烧录一个干净的副本……西蒙·朗——软件工程师/树莓派
这正是本文要展示的：一种安全可靠的干净升级方法。
整个流程主要包含以下几个核心步骤：
备份所有重要文件和数据。执行树莓派操作系统的干净安装。恢复之前备份的数据和配置。接下来，我们将详细探讨每个步骤。
第一步：为系统迁移做好旧设备准备
在本节中，您需要确定需要保留的文件，完成备份工作，并为安装最新的树莓派操作系统做好准备。
清点需要保留的文件
在开始升级操作之前，最好先明确您希望保留哪些内容。这样，即使在升级过程中出现问题，您也能确保数据安全。以下是一些建议您检查的关键位置。
Home 目录
您的用户文件夹（例如 /home/pat）通常包含您存储的所有个人文件，如图片、文档或3D模型。
但您可能没有意识到，这里还隐藏着一些重要目录。
可以通过运行以下命令查看所有文件：
ls -hal
像 ~/.config/ 和 ~/.local/share/ 这样的文件夹包含了应用程序的配置信息，未来可能需要用到。
如果系统中有其他用户，他们在 /home 目录下也会有各自的文件夹。
最简单的方法是备份整个 /home 文件夹。
/etc 中的配置文件
在大多数Linux系统中，/etc 文件夹至关重要：它包含了系统上几乎所有应用程序和服务的配置文件，例如Web服务器设置、SSH密钥、定时任务和文件系统挂载指令。
这个文件夹可能包含大量文件，但由于它们大多是文本格式，实际占用的存储空间往往很小。为了简化操作，建议像处理 /home 一样备份整个 /etc 文件夹，之后再有选择性地恢复所需文件。
特殊启动文件
树莓派有两个特殊的启动文件：config.txt 和 cmdline.txt。
在较新的安装中，这些文件位于 /boot/firmware 文件夹内。
对于较旧的安装，这些文件则位于 /boot 中。
例如，config.txt 可能包含用于复古游戏超频的特定设置。
如果您从未修改过这些文件，可能无需保存，但鉴于它们体积小巧，备份起来也无妨。
已安装的软件包
迁移到新系统时，您可能需要重新安装常用的应用程序。但如果记不清安装了哪些软件怎么办？
使用以下命令创建文本记录，以便后续重新安装：
记录通过APT安装的软件包列表：dpkg -l > my_packages.txt
记录系统上正在运行的服务：systemctl list-units --type=service --state=running > my_services.txt
如何备份重要文件
现在您已经明确了需要保留的内容，接下来介绍备份这些文件的方法。
备份方式多种多样，我们将从最简单的方法开始，并提供其他进阶指南的链接。
保留旧SD卡作为备用盘
最简单的备份方法是保持旧SD卡完好无损。然后，使用另一张SD卡安装新系统。待新系统运行稳定后，可以通过USB读卡器插入旧SD卡，并复制所需文件。
即使数月后您突然想起某些内容，也可以随时从抽屉中取出旧SD卡进行检索，操作快捷方便。
将文件复制到其他存储介质
如果没有备用SD卡，可以通过将文件从树莓派复制到其他存储设备来创建备份。
例如，我喜欢使用SFTP协议将整个 /home 和 /etc 文件夹从树莓派传输到个人电脑上，这样可以省去压缩和解压缩的步骤。
另一种方法是使用 tar 命令压缩需要保留的文件夹，并将压缩文件保存到USB闪存盘中。
或者采用高级备份方案
如果上述备份方法不适用，可以参考我们网站上的其他方案。例如，您可以创建旧系统的完整镜像，以备未来恢复之需：如何创建树莓派SD卡的镜像？（Windows/Linux/Mac）。
https://raspberrytips.com/create-image-sd-card/
对于更特殊的备份需求，例如备份到在线云服务，请查阅我们的指南：备份树莓派的5种最佳方法（优缺点分析）。
https://raspberrytips.com/backup-raspberry-pi/
更新固件
完成备份后，您可以开始准备更新树莓派的固件。
固件存储在设备主板上，在安装新操作系统版本前确保其处于最新状态非常有益。这将提供最新的启动选项并减少硬件兼容性问题。
在终端中运行以下命令以检查树莓派固件是否需要更新：
sudo rpi-eeprom-update
如果提示“有更新可用”，请按照以下步骤更新树莓派固件：
https://raspberrytips.com/update-raspberry-pi-firmware/
sudo apt update
sudo apt full-upgrade
sudo rpi-eeprom-update -a
sudo reboot now
重启后，再次运行检查命令，应显示您正在使用最新的稳定固件版本。
第二步：执行干净安装最新版树莓派操作系统
现在，旧系统已妥善处理，是时候从头开始安装最新的树莓派操作系统版本了。
提示：使用两张SD卡会更加便捷。您可以将旧的工作系统保留在一张卡上作为备份，同时在另一张卡上安装新版本。
我们已有多个关于如何干净安装树莓派操作系统的指南。您可以根据情况选择以下方法之一：
A）使用USB SD卡读卡器的标准安装流程：
在树莓派上安装树莓派操作系统Trixie（图文并茂指南）。
https://raspberrytips.com/install-raspbian-raspberry-pi/
B）如果没有额外的显示器或键盘：
如何无头安装树莓派（无需显示器）。
https://raspberrytips.com/raspberry-pi-headless-setup/
C）如果没有其他电脑或SD卡读卡器：
通过网络启动方式安装树莓派系统。
https://raspberrytips.com/network-boot-with-raspberry-pi/
新系统启动并运行后，请花些时间完成树莓派操作系统的基础配置：设置用户账户、配置网络、安装系统更新等。完成这些步骤后，即可进入下一阶段。
第三步：恢复备份数据与配置
在干净安装最新的树莓派操作系统版本后，如何恢复您的旧有数据呢？以下是一些推荐的常见操作步骤。
重新安装应用程序
还记得在第一步中记录的软件包列表吗？现在是时候重新安装它们了。
您可以通过图形界面或命令行安装软件包，选择您更熟悉的方式即可。更多详细信息，请参考我们的指南：如何在树莓派操作系统上轻松安装应用程序？（5种常用方法）。
https://raspberrytips.com/install-apps-raspberry-pi/
但请注意，不建议盲目重新安装整个旧软件包列表。新版本中可能有些依赖关系已经发生变化。最好将列表作为参考，手动安装您可能需要的新版本软件。
复制用户文件
还记得之前备份的 /home 文件夹吗？您可以将其中的部分内容复制到新系统中。建议先从个人文件开始，例如视频、笔记等您自己创建并认识的文件。
然而，对于像 ~/.config 或 ~/.local 这样的隐藏文件夹，不建议直接全部复制。它们可能包含与刚安装的新应用程序版本冲突的配置。只有当您对某个特定应用程序有大量自定义设置且确实需要恢复时，才从这些文件夹中复制相关内容。
对于大多数应用程序，通常可以接受新的默认设置，并在此基础上进行调整。
恢复配置文件
还记得备份的 /etc 文件夹吗？您也可以有选择性地复制其中的内容。建议仅复制那些您明确知道进行过大量修改的服务配置文件。
例如：
/etc/ssh/etc/apache2/etc/ts.conf对于其余文件，建议使用新系统默认安装的版本。只有当您发现某个服务或程序的工作方式与以往不同时，才从备份中查找旧的配置文件并恢复该特定文件。
测试服务运行状态
还记得之前保存的服务列表吗？以下是如何让这些服务重新运行起来的方法：
重新安装服务的软件包。（例如：sudo apt install apache2）
复制其配置文件，这些文件通常可以在旧的 /etc 文件夹中找到。（例如，Pi-hole 的配置可能存储在 /etc/pihole 中）
启动服务并设置为开机自启：
sudo systemctl start
sudo systemctl enable
（更多详细信息，请查阅我们关于如何使用“systemctl”命令的指南。）
https://raspberrytips.com/systemctl-linux-command/
进行一些测试，确保您的服务按预期工作。建议一次处理一个服务会更轻松。例如，先安装并检查Web服务器是否正常运行，再验证Pi-Hole是否正确拦截广告，依此类推。
恭喜！以上步骤应能覆盖您升级到新版本所需的大部分操作。如果您是高级用户，请继续阅读下一节以获取更多实用技巧。
高级技巧：主版本升级的额外建议
实际上，每个系统环境都有所不同，因此无法在上述步骤中涵盖所有特殊情况。本节将介绍一些额外的技巧和窍门，或许能在备份和恢复过程中提供帮助。
定时任务（Cron Jobs）
如果您设置了自动化任务或脚本（即cron作业），则需要手动恢复它们。
在旧系统上，建议从以下位置查看并复制您的cron作业：
crontab -e
sudo crontab -e
如果无法访问运行中的系统，则需要复制相关文件。您可以在旧安装的以下位置查找它们：
用户作业: /var/spool/cron/crontabs/系统作业: /etc/crontab 和 /etc/cron.d/Web服务器配置
如果您托管了网站，需要确保从旧系统中复制网站文件。通常，网站文件可能存储在 /var/www/ 或 /var/www/html 文件夹中。
恢复网站的一般步骤如下：
将网站文件复制到新系统上的相同文件夹中。将您选择的Web服务器（如Apache、nginx或Caddy）的旧配置文件复制到新系统上。（这些配置文件通常位于 /etc 文件夹中。）在新安装上启动并启用Web服务器。测试您的网站是否可以正常访问。如果忘记了当初的设置方式，请参考我们的指南以唤醒记忆：在家中使用树莓派托管网站。
数据库文件迁移
如果在数据库中存储了重要信息，最好使用数据库应用程序的导出功能进行迁移。
首先，从旧系统导出数据库：
启动数据库应用程序。使用导出功能逐个导出每个数据库。此操作将创建数据库备份文件，例如 export.sql。
然后，在新系统上恢复数据库：
将导出的文件复制到新系统上。启动数据库应用程序。使用导入功能选择文件，逐个恢复每个数据库。具体步骤可能因您在树莓派上使用的数据库类型（如MySQL或MongoDB）而略有不同。
Python虚拟环境恢复
对于开发者而言，您可能有一些珍贵的Python虚拟环境需要在新系统上重建。但是，不建议直接压缩整个 venv 文件夹进行恢复，因为这可能导致兼容性问题。正确的做法是从旧系统导出虚拟环境配置，并在新系统上重新创建。
首先，从旧系统导出虚拟环境：
激活虚拟环境：source /path/to/venv/bin/activate
导出环境依赖列表：pip freeze > requirements.txt
然后，在新系统上恢复虚拟环境：
创建并激活新的虚拟环境：python3 -m venv venv
source venv/bin/activate
更新pip到最新版本以确保兼容性：pip install --upgrade pip
恢复依赖环境：pip install -r requirements.txt
容器化应用迁移
恢复Docker或Podman容器很大程度上取决于您最初的设置方式。
例如，如果您使用Docker Compose文件进行管理，并且这些文件存储在 ~/containers 文件夹中，那么只需将整个文件夹从旧系统复制到新系统上，然后让Docker根据配置拉取镜像并重新创建容器。这种方式无需手动恢复每个文件，这正是容器化部署的优势所在——便于移植。
推荐做法：复制容器配置文件，并让Docker或Podman自动处理其余部分。
但是，如果容器内确实包含需要保留的自定义设置怎么办？在这种情况下，请查看容器的配置文件（如YAML文件），并找到“volumes”部分。
该容器的文件存储在 /etc/pihole 和 /etc/dnsmasq.d 目录中。
（：）左侧列出的路径指示了这些文件在本地系统中的位置。如果需要，您可以将这些文件夹复制到新系统上。
希望本指南能帮助您理清升级流程，并对彻底升级树莓派系统充满信心。