1. 简介

本文档告知 Debian 发行版的用户，版本 13 （代号 trixie ）发生的主要变化。

本发行说明提供如何安全地从版本 12 （代号 bookworm ）升级到当前版本的信息，并告知用户在升级过程中可能会遇到的已知的潜在问题。

您可以在 https://www.debian.org/releases/trixie/releasenotes 获取本文档的最新版本。

小心

注意列出所有已知的问题是不可能的，因此我们根据影响范围和严重程度选择了一部分问题加以说明。

请注意，我们仅支持从 Debian 的前一版本升级（对于本次发行，即为从 bookworm 升级）并对其提供说明文档。如果您需要从更早的版本升级，我们建议您先查看前一版本的发行说明，并先升级到 bookworm。

1.1. 报告文档错误

我们已尽可能地测试了本文档中描述的所有不同的升级步骤，并预测了用户可能遇到的所有问题。

尽管如此，如果您认为您发现了本文档的任何错误（不正确或者缺失的信息），请在 错误追踪系统 中向 release-notes 软件包提交错误报告。您可以考虑先浏览一遍 已有的错误报告 以避免重复报告同一问题。如果您有能力对本文档做出贡献，也欢迎您向现有的错误报告添加额外的信息。

我们鼓励在提交错误报告时提供针对本文档源代码的补丁，并对此表示由衷感谢。您可以在 本文档的源文件 中获知如何获取本文档源代码。

1.2. 贡献升级报告

我们欢迎用户提供关于从 bookworm 升级到 trixie 的任何信息。如果您愿意分享，请在 错误追踪系统 中向 upgrade-reports 软件包提交包含您的升级结果的错误报告。我们希望您压缩提交的所有附件（使用 gzip）。

当您提交升级报告的时候，请包含以下信息：

• 在升级前后，软件包数据库的状态：dpkg 的状态数据库在 /var/lib/dpkg/status，apt 的软件包状态信息在 /var/lib/apt/extended_states。您应当在升级之前先根据 备份数据和配置文件 里的说明进行备份，但您也可以在 /var/backups 中找到 /var/lib/dpkg/status 文件的备份。

• 使用 script 创建的会话日志，如:ref:`record-session`所述。

• apt 的日志 /var/log/apt/term.log，或 aptitude 的日志 /var/log/aptitude。

备注

在提交错误报告之前，您应该花点时间检查和删除日志中的任何敏感和/或机密信息，因为这些信息都会被发布在公开的数据库中。

1.3. 本文档的源文件

本文档的源文件格式是 reStructuredText，使用了 sphinx 转换器。HTML 版本使用 sphinx-build -b html 生成。PDF 版本使用 sphinx-build -b latex 生成。可以从 Debian 文档计划 的 Git 仓库获得本发行说明的源文件。您也可以在 网页端 分别访问这些文件，并查看它们的变更。请参考 Debian 文档计划的版本控制系统信息页面 以了解访问 Git 仓库的方法。