Golang在CentOS打包步骤

在实际生产环境中，把Golang项目打包部署到CentOS服务器上，几乎是每个Go开发者都会遇到的需求。整个过程并没有太多黑科技，但细节决定成败——从环境搭建到编译选项，再到最终的RPM打包和systemd自启，每一步都有值得留神的地方。下面就把这个标准化流程完整走一遍，方便你对照操作。

1. 安装Golang环境

开始之前，先把Go装上。CentOS下有两个常见选择：

• Yum快速安装——最省事，但版本可能偏旧：

  sudo yum install -y golang

• 手动下载安装——推荐用最新稳定版，更可控：

  wget https://golang.org/dl/go1.23.0.linux-amd64.tar.gz
  sudo tar -C /usr/local -xzf go1.23.0.linux-amd64.tar.gz

装完后要配置环境变量。编辑 ~/.bashrc（或 /etc/profile），加入：

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

然后 source ~/.bashrc 让配置生效。最后验证一下：

go version
# 输出类似 "go1.23.0 linux/amd64" 即成功

2. 编写或准备Go项目

在 $GOPATH/src 下创建项目目录，比如 myapp，然后写一个简单的 main.go：

mkdir -p $GOPATH/src/myapp
cd $GOPATH/src/myapp
vim main.go
// 示例代码：
package main
import "fmt"
func main() {
    fmt.Println("Hello, CentOS!")
}

如果项目依赖第三方库，建议用Go Modules管理。初始化模块并下载依赖：

go mod init example.com/myapp
go get -u github.com/gin-gonic/gin  // 以Gin框架为例

3. 编译项目（生成可执行文件）

• 本地编译（仅用于CentOS）：

  cd $GOPATH/src/myapp
  go build -o myapp

• 交叉编译（比如为Windows编译）：

  GOOS=windows GOARCH=amd64 go build -o myapp.exe

• 静态编译（避免依赖外部库，生成自包含的二进制文件）：

  CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o myapp

  其中 -s -w 能去掉调试信息和符号表，减小体积；CGO_ENABLED=0 强制禁用CGO，实现纯静态。

4. 打包项目文件

把可执行文件、配置文件（如 config.yaml）、启动脚本等一起打包：

cd $GOPATH/src/myapp
tar -czvf myapp.tar.gz myapp config/ scripts/run.sh

一个典型的 run.sh 脚本长这样：

#!/bin/bash
nohup ./myapp > app.log 2>&1 &
chmod +x run.sh  # 别忘了给权限

5. 可选：创建RPM包（便于分发）

如果你希望项目能像系统包一样被安装和管理，可以考虑RPM打包。步骤如下：

• 安装rpmbuild：

  sudo yum install -y rpm-build

• 配置宏文件并创建目录结构：

  echo '%_topdir %(echo $HOME)/rpmbuild' >> ~/.rpmmacros
  mkdir -p ~/rpmbuild/{BUILD,RPMS,SOURCES,SPECS,SRPMS}

• 编写SPEC文件（~/rpmbuild/SPECS/myapp.spec）：

  Name: myapp
  Version: 1.0
  Release: 1%{?dist}
  Summary: A simple Golang application for CentOS
  License: MIT
  URL: http://example.com/myapp
  Source0: %{name}-%{version}.tar.gz
  BuildRequires: golang >= 1.16
  Requires: golang >= 1.16
  %description
  This is a Golang application packaged for CentOS.
  %prep
  %setup -q
  %build
  go build -o %{buildroot}/usr/bin/myapp .
  %install
  rm -rf %{buildroot}
  mkdir -p %{buildroot}/usr/bin
  cp myapp %{buildroot}/usr/bin/
  %files
  /usr/bin/myapp
  %changelog
  * Tue Oct 28 2025 Your Name  - 1.0-1
  - Initial package

• 将项目源码打包放入SOURCES：

  tar -czvf ~/rpmbuild/SOURCES/myapp-1.0.tar.gz -C $GOPATH/src/myapp .

• 执行构建：

  rpmbuild -ba ~/rpmbuild/SPECS/myapp.spec

  生成的RPM包在 ~/rpmbuild/RPMS/x86_64/ 下，比如 myapp-1.0-1.el7.x86_64.rpm。

6. 部署与运行

• 上传并解压：

  scp myapp.tar.gz user@your_server_ip:/opt
  ssh user@your_server_ip
  cd /opt
  tar -xzvf myapp.tar.gz

• 运行程序：

  cd /opt/myapp
  chmod +x myapp
  ./myapp       # 前台运行

• 后台运行（推荐）：

  nohup ./myapp > app.log 2>&1 &

• 设置开机自启（systemd）：创建服务文件 /etc/systemd/system/myapp.service：

  [Unit]
  Description=My Golang Application
  After=network.target
  
  [Service]
  User=root
  ExecStart=/opt/myapp/myapp
  Restart=always
  
  [Install]
  WantedBy=multi-user.target

  然后启用并启动：

  sudo systemctl daemon-reload
  sudo systemctl enable myapp
  sudo systemctl start myapp

以上就是一个完整的Golang项目在CentOS上从打包到部署的流程。根据实际场景，你还可以选择静态编译、RPM打包或Docker容器化等方式进一步优化。关键是理解每一步背后的意图——比如为什么要静态编译、RPM的好处是什么，这样遇到具体需求时才能灵活调整。