内容总览

linux: APT 包管理工具 思维导图

一、起源:包管理解决的问题

1.1 源码编译的繁琐

早期 Linux 软件以源码形式分发,使用前需手动编译、配置路径、处理依赖。软件升级、卸载、回滚成本高,且无统一元数据记录安装内容。

1.2 依赖地狱

软件之间相互依赖,手动追踪依赖树易出错、遗漏或产生版本冲突。一个软件的安装可能需先解决数十个依赖,依赖之间又相互依赖,形成复杂依赖图。

1.3 安装一致性

不同机器重复编译,配置不统一,难以维护和复现。同一软件在不同环境下的行为可能存在差异。

1.4 包管理的诞生

  1. dpkg:解决"打包 + 元数据 + 安装卸载"问题
    • 将软件封装为 .deb 包,内含文件清单与依赖声明

    • 提供本地安装、卸载、查询能力,维护本地数据库(/var/lib/dpkg)

  2. apt:在 dpkg 之上解决"依赖自动解析 + 源管理 + 索引"问题
    • 自动从源下载索引,构建依赖图,解析版本约束

    • 调用 dpkg 完成实际安装,形成分层架构

二、原理:APT 如何工作

2.1 分层架构

  1. dpkg(底层)
    • 负责 .deb 包的安装、卸载、本地数据库维护

    • 数据库位于 /var/lib/dpkg,记录已安装包的文件清单与状态

    • 不处理依赖,仅执行单包安装

  2. apt(上层)
    • 负责源管理、索引下载、依赖解析、版本选择

    • 解析完成后调用 dpkg 完成实际安装

  3. 调用关系
    • apt 命令 → 依赖解析与版本选择 → 调用 dpkg → 实际安装卸载

2.2 .deb 包格式

.deb 是 ar 归档文件,包含三个核心部分:

  1. control(控制信息)
    • 包名、版本、依赖声明、冲突声明、维护者、描述等元数据
  2. data(数据)
    • 软件实际文件,按目录结构组织
  3. scripts(脚本)
    • preinst:安装前执行

    • postinst:安装后执行

    • prerm:卸载前执行

    • postrm:卸载后执行

2.3 软件包索引机制

  1. 索引内容
    • 源服务器提供 Packages.gz / Sources.gz 索引文件

    • 索引记录所有可用包的版本、依赖、大小、描述

  2. 索引下载
    • apt update 从配置源下载最新索引

    • 存储于 /var/lib/apt/lists/

  3. 索引作用
    • 依赖解析基于本地索引构建依赖图,无需实时访问网络

    • 索引过时会导致依赖解析失败或版本不准

2.4 依赖解析与版本约束

  1. 依赖解析
    • 基于索引构建依赖图,自动选择满足约束的版本组合
    • 遇到冲突时优先满足核心约束,必要时提示用户
  2. 版本约束符号
符号 含义 示例
= 精确版本 package=1.2.3
> / >= 大于 / 大于等于 package>=1.0
< / <= 小于 / 小于等于 package<=2.0
<< 严格小于 package<<2.0
  1. 版本查询
    • apt-cache policy 软件包名:查看包在所有源中的可用版本与优先级
    • apt-cache depends 软件包名:查看依赖关系

2.5 apt / apt-get / apt-cache 的关系

  1. 命令来源
    • apt-get 与 apt-cache 是早期命令
    • apt 是现代整合命令
  2. 职责划分
命令 定位 适用场景
apt-get 安装/升级/删除等写操作 shell 脚本,向后兼容
apt-cache 查询类操作 shell 脚本
apt 整合 apt-get 与 apt-cache 常用功能 交互式日常使用
  1. 关系说明
    • apt 整合 apt-get 与 apt-cache 常用功能,优化输出格式
    • apt 在不同版本间输出格式可能变化,脚本中仍优先使用 apt-get 与 apt-cache
    • 三者最终调用 dpkg 完成实际操作

2.6 与其他包管理工具的对照

发行版系 包管理工具 底层工具 包格式
Debian / Ubuntu apt dpkg .deb
RedHat / CentOS / Fedora dnf / yum rpm .rpm
Arch pacman pacman .pkg.tar
Alpine apk apk .apk

注:apt 仅适用于 Debian 系,其他发行版使用各自包管理工具。

三、实现:APT 的使用

3.1 适用环境

适用于基于 Debian 系的 Linux 发行版:

  1. Ubuntu 16.04 及以上版本(apt 命令默认启用)
  2. Debian 8 及以上版本
  3. Linux Mint、Elementary OS 等 Debian 衍生系统

不适用于 RedHat、CentOS、Fedora 等 RPM 系发行版(对应 yum 或 dnf),Arch Linux 系使用 pacman,macOS 使用 Homebrew,Windows 使用 Chocolatey。

3.2 权限说明

  1. 需管理员权限的命令
    • 安装、更新、删除软件等写操作需 root 权限
    • 执行时在命令前加 sudo,输入当前用户密码后执行(密码输入无字符显示属正常现象)
  2. 无需管理员权限的命令
    • 查询类命令(search、show、list 等)普通用户可执行
  3. 权限不足提示
    • 普通用户执行写操作时提示 "Permission denied"

3.3 基础配置

3.3.1 软件源配置

软件源由配置文件 /etc/apt/sources.list 及 /etc/apt/sources.list.d/ 目录下的 .list 文件定义,指定 APT 从哪些服务器获取软件包及索引信息。

查看软件源

cat /etc/apt/sources.list

修改软件源

修改前备份原始配置文件:

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

编辑配置文件(vim、nano 等):

sudo vim /etc/apt/sources.list

常用软件源(以 Ubuntu 为例):

  1. 官方源:默认配置,稳定性高,国内访问速度较慢
  2. 国内镜像源:阿里云、清华源、中科大源等,访问速度快,适合国内用户

修改完成后执行更新命令使配置生效(详见 3.4.2 节)。

sources.list 格式说明

每行格式:类型 地址 发行版代号 组件

  1. 类型:deb(二进制包)/ deb-src(源码包)
  2. 地址:源服务器 URL
  3. 发行版代号:如 focal、jammy(对应 Ubuntu 版本)
  4. 组件
组件 说明
main 官方支持的开源软件
universe 社区维护的开源软件
restricted 官方支持的闭源软件
multiverse 非自由软件

示例:

deb http://mirrors.aliyun.com/ubuntu/ focal main restricted universe multiverse

GPG 签名验证

  1. 作用
    • 源通过 GPG 签名保证软件包完整性与来源可信
    • 添加第三方源时需导入对应 GPG key,否则 apt update 报告 NO_PUBKEY
  2. 导入 key
# 旧方式(apt-key,已逐步弃用)
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys KEY_ID

# 新方式(导入到 keyring 目录)
sudo gpg --dearmor -o /etc/apt/keyrings/xxx.gpg keyfile.asc
  1. 配置源引用 keyring
deb [signed-by=/etc/apt/keyrings/xxx.gpg] https://xxx/ubuntu focal main

3.3.2 缓存说明

  1. 软件包缓存
    • 下载的 .deb 包缓存于 /var/cache/apt/archives/
    • 加快后续安装与更新速度
  2. 索引缓存
    • 索引信息缓存于 /var/lib/apt/lists/
  3. 空间占用
    • 长期使用会占用磁盘空间,可通过清理命令释放(详见 3.4.6 节)

3.4 核心命令

3.4.1 软件包查询

查询类命令无需管理员权限。

  1. 搜索软件包
apt search vim
  1. 查看软件包详细信息
apt show vim
  1. 列出已安装的软件包
apt list --installed
apt list --installed | grep vim
  1. 列出可升级的软件包
apt list --upgradable
  1. 查看依赖关系
apt-cache depends vim          # 该包依赖哪些包
apt-cache rdepends vim         # 哪些包依赖该包

3.4.2 系统与软件更新

更新分为"更新索引"与"升级软件包"两步。

  1. 更新软件包索引
sudo apt update

修改软件源后必须执行;安装、升级前执行以确保获取最新信息。仅更新索引,不安装任何软件。

  1. 升级已安装的软件包

保守升级(不删除包、不安装新依赖):

sudo apt upgrade

彻底升级(处理依赖变化,必要时安装新依赖或删除过时包):

sudo apt full-upgrade

升级过程中输入 y 回车继续,输入 n 取消。

3.4.3 软件包安装

  1. 安装单个软件包
sudo apt install vim
  1. 安装多个软件包
sudo apt install git curl wget
  1. 重新安装软件包(文件损坏时)
sudo apt reinstall vim
  1. 安装本地 .deb 包
sudo apt install ./test.deb
  1. 安装指定版本
sudo apt install vim=2:8.1.0875-5ubuntu2

可用 apt-cache policy vim 查询可用版本。

  1. 安装编译环境
sudo apt build-dep 软件包名

3.4.4 软件包删除

  1. 删除软件包(保留配置文件)
sudo apt remove vim
  1. 彻底删除软件包(含配置文件)
sudo apt purge vim
  1. 删除多个软件包
sudo apt purge git curl

3.4.5 清理无用依赖

sudo apt autoremove

自动检测并删除不再被任何软件依赖的无用依赖包。删除软件包后执行以清理残留依赖。

3.4.6 清理缓存

  1. 清空所有缓存
sudo apt clean

删除 /var/cache/apt/archives/ 下所有 .deb 缓存。

  1. 清理过时缓存
sudo apt autoclean

仅删除过时的 .deb 缓存,保留最新版本,兼顾空间与速度。

3.5 dpkg 基础命令(底层参考)

dpkg 是 apt 的底层工具,apt 完成依赖解析后调用 dpkg 执行实际安装。dpkg 不处理依赖,适用于直接操作 .deb 包或查询本地数据库。

命令 功能
dpkg -i 包.deb 安装本地 .deb 包
dpkg -r 软件包名 删除软件包(保留配置)
dpkg -P 软件包名 彻底删除(含配置)
dpkg -l 列出已安装的软件包
dpkg -l 软件包名 查看指定包的安装状态
dpkg -L 软件包名 列出该包安装的所有文件路径
dpkg -S 文件路径 查询某文件属于哪个已安装包
dpkg --configure -a 修复中断的配置过程

示例:

# 查询 /usr/bin/vim 属于哪个包
dpkg -S /usr/bin/vim

# 列出 vim 包安装的所有文件
dpkg -L vim

3.6 进阶操作

3.6.1 锁定软件包版本

sudo apt-mark hold vim       # 锁定,禁止自动升级
sudo apt-mark unhold vim     # 解锁
apt-mark showhold            # 查看已锁定的包

3.6.2 模拟命令执行

sudo apt install --simulate vim

通过 --simulate 查看将安装、升级、删除的软件包,不实际执行。

3.6.3 修复损坏的依赖关系

安装、升级过程中意外中断(如网络中断、电源故障)导致依赖损坏时修复:

sudo apt install -f

-f 是 --fix-broken 的缩写,自动修复缺失依赖。

3.6.4 下载软件包源代码

apt-get source vim

下载源码到当前目录,适用于查看、修改软件源码。需先在 sources.list 启用 deb-src 源。

3.6.5 添加自定义软件源

sudo add-apt-repository ppa:xxx/xxx
sudo apt update

添加第三方源后需执行 apt update 更新索引,并导入对应 GPG key(见 3.3.1)。

3.6.6 查询软件包可用版本

apt-cache policy vim

显示包在所有配置源中的可用版本与优先级,用于选择特定版本安装。

3.7 常见问题与解决方法

3.7.1 无法获取锁异常(Could not get lock)

原因:已有其他 apt 进程运行,占用 dpkg 锁。

解决:

sudo killall apt apt-get

若仍无法解决,强制删除锁文件(谨慎操作):

sudo rm /var/lib/dpkg/lock-frontend
sudo rm /var/lib/dpkg/lock

3.7.2 软件源报错(404 Not Found)

原因:源地址无效或与系统版本不匹配。

解决:修改软件源为有效地址(如国内镜像源),保存后执行 sudo apt update。

3.7.3 依赖关系无法满足

原因:依赖包未安装、版本不匹配或源中缺少依赖。

解决:

  1. 执行 sudo apt update 更新索引
  2. 执行 sudo apt install -f 修复依赖
  3. 更换软件源或手动安装缺失依赖

3.7.4 sudo 无法使用

原因:当前用户不在 sudoers 文件中,无管理员权限。

解决:切换 root 用户,将当前用户加入 sudo 组:

su -                                    # 切换到 root
usermod -aG sudo 用户名                  # 添加到 sudo 组
logout                                  # 退出后重新登录

3.7.5 NO_PUBKEY 签名错误

原因:第三方源未导入 GPG key。

解决:按 3.3.1 GPG 签名验证导入对应 key。

3.8 注意事项

  1. 删除类命令(purge、rm)需确认目标,避免误删系统关键包
  2. 修改软件源、删除锁文件前先备份
  3. 升级时保持网络稳定,避免中断导致依赖损坏
  4. 第三方软件源需确认来源可信,避免安全风险
  5. apt 仅适用于 Debian 系,其他发行版使用对应工具
  6. 定期执行 sudo apt update && sudo apt upgrade 保持系统安全

3.9 常用命令速查表

命令 功能说明 是否需要 sudo
apt search 关键词 搜索软件包 否
apt show 软件包名 查看软件包详细信息 否
apt list --installed 列出已安装软件包 否
apt list --upgradable 列出可升级软件包 否
apt-cache depends 软件包名 查看依赖关系 否
apt-cache policy 软件包名 查询可用版本 否
sudo apt update 更新软件包索引 是
sudo apt upgrade 保守升级所有软件包 是
sudo apt full-upgrade 彻底升级所有软件包 是
sudo apt install 软件包名 安装软件包 是
sudo apt install 软件包名=版本 安装指定版本 是
sudo apt reinstall 软件包名 重新安装软件包 是
sudo apt remove 软件包名 删除软件包(保留配置) 是
sudo apt purge 软件包名 彻底删除软件包(含配置) 是
sudo apt autoremove 清理无用依赖包 是
sudo apt clean 清空软件包缓存 是
sudo apt autoclean 清理过时软件包缓存 是
sudo apt-mark hold 软件包名 锁定软件包版本 是
sudo apt install -f 修复依赖关系 是

3.10 离线安装与企业私有源

内网主机无法直接访问公网源时,需要先在与目标机同版本的环境上生成下载清单,再把包与索引投递到内网;规模较大时应维护本地仓库,而不是逐个传包。

3.10.1 生成下载清单

# 方式一:只下载命令行列出的 .deb,不解析依赖
apt-get download vim curl wget
# 产物位于当前目录,文件名形如 vim_8.1.0875-5ubuntu2_amd64.deb

# 方式二:打印将访问的 URL 与文件名,不实际下载
apt-get --print-uris install vim

# 方式三:解析依赖并把全部 .deb 下载到缓存目录
sudo apt-get install --download-only vim
ls /var/cache/apt/archives/*.deb
  1. apt-get download 只处理命令行列出的包,不解析依赖,适合已知完整包名的场景
  2. --print-uris 输出实际请求地址与校验值,可在联网机器上直接生成下载清单,交给其他工具批量拉取
  3. --download-only 由 apt 完成依赖解析,把相关 .deb 全部放入 /var/cache/apt/archives/,是获取依赖闭包最直接的方式

3.10.2 依赖闭包的处理

# 把依赖一并下载到指定目录,目录需可写且路径以 / 结尾
sudo apt-get install --download-only --reinstall \
  -o Dir::Cache::archives=/tmp/debs/ vim
ls /tmp/debs/

# 查询依赖树,核对闭包是否完整
apt-cache depends --recurse --no-recommends --no-suggests \
  --no-conflicts --no-breaks --no-replaces --no-enhances vim | grep '^\w' | sort -u
  1. 依赖解析以本机索引为基础,联网机器与目标机应保持相同的发行版代号与组件(见 3.3.1),否则下载的版本可能不满足目标机的约束
  2. --download-only 会连同被升级的既有包一起下载,清单中可能出现与本次安装无直接关系的包,投递前用 --simulate(见 3.6.2)核对动作列表
  3. 已安装的包不会被重复下载,两台机器的已装状态差异会导致闭包不完整,跨机器投递应使用干净的同版本环境生成清单

3.10.3 目标机安装与依赖修复

# 逐个安装:需自行保证顺序,依赖未就绪时配置阶段会失败
sudo dpkg -i libssl3_3.0.13-0ubuntu3_amd64.deb
sudo dpkg -i vim_8.1.0875-5ubuntu2_amd64.deb

# 一次传入全部包,dpkg 先解包再统一配置,可减少顺序问题
sudo dpkg -i /tmp/debs/*.deb

# 由 apt 处理本地文件及其依赖
sudo apt install ./vim_8.1.0875-5ubuntu2_amd64.deb
  1. dpkg 不解析依赖,dpkg -i 只完成解包与配置;依赖缺失时该包停留在未配置状态,后续安装的包也不会触发对前者的配置
  2. 顺序问题的典型报错为 dpkg: dependency problems prevent configuration of ...,此时用 apt 修复:
sudo apt -f install         # 补齐缺失依赖并继续配置
sudo dpkg --configure -a    # 仅重试未完成的配置步骤
  1. apt -f install 需要能访问到缺失依赖所在的源,完全离线时无法补齐,只能按 3.10.1 与 3.10.2 重新生成完整闭包后再次投递
  2. 投递前后用 sha256sum 核对包文件,避免传输损坏导致的安装失败

3.10.4 本地仓库搭建

# 生成索引(适用于包量较小的内网仓库)
sudo apt install dpkg-dev
mkdir -p /srv/deb-repo
cp /tmp/debs/*.deb /srv/deb-repo/
cd /srv/deb-repo
dpkg-scanpackages . /dev/null | gzip -9c > Packages.gz
# /etc/apt/sources.list.d/local.list
deb [trusted=yes] file:/srv/deb-repo ./
sudo apt update
  1. dpkg-scanpackages 扫描目录并生成 Packages.gz,索引路径需与源配置中的地址一致,第二个参数 /dev/null 表示不使用 override 文件
  2. 本机目录使用 file: 前缀;需要多机共享时可把该目录交给 Nginx 提供服务,源地址相应写为 http://内网地址/deb-repo
  3. [trusted=yes] 跳过签名校验,仅适用于内网自建仓库;对外提供或需要审计时应使用 GPG 签名(见 3.3.1),并通过 signed-by 指定 keyring
  4. 包量较大、需要镜像上游、保留历史版本或按多个发行版发布时,改用 aptly 或 reprepro:aptly 侧重仓库快照与镜像,reprepro 以配置文件管理发行版与组件;仅做一次性投递时,直接传递 .deb 文件(见 3.10.1)更省事
  5. 仓库内容变化后需重新生成索引,客户端再执行 apt update

3.10.5 deb822 格式的 .sources 文件

Ubuntu 24.04 起,默认源改为 /etc/apt/sources.list.d/ubuntu.sources,使用 deb822 的键值结构:

# /etc/apt/sources.list.d/ubuntu.sources
Types: deb
URIs: http://mirrors.aliyun.com/ubuntu/
Suites: noble noble-updates noble-backports
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg

对应的旧写法(sources.list 中的单行格式):

deb http://mirrors.aliyun.com/ubuntu/ noble main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ noble-updates main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ noble-backports main restricted universe multiverse
  1. 字段对应关系:Types 对应 deb 与 deb-src,URIs 对应地址,Suites 对应发行版代号,Components 对应组件,Signed-By 对应旧写法的 signed-by 选项
  2. 一份 .sources 文件通过空格分隔即可列出多个 Suites 与 Components,等价于旧格式的多行组合
  3. 两种格式可同时存在,apt 会一并读取 /etc/apt/sources.list 与 /etc/apt/sources.list.d/ 下的 .list 与 .sources 文件;重复配置同一源会造成 apt update 时的重复下载
  4. 两种格式修改后都需要执行 sudo apt update 使索引生效

3.10.6 代理与超时重试

# /etc/apt/apt.conf.d/95proxy
Acquire::http::Proxy "http://10.0.0.2:3128";
Acquire::https::Proxy "http://10.0.0.2:3128";
# 指定主机直连,不走代理
Acquire::http::Proxy::internal.example.com "DIRECT";
# 超时与重试
Acquire::http::Timeout "15";
Acquire::https::Timeout "15";
Acquire::Retries "3";
  1. 配置文件放在 /etc/apt/apt.conf.d/ 下,文件名前缀数字决定加载顺序;语法为 键 "值";,每条以分号结尾
  2. 代理也可由 http_proxy、https_proxy 环境变量提供,apt.conf.d 中的配置优先级更高,且对 sudo 执行的命令同样有效
  3. Acquire::Retries 控制单个文件下载失败后的重试次数,受限网络下适当提高可减少中断;Acquire::http::Timeout 控制单次连接的等待秒数,取值过大时不可用的源会长时间阻塞 apt update
  4. 代理需要认证时写作 http://用户名:密码@代理地址:端口,凭据以明文保存在配置文件中,该文件权限应设为 600

3.10.7 源不可用时的排查顺序

  1. 网络与解析:用 ping 与 getent hosts 确认源服务器可达且名称解析正常,所在网络需要代理时先完成 3.10.6 的配置
  2. 代理生效范围:在相同代理设置下执行 curl -I 源索引地址,确认 apt.conf.d 中的代理与终端环境一致
  3. 源地址与发行版代号:核对 URIs 与 Suites 是否与系统版本匹配(如 noble 对应 24.04),地址无效或代号错误表现为 404(见 3.7.2)
  4. 签名:出现 NO_PUBKEY 时按 3.3.1 导入对应 key,并确认 Signed-By 指向的 keyring 文件存在
  5. 索引缓存:源已修正仍报错时执行 sudo apt update 重新拉取,持续失败可清理 /var/lib/apt/lists/ 下的对应文件后重试
  6. 磁盘与锁:用 df -h /var 确认空间充足,出现 Could not get lock 时按 3.7.1 处理
  7. 请求地址比对:执行 apt-get --print-uris install 软件包名,把输出的实际请求地址与手工可访问的地址逐一比对,定位差异出现在解析、代理还是源配置

四、总结

  • APT 是 Debian 系的包管理工具,由 dpkg(底层)与 apt(上层)形成分层架构

  • 起源在于解决源码编译繁琐、依赖地狱、安装一致性问题

  • 原理基于索引机制与依赖解析,apt 整合 apt-get 与 apt-cache 常用功能

  • 实现覆盖源配置、核心命令、dpkg 底层操作、进阶用法与常见问题排查