Linux DEB 文件详解：从基础到高级应用

目录#

什么是 DEB 文件？
DEB 文件的内部结构
- 2.1 AR 归档格式
- 2.2 数据归档（data.tar.*）
- 2.3 控制归档（control.tar.*）
DEB 文件的常用操作命令
- 3.1 安装与卸载
- 3.2 查询与验证
- 3.3 依赖处理
如何创建自己的 DEB 包？
- 4.1 基础目录结构
- 4.2 控制文件（control）详解
- 4.3 维护脚本（postinst、prerm 等）
- 4.4 打包命令（dpkg-deb）
DEB 打包最佳实践
- 5.1 目录结构规范
- 5.2 控制文件与依赖管理
- 5.3 维护脚本编写原则
- 5.4 安全性与可维护性
常见问题与故障排查
- 6.1 依赖错误（Dependency Errors）
- 6.2 损坏的包（Broken Packages）
- 6.3 权限问题
高级应用：从 repack 到签名
- 7.1 修改与重新打包 DEB 文件
- 7.2 使用 GPG 签名 DEB 包
- 7.3 debhelper 与复杂项目打包
参考资料

1. 什么是 DEB 文件？#

DEB 文件是基于 Debian 系统的软件包格式，文件名通常以 .deb 结尾（如 google-chrome-stable_current_amd64.deb）。它本质上是一个归档文件，包含了软件的二进制文件、配置文件、依赖信息及安装/卸载脚本，通过标准化的流程实现软件的自动化管理。

核心作用：

简化软件分发：开发者可将软件及其依赖打包为单个文件，用户无需手动编译或配置。
确保一致性：通过预定义的目录结构和权限，保证软件在不同 Debian 系统中的行为一致。
依赖管理：自动处理软件运行所需的其他包，避免“缺少库文件”等问题。

适用系统：Debian、Ubuntu、Kubuntu、Linux Mint、Pop!_OS 等 Debian 系发行版。

2. DEB 文件的内部结构#

DEB 文件采用 AR 归档格式（一种简单的 Unix 归档格式），内部包含两个核心子归档和一个可选的元数据文件。通过 ar 命令可直接查看或提取其内容。

2.1 AR 归档格式#

使用 ar t <包名.deb> 可列出 DEB 文件的顶层结构，例如：

$ ar t google-chrome-stable_current_amd64.deb
debian-binary
control.tar.xz
data.tar.xz

debian-binary：固定内容为 2.0，标识 DEB 包格式版本。
control.tar. ：控制归档，包含包的元数据、依赖信息和维护脚本（如postinst、prerm），通常使用xz或gz压缩。 - data.tar. **：数据归档，包含软件的实际文件（二进制、配置、文档等），按系统目录结构（如/usr/bin/、/etc/）存放。

2.2 数据归档（data.tar.*）#

数据归档是软件文件的“容器”，解压后直接映射到系统目录。例如，一个简单的工具包可能包含：

data/
├── usr/
│   └── bin/
│       └── mytool  # 可执行文件
└── etc/
    └── mytool.conf  # 配置文件

注意：数据归档中的路径均为绝对路径（如 usr/bin/ 对应系统的 /usr/bin/），安装时会直接复制到目标位置。

2.3 控制归档（control.tar.*）#

控制归档是 DEB 包的“大脑”，决定了包的安装逻辑和依赖关系。核心文件包括：

2.3.1 `control` 文件（必需）#

包的元数据，格式为 键: 值，示例：

Package: mytool
Version: 1.0.0
Architecture: amd64
Maintainer: John Doe <[email protected]>
Depends: libc6 (>= 2.34), libssl1.1
Section: utils
Priority: optional
Description: A simple command-line tool
 Mytool is a demo package for DEB tutorial.
 It supports file conversion and log analysis.

关键字段：

Package：包名（唯一标识，小写字母+数字+连字符）。
Version：版本号（格式建议 主版本.次版本.修订号，如 2.3.1）。
Architecture：支持的架构（amd64、i386、arm64 或 all 表示通用）。
Depends：依赖包列表（支持版本约束，如 libc6 (>= 2.34)）。
Description：包描述（首行为简短描述，后续行为详细说明）。

2.3.2 维护脚本（可选）#

控制归档中可包含多个脚本，用于在安装/卸载过程中执行自定义逻辑，常见脚本：

脚本名	触发时机	作用示例
`preinst`	包安装前执行	停止服务、备份旧配置
`postinst`	包安装后执行	启动服务、生成配置文件
`prerm`	包卸载前执行	停止服务、清理临时文件
`postrm`	包卸载后执行	删除残留目录、恢复备份

示例 postinst 脚本（安装后启动服务）：

#!/bin/sh
set -e  # 遇到错误立即退出
if [ -x "/etc/init.d/mytool" ]; then
    /etc/init.d/mytool start || true  # 即使启动失败也不中断安装
fi

2.3.3 其他文件#

md5sums：数据归档中所有文件的 MD5 校验和，用于验证文件完整性。
conffiles：标记配置文件（卸载时不会删除，而是保留为 .dpkg-old）。

3. DEB 文件的常用操作命令#

管理 DEB 文件的核心工具是 dpkg（Debian Package Manager），辅以 apt 处理依赖，以下是高频操作：

3.1 安装与卸载#

安装 DEB 包#

# 使用 dpkg 安装（需手动处理依赖）
sudo dpkg -i <包名.deb>
 
# 使用 apt 安装（自动解决依赖，推荐）
sudo apt install ./<包名.deb>  # 注意路径前的 "./"
 
# 使用 gdebi（图形化工具，自动依赖处理）
sudo apt install gdebi-core
sudo gdebi <包名.deb>

卸载 DEB 包#

# 保留配置文件卸载
sudo dpkg -r <包名>  # 包名即 control 文件中的 Package 字段，无需 .deb 后缀
 
# 彻底删除（含配置文件）
sudo dpkg -P <包名>

3.2 查询与验证#

查看包信息#

# 查看已安装包的详细信息
dpkg -s <包名>
 
# 查看包的安装文件列表
dpkg -L <包名>
 
# 查看 DEB 文件的控制信息（未安装时）
dpkg-deb -I <包名.deb>  # 或 --info

验证文件完整性#

# 检查已安装包的文件是否被修改（基于 md5sums）
dpkg -V <包名>

3.3 依赖处理#

dpkg 仅负责安装包文件，不自动解决依赖，若依赖缺失会报错：

dpkg: 依赖关系问题使得 <包名> 的配置工作不能继续

解决方法：使用 apt 修复依赖：

sudo apt -f install  # -f 表示“修复损坏的依赖”

3. 如何创建自己的 DEB 包？#

创建 DEB 包需遵循固定的目录结构，核心是构建 data.tar.* 和 control.tar.*，最终通过 dpkg-deb 打包。以下以“打包一个简单的命令行工具 mytool”为例：

4.1 基础目录结构#

创建一个临时工作目录（如 mytool-deb），内部结构如下：

mytool-deb/
└── mytool_1.0.0_amd64/  # 包构建目录，命名格式：<包名>_<版本>_<架构>
    ├── DEBIAN/          # 控制归档的源目录（必需）
    │   ├── control      # 包元数据（必需）
    │   └── postinst     # 安装后脚本（可选）
    └── usr/             # 数据归档的源目录（按系统目录结构存放文件）
        └── bin/
            └── mytool   # 可执行文件

4.2 控制文件（control）详解#

在 DEBIAN/control 中填写元数据，示例：

Package: mytool
Version: 1.0.0
Architecture: amd64
Maintainer: Your Name <[email protected]>
Depends: libc6 (>= 2.34)  # 依赖系统 libc 库
Section: utils
Priority: optional
Description: A demo command-line tool
 This is a simple tool for DEB packaging tutorial.
 It prints "Hello, DEB!" when executed.

4.3 维护脚本（postinst）#

在 DEBIAN/postinst 中添加安装后逻辑（如设置执行权限），并赋予可执行权限：

#!/bin/sh
set -e
chmod +x /usr/bin/mytool  # 确保可执行文件有权限
echo "mytool installed successfully!"

chmod 755 DEBIAN/postinst  # 脚本必须可执行，否则安装时会报错

4.4 打包命令（dpkg-deb）#

使用 dpkg-deb --build <构建目录> 生成 DEB 文件：

cd mytool-deb
dpkg-deb --build mytool_1.0.0_amd64

执行后，当前目录会生成 mytool_1.0.0_amd64.deb，即可通过 dpkg -i 安装。

5. DEB 打包最佳实践#

5.1 目录结构规范#

遵循 FHS 标准：数据文件应放在标准目录（如可执行文件 usr/bin/、配置 etc/、文档 usr/share/doc/），避免自定义根目录（如 /mytool/）。
权限控制：数据文件权限建议 644（普通文件）或 755（可执行文件），目录权限 755，避免使用 777。

5.2 控制文件与依赖管理#

依赖最小化：仅声明必要的依赖，避免冗余（如 Depends 中不包含可选功能的依赖，可用 Recommends 或 Suggests 标记推荐依赖）。
版本约束明确：依赖版本需精确（如 libssl1.1 (>= 1.1.1)），避免因版本过低导致功能异常。

5.3 维护脚本编写原则#

幂等性：脚本可重复执行（如 postinst 中检查服务是否已启动，避免重复启动）。
错误处理：使用 set -e 确保错误终止，关键步骤添加日志（如 echo "Starting service..." >> /var/log/mytool.log）。

5.4 安全性与可维护性#

使用 lintian 检查：lintian <包名.deb> 可扫描包中的潜在问题（如权限错误、依赖缺失），示例：
```
sudo apt install lintian
lintian mytool_1.0.0_amd64.deb
```
避免高危操作：维护脚本中不执行 rm -rf / 等危险命令，不运行未验证的外部脚本。

6. 常见问题与故障排查#

6.1 依赖错误（Dependency Errors）#

症状：dpkg -i 安装时提示“依赖关系问题”，如：

dpkg: error processing package mytool (--install):
 dependency problems - leaving unconfigured

解决：

手动安装缺失依赖：sudo apt install <缺失的包>。
自动修复依赖：sudo apt -f install。

6.2 损坏的包（Broken Packages）#

症状：apt 命令提示“有损坏的软件包”，无法安装其他包。

解决：

# 重新配置未完成的包
sudo dpkg --configure -a
 
# 强制删除损坏的包（谨慎使用）
sudo dpkg -r --force-all <包名>

6.3 权限问题#

症状：安装后执行命令提示“权限被拒绝”。

原因：数据归档中文件权限错误（如可执行文件无 x 权限）。

解决：

重新打包时修正文件权限（如 chmod 755 usr/bin/mytool）。
临时修复：sudo chmod +x /usr/bin/mytool。

7. 高级应用：从 repack 到签名#

7.1 修改与重新打包 DEB 文件#

如需修改现有 DEB 包（如替换配置文件），可按以下步骤操作：

# 1. 创建临时目录并提取 DEB 内容
mkdir deb-tmp && cd deb-tmp
ar x ../original.deb
 
# 2. 提取控制归档和数据归档
xz -d control.tar.xz && tar xf control.tar
xz -d data.tar.xz && tar xf data.tar
 
# 3. 修改文件（如编辑 data/etc/mytool.conf）
 
# 4. 重新压缩归档
tar cf control.tar ./control ./postinst  # 仅包含修改的控制文件
xz -z control.tar
tar cf data.tar ./usr ./etc  # 包含所有数据文件
xz -z data.tar
 
# 5. 重新打包为 DEB
ar r ../modified.deb debian-binary control.tar.xz data.tar.xz

7.2 使用 GPG 签名 DEB 包#

为确保包的完整性和来源可信，可使用 GPG 签名 DEB 包：

生成 GPG 密钥（若未创建）：gpg --gen-key。

签名包：

dpkg-sig --sign builder modified.deb  # "builder" 为密钥标识

验证签名：
```
dpkg-sig --verify modified.deb
```

7.3 debhelper 与复杂项目打包#

对于包含源码编译、多组件的复杂项目（如 C/C++ 程序），推荐使用 debhelper 工具链（dh_make、dh_builddeb 等），自动生成控制文件和维护脚本。

示例流程：

# 1. 创建源码包目录
mkdir mytool-1.0 && cd mytool-1.0
# 2. 生成 debhelper 模板
dh_make --createorig -s  # -s 表示单文件源码包
# 3. 编辑 debian/ 目录下的控制文件和规则
# 4. 构建 DEB 包
dpkg-buildpackage -us -uc  # -us -uc 表示不签名（测试用）

8. 参考资料#

Debian 策略手册：DEB 包规范的官方文档。
dpkg-deb 手册：dpkg-deb 命令详解。
Debian 打包教程：入门级打包指南。
Lintian 检查项说明：解释 lintian 报错的含义及修复方法。

通过本文，你已掌握 DEB 文件的核心原理、操作与打包技巧。无论是日常使用还是开发分发，遵循规范与最佳实践能让 DEB 包更可靠、更易于维护。

目录#