Debian系统如何简化Golang打包操作

Debian 系统简化 Golang 打包的实用方案

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

• 安装工具链：sudo apt-get install dh-golang golang-go debhelper
• 在项目根目录生成打包骨架：dh_make -f …/your-project_1.0.0.orig.tar.gz（或 dh_make -p your-go-app_1.0.0），选择单二进制包类型，按需保留示例文件
• 关键文件最简内容
  • debian/control
    • Build-Depends: debhelper (>= 10), dh-golang, golang-go
    • Standards-Version: 4.5.0
  • debian/rules（可执行，#!/usr/bin/make -f）
    • %: dh $@ --with golang
    • override_dh_auto_install: dh_golang_install
  • debian/install（示例）
    • your-go-app /usr/bin/
    • config.yaml /etc/your-go-app/
    • static/ /usr/share/your-go-app/static/
• 构建与检查
  • debuild -us -uc 或 dpkg-buildpackage -us -uc -b
  • lintian 校验（必要时用 debian/lintian-overrides 做精细化覆盖）
• 说明：dh-golang 会自动处理 Go 模块依赖、构建与安装，使 debian/rules 保持极简，符合 Debian 打包规范。

二、极速二进制封装 跳过编译

• 适用场景：上游已提供可复现的构建产物，或你已在外部完成构建，仅需封装为 .deb
• 步骤
  • 准备已编译的二进制（如 bin/your-go-app），放入项目目录
  • 生成 debian/ 骨架后，编辑 debian/rules 仅做安装（不触发编译）
  • 使用 debian/install 指定安装路径（见上节示例）
  • 构建：dpkg-buildpackage -us -uc -b（或 debuild -us -uc）
• 提示：若使用 debuild 遇到 lintian 严格检查，可直接用 dpkg-buildpackage 构建二进制包，或在 debian/lintian-overrides/ 中对特定告警做覆盖（如 binary-without-manpage）。

三、常见简化与提速技巧

• 使用国内 Go 代理加速依赖拉取：go env -w GOPROXY=https://goproxy.cn,direct
• 纯 Go 项目建议禁用 CGO 并静态编译，减小体积并避免外部运行时依赖：CGO_ENABLED=0 go build -ldflags ‘-s -w’ -o your-go-app
• 并行构建：export GOMAXPROCS=$(nproc)
• 依赖管理：go mod tidy && go mod download，确保可复现构建与缓存命中。

四、快速对照