Debian 环境下 Golang 打包步骤

一 准备环境

• 安装 Go 与打包工具：
  • sudo apt update
  • sudo apt install -y golang-go debhelper dh-golang
• 确认版本：go version
• 建议启用 Go Modules（Go 1.11+），在项目根目录执行：go mod init <module_name>；整理依赖：go mod tidy。

二 方法一 使用 dh-golang 构建符合 Debian 规范的包（推荐）

• 在项目根目录生成打包骨架（仅首次）：dh_make -f …/your-project.tar.gz，按向导选择单二进制包等；或手动创建 debian/ 目录及必要文件。
• 编辑 debian/control（示例）：
  • Source: my-go-app
  • Section: utils
  • Priority: optional
  • Maintainer: Your Name you@example.com
  • Build-Depends: debhelper-compat (= 13), 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: amd64
  • Depends: ${misc:Depends}
  • Description: Short desc Long description.
• 编辑 debian/rules（示例，使用 dh-golang 插件）：
  • #!/usr/bin/make -f
  • export GOPATH := $(CURDIR)/.gopath
  • export GOBIN := $(CURDIR)/bin
  • %:
    • dh $@ --with golang
  • override_dh_auto_install:
    • dh_golang_install

    • 如有静态资源：dh_install -X.go -X.mod -X.sum

  • override_dh_auto_clean:
    • dh_auto_clean
    • rm -rf $(GOPATH) $(GOBIN)
• 构建与检查：
  • debuild -us -uc
  • 或仅构建二进制包：dpkg-buildpackage -us -uc -b
  • 安装测试：sudo dpkg -i …/my-go-app_1.0.0-1_amd64.deb
  • 质量检查：lintian …/my-go-app_1.0.0-1_amd64.deb（如有误报可用 lintian-overrides 处理）。

三 方法二 预编译二进制直接封装为 .deb（简单交付）

• 交叉/本地编译（禁用 CGO 便于移植）：
  • CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags “-s -w” -o myapp main.go
  • 验证：file myapp（应显示“statically linked”等）
• 快速打包为 .deb（最小化 debian/ 结构）：

  • mkdir -p debian/usr/bin

  • cp myapp debian/usr/bin/

  • cat > debian/control <<EOF Source: myapp Section: utils Priority: optional Maintainer: Your Name you@example.com Build-Depends: debhelper (>= 9) Standards-Version: 3.9.5

    Package: myapp Architecture: amd64 Depends: ${misc:Depends} Description: Short desc Long description. EOF

  • dpkg-deb --build debian myapp.deb

  • 安装与测试：sudo dpkg -i myapp.deb。

四 常见要点与排错

• 架构与构建参数：
  • 多架构构建可用交叉编译：GOOS=linux GOARCH=arm64（或 amd64）；无 C 依赖时建议 CGO_ENABLED=0 生成静态二进制，减少外部依赖与环境差异带来的问题。
• 减小体积与优化：
  • 链接参数：-ldflags “-s -w” 去除调试信息；配合 CGO_ENABLED=0 可进一步减小体积并提升可移植性。
• Lintian 警告处理：
  • 简单绕过：dpkg-buildpackage -us -uc -b（不自动跑 lintian）
  • 规范做法：使用 debian/lintian-overrides/ 或 debian/changelog 中的 override 注释忽略特定告警（如 binary-without-manpage）。
• 资源与安装路径：
  • 二进制通常安装到 /usr/bin/；配置文件、静态资源按需在 debian/rules 中使用 dh_install 安装到 /etc/、/usr/share/ 等路径，并在 .install 文件中声明。