Go 应用 Debian 打包指南：从静态链接到 dh-golang 的演进

理解 Go 应用程序的特性与 Debian 打包挑战

Go 语言以其静态链接特性而闻名，这意味着一个 Go 应用程序通常编译成一个独立的二进制文件，包含了所有必要的运行时和依赖项。这种特性简化了部署，但也给传统的 Debian 打包流程带来了一些挑战。Debian 的打包系统通常期望应用程序是动态链接的，并且其构建过程（例如通过 debian/rules 文件）会尝试从源代码构建应用程序。此外，lintian 等工具会对包的结构和内容进行严格检查，对于静态链接的 Go 二进制文件，可能会报告一些不适用的警告或错误。

早期方法：绕过 debuild 与处理 lintian 警告

在 dh-golang 出现之前，打包 Go 应用程序的一种常见方法是避免让 Debian 的构建系统尝试重新编译 Go 代码，而是将其视为一个预编译的“二进制块”进行封装。

1. 直接使用 dpkg-buildpackage

debuild 工具实际上是对 dpkg-buildpackage 的封装，并增加了 lintian 检查等功能。如果 lintian 的严格检查成为障碍，可以直接调用 dpkg-buildpackage 来构建二进制包，从而绕过 lintian 的自动运行。

构建二进制包的典型命令是：

立即学习“go语言免费学习笔记（深入）”；

dpkg-buildpackage -us -uc -b

• -us：不签名源代码包。
• -uc：不签名 changes 文件。
• -b：只构建二进制包。

这种方法的核心思想是，你的 debian/rules 文件不应该包含 Go 应用程序的编译逻辑，而是直接将预编译好的 Go 二进制文件复制到正确的目标路径。

2. lintian 覆盖 (Overrides)

如果出于某些原因仍希望使用 debuild，但又想忽略 lintian 报告的特定问题，可以配置 lintian 覆盖。这允许你明确告知 lintian，某些警告或错误在你的特定包中是预期行为，不应被视为问题。

lintian 覆盖通常通过在 debian/ 目录下创建 lintian-overrides/ 文件来实现。例如，如果你的包名为 my-go-app，你可以在 debian/lintian-overrides/my-go-app 中添加类似以下内容：

my-go-app: binary-without-manpage
my-go-app: hardening-no-relro

这会告诉 lintian 忽略 my-go-app 包中缺少手册页和未启用 RELRO (Relocation Read-Only) 保护的警告。这对于静态链接的 Go 二进制文件可能出现的某些警告尤其有用。

墨狐AI

5分钟生成万字小说，人人都是小说家！

下载

注意事项：

• 这两种方法都要求你在打包前手动编译 Go 应用程序。
• debian/rules 文件需要相应地调整，以跳过构建步骤，直接进行安装。

gcc-go：动态链接的另一种选择（较少使用）

理论上，使用 gcc-go 编译器（GCC 的 Go 前端）可以生成动态链接的 Go 应用程序。这种方式会生成依赖于 libgo 等共享库的二进制文件，从而更符合 Debian 的传统打包哲学。然而，对于大多数使用 Google 官方 gc 编译器的 Go 项目而言，gcc-go 并不是主流选择，并且可能引入额外的复杂性。通常，只有在目标是将 Go 应用程序推送到 Debian 官方仓库时，才会认真考虑这种方法。

现代与推荐方法：拥抱 dh-golang

自 2015 年以来，Go 应用程序的 Debian 打包生态系统得到了显著改善，现在有了更优雅、更“Debian-ish”的方式来处理 gc 编译器构建的 Go 程序——那就是使用 dh-golang。

dh-golang 是一个 Debian helper 工具，它集成了 Go 语言的构建和打包逻辑，极大地简化了 debian/rules 文件的编写。它能够理解 Go 模块和构建过程，并自动处理 Go 应用程序和库的安装、依赖关系以及常见的打包任务。

dh-golang 的优势：

• 自动化构建： dh-golang 可以自动调用 go build 或 go install 来构建你的 Go 应用程序或库。
• 简化 debian/rules： 它将复杂的打包逻辑抽象化，使得 debian/rules 文件变得非常简洁。
• 处理依赖： 能够更好地处理 Go 模块的依赖关系，尽管 Debian 的包管理器仍然需要明确的 Build-Depends。
• 与 Debian 标准融合： 提供了一种更符合 Debian 规范的方式来打包 Go 应用，即使它们是静态链接的。

使用 dh-golang 的基本步骤：

1. 安装 dh-golang：

   sudo apt-get install dh-golang

2. 创建 debian/control 文件： 除了标准的 Source、Maintainer、Build-Depends 和 Description 字段外，你可能需要添加 Vcs-Git 和 Homepage 等信息。 在 Build-Depends 中，需要包含 dh-golang 和 golang-go (或 golang-any)：

   Source: my-go-app
   Section: devel
   Priority: optional
   Maintainer: Your Name 
   Build-Depends: debhelper (>= 10),
                  dh-golang,
                  golang-go
   Standards-Version: 4.5.0
   Homepage: https://github.com/youruser/my-go-app
   Vcs-Git: https://github.com/youruser/my-go-app.git
   Vcs-Browser: https://github.com/youruser/my-go-app
   
   Package: my-go-app
   Architecture: any
   Depends: ${shlibs:Depends}, ${misc:Depends}
   Description: My Awesome Go Application
    This package contains the my-go-app executable.

3. 创建 debian/rules 文件： 使用 dh-golang，debian/rules 文件可以变得非常简单：

   #!/usr/bin/make -f
   
   # Uncomment this to turn on verbose output from dpkg-buildpackage
   # export DH_VERBOSE = 1
   
   # This is the most common rules file for dh-golang.
   # See /usr/share/doc/dh-golang/examples/ for more examples.
   %::
       dh $@ --with golang

   dh $@ --with golang 这一行是关键，它指示 debhelper 调用 dh-golang 来处理 Go 相关的构建和安装逻辑。

4. 创建 debian/compat 文件： 指定 debhelper 兼容级别，通常是最新版本，例如 10 或 12。

   10

5. 其他文件： 根据需要添加 debian/changelog、debian/copyright 等标准 Debian 打包文件。

6. 构建包： 现在可以使用 debuild 来构建包了，dh-golang 会处理 Go 应用程序的编译和安装。

   debuild -us -uc

总结与最佳实践

将 Go 应用程序打包为 Debian 格式已经从最初的“规避”策略发展到利用 dh-golang 这种集成工具的更标准化流程。

• 对于简单的 Go 二进制文件，如果不想深入了解 Debian 打包细节，早期的 dpkg-buildpackage -us -uc -b 配合手动编译和简单的 debian/rules 仍然可行，但维护性较差。
• 强烈推荐使用 dh-golang。它提供了一种现代、高效且符合 Debian 哲学的方式来打包 Go 应用程序和库。通过 dh-golang，你可以轻松地将 gc 编译器构建的 Go 程序集成到 Debian 打包流程中，享受自动化的构建和安装便利。
• 始终确保你的 debian/control 文件中的 Build-Depends 包含 dh-golang 和 golang-go (或 golang-any)。
• 熟悉 dh-golang 的文档和示例，可以帮助你处理更复杂的 Go 项目结构或特定的打包需求。

通过采纳 dh-golang，Go 开发者可以更顺畅地将其应用程序分发给 Debian 及其衍生发行版的用户，同时遵循社区的最佳实践。