Debian 13 教程 / 配置deb822软件源与Signed-By签名密钥环

Debian 13的高级软件包工具(Advanced Package Tool,APT)从/etc/apt/sources.list及/etc/apt/sources.list.d下的文件读取软件源定义。deb822格式的.sources文件使用具名字段组织仓库设置。转换现有配置时,应保留地址、发行分支、组件和签名信任范围,停用旧的重复条目,再刷新索引并比较软件包候选版本。

检查当前的仓库格式

使用已完成APT软件包安装与移除实验的Debian 13虚拟机。仓库定义控制着软件包来源和信任。不要粘贴 Ubuntu 仓库或其他 Debian 发行版的配置。

cat /etc/os-release
ls -l /etc/apt/sources.list
find /etc/apt/sources.list.d -maxdepth 1 -type f -print
cat /etc/apt/sources.list
apt-cache policy bash

如果 .sources 文件已存在,请读取文件以验证有效的仓库。在私有仓库地址包含身份验证信息的环境中,不要将整个文件外部共享。可能存在没有 /etc/apt/sources.list 的配置,因此不要仅因为文件缺失就假设没有仓库。

原课程的实际验证环境为 Debian 13.7,APT 3.0.3。安装程序在 sources.list 中创建了单行 deb 和 deb-src 条目,而 sources.list.d 是空的。这里描述的转换过程针对该状态。如果已经存在合适的 deb822 配置,请不要创建新的重复文件,而是查看当前文件的各个字段。

理解deb822字段与仓库组件

deb822 是一种将仓库写为字段名称和值集合的格式。每个集合由空行分隔。由于它既不是 YAML 也不是 shell 脚本,因此您不能用 bash 运行 .sources 文件。sources.list 手册 解释了 .list 的单行格式和 .sources 的 deb822 格式。

字段 作用 示例选择
Types 二进制和源包列表的类型 deb 请求二进制包索引;deb-src 请求源包索引。
URIs 仓库的基本地址 区分普通存档和安全仓库。
Suites 发布/更新分支 使用 trixie、trixie-updates、trixie-security。
Components 要查询的存档区域 保留现有的main与non-free-firmware。
Signed-By 用于验证此仓库的密钥环 已安装的 Debian 存档密钥环的绝对路径。

用空格分隔多个字段值,而不是用逗号。例如,两个 Suites 值共享一个以空格分隔的字段。在某个.sources配置块中加入Enabled: no,会停用整个块,包括其中定义的每个发行分支。删除该字段或将值改为yes可重新启用整个块。请检查所有活动定义,以确保安全存储库不会意外被禁用。

为了维护 Debian 13,指定代号 trixie 的配置意图比使用像 stable 这样的移动名称更明确。即使新的 Debian 版本成为 stable,trixie 仍然指向同一个版本。trixie-updates 是稳定版本的更新分支,而 trixie-security 是安全更新分支。更改代号与发行版升级计划相关,不能为了绕过仓库错误而随意更换代号。

区域 分类标准 选择时确认
main 该发行版符合 Debian自由软件指导方针(DFSG)的区域 默认软件包配置的核心。
contrib 一个区域,软件本身符合自由软件指南,但可能依赖main区域以外的组件。 检查必要的程序和依赖项。
non-free 不符合自由软件指南的软件 检查许可证和组织政策。
non-free-firmware 单独隔离的非自由固件区域 检查设备所需的固件及分发条件。

区分区域的依据可以在 Debian 政策存档区域描述 中找到。仅仅因为需要固件,并不意味着所有非自由区域都必须自动添加。这个示例保留了安装程序现有的选择。

备份定义并记录软件包候选项

备份目录必须尚不存在。如果存在,请选择一个新的名称,并一致地调整每个恢复路径。单独运行第一行,并且仅在成功时继续;如果复制或任何目标文件检查失败,也要停止。没有可用备份时不要进行编辑。

sudo test ! -e /var/backups/lf-debian13-10 && sudo install -d -m 700 /var/backups/lf-debian13-10
sudo cp -a /etc/apt/sources.list /etc/apt/sources.list.d /var/backups/lf-debian13-10/
apt-cache policy bash | sudo tee /var/backups/lf-debian13-10/bash-policy-before.txt
sudo test ! -e /etc/apt/sources.list.d/debian.sources
ls -l /usr/share/keyrings/debian-archive-keyring.gpg
sudo -u _apt test -r /usr/share/keyrings/debian-archive-keyring.gpg && printf 'APT account can read the keyring\n'

如果 debian.sources 已经存在,不要覆盖它。密钥环由 debian-archive-keyring 包提供,在这个虚拟机中,.gpg 路径是指向 .pgp 文件的链接。重要的是指定的公钥环是否真的可以被 _apt 账户读取。如果密钥文件丢失或损坏,不要通过接收未经验证的密钥来绕过,而应检查正确的软件包和恢复资料。

bash 候选项查找是用于比较数据,以验证软件包选择是否因转换而无意中改变。即使某个软件包相同,也不能证明所有软件包策略都是相同的,因此还需比较存储库的地址、分支和组件。

编写完整的 deb822 文件并禁用旧条目

使用以下命令打开一个新文件。只有在先前的存在检查和备份完成后才继续。

sudo nano /etc/apt/sources.list.d/debian.sources

输入以下所有内容,使用 Ctrl+O 然后 Enter 保存,然后使用 Ctrl+X 退出。将常规和更新的条目分组到同一地址下,并将安全仓库放在单独的组中。两个组之间保持一行空行。

Types: deb deb-src
URIs: http://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb deb-src
URIs: http://security.debian.org/debian-security
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

在 Types 中包含 deb-src 的原因是为了保留现有的源列表功能。不会下载和构建源代码的服务器可以根据需要只使用 deb,但这个选择与格式转换是分开的。将仓库地址写入URIs字段,并将相应密钥环路径写入Signed-By字段;不要改用其他发行版的密钥环。

sudo chmod 644 /etc/apt/sources.list.d/debian.sources
sudo nano /etc/apt/sources.list

将从现有 sources.list 移动到新文件的 Debian deb 和 deb-src 行注释掉以停用它们。在没有单独审核的情况下,不要删除用于其他目的的条目。例如,将现有的 deb http://deb.debian.org/debian trixie main non-free-firmware 改为注释。如果现有的光盘条目已经被注释掉,则保持原样。

如果同一个仓库同时在 .list 和 .sources 文件中激活,可能会出现重复警告或 Signed-By 值冲突。如果您将文件名保存为 .sources.txt,APT 将不会将其读取为它期望的格式,因此也请检查文件扩展名。

刷新列表并比较软件包选择

下一步操作不会升级已安装的软件包。首先,它会检查仓库定义和签名验证是否被正确处理。

sudo apt update
apt-cache policy bash | sudo tee /var/backups/lf-debian13-10/bash-policy-after.txt
sudo diff -u /var/backups/lf-debian13-10/bash-policy-before.txt /var/backups/lf-debian13-10/bash-policy-after.txt
sudo apt-get -s install tree

原课程验证虚拟机中,trixie、trixie-updates 和 trixie-security 的 InRelease 处理都通过了。bash 的候选版本和优先级比较没有差异,tree 的模拟安装也正常创建了计划。如果操作期间仓库发布了新版本,前后候选值可能不同;应核对变化的来源与版本,判断差异来自格式转换还是仓库更新。

更新可能会部分失败,而后续命令继续使用旧的软件包列表。不要只看最后一行;要检查签名错误、下载失败和重复警告。如果失败的仓库是安全仓库,仅因为可以找到现有的软件包,并不意味着操作已完成。

理解 Signed-By 和仓库信任

Signed-By 限制用于验证存储库元数据的公钥范围。存在密钥文件和存储库签名被正确验证是不同的情况。apt-secure 手册 解释了使用已签名的 Release 信息和软件包哈希进行的验证系统。存储库信任也不同于保证所有软件包操作都是无害的。

此示例保留安装程序的官方 HTTP 地址并使用签名验证。HTTPS 为传输段提供了额外保护,但不能替代签名验证。使用 HTTPS 的组织应通过检查证书信任和代理策略来一致地应用它。

在添加外部提供者仓库时,请检查是否支持 Debian 13、官方分发地址、密钥指纹以及发行版路径。由管理员存储的密钥可以放在 /etc/apt/keyrings 中,包管理的密钥可以放在 /usr/share/keyrings 中。不要随意添加外部密钥以用于全局信任,也不要使用 Trusted: yes 或禁用签名验证选项来绕过问题。对于 Debian 13,也不需要复制旧的 apt-key add 流程来获取默认仓库密钥。

对于签名密钥错误,请检查 Signed-By 路径、读取权限、准确的密钥以及仓库;对于 Release 有效期错误,请检查服务器时钟和仓库状态。检查时间的方法可以参考 区分时区和实际同步 中说明的标准。在未确定原因前,不要禁用日期或有效性检查。

恢复原始仓库定义

仅在符合本例初始状态、原先只启用了sources.list且本次新增debian.sources时,才使用下面的恢复方法。在恢复之前,请与备份进行比较,以检查是否没有其他正常更改。如果已经在运行的 .sources 文件被修改,则需要单独恢复该文件的备份。

sudo cp -a /var/backups/lf-debian13-10/sources.list /etc/apt/sources.list
sudo rm -- /etc/apt/sources.list.d/debian.sources
sudo apt update
apt-cache policy bash

只删除新的 debian.sources 文件;其余的 sources.list.d 保留。原课程实习中,恢复的 sources.list 与原始文件逐字节匹配,随后的列表刷新成功。转换存储库格式不会将已安装的软件包回滚到以前的版本。之后进行的任何软件包升级都需要自己的恢复计划。