首页/系统/信创系统运维速查/apt 软件源 sources.list 格式
命令与包管理65 条

apt 软件源 sources.list 格式

deb 系源文件:/etc/apt/sources.list 或 /etc/apt/sources.list.d/*.list,一行等于类型加地址加发行版代号加组件;代号写错是报错高发点。

信创系统运维速查系统更新于 2026-10-13

apt 源文件格式

deb 系发行版的软件源写在 /etc/apt/sources.list 或 /etc/apt/sources.list.d/ 下的文件里。传统格式一行由四部分组成:类型、仓库地址、发行版代号、组件列表。代号必须与本机系统版本严格对应,拷贝其他版本机器的源文件是 404 报错最常见的原因。较新系统也支持 deb822 风格的 .sources 文件。

基本信息

传统格式deb 地址 代号 组件
文件位置/etc/apt/sources.list 与 sources.list.d/
变体格式deb822(.sources 文件)
生效命令apt update
排障命令apt policy 与 apt-cache policy

典型使用场景

  • 内网环境把默认源替换成企业镜像源
  • 临时挂载本地 ISO 作为安装源
  • 添加第三方仓库以获取特定软件
  • 排障时确认某个包的候选版本来自哪个源
  • 统一多台主机的源配置以保持一致

传统格式样例

传统格式样例
deb http://mirrors.example.com/uos/ 20 main contrib non-free
deb http://mirrors.example.com/uos/ 20-updates main
deb http://mirrors.example.com/uos/ 20-security main

更新与验证

更新与验证
cp /etc/apt/sources.list /etc/apt/sources.list.bak   # 改前备份
vim /etc/apt/sources.list                            # 编辑源地址与代号
sudo apt update                                      # 刷新索引
sudo apt policy | head -20                           # 查看各源的优先级与候选版本
apt-cache policy nginx                               # 查看某个包的候选来源
ls /etc/apt/sources.list.d/                          # 确认附加源目录内容

常见报错对照

现象原因处理
404 找不到文件地址或代号拼错核对地址与系统代号
签名验证失败缺少公钥按提示导入仓库公钥
组件名无效组件与仓库不匹配确认该仓库支持的组件
候选版本不对启用了多余的源逐个源验证后再保留
索引过期缓存未刷新重新执行 apt update

使用建议

  • 源文件只保留必要的仓库,减少冲突
  • 改动前先备份原文件
  • 第三方源逐个添加并验证
  • 代号与系统版本保持一致
  • 把源配置纳入配置管理与基线核查
代号与系统版本必须一致:把其他版本机器的源文件照搬过来,会出现大面积找不到文件的报错,先确认本机版本代号再改源。

易错点

  • 照搬其他版本机器的源文件:代号不匹配会导致大量 404,先确认本机版本对应的代号
  • 第三方源与官方源混用不评估:依赖冲突与版本跳变都可能发生,逐个源验证再加
  • 改完不备份原文件:出问题难以快速回退,改动前先复制一份
  • 看到 404 就急着换源:先核对地址与代号拼写,多数问题出在地址写错而不是源不可用
  • 忽略 sources.list.d 目录:遗留的附加源会一起生效,排查时两处都要看

数据来源与参考

  • Debian sources.list 手册
  • 统信 UOS 知识库
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌