Debian Golang 打包流程

来说说Golang项目在Debian上的打包。这事儿其实挺常规的，但细节一多，新手就容易磕绊。先理清几个关键环节，后面上手就顺了。

一、准备与工具

先把基础环境搭好。构建工具和Go是必须的，一条命令搞定：sudo apt update && sudo apt install -y build-essential devscripts dh-golang golang-go（或者用golang-any也行）。项目这边，确保你已经用上了Go Modules（也就是有go.mod文件），可执行文件的名字最好和上游保持一致，版本号要符合Debian的规矩，比如1.2.3-1这种格式。

打包方式有两种主流选择。最推荐的是用dh-golang，直接从源码构建，这样最符合Debian的规范，一劳永逸。如果遇到特殊情况，比如上游没给源码构建方案，或者只是内部交付用，那就走备选路线：先把二进制预编译好，再封装成.deb包。

二、推荐方式：使用 dh-golang 从源码构建

这是最正统的路径。先在你项目的根目录下生成打包骨架：执行dh_make -p your-go-app_1.0.0-1 --createorig。当然，如果团队有现成的debian/目录模板，直接复制过来也行。

骨架搭好之后，有几个关键文件需要你仔细填。

debian/control 文件，这里定义了包的元信息。举个例子：

Source: your-go-app
Section: utils
Priority: optional
Maintainer: Your Name 
Build-Depends: debhelper-compat (= 13), dh-golang, golang-go
Standards-Version: 4.5.0
Homepage: https://github.com/youruser/your-go-app
Package: your-go-app
Architecture: amd64
Depends: ${misc:Depends}
Description: Short desc.
 Long desc.

注意Architecture字段，纯Go程序通常可以写amd64或者arm64，具体看你目标平台。别漏了Build-Depends里的dh-golang和golang-go，少了它们可跑不起来。

debian/rules 文件是构建的核心脚本，最简化的版本长这样：

#!/usr/bin/make -f
%:
        dh $@ --with golang

override_dh_auto_install:
        dh_golang_install
        # 如果有静态资源，用下面这行安装：
        # dh_install -p your-go-app path/in/src /usr/share/your-go-app/

这里的关键是--with golang，它告诉构建系统我们是用Go来编译的。如果程序还依赖一些配置文件、静态资源或者systemd单元，可以通过debian/install文件或override_dh_auto_install来显式安装到标准路径下，比如/etc/your-go-app/、/usr/share/your-go-app/或/lib/systemd/system/。

除此之外，debian/copyright、debian/changelog这些文件也是必不可少的，它们记录了版权信息和版本历史。

文件都填好之后，就开始构建。执行debuild -us -uc（或者dpkg-buildpackage -us -uc -b），等跑完，你会得到一个.deb包。然后安装测试一下：sudo dpkg -i .../your-go-app_1.0.0-1_amd64.deb，跑起来看看二进制是不是正常，权限对不对。最后再用lintian跑一遍检查：lintian .../your-go-app_1.0.0-1_amd64.changes，如果有误报，可以在debian/lintian-overrides/下加规则来处理。

三、备选方式：预编译二进制封装为 deb

这个方案省下了在Debian环境里编译的步骤，但前提是你已经在构建机或CI里完成了交叉编译。编译时注意加上这些参数：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o your-go-app ./cmd/your-go-app。静态链接是关键，CGO_ENABLED=0可以避免后续运行时依赖C库的问题。其他架构比如arm64同理。

然后准备一个精简的debian/目录，至少得有debian/control文件。在debian/rules里，需要跳过构建和测试步骤，只做安装：

override_dh_auto_build:
override_dh_auto_test:
        # 空

override_dh_auto_install:
        dh_install -p your-go-app your-go-app /usr/bin/

注意这里dh_install直接指定了二进制文件和安装目标路径，不需要再走编译流程。然后执行debuild -us -uc，拿到.deb包后用sudo dpkg -i安装测试。

四、常见要点与排错

最后说几个容易踩坑的点。

架构与构建参数：纯Go程序通常只依赖amd64和arm64，跨编译时务必注意CGO_ENABLED=0，否则二进制会绑定外部C库，跑到别的机器上可能直接罢工。

版本与变更：debian/changelog用dch -i来递增版本，遵循“上游版本-修订号”的规则。别手动乱改格式，Debian的版本解析很严格。

依赖处理：dh-golang会自动解析Go模块依赖，但Build-Depends里必须显式声明dh-golang和golang-go，否则打包工具链会报错。

Lintian 警告：Go静态二进制常见几个“误报”，比如binary-without-manpage、hardening-no-relro。可以通过debian/lintian-overrides/合理抑制，并在README里解释一下理由。

资源与系统整合：除了二进制，你很可能还需要配置文件、静态网页、systemd服务单元。这些都用debian/install或override_dh_auto_install安排到标准路径下。别偷懒，把它们塞进/etc/、/usr/share/、/lib/systemd/system/，这样你的包才像个正经的Debian包。

好了，流程差不多就是这样。按照这个路子走，从Git仓库到.deb包，应该不会出大岔子。