Debian Bookworm国内源更换

在 Debian Bookworm（Debian 12）上，apt 默认从官方源下载软件包，国内网络环境下速度往往很慢。
把源切换到国内镜像站，并同步配置好安全更新源，既能让下载提速，也能保证系统及时获得安全补丁。
本文面向刚接触 Linux 的用户，按步骤完成备份、换源、验证和排错，整个操作只需几分钟。

一、换源前先确认系统版本和可用镜像

首先确认你的系统确实是 Bookworm。
执行：

cat /etc/os-release

如果输出中有 VERSION_CODENAME=bookworm，就可以继续。
国内常用的 Debian 镜像源有清华 TUNA、阿里云、中科大 USTC，本文以清华源为例，其他镜像地址结构类似。

二、备份原源列表并写入国内源

apt 的软件源配置集中在 /etc/apt/sources.list 文件中。
先备份原文件：

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

然后用文本编辑器打开：

sudo nano /etc/apt/sources.list

清空原内容，写入以下配置（清华源）：

deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware

其中第三行就是安全更新源，必不可少。non-free-firmware 是 Debian 12 新增的组件，缺少它会导致部分固件包无法安装。

三、更新索引并验证安全源是否生效

保存文件后，执行：

sudo apt update

看到 Reading package lists... Done 且没有 Err 或 404 信息，说明换源成功。
如果提示公钥不可用，先安装官方密钥包：

sudo apt install debian-archive-keyring

再执行 sudo apt update 即可。
之后可以查看可升级的软件包：

apt list --upgradable

确认列表正常后，再执行 sudo apt upgrade 完成更新。
判断配置是否正确的简单方法是检查安全源地址是否与主源一致，常见错误是只替换了前三行却漏掉 bookworm-security。

四、高频报错与避坑提醒

出现 404 或 Release file not found：通常是仓库路径或组件名写错了。
请检查每行末尾是否包含 non-free-firmware，并确认 codename 是 bookworm 而不是 bullseye。

不要混用多个镜像源：系统中只需要一套源配置，把清华、阿里、中科大的地址混在一起，会造成索引冲突和软件包版本不一致。

GPG 错误不要用 apt-key 修复：Debian 已弃用 apt-key，正确做法是安装对应的 keyring 包，或者从镜像站获取官方签名文件。

安全源必须单独配置：bookworm-security 不是 bookworm-updates 的子集，漏掉它会导致安全补丁无法获取，这是新手最容易踩的坑。

五、如何判断换源最终是否成功

完成以上步骤后，apt update 无报错、apt upgrade 能正常执行，且下载速度明显快于官方源，就说明配置生效。
后续建议每周执行一次 sudo apt update && sudo apt upgrade，让服务器保持最新安全状态。
如果更换过程中遇到其它报错，优先核对源地址的 HTTPS 前缀、系统版本号和组件名，再检查网络连通性。