Debian 13 (trixie) 的发行说明
*****************************

Debian 文档计划 <https://www.debian.org/doc>.

最近更新： 2025-04-04

本文档是自由软件；您可以在自由软件基金会发布的 GNU 通用公共许可证的条
款下重新发布或修改它；您应当使用该许可证的第二版本。

本程序发布的目的是希望它对您有用，但没有任何担保，甚至不保证它有经济价
值和适合特定用途。请查阅 GNU 通用公共许可证以获得更多细节。

您应当在收到本程序的同时也收到了一份 GNU 通用公共许可证的副本；如果没
有收到，请给自由软件基金会写信。地址是：51 Franklin Street, Fifth
Floor, Boston, MA 02110-1301 USA.

协议文本可以在 https://www.gnu.org/licenses/gpl-2.0.html 和 Debian 系
统中的 "/usr/share/common-licenses/GPL-2" 找到。

* 1. 简介

  * 1.1. 报告文档错误

  * 1.2. 贡献升级报告

  * 1.3. 本文档的源文件

* 2. Debian 13 的新变化

  * 2.1. 支持的架构

  * 2.2. 这次发布中有什么新变化？

    * 2.2.1. Official support for riscv64

    * 2.2.2. 桌面和知名软件包

* 3. 安装系统

  * 3.1. 安装系统有哪些新特性？

  * 3.2. 云服务安装

  * 3.3. 容器和虚拟机映像

* 4. 从 Debian 12 （bookworm）升级

  * 4.1. 升级前的准备

    * 4.1.1. 备份数据和配置文件

    * 4.1.2. 提前告知用户

    * 4.1.3. 准备服务停机

    * 4.1.4. 准备故障恢复

    * 4.1.5. 为升级准备安全环境

  * 4.2. Start from "pure" Debian

    * 4.2.1. Upgrade to Debian 12 (bookworm)

    * 4.2.2. 升级至最新的小版本更新

    * 4.2.3. Debian Backports

    * 4.2.4. 准备软件包数据库

    * 4.2.5. 移除过时的软件包

    * 4.2.6. 移除非 Debian 软件包

    * 4.2.7. 清理配置文件残留

    * 4.2.8. non-free 和 non-free-firmware 区

    * 4.2.9. proposed-updates 区

    * 4.2.10. 非官方源

    * 4.2.11. 禁用 APT pinning

    * 4.2.12. 检查 gpgv 是否已安装

    * 4.2.13. 检查包状态

  * 4.3. 准备 APT source-list 文件

    * 4.3.1. 添加互联网 APT 源

    * 4.3.2. 添加本地镜像 APT 源

    * 4.3.3. 从光学介质中添加 APT 源

  * 4.4. 升级软件包

    * 4.4.1. 记录会话

    * 4.4.2. 更新软件包列表

    * 4.4.3. 确保您有足够的空间升级

    * 4.4.4. 停止监控系统

    * 4.4.5. 最小系统升级

    * 4.4.6. 升级系统

  * 4.5. 升级期间可能遇到的问题

    * 4.5.1. Full-upgrade 失败，显示"无法立即配置"

    * 4.5.2. 预期的删除

    * 4.5.3. 冲突或预依赖循环

    * 4.5.4. 文件冲突

    * 4.5.5. 配置文件变化

    * 4.5.6. 将会话切换到控制台

  * 4.6. 升级内核与相关包

    * 4.6.1. 安装内核元软件包

  * 4.7. 为下个发布版本做准备

    * 4.7.1. 清理已删除的软件包

  * 4.8. 过时的软件包

    * 4.8.1. 过渡哑包

* 5. trixie 中需要注意的问题

  * 5.1. 升级到 trixie 时可能出现的问题

    * 5.1.1. openssh-server no longer reads ~/.pam_environment

    * 5.1.2. OpenSSH no longer supports DSA keys

  * 5.2. 升级后在重启前需要做的事

    * 5.2.1. 升级过程之外的注意事项

    * 5.2.2. 安全支持上的局限性

  * 5.3. 过时与废弃内容

    * 5.3.1. 值得注意的过时软件包

    * 5.3.2. trixie 的废弃组件

  * 5.4. 已知的严重缺陷

* 6. 关于 Debian 的更多信息

  * 6.1. 扩展阅读

  * 6.2. 获得帮助

    * 6.2.1. 邮件列表

    * 6.2.2. IRC

  * 6.3. 报告 Bug

  * 6.4. 为 Debian 做贡献

* 7. 在升级前管理您的 bookworm 系统

  * 7.1. 升级您的 bookworm 系统

  * 7.2. 检查您的 APT source-list 文件

  * 7.3. Performing the upgrade to latest bookworm release

  * 7.4. 删除过时的配置文件

* 8. 发行说明的贡献者



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 仓库的方法。



2. Debian 13 的新变化
*********************

The Wiki has more information about this topic.


2.1. 支持的架构
===============

下面是 Debian 13 官方支持的架构：

* 32 位 PC（"i386"）和 64 位 PC（"amd64"）

* 64 位 ARM（"arm64"）

* ARM EABI（"armel"）

* ARMv7（EABI 硬浮点 ABI，"armhf"）

* 64 位小端序 MIPS（"mips64el"）

* 64 位小端序 PowerPC（"ppc64el"）

* 64-bit little-endian RISC-V ("riscv64")

* IBM System z（"s390x"）

您可以在 Debian 移植页面 阅读更多的关于您的架构的移植状态和移植细节的
信息。


2.2. 这次发布中有什么新变化？
=============================

Debian 的这次发行再次带来了比上一版本 bookworm 更多的软件；本次发行包
括 11294 个新软件包，软件包的总数达到了 59551 个。这个发行版的多数软件
包得到了更新：更新了 42821 个软件包（占 bookworm 软件包总数的 72%）。
而且，由于各种原因，有相当数量的软件包（9519 个，占 bookworm 软件包总
数的 16%）从这次发行中被删除了。您将不会看到这些包有任何更新，而且在包
管理软件中它们会被标记为“过时的”；参见 过时的软件包。


2.2.1. Official support for riscv64
-----------------------------------

This release for the first time officially supports the riscv64
architecture, allowing users to run Debian on 64-bit RISC-V hardware
and benefit from all Debian 13 features.

The Wiki provides more details about riscv64 support in Debian.


2.2.2. 桌面和知名软件包
-----------------------

如往常一样，Debian 也提供了多个桌面程序和环境。提供的桌面环境包括
GNOME 43, KDE Plasma 5.27, LXDE 11, LXQt 1.2.0, MATE 1.26, 以及 Xfce
4.18。

生产力应用也得到了升级，包括办公套件：

* LibreOffice 已升级到 7.4 版；

* GNUcash 已升级到 4.13 版；

这次发行包含了许多软件的更新，其中包括：

+------------------------+------------------------+------------------------+
| 软件包                 | 在 12 （bookworm） 中  | 在 13 （trixie） 中的  |
|                        | 的版本                 | 版本                   |
|========================|========================|========================|
| Apache                 | 2.4.62                 | 2.4.63                 |
+------------------------+------------------------+------------------------+
| Bash                   | 5.2.15                 | 5.2.37                 |
+------------------------+------------------------+------------------------+
| BIND DNS 服务器        | 9.18                   | 9.20                   |
+------------------------+------------------------+------------------------+
| Cryptsetup             | 2.6                    | 2.7                    |
+------------------------+------------------------+------------------------+
| Emacs                  | 28.2                   | 30.1                   |
+------------------------+------------------------+------------------------+
| Exim 默认邮件服务器    | 4.96                   | 4.98                   |
+------------------------+------------------------+------------------------+
| GNU Compiler           | 12.2                   | 14.2                   |
| Collection，默认编译器 |                        |                        |
+------------------------+------------------------+------------------------+
| GIMP                   | 2.10.34                | 3.0.0                  |
+------------------------+------------------------+------------------------+
| GnuPG                  | 2.2.40                 | 2.2.46                 |
+------------------------+------------------------+------------------------+
| Inkscape               | 1.2.2                  | 1.4                    |
+------------------------+------------------------+------------------------+
| GNU C 运行库           | 2.36                   | 2.41                   |
+------------------------+------------------------+------------------------+
| Linux 内核映像         | 6.1 系列               | 6.12 series            |
+------------------------+------------------------+------------------------+
| LLVM/Clang 工具链      | 13.0.1 和 14.0（默认） | 19 (default), 17 and   |
|                        | 和 15.0.6              | 18 available           |
+------------------------+------------------------+------------------------+
| MariaDB                | 10.11                  | 11.4                   |
+------------------------+------------------------+------------------------+
| Nginx                  | 1.22                   | 1.26                   |
+------------------------+------------------------+------------------------+
| OpenJDK                | 17                     | 21                     |
+------------------------+------------------------+------------------------+
| OpenLDAP               | 2.5.13                 | 2.6.9                  |
+------------------------+------------------------+------------------------+
| OpenSSH                | 9.2p1                  | 9.9p1                  |
+------------------------+------------------------+------------------------+
| OpenSSL                | 3.0                    | 3.4                    |
+------------------------+------------------------+------------------------+
| Perl                   | 5.36                   | 5.40                   |
+------------------------+------------------------+------------------------+
| PHP                    | 8.2                    | 8.4                    |
+------------------------+------------------------+------------------------+
| Postfix MTA            | 3.7                    | 3.10                   |
+------------------------+------------------------+------------------------+
| PostgreSQL             | 15                     | 17                     |
+------------------------+------------------------+------------------------+
| Python 3               | 3.11                   | 3.13                   |
+------------------------+------------------------+------------------------+
| Rustc                  | 1.63                   | 1.85                   |
+------------------------+------------------------+------------------------+
| Samba                  | 4.17                   | 4.22                   |
+------------------------+------------------------+------------------------+
| Systemd                | 252                    | 257                    |
+------------------------+------------------------+------------------------+
| Vim                    | 9.0                    | 9.1                    |
+------------------------+------------------------+------------------------+



3. 安装系统
***********

Debian 安装程序是 Debian 官方的安装系统。它提供了多种安装方式。实际可
用的安装方式取决于您的处理器架构。

Images of the installer for trixie can be found together with the
Installation Guide on the Debian website
(https://www.debian.org/releases/trixie/debian-installer/).

安装手册也可以在 Debian 官方 DVD（CD/蓝光光碟）的第一张盘上找到，路径
是：

   /doc/install/manual/language/index.html

You may also want to check the errata for debian-installer at
https://www.debian.org/releases/trixie/debian-installer#errata for a
list of known issues.


3.1. 安装系统有哪些新特性？
===========================

自从 Debian 安装程序上一次随 Debian 12 发布以来，我们进行了大量的开发
工作，以提供更好的硬件支持及各种激动人心的新功能与改进。

If you are interested in an overview of the changes since bookworm,
please check the release announcements for the trixie beta and RC
releases available from the Debian Installer's news history.


3.2. 云服务安装
===============

The cloud team publishes Debian trixie for several popular cloud
computing services including:

* Amazon Web Services

* Microsoft Azure

* OpenStack

* 普通 VM

云映像将使用 "cloud-init" 提供自动化的钩子，并使用特别优化过的内核软件
包和 grub 配置达到快速建立实例的效果。在需要的场合，映像将支持不同的硬
件架构；同时云团队致力于支持云服务提供商提供的所有功能。

The cloud team will provide updated images until the end of the LTS
period for trixie. New images are typically released for each point
release and after security fixes for critical packages. The cloud
team's full support policy can be found here.

More details are available at https://cloud.debian.org/ and on the
wiki.


3.3. 容器和虚拟机映像
=====================

可以在 Docker Hub 找到多种架构的 Debian trixie 容器映像。除了标准映像
之外，另有提供剪裁版（"slim"版本）以便缩减磁盘使用量。

用于 Hashicorp Vagrant VM manager 的虚拟机映像在 Vagrant Cloud 处发布
。



4. 从 Debian 12 （bookworm）升级
********************************


4.1. 升级前的准备
=================

我们建议您在升级前阅读 trixie 中需要注意的问题 。它描述的潜在问题与升
级过程没有直接联系，但您仍可能需要在开始前了解这些信息。


4.1.1. 备份数据和配置文件
-------------------------

Before upgrading your system, it is strongly recommended that you make
a full backup, or at least back up any data or configuration
information you can't afford to lose. The upgrade tools and process
are quite reliable, but a hardware failure in the middle of an upgrade
could result in a severely damaged system.

The main things you'll want to back up are the contents of "/etc",
"/var/lib/dpkg", "/var/lib/apt/extended_states" and the output of:

   $ dpkg --get-selections '*' # (the quotes are important)

If you use "aptitude" to manage packages on your system, you will also
want to back up "/var/lib/aptitude/pkgstates".

The upgrade process itself does not modify anything in the "/home"
directory. However, some applications (e.g. parts of the Mozilla
suite, and the GNOME and KDE desktop environments) are known to
overwrite existing user settings with new defaults when a new version
of the application is first started by a user. As a precaution, you
may want to make a backup of the hidden files and directories
("dotfiles") in users' home directories. This backup may help to
restore or recreate the old settings. You may also want to inform
users about this.

Any package installation operation must be run with superuser
privileges, so either log in as "root" or use "su" or "sudo" to gain
the necessary access rights.

升级需要几个前提条件，您应当在实际升级前检查它们。


4.1.2. 提前告知用户
-------------------

It's wise to inform all users in advance of any upgrades you're
planning, although users accessing your system via an "ssh" connection
should notice little during the upgrade, and should be able to
continue working.

If you wish to take extra precautions, back up or unmount the "/home"
partition before upgrading.

You will have to do a kernel upgrade when upgrading to trixie, so a
reboot will be necessary. Typically, this will be done after the
upgrade is finished.


4.1.3. 准备服务停机
-------------------

系统提供的服务可能与升级包含的软件包相关联。如果存在这种情况，请注意，
在升级期间，当相关软件包被更换和配置时，这些服务将被停止。在此期间，这
些服务将无法使用。

The precise downtime for these services will vary depending on the
number of packages being upgraded in the system, and it also includes
the time the system administrator spends answering any configuration
questions from package upgrades. Notice that if the upgrade process is
left unattended and the system requests input during the upgrade there
is a high possibility of services being unavailable [1] for a
significant period of time.

If the system being upgraded provides critical services for your users
or the network [2], you can reduce the downtime if you do a minimal
system upgrade, as described in Minimal system upgrade, followed by a
kernel upgrade and reboot, and then upgrade the packages associated
with your critical services. Upgrade these packages prior to doing the
full upgrade described in Upgrading the system. This way you can
ensure that these critical services are running and available through
the full upgrade process, and their downtime is reduced.


4.1.4. 准备故障恢复
-------------------

Although Debian tries to ensure that your system stays bootable at all
times, there is always a chance that you may experience problems
rebooting your system after the upgrade. Known potential issues are
documented in this and the next chapters of these Release Notes.

因此，当您的系统重启失败（或对于远程管理的系统来说，无法连接网络）时，
请确保您能够将其恢复。

If you are upgrading remotely via an "ssh" link it is recommended that
you take the necessary precautions to be able to access the server
through a remote serial terminal. There is a chance that, after
upgrading the kernel and rebooting, you will have to fix the system
configuration through a local console. Also, if the system is rebooted
accidentally in the middle of an upgrade there is a chance you will
need to recover using a local console.

For emergency recovery we generally recommend using the *rescue mode*
of the trixie Debian Installer. The advantage of using the installer
is that you can choose between its many methods to find one that best
suits your situation. For more information, please consult the section
"Recovering a Broken System" in chapter 8 of the Installation Guide
(at https://www.debian.org/releases/trixie/installmanual) and the
Debian Installer FAQ.

如果上述步骤失败了，您需要采取替代方案来启动您的系统以便访问和修复它。
其中一种选择是使用特制的急救或者 live install 镜像。以这些介质引导后，
您应该可以挂载您的根文件系统并 "chroot" 到它里面来检查并修复问题。


4.1.4.1. initrd 引导时使用调试环境
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The **initramfs-tools** package includes a debug shell [3] in the
initrds it generates. If for example the initrd is unable to mount
your root file system, you will be dropped into this debug shell which
has basic commands available to help trace the problem and possibly
fix it.

Basic things to check are: presence of correct device files in "/dev";
what modules are loaded ("cat /proc/modules"); output of "dmesg" for
errors loading drivers. The output of "dmesg" will also show what
device files have been assigned to which disks; you should check that
against the output of "echo $ROOT" to make sure that the root file
system is on the expected device.

If you do manage to fix the problem, typing "exit" will quit the debug
shell and continue the boot process at the point it failed. Of course
you will also need to fix the underlying problem and regenerate the
initrd so the next boot won't fail again.


4.1.4.2. systemd 引导时使用调试 shell
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If the boot fails under systemd, it is possible to obtain a debug root
shell by changing the kernel command line. If the basic boot succeeds,
but some services fail to start, it may be useful to add
"systemd.unit=rescue.target" to the kernel parameters.

Otherwise, the kernel parameter "systemd.unit=emergency.target" will
provide you with a root shell at the earliest possible point. However,
this is done before mounting the root file system with read-write
permissions. You will have to do that manually with:

   # mount -o remount,rw /

Another approach is to enable the systemd "early debug shell" via the
"debug-shell.service". On the next boot this service opens a root
login shell on tty9 very early in the boot process. It can be enabled
with the kernel boot parameter "systemd.debug-shell=1", or made
persistent with "systemctl enable debug-shell" (in which case it
should be disabled again when debugging is completed).

More information on debugging a broken boot under systemd can be found
in the Freedesktop.org Diagnosing Boot Problems article.


4.1.5. 为升级准备安全环境
-------------------------

重要:

  If you are using some VPN services (such as **tinc**) consider that
  they might not be available throughout the upgrade process. Please
  see Prepare for downtime on services.

In order to gain extra safety margin when upgrading remotely, we
suggest that you run upgrade processes in the virtual console provided
by the "screen" program, which enables safe reconnection and ensures
the upgrade process is not interrupted even if the remote connection
process temporarily fails.

使用由 **micro-evtd** 提供的 watchdog 守护程序的用户应该在升级前停止守
护进程并禁用 watchdog timer，以避免在升级过程中发生不必要的重启：

   # service micro-evtd stop
   # /usr/sbin/microapl -a system_set_watchdog off


4.2. Start from "pure" Debian
=============================

The upgrade process described in this chapter has been designed for
"pure" Debian stable systems. APT controls what is installed on your
system. If your APT configuration mentions additional sources besides
bookworm, or if you have installed packages from other releases or
from third parties, then to ensure a reliable upgrade process you may
wish to begin by removing these complicating factors.

The main configuration file that APT uses to decide what sources it
should download packages from is "/etc/apt/sources.list", but it can
also use files in the "/etc/apt/sources.list.d/" directory - for
details see sources.list(5). If your system is using multiple source-
list files then you will need to ensure they stay consistent.


4.2.1. Upgrade to Debian 12 (bookworm)
--------------------------------------

Only upgrades from Debian 12 (bookworm) are supported. Display your
Debian version with:

   $ cat /etc/debian_version

Please follow the instructions in the Release Notes for Debian 12 at
https://www.debian.org/releases/bookworm/releasenotes to upgrade to
Debian 12 first if needed.


4.2.2. 升级至最新的小版本更新
-----------------------------

This procedure assumes your system has been updated to the latest
point release of bookworm. If you have not done this or are unsure,
follow the instructions in 升级您的 bookworm 系统.


4.2.3. Debian Backports
-----------------------

Debian Backports allows users of Debian stable to run more up-to-date
versions of packages (with some tradeoffs in testing and security
support). The Debian Backports Team maintains a subset of packages
from the next Debian release, adjusted and recompiled for usage on the
current Debian stable release.

Packages from bookworm-backports have version numbers lower than the
version in trixie, so they should upgrade normally to trixie in the
same way as "pure" bookworm packages during the distribution upgrade.
While there are no known potential issues, the upgrade paths from
backports are less tested, and correspondingly incur more risk.

小心:

  While regular Debian Backports are supported, there is no clean
  upgrade path from sloppy backports (which use APT source-list
  entries referencing bookworm-backports-sloppy).

As with Unofficial sources, users are advised to remove "bookworm-
backports" entries from their APT source-list files before the
upgrade. After it is completed, they may consider adding "trixie-
backports" (see https://backports.debian.org/Instructions/).

For more information, consult the Backports Wiki page.


4.2.4. 准备软件包数据库
-----------------------

在继续升级之前，还应确保软件包数据库已准备就绪。如果您是 **aptitude**
或 **synaptic** 等其他软件包管理器的用户，请查看任何待处理的操作。在包
管理器中被计划安装或删除的软件包可能会干扰升级过程。请注意，仅当您的
APT source-list 文件仍指向 "bookworm" 而不是 "stable" 或 "trixie" 时，
才能更正此项；请参阅 检查您的 APT source-list 文件。


4.2.5. 移除过时的软件包
-----------------------

在升级前从您的系统中 移除过时的软件包 是一个好想法。未移除即升级可能会
使升级过程复杂化，且它们因不再得到维护而可能带来安全风险。


4.2.6. 移除非 Debian 软件包
---------------------------

Below there are two methods for finding installed packages that did
not come from Debian, using either "apt" or "apt-forktracer". Please
note that neither of them are 100% accurate (e.g. the apt example will
list packages that were once provided by Debian but no longer are,
such as old kernel packages).

   $ apt list '?narrow(?installed, ?not(?origin(Debian)))'
   $ apt-forktracer | sort


4.2.7. 清理配置文件残留
-----------------------

A previous upgrade may have left unused copies of configuration files;
old versions of configuration files, versions supplied by the package
maintainers, etc. Removing leftover files from previous upgrades can
avoid confusion. Find such leftover files with:

   # find /etc -name '*.dpkg-*' -o -name '*.ucf-*' -o -name '*.merge-error'


4.2.8. non-free 和 non-free-firmware 区
---------------------------------------

If you have non-free firmware installed it is recommended to add "non-
free-firmware" to your APT sources-list.


4.2.9. proposed-updates 区
--------------------------

If you have listed the "proposed-updates" section in your APT source-
list files, you should remove it before attempting to upgrade your
system. This is a precaution to reduce the likelihood of conflicts.


4.2.10. 非官方源
----------------

If you have any non-Debian packages on your system, you should be
aware that these may be removed during the upgrade because of
conflicting dependencies. If these packages were installed by adding
an extra package archive in your APT source-list files, you should
check if that archive also offers packages compiled for trixie and
change the source item accordingly at the same time as your source
items for Debian packages.

Some users may have *unofficial* backported "newer" versions of
packages that *are* in Debian installed on their bookworm system. Such
packages are most likely to cause problems during an upgrade as they
may result in file conflicts [4]. Possible issues during upgrade has
some information on how to deal with file conflicts if they should
occur.


4.2.11. 禁用 APT pinning
------------------------

如果您已经设置 APT 从一个非 stable（如 testing）版安装特定的软件包，您
可能必须改变 APT pinning 设置（保存在 "/etc/apt/preferences" 和
"/etc/apt/preferences.d/" 中），以允许将软件包升级至新的 stable 中的版
本。如需更多有关 APT pinning 的信息，请参阅 apt_preferences(5)。


4.2.12. 检查 gpgv 是否已安装
----------------------------

APT 需要 **gpgv** 版本 2 或更高，以验证给 trixie 发布版本签名的密钥。
鉴于 **gpgv1** 在技术上满足了依赖关系，但仅能在一些特殊情况下使用，您
可能想要使用以下命令确保已经安装了正确的版本：

   # apt install gpgv


4.2.13. 检查包状态
------------------

不管用什么方法升级，我们都建议您先检查所有软件包的状态，并验证所有包都
处于可升级状态。以下命令会显示任何半安装或是配置失败的包，还有那些有任
何错误状态的包。

   $ dpkg --audit

您也可以用 "aptitude" 来检查系统中的所有软件包的状态，也可以使用如下命
令

   $ dpkg -l | pager

或是

   # dpkg --get-selections '*' > ~/curr-pkgs.txt

或者您也可以使用 "apt"。

   # apt list --installed > ~/curr-pkgs.txt

在升级前移除所有的 hold 状态是很有必要的。如果有任何对升级而言有重大影
响的包处于 hold 状态，升级会失败。

   $ apt-mark showhold

如果您在本地更改并重新编译了一个包，且并未重命名它，或是在版本号中放入
新的纪元号（epoch），您就必须将它设为 hold 状态，以防止它被升级。

"apt" 中的 "hold" 状态的包可以使用以下命令修改：

   # apt-mark hold package_name

用 "unhold" 代替 "hold" 即可清除 "hold" 状态。

如果有任何需要修复的东西，最好确保您的 APT source-list 文件仍然指向
bookworm，就像 检查您的 APT source-list 文件 中所解释的那样。


4.3. 准备 APT source-list 文件
==============================

在开始升级之前，您必须重新配置 APT 的 source-list 文件（
"/etc/apt/sources.list" 以及 "/etc/apt/sources.list.d/" 下的文件）以添
加用于 trixie 的源以及在通常情况下移除用于 bookworm 的源。

APT 将考虑所有已配置的源中包含的所有软件包，并安装具有最高版本号的软件
包，优先考虑文件中的第一个条目。 因此，如果您有多个镜像位置，请将本地
硬盘放在第一位，然后是 CD-ROM，最后是远程镜像。

一个发行版通常既能通过它的代号（如："bookworm"，"trixie"）引用，也可以
用它的状态名引用（如："oldstable"，"stable"，"testing"，"unstable"）。
引用发行版的代号的好处在于，您绝对不会因为新版本的发布而感到惊讶，因此
本文使用这种方法。当然，这也意味着您不得不自己关注新版的发行公告。如果
转而使用状态名，一旦有新版发行，您将只会看到一堆可用的软件包的更新。

Debian 提供了两个公告邮件列表，以帮助您及时了解与 Debian 发布相关的信
息：

* 通过 订阅 Debian 公告邮件列表，每次 Debian 发布新版本时，您都会收到
  通知。 例如当 "trixie" 从 "testing" 变为 "stable" 时。

* 通过 订阅 Debian 安全公告邮件列表，每次 Debian 发布安全公告时，您都
  会收到通知。


4.3.1. 添加互联网 APT 源
------------------------

在新版安装中，APT 默认使用 Debian APT CDN 服务，该服务确保软件包自动从
网络上离您较近的一个服务器下载。由于这是一项相对较新的服务，旧版安装的
配置可能仍然指向 Debian Internet 主服务器之一或其中一个镜像。如果您尚
未这样做，建议在 APT 配置中切换为使用 CDN 服务。

要使用 CDN 服务，请在 APT 源配置中添加这样一行（假设您在使用 "main" 和
"contrib"）：

   deb https://deb.debian.org/debian trixie main contrib

添加新源后，通过在以前存在的 ""deb"" 行前放置一个井号（"#"）来禁用它们
。

不过，如果您通过使用在网络上更接近您的特定的镜像得到了更好的结果，您仍
然可以继续这么做。

Debian mirror addresses can be found at
https://www.debian.org/mirror/list.

例如，假设离您最近的 Debian 镜像是 "http://mirrors.kernel.org"。 如果
使用网络浏览器检查该镜像，您会注意到主目录的组织方式如下：

   http://mirrors.kernel.org/debian/dists/trixie/main/...
   http://mirrors.kernel.org/debian/dists/trixie/contrib/...

要使用给定的镜像配置 APT，请添加类似如下的一行（同样，假设您正在使用
"main" and "contrib"）：

   deb http://mirrors.kernel.org/debian trixie main contrib

注意""dists""会隐式添加，而版本名称后的参数则用于将路径扩展到多个目录
。

同样，添加新源后，禁用以前存在的软件源条目。


4.3.2. 添加本地镜像 APT 源
--------------------------

您可能希望修改 APT source-list 文件以使用本地磁盘上的镜像（可能挂载在
NFS 上），而不是使用远程软件包镜像。

例如，您的软件包镜像可能位于 "/var/local/debian/" 下，并且具有如下的目
录结构：

   /var/local/debian/dists/trixie/main/...
   /var/local/debian/dists/trixie/contrib/...

要让 **apt** 使用它，需要把这一行添加至 "sources.list" 文件：

   deb file:/var/local/debian trixie main contrib

注意""dists""会隐式添加，而版本名称后的参数则用于将路径扩展到多个目录
。

添加新源后，通过在 APT source-list 文件中以前存在的软件源条目前放置一
个井号（"#"）来禁用它们。


4.3.3. 从光学介质中添加 APT 源
------------------------------

如果您 *只* 想使用 DVD（或 CD 或蓝光光盘），请在所有 APT source-list
文件中注释掉现有条目，方法是在它们前面放置一个井号（"#"）。

确保在 "/etc/fstab" 中有一行允许您挂载 CD-ROM 于 "/media/cdrom" 挂载点
。例如，假设 "/dev/sr0" 就是您的 CD-ROM，"/etc/fstab" 中应该带有一行：

   /dev/sr0 /media/cdrom auto noauto,ro 0 0

注意在第四列 "noauto,ro" 之间必须 *没有空格* 。

要验证设置是否有效，插入一片 CD，尝试运行

   # mount /media/cdrom    # this will mount the CD to the mount point
   # ls -alF /media/cdrom  # this should show the CD's root directory
   # umount /media/cdrom   # this will unmount the CD

下一步，运行：

   # apt-cdrom add

每片您所拥有的 Debian 二进制 CD-ROM 都要这么做，以便将每片 CD 的数据添
加至 APT 的数据库。


4.4. 升级软件包
===============

从以前的 Debian 版本升级的推荐方法是使用包管理工具 "apt"。

备注:

  "apt" 被设计用于交互式使用，故不应在脚本中使用。 在脚本中，应该使用
  "apt-get"，它具有更适合进行文本处理的稳定输出。

不要忘记挂载所有必需的分区（尤其是根分区和 "/usr" 分区）为可读写状态，
用以下命令：

   # mount -o remount,rw /mountpoint

接下来，您应该仔细检查确认 APT 源条目（在 "/etc/apt/sources.list" 以及
"/etc/apt/sources.list.d/" 下的文件）要么指向 "trixie"，要么指向
"stable"。 不应该有任何源条目指向 bookworm。

备注:

  CD-ROM 的源有时会指向 ""unstable""。尽管这令人困惑，但您 *不应该* 改
  变它。


4.4.1. 记录会话
---------------

强烈推荐您使用 "/usr/bin/script" 程序来记录升级会话中的交互信息。这样
如果有问题了，您就有一份日志，而且需要的话，它也可以在缺陷报告中提供准
确的信息。要开始记录，输入：

   # script -t 2>~/upgrade-trixie-step.time -a ~/upgrade-trixie-step.script

or similar. If you have to rerun the typescript (e.g. if you have to
reboot the system) use different *step* values to indicate which step
of the upgrade you are logging. Do not put the typescript file in a
temporary directory such as "/tmp" or "/var/tmp" (files in those
directories may be deleted during the upgrade or during any restart).

The typescript will also allow you to review information that has
scrolled off-screen. If you are at the system's console, just switch
to VT2 (using "Alt+F2") and, after logging in, use

   # less -R ~root/upgrade-trixie.script

to view the file.

在完成升级后，您可以在提示符下输入 "exit" 停止 "script"。

"apt" 也会把软件包的状态变更记录在 "/var/log/apt/history.log"，并把终
端输出记录在 "/var/log/apt/term.log"。"dpkg" 会额外地把软件包的状态变
更记录在 "/var/log/dpkg.log"。如果您使用 "aptitude", 它也会把软件包的
状态变更记录在 "/var/log/aptitude"。

如果已经对 "script" 使用了 *-t* 选项，您就可以用 "scriptplay" 程序来回
放整个过程：

   # scriptreplay ~/upgrade-trixie-step.time ~/upgrade-trixie-step.script


4.4.2. 更新软件包列表
---------------------

首先，需要获取新发行版的可用包列表。执行：

   # apt update

备注:

  apt-secure 的用户可能会在使用 "aptitude" 或 "apt-get" 时遇到问题。对
  于 apt-get，您可以使用 "apt-get update --allow-releaseinfo-change"。


4.4.3. 确保您有足够的空间升级
-----------------------------

You have to make sure before upgrading your system that you will have
sufficient hard disk space when you start the full system upgrade
described in Upgrading the system. First, any package needed for
installation that is fetched from the network is stored in
"/var/cache/apt/archives" (and the "partial/" subdirectory, during
download), so you must make sure you have enough space on the file
system partition that holds "/var/" to temporarily download the
packages that will be installed in your system. After the download,
you will probably need more space in other file system partitions in
order to both install upgraded packages (which might contain bigger
binaries or more data) and new packages that will be pulled in for the
upgrade. If your system does not have sufficient space you might end
up with an incomplete upgrade that is difficult to recover from.

"apt" 可以显示有关安装所需磁盘空间的详细信息。 在执行升级之前，您可以
通过运行以下命令来查看此估计：

   # apt -o APT::Get::Trivial-Only=true full-upgrade
   [ ... ]
   XXX upgraded, XXX newly installed, XXX to remove and XXX not upgraded.
   Need to get xx.xMB of archives.
   After this operation, AAAMB of additional disk space will be used.

备注:

  Running this command at the beginning of the upgrade process may
  give an error, for the reasons described in the next sections. In
  that case you will need to wait until you've done the minimal system
  upgrade as in Minimal system upgrade before running this command to
  estimate the disk space.

如果您没有足够的空间进行升级， "apt" 将通过类似这样的消息警告您：

   E: You don't have enough free space in /var/cache/apt/archives/.

在这种情况下，请确保事先释放空间。您可以：

* 删除以前安装时下载的软件包（位于 "/var/cache/apt/archives"）。 通过
  运行 "apt clean" 来清理软件包缓存，这将会删除所有以前下载过的软件包
  文件。

* 删除被遗忘的软件包。 如果您曾用 "aptitude" 或 "apt" 手动在 bookworm
  中安装过包，它将会保存手动安装的记录，并且对于由依赖关系拉入的包，在
  主包删除时能自动识别为不再需要的并标记为冗余。不会将您手动安装的包标
  记为删除。要删除自动安装的、不再使用的软件包，请运行：

     # apt autoremove

  您可以用其它的工具来找出多余的包，例如 "deborphan"，"debfoster" 或
  "cruft"。不要盲目地移除那些工具找到的包，尤其是当您使用了激进的非默
  认的选项时，很容易产生假阳性结果。强烈推荐您在移除它们之前，手工核查
  那些建议移除的包（例如：它们的内容、大小以及描述信息）。

* Remove packages that take up too much space and are not currently
  needed (you can always reinstall them after the upgrade). If you
  have **popularity-contest** installed, you can use "popcon-largest-
  unused" to list the packages you do not use that occupy the most
  space. You can find the packages that just take up the most disk
  space with "dpigs" (available in the **debian-goodies** package) or
  with "wajig" (running "wajig size"). They can also be found with
  **aptitude**. Start "aptitude" in full-terminal mode, select "Views
  > New Flat Package List", press "l" and enter "~i", then press "S"
  and enter "~installsize". This will give you a handy list to work
  with.

* 如果不需要的话可以从系统中移除翻译和本地化文件。您可以安装并配置
  **localepurge** 软件包，这样只有一小部分指定的 locale 被保留在系统中
  。这将减少 "/usr/share/locale" 所使用的磁盘空间。

* 将 "/var/log/" 下的系统日志临时放到其它系统，或是永久删除。

* 使用临时的 "/var/cache/apt/archives"：您可以使用其他文件系统中的临时
  缓存目录（USB 存储设备，临时硬盘，已在使用的文件系统等等）。

  备注:

    不要使用 NFS，这是因为网络连接可能在升级期间断开。

  例如，假设您将 USB 驱动器挂在 "/media/usbkey" 下：

  1. 删除以前安装时下载的包：

        # apt clean

  2. 将 "/var/cache/apt/archives" 目录复制到 USB 驱动器：

        # cp -ax /var/cache/apt/archives /media/usbkey/

  3. 将临时缓存目录挂载至当前使用的目录：

        # mount --bind /media/usbkey/archives /var/cache/apt/archives

  4. 升级后，还原 "/var/cache/apt/archives" 目录：

        # umount /var/cache/apt/archives

  5. 删除留下的 "/media/usbkey/archives"。

  您可以在挂载于系统中的任何文件系统上创建临时缓存目录。

* Do a minimal upgrade of the system (see Minimal system upgrade) or
  partial upgrades of the system followed by a full upgrade. This will
  make it possible to upgrade the system partially, and allow you to
  clean the package cache before the full upgrade.

请注意，为了安全地删除软件包，建议将 APT source-list 文件切换回
bookworm，如 检查您的 APT source-list 文件 中所述。


4.4.4. 停止监控系统
-------------------

因为 "apt" 可能需要暂时停止您的计算机上运行的服务，所以可能有必要在升
级期间停止有可能重启其他被停止的服务的监控服务。Debian 中的 **monit**
就是这种服务的一个例子。


4.4.5. 最小系统升级
-------------------

In some cases, doing the full upgrade (as described below) directly
might remove large numbers of packages that you will want to keep. We
therefore recommend a two-part upgrade process: first a minimal
upgrade to overcome these conflicts, then a full upgrade as described
in Upgrading the system.

要开始，请运行：

   # apt upgrade --without-new-pkgs

这会升级那些不需要删除或安装其它任何包的软件。

当系统空间紧张，并且由于空间限制而无法运行完整升级时，最小的系统升级也
将非常有用。

If the **apt-listchanges** package is installed, it will (in its
default configuration) show important information about upgraded
packages in a pager after downloading the packages. Press "q" after
reading to exit the pager and continue the upgrade.


4.4.6. 升级系统
---------------

一旦您完成了上述步骤，您就可以继续进行升级的主要部分。请执行：

   # apt full-upgrade

这将对系统进行一次全面的升级，安装所有包的最新可用版本，解决不同发行版
本的软件包之间的所有潜在的依赖关系变化。如有必要，它会安装一些新包（通
常是新版本的库，或是被重命名的软件包），并删除任何存在冲突的过时包。

当从一组 CD/DVD/BD 升级时，您会在升级期间的某些时刻被要求插入指定的盘
片。 您可能不得不多次插入相同的盘片，这是因为互相依赖的包已经被散布到
整个盘片组中去了。

无法在不改变其他软件包的安装状态的情况下升级的已安装软件包将停留在当前
版本（显示为"未被升级"）。这个问题可以通过使用 "aptitude" 选择这些包来
安装或是用 "apt install 软件包" 来解决。


4.5. 升级期间可能遇到的问题
===========================

以下部分描述升级到 trixie 期间已知可能会出现的问题。


4.5.1. Full-upgrade 失败，显示"无法立即配置"
--------------------------------------------

在某些情况下，下载软件包后，"apt full-upgrade" 步骤可能会失败：

   E: Could not perform immediate configuration on 'package'.  Please see man 5 apt.conf under APT::Immediate-Configure for details.

如果发生这种情况，运行 "apt full-upgrade -o APT::Immediate-
Configure=0" 应该可以使升级继续。

此问题的另一个可能解决方法是临时将 bookworm 和 trixie 源都添加到您的
APT source-list 文件中，并运行 "apt update"。


4.5.2. 预期的删除
-----------------

The upgrade process to trixie might ask for the removal of packages on
the system. The precise list of packages will vary depending on the
set of packages that you have installed. These release notes give
general advice on these removals, but if in doubt, it is recommended
that you examine the package removals proposed by each method before
proceeding. For more information about packages obsoleted in trixie,
see Obsolete packages.


4.5.3. 冲突或预依赖循环
-----------------------

有时有必要在 APT 中开启 "APT::Force-LoopBreak" 选项使之能够临时移除一
个重要的包，这是由于冲突或是预依赖循环。 "apt" 会警告您这一点并中止升
级。 您可以通过在 "apt" 命令行中指定 "-o APT::Force-LoopBreak=1" 选项
来解决这个问题。

有时一个系统的依赖关系太乱了以至于需要手工干预。 通常这意味着使用
"apt" 或

   # dpkg --remove package_name

来消除某些引起问题的包，或是

   # apt -f install
   # dpkg --configure --pending

在极端情况下，您可能不得不用类似下面的命令强制重新安装某个包

   # dpkg --install /path/to/package_name.deb


4.5.4. 文件冲突
---------------

如果您从"纯净的" bookworm 系统升级就不会出现文件冲突，但如果您装有非官
方的向后移植的软件包就可能出现冲突。文件冲突会导致类似以下这样的错误：

   Unpacking <package-foo> (from <package-foo-file>) ...
   dpkg: error processing <package-foo> (--install):
   trying to overwrite `<some-file-name>',
   which is also in package <package-bar>
   dpkg-deb: subprocess paste killed by signal (Broken pipe)
   Errors were encountered while processing:
   <package-foo>

您可以尝试强制删除错误信息中的*最后*一行提到的软件包来解决文件冲突：

   # dpkg -r --force-depends package_name

在修复这些问题后，您应该可以通过重复前述的 "apt" 命令来继续升级。


4.5.5. 配置文件变化
-------------------

升级期间，您将会被询问有关配置或是重新配置一些软件包的问题。如果您被问
到是否用软件包维护者的版本替换 "/etc/init.d" 或 "/etc/manpath.config"
下的文件时，通常有必要回答 "yes" 来确保系统一致性。您总是可以恢复老版
本的配置文件，因为它们会被保存为带有 ".dpkg-old" 后缀名的文件。

如果您不确定该做什么，那就记下软件包或文件的名称，以后再妥善处理这些问
题。您可以通过在 typescript 文件中搜索来查看升级期间显示在屏幕上的信息
。


4.5.6. 将会话切换到控制台
-------------------------

如果您使用系统的本地控制台升级，则可能会发现在升级过程中的某些时候，控
制台切换到了不同的视图，并且您无法看到升级过程。例如，在含有图形界面的
系统中，当显示管理器重新启动时，就可能发生这种情况。

To recover the console where the upgrade was running you will have to
use "Ctrl+Alt+F1" (if in the graphical startup screen) or "Alt+F1" (if
in the local text-mode console) to switch back to the virtual terminal
1. Replace "F1" with the function key with the same number as the
virtual terminal the upgrade was running in. You can also use
"Alt+Left Arrow" or "Alt+Right Arrow" to switch between the different
text-mode terminals.


4.6. 升级内核与相关包
=====================

这一节解释了如何升级您的内核，以及明确有关此次升级的潜在问题。您可以安
装由 Debian 提供的 **linux-image-*** 包，或者从源码编译一个自定义的内
核。

注意本节的很多信息基于假设，即您会使用一个模块化的 Debian 内核，以及
**initramfs-tools** 和 **udev**。如果您选择使用一个不需要 initrd 的自
定义内核，或是您使用了一种不同的 initrd 生成器，对您来说某些信息可能不
适用。


4.6.1. 安装内核元软件包
-----------------------

当您从 bookworm 完整升级至 trixie 时，如果没有安装，强烈推荐您安装
linux-image-* 元包。这些元包将在升级过程中自动引入新版本的内核。您可以
运行以下命令验证是否安装了上述元包：

   $ dpkg -l 'linux-image*' | grep ^ii | grep -i meta

如果您没有看到任何输出，那么您需要手动安装一个新的 linux-image 软件包
，或者安装 linux-image 元包。要查看可用的 linux-image 元包列表，请运行
：

   $ apt-cache search linux-image- | grep -i meta | grep -v transition

如果您不确定要选哪个包，那就运行 "uname -r" 并查找带有类似名称的包。
例如，如果您看到 ""4.9.0-8-amd64""，那推荐您安装 **linux-image-amd64**
。 您也可以使用 "apt" 来查看每个包的详细描述，以帮助您选择最好用的那个
。 例如：

   $ apt show linux-image-amd64

然后您应该使用 "apt install" 来安装它。 安装此新内核后，您应该在下一个
可能的时刻重新启动，以获得新内核版本提供的特性。 但是，在升级之后的第
一次重启之前，请先查看 升级后在重启前需要做的事。

对于热爱冒险的用户，有一个简单的方法可以在 Debian 上编译自己的定制内核
。安装由 **linux-source** 包提供的内核源码。您可以使用源文件的
makefile 中的 "deb-pkg" 目标来构建二进制包。更多信息可以在 Debian
Linux 内核手册 中找到，**debian-kernel-handbook** 包也提供同样内容。

If possible, it is to your advantage to upgrade the kernel package
separately from the main "full-upgrade" to reduce the chances of a
temporarily non-bootable system. Note that this should only be done
after the minimal upgrade process described in Minimal system upgrade.


4.7. 为下个发布版本做准备
=========================

升级完成后，您可以为下一个发布版本做些准备工作。

* Remove newly redundant or obsolete packages as described in Make
  sure you have sufficient space for the upgrade and Obsolete
  packages. You should review which configuration files they use and
  consider purging the packages to remove their configuration files.
  See also Purging removed packages.


4.7.1. 清理已删除的软件包
-------------------------

通常建议清理已删除的软件包。如果这些软件包已经在之前的版本升级（例如升
级到 bookworm）过程中被删除，或者它们是由第三方供应商提供的，则尤其如
此。特别地，已知旧的 init.d 脚本会导致问题。

小心:

  清理软件包通常也会清除其日志文件，因此您可能希望先备份它们。

以下命令显示所有已删除、但可能在系统上留下配置文件的软件包的列表（如果
有的话）：

   $ apt list '~c'

可以使用 "apt purge" 删除这些软件包。 假设您想一次性清除它们，可以使用
以下命令：

   # apt purge '~c'


4.8. 过时的软件包
=================

引进新软件包的同时，trixie 也清除了一些曾位于 bookworm 的旧软件包。 它
不提供对这些过时包的升级。 虽然没有什么可以阻止您继续使用过时的软件包
，但 Debian 项目通常会在 trixie 发布一年后停止对它的安全更新 [5]，并且
在此期间通常不会提供其他支持。 如果有的话，建议用可用的替代品替换它们
。

软件包被从发行版中移除有很多原因，如：它们不再被上游作者维护了；没有
Debian 开发者对维护这个包感兴趣；这些包提供的功能被不同的软件（或新版
本）替代了；或者由于它们自身的缺陷，使得它们被认为不适用于 trixie。最
后一种情况下，这些包有可能仍然位于 "unstable" 版之下。

以下命令可以列出并清除"过时的和在本地创建的软件包"：

   $ apt list '~o'
   # apt purge '~o'

Debian 缺陷跟踪系统 通常会提供有关这个包为什么会被移除的额外信息。您应
该既查看此包自身的归档缺陷报告，同时也要查看 ftp.debian.org 伪软件包
的归档缺陷报告。

要获得 trixie 的过时包列表，请参阅 值得注意的过时软件包。


4.8.1. 过渡哑包
---------------

来自 bookworm 的一些软件包可能已在 trixie 中被过渡哑包（transitional
dummy package）替换，这些软件包是用于简化升级的空占位符。例如，如果以
前单个包的应用程序已被拆分为多个，则可以提供与旧包具有相同名称的过渡包
，并设置合适的依赖以使新的包被安装。发生这种情况后，可以安全地移除冗余
哑包。

绝大多数过渡哑包的描述信息会显示它们的用途。但哑包的描述信息并不统一；
特别是，一些 "哑" 包被设计为保持安装，以便引入完整的软件套件或跟踪某些
程序的当前最新版本。您也可以使用 "deborphan" 命令的 "--guess-*" 选项（
例如 "--guess-dummy"）来检测系统上的过渡哑包。

[1] 如果 debconf 优先级被设置为非常高的级别，则可能不会弹出配置提示，
    但如果默认应答不适用于您的系统，依赖于此的服务将无法启动。

[2] 例如：DNS 或 DHCP 服务，特别是当没有冗余或故障转移时。以 DHCP 为例
    ，如果租用时间低于升级过程完成所需的时间，终端用户可能会断开网络连
    接。

[3] 此功能可以通过在您的启动参数中添加参数 "panic=0" 来禁用。

[4] Debian 的包管理系统正常情况下不允许一个软件包移除或是替换另一个软
    件包所拥有的文件，除非已经被设定为替换那个包。

[5] 或者，直到这段时间内有另一个版本发布为止。在任意时刻，一般仅对两个
    stable 版本提供支持。



5. trixie 中需要注意的问题
**************************

Sometimes, changes introduced in a new release have side-effects we
cannot reasonably avoid, or they expose bugs somewhere else. This
section documents issues we are aware of. Please also read the errata,
the relevant packages' documentation, bug reports, and other
information mentioned in 扩展阅读.


5.1. 升级到 trixie 时可能出现的问题
===================================

本节介绍从 bookworm 升级到 trixie 的相关问题。


5.1.1. openssh-server no longer reads ~/.pam_environment
--------------------------------------------------------

The Secure Shell (SSH) daemon provided in the **openssh-server**
package, which allows logins from remote systems, no longer reads the
user's "~/.pam_environment" file by default; this feature has a
history of security problems and has been deprecated in current
versions of the Pluggable Authentication Modules (PAM) library.  If
you used this feature, you should switch from setting variables in
"~/.pam_environment" to setting them in your shell initialization
files (e.g. "~/.bash_profile" or "~/.bashrc") or some other similar
mechanism instead.

Existing SSH connections will not be affected, but new connections may
behave differently after the upgrade.  If you are upgrading remotely,
it is normally a good idea to ensure that you have some other way to
log into the system before starting the upgrade; see 准备故障恢复.


5.1.2. OpenSSH no longer supports DSA keys
------------------------------------------

Digital Signature Algorithm (DSA) keys, as specified in the Secure
Shell (SSH) protocol, are inherently weak: they are limited to 160-bit
private keys and the SHA-1 digest.  The SSH implementation provided by
the **openssh-client** and **openssh-server** packages has disabled
support for DSA keys by default since OpenSSH 7.0p1 in 2015, released
with Debian 9 ("stretch"), although it could still be enabled using
the "HostKeyAlgorithms" and "PubkeyAcceptedAlgorithms" configuration
options for host and user keys respectively.

The only remaining uses of DSA at this point should be connecting to
some very old devices.  For all other purposes, the other key types
supported by OpenSSH (RSA, ECDSA, and Ed25519) are superior.

As of OpenSSH 9.8p1 in trixie, DSA keys are no longer supported even
with the above configuration options.  If you have a device that you
can only connect to using DSA, then you can use the "ssh1" command
provided by the **openssh-client-ssh1** package to do so.

In the unlikely event that you are still using DSA keys to connect to
a Debian server (if you are unsure, you can check by adding the "-v"
option to the "ssh" command line you use to connect to that server and
looking for the "Server accepts key:" line), then you must generate
replacement keys before upgrading.  For example, to generate a new
Ed25519 key and enable logins to a server using it, run this on the
client, replacing "username@server" with the appropriate user and host
names:

   $ ssh-keygen -t ed25519
   $ ssh-copy-id username@server


5.2. 升级后在重启前需要做的事
=============================

当 "apt full-upgrade" 完成时，"形式上的"升级就完成了。对于向 trixie 的
升级而言，重启前没有什么特别的操作需要完成。


5.2.1. 升级过程之外的注意事项
-----------------------------


5.2.2. 安全支持上的局限性
-------------------------

有一些软件包，Debian 不能保证针对安全漏洞提供最小的向后移植。这些将在
以下小节中介绍。

备注:

  **debian-security-support** 软件包可帮助跟踪已安装软件包的安全支持状
  态。


5.2.2.1. 网页浏览器及其渲染引擎的安全支持状态
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Debian 13 includes several browser engines which are affected by a
steady stream of security vulnerabilities. The high rate of
vulnerabilities and partial lack of upstream support in the form of
long term branches make it very difficult to support these browsers
and engines with backported security fixes. Additionally, library
interdependencies make it extremely difficult to update to newer
upstream releases. Applications using the **webkit2gtk** source
package (e.g. **epiphany**) are covered by security support, but
applications using qtwebkit (source package **qtwebkit-opensource-
src**) are not.

对于通用网页浏览器，我们推荐 Firefox 和 Chromium。这些软件将使用最新的
ESR 版本持续在 stable 中予以更新。这同样适用于 Thunderbird。

一旦一个发布版本成为 "oldstable"，官方支持的浏览器的支持周期可能短于发
布版本的标准支持周期。例如，Chromium 在 "oldstable" 中只会获得 6 个月
的安全支持，而不是通常的 12 个月。


5.2.2.2. 基于 Go 和 Rust 的软件包
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Debian 当前的基础架构在重新构建系统化使用静态链接的软件包时存在一些问
题。随着 Go 和 Rust 生态系统的成长，这些软件包将只能得到有限的安全支持
，直到基础架构得到改进使得这些软件包更加易于维护。

大多数情况下，如果 Go 或 Rust 开发库需要更新，这些更新只能通过定期的小
版本更新提供。


5.3. 过时与废弃内容
===================


5.3.1. 值得注意的过时软件包
---------------------------

以下是已知的和值得注意的过时软件包的列表（有关过时软件包的描述，请参阅
过时的软件包）。

过时的软件包包括：

* To be added, as below:

* **libnss-ldap** 软件包已从 trixie 移除。它的功能已由 **libnss-
  ldapd** 和 **libnss-sss** 代替。


5.3.2. trixie 的废弃组件
------------------------

随着下一个版本 Debian 14 （代号为 forky） 的发布，某些功能将被弃用。用
户需要迁移到其他替代方案，以防止在更新到 Debian 14 时出现问题。

这包括以下特性：

* To be added, as below:

* NSS 服务 "gw_name" 的开发已于 2015 年停止。与之对应的软件包
  **libnss-gw-name** 可能在未来的 Debian 发布版本中被移除。上游开发者
  建议使用 **libnss-myhostname** 代替它。

* The **openssh-client** and **openssh-server** packages currently
  support GSS-API authentication and key exchange, which is usually
  used to authenticate to Kerberos services. This has caused some
  problems, especially on the server side where it adds new pre-
  authentication attack surface, and Debian's main OpenSSH packages
  will therefore stop supporting it starting with forky.

  If you are using GSS-API authentication or key exchange (look for
  options starting with "GSSAPI" in your OpenSSH configuration files)
  then you should install the **openssh-client-gssapi** (on clients)
  or **openssh-server-gssapi** (on servers) package now.  On trixie,
  these are empty packages depending on **openssh-client** and
  **openssh-server** respectively; on forky, they will be built
  separately.


5.4. 已知的严重缺陷
===================

Although Debian releases when it's ready, that unfortunately doesn't
mean there are no known bugs. As part of the release process all the
bugs of severity serious or higher are actively tracked by the Release
Team, so an overview of those bugs that were tagged to be ignored in
the last part of releasing trixie can be found in the Debian Bug
Tracking System. The following bugs were affecting trixie at the time
of the release and worth mentioning in this document:

+------------------------+-----------------------------+--------------------------------+
| 缺陷编号               | 软件包（源码包或二进制包）  | 描述                           |
|========================|=============================|================================|
| 1032240                | **akonadi-backend-mysql**   | akonadi server fails to start  |
|                        |                             | since it cannot connect to     |
|                        |                             | mysql database                 |
+------------------------+-----------------------------+--------------------------------+
| 1032177                | **faketime**                | faketime doesn't fake time (on |
|                        |                             | i386)                          |
+------------------------+-----------------------------+--------------------------------+
| 918984                 | **src:fuse3**               | provide upgrade path fuse ->   |
|                        |                             | fuse3 for bookworm             |
+------------------------+-----------------------------+--------------------------------+
| 1016903                | **g++-12**                  | tree-vectorize: Wrong code at  |
|                        |                             | O2 level (-fno-tree-vectorize  |
|                        |                             | is working)                    |
+------------------------+-----------------------------+--------------------------------+
| 1020284                | **git-daemon-run**          | fails to purge: deluser -f:    |
|                        |                             | Unknown option: f              |
+------------------------+-----------------------------+--------------------------------+
| 919296                 | **git-daemon-run**          | fails with 'warning: git-      |
|                        |                             | daemon: unable to open         |
|                        |                             | supervise/ok: file does not    |
|                        |                             | exist'                         |
+------------------------+-----------------------------+--------------------------------+
| 1034752                | **src:gluegen2**            | embeds non-free headers        |
+------------------------+-----------------------------+--------------------------------+



6. 关于 Debian 的更多信息
*************************


6.1. 扩展阅读
=============

Beyond these release notes and the installation guide (at
https://www.debian.org/releases/trixie/installmanual) further
documentation on Debian is available from the Debian Documentation
Project (DDP), whose goal is to create high-quality documentation for
Debian users and developers, such as the Debian Reference, Debian New
Maintainers Guide, the Debian FAQ, and many more. For full details of
the existing resources see the Debian Documentation website and the
Debian Wiki.

各个软件包的文档被安装到 "/usr/share/doc/软件包"。它包括版权信息，特定
于 Debian 的信息，以及上游的文档。


6.2. 获得帮助
=============

Debian 的用户可以从很多渠道获得帮助、建议和支持，但您只应该在研究并查
阅文档了解问题大致情况后再考虑寻求帮助。本节简单介绍了对 Debian 新用户
可能会有帮助的渠道。


6.2.1. 邮件列表
---------------

The mailing lists of most interest to Debian users are the debian-user
list (English) and other debian-user-language lists (for other
languages). For information on these lists and details of how to
subscribe see https://lists.debian.org/. Please check the archives for
answers to your question prior to posting and also adhere to standard
list etiquette.


6.2.2. IRC
----------

Debian 在 OFTC IRC 网络上有专门对 Debian 用户提供帮助的 IRC 频道。使用
您喜欢的 IRC 客户端连接 irc.debian.org，加入 "#debian" 频道即可。

请遵守频道的准则，尊敬其他用户。可以在 Debian 维基 中找到该准则。

欲了解更多关于 OFTC 的信息，请访问他们的 网站。


6.3. 报告 Bug
=============

我们努力让 Debian 成为一款高质量的操作系统，但这并不意味着我们提供的软
件包完全没有任何错误。为了和 Debian 一贯的"开放的开发"原则相呼应，也为
了能为我们的用户提供更好的服务，我们在错误追踪系统（BTS）提供全部已经
报告的错误的所有信息。您可以通过 https://bugs.debian.org/ 来访问 BTS。

如果您在本发行版或者软件包中发现了错误，请报告它，从而可以在将来的发行
中被修复。您需要一个有效的电子邮件地址才能报告错误。有这个限制是因为这
样我们才能够追踪错误，以及在开发人员需要更多信息时，能够与提交人联系。

您可以使用程序 "reportbug" 来提交一个错误报告，或者亲自动手发送电子邮
件。可以通过阅读参考文档（如果您安装了 **doc-debian** 包的话，在
"/usr/share/doc/debian" 可以找到）或者在线的 错误追踪系统，以获得更多
关于错误追踪系统的信息和用法。


6.4. 为 Debian 做贡献
=====================

You do not need to be an expert to contribute to Debian. By assisting
users with problems on the various user support lists you are
contributing to the community. Identifying (and also solving) problems
related to the development of the distribution by participating on the
development lists is also extremely helpful. To maintain Debian's
high-quality distribution, submit bugs and help developers track them
down and fix them. The tool "how-can-i-help" helps you to find
suitable reported bugs to work on. If you have a way with words then
you may want to contribute more actively by helping to write
documentation or translating existing documentation into your own
language.

如果您能投入更多的时间的话，您可以负责维护 Debian 发行版中的部分自由软
件。如果您能够新增或维护其他用户希望 Debian 所能包含的软件包的话就更好
了，可以在 急需人手和被期待的软件包库 （WNPP） 中获得相关的信息。如果
您对特定的用户群体感兴趣，那么您可能会很乐意参加 Debian 的某些 子项目
，包括向特定处理器架构的移植，以及为特定用户群体准备的 Debian Pure
Blends，等等。

无论如何，只要您以任何方式参加了自由软件社区的活动，不管您是用户、程序
员、作者，还是译者，您就已经为自由软件社区做出了贡献。贡献本身就是一件
非常有益而有趣的事情，它不仅让您能够结交更多的新伙伴，还能让您内心充满
温暖的感觉。



7. 在升级前管理您的 bookworm 系统
*********************************

本附录包含在升级到 trixie 之前，如何确保您能够从 bookworm 安装或升级软
件包的相关信息。


7.1. 升级您的 bookworm 系统
===========================

Basically this is no different from any other upgrade of bookworm
you've been doing. The only difference is that you first need to make
sure your package list still contains references to bookworm as
explained in Checking your APT source-list files.

如果您从 Debian 镜像升级，将自动升级到最新的 bookworm 的小版本更新。


7.2. 检查您的 APT source-list 文件
==================================

如果您的 APT source-list 文件（参见 sources.list(5)）的任意一行包含了
"stable" 这样的字符串，它在新的稳定版本发布后实际上已经指向了 trixie。
如果您还没准备好升级系统的话，这可能不是您想要的结果。但如果您已经运行
过了 "apt update" 命令的话，您仍然可以采取下述步骤退回原状态而不产生额
外问题。

如果您已经从 trixie 安装了软件包，就没有太大的必要再从 bookworm 安装软
件包了。在这种情况下，您必须决定是否继续或者终止。降级软件包是可能的，
但是不属于本文的讨论范围。

As root, open the relevant APT source-list file (such as
"/etc/apt/sources.list") with your favorite editor, and check all
lines beginning with

   * "deb http:"

   * "deb https:"

   * "deb tor+http:"

   * "deb tor+https:"

   * "URIs: http:"

   * "URIs: https:"

   * "URIs: tor+http:"

   * "URIs: tor+https:"

for a reference to "stable". If you find any, change "stable" to
"bookworm".

如果有些行以 "deb file:" 或 "URIs: file:" 开始，您应该自己检查该位置是
否包含有 bookworm 或者 trixie 的档案仓库。

重要:

  不要修改任何以 "deb cdrom:" 或 "URIs: cdrom:" 开始的行。如果这样做了
  的话，这些行就会失效，您将需要重新运行 "apt-cdrom" 命令以启用从光盘
  更新的功能。即使在 "cdrom:" 的行发现 "unstable" 这样的字符串也不要感
  到奇怪。虽然令人困惑，但这是正常的。

如果做了任何修改，保存文件后执行

   # apt update

以刷新软件包列表。


7.3. Performing the upgrade to latest bookworm release
======================================================

To upgrade all packages to the state of the latest point release for
bookworm, do

   # apt full-upgrade


7.4. 删除过时的配置文件
=======================

在将系统升级到 trixie 之前，建议从系统中删除旧的配置文件（例如 "/etc"
下的 "*.dpkg-{new,old}" 文件）。



8. 发行说明的贡献者
*******************

有许多人对发行说明提供了帮助，包括但不限于

* Adam D. Barrat (2013 年的多项修复),

* Adam Di Carlo (先前的版本),

* Andreas Barth aba (先前的版本：2005 - 2007),

* Andrei Popescu (大量贡献),

* Anne Bezemer (先前的版本),

* Bob Hilliard (之前的发行),

* Charles Plessy (GM965 问题描述),

* Christian Perrier bubulle (Lenny 安装程序),

* Christoph Berg (PostgreSQL 相关的问题),

* Daniel Baumann (Debian Live),

* David Prévot taffit (Wheezy 版本),

* Eddy Petrișor (大量贡献),

* Emmanuel Kasper (回迁软件包),

* Esko Arajärvi (重新实现 X11 升级),

* Frans Pop fjp (先前版本 Etch),

* Giovanni Rapagnani (无数贡献),

* Gordon Farquharson (ARM 移植的问题),

* Hideki Yamane henrich (自 2006 年起),

* Holger Wansing holgerw (自 2009 年起),

* Javier Fernández-Sanguino Peña jfs (Etch 版本，Squeeze 版本),

* Jens Seidel (德语翻译者，无数贡献),

* Jonas Meurer (syslog 问题),

* Jonathan Nieder (Squeeze 版本，Wheezy 版本),

* Joost van Baal-Ilić joostvb (Wheezy 版本，Jessie 版本),

* Josip Rodin (先前的版本),

* Julien Cristau jcristau (Squeeze 版本，Wheezy 版本),

* Justin B Rye (英语修改),

* LaMont Jones (NFS 问题的描述),

* Luk Claes (编辑动员管理员),

* Martin Michlmayr (ARM 移植的问题),

* Michael Biebl (syslog 问题),

* Moritz Mühlenhoff (大量贡献),

* Niels Thykier nthykier (Jessie 版本),

* Noah Meyerhans (无数贡献),

* Noritada Kobayashi (日语翻译（协调），无数贡献),

* Osamu Aoki (大量贡献),

* Paul Gevers elbrus (Buster 版本),

* Peter Green (内核版本注记),

* Rob Bradford (Etch 版本),

* Samuel Thibault (d-i 布莱叶支持描述),

* Simon Bienlein (d-i 布莱叶支持描述),

* Simon Paillard spaillar-guest (无数贡献),

* Stefan Fritsch (Apache 问题描述),

* Steve Langasek (Etch 版本),

* Steve McIntyre (Debian CD),

* Tobias Scherer ("proposed-update"描述),

* victory victory-guest (标记语言修复，自 2006 年起),

* Vincent McIntyre ("proposed-update"描述),

* W. Martin Borgert (编辑 Lenny 发行，转换到 DocBook XML).

本文档被翻译为多种语言。感谢这些翻译者们！