Debian 下简化 Go 应用打包的实用方案

一、推荐路径 dh-golang 最小化配置

• 安装工具链：sudo apt-get install dh-golang golang-go（或 golang-any）、debhelper。
• 在项目根目录准备打包骨架：dh_make -f …/yourproject.tar.gz（或 dh_make），选择单二进制包类型，生成 debian/ 目录。
• 关键文件最简示例：
  • debian/control（片段）
    • Build-Depends: debhelper (>= 10), dh-golang, golang-go
    • Package: my-go-app
    • Architecture: amd64（或依据需要设为 any/arm64）
  • debian/rules（最简）
    • #!/usr/bin/make -f
    • %:
      • dh $@ --with golang
    • override_dh_auto_install:
      • dh_golang_install
  • 构建与检查：debuild -us -uc 或 dpkg-buildpackage -us -uc -b；如需跳过 lintian 可仅用 dpkg-buildpackage，或用 debian/lintian-overrides/ 做局部忽略。
• 说明：dh-golang 会自动处理 Go 模块依赖、构建与安装，使 debian/rules 极简且符合 Debian 规范。

二、极简替代方案 预编译二进制直封 .deb

• 适用场景：CI 已在别处交叉编译好二进制，只需在 Debian 打包环境做“安装与打包”。
• 步骤：
  • 准备二进制（推荐静态）：CGO_ENABLED=0 go build -ldflags “-s -w” -o myapp；将产物与可能的 config/static/ 等资源放入 debian/ 临时目录（如 debian/usr/bin/、debian/etc/myapp/）。
  • 最简 debian/control（片段）
    • Package: my-go-app
    • Architecture: amd64
    • Depends: ${misc:Depends}（如有外部工具再补充）
  • 最简 debian/rules（片段）
    • #!/usr/bin/make -f
    • %:
      • dh $@
    • override_dh_auto_build override_dh_auto_test:

      • 跳过构建与测试

    • override_dh_auto_install:
      • dh_install -pmy-go-app usr/bin/myapp usr/bin/
      • dh_install -pmy-go-app etc/myapp/ etc/myapp/
  • 构建：debuild -us -uc 或 dpkg-buildpackage -us -uc -b；遇到静态链接相关 lintian 警告可用 lintian-overrides 或仅用 dpkg-buildpackage 跳过检查。

三、常见坑与优化要点

• 架构与构建：纯 Go 项目通常设为 Architecture: amd64/arm64；若包含 cgo 依赖需启用 CGO 并准备相应库，复杂度显著上升，非必要建议保持 CGO_ENABLED=0 的静态构建。
• 二进制瘦身与稳定性：使用 -ldflags “-s -w” 去除符号与调试信息，减小体积并提升加载速度。
• 依赖与代理：国内环境建议 go env -w GOPROXY=https://goproxy.cn,direct，加速模块拉取；dh-golang 会解析模块依赖，必要时在控制文件声明版本或提供打包规则。
• 系统服务与配置：将 systemd 单元、默认配置放入 debian/ 相应路径（如 lib/systemd/system/、etc/），并在 rules 中用 dh_install 安装；这样交付即包含开机自启与配置能力。