服务器Go教程：从零编译部署到Systemd守护与Nginx反代

知识分享

2026-10-12 20:00

9 阅读

在 Linux 服务器上跑一个 Go 程序，核心链路是：装好 Go 环境、编译出二进制、交给 Systemd 守护、再用 Nginx 把外部请求转进来。
本文以 Ubuntu/Debian 和 CentOS 为例，从零走完这套流程，并给出 502、端口不通等常见问题的排查方向。

先确认服务器环境和登录方式

操作前提：一台可以 SSH 登录的 Linux 服务器，具备 sudo 或 root 权限。
以下命令用普通用户加 sudo 演示，如果你直接用 root，去掉 sudo 即可。

先看系统版本和架构，因为下载 Go 安装包要匹配 CPU 架构：

cat /etc/os-release
uname -m

uname -m 输出 x86_64 对应 amd64，输出 aarch64 对应 arm64。
后面下载安装包时要用到。

安装 Go 环境

推荐用官方二进制包安装，版本可控，不依赖系统源。
先到 Go 官网下载页确认当前稳定版本号，把下面链接里的版本替换成你看到的实际版本：

cd /tmp
# 版本号请以官网为准，这里仅演示格式
wget https://go.dev/dl/go1.xx.x.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.xx.x.linux-amd64.tar.gz

把 Go 加入环境变量，编辑 /etc/profile.d/go.sh：

sudo tee /etc/profile.d/go.sh > /dev/null <<'EOF'
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
EOF
source /etc/profile.d/go.sh

验证安装：

go version

能打印出 go version go1.xx.x linux/amd64 就说明环境变量生效。
如果提示 command not found，先执行 source /etc/profile.d/go.sh，再检查是否写错了路径。

编译你的 Go 项目

把代码放到服务器上，比如 /opt/myapp，进入项目目录后编译。
假设项目入口是 main.go：

cd /opt/myapp
go mod tidy
go build -o myapp main.go

编译完成后当前目录会生成 myapp 二进制文件。
在生产服务器上直接编译，要确保服务器本身能拉到依赖；
如果网络受限，可以在本地交叉编译后上传：

# 在本地开发机执行，目标为 Linux amd64
GOOS=linux GOARCH=amd64 go build -o myapp main.go

上传到服务器后记得给执行权限：

chmod +x /opt/myapp/myapp

注意：Go 编译出的二进制默认不依赖外部运行时，但你的程序如果连接 MySQL、Redis，这些服务要单独准备好，不在 Go 安装范围内。

用 Systemd 守护进程

直接 ./myapp 跑，SSH 一断开进程就没了。
正确做法是写成 Systemd 服务。
新建 /etc/systemd/system/myapp.service：

[Unit]
Description=My Go App
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/myapp
ExecStart=/opt/myapp/myapp
Restart=always
RestartSec=3
Environment=APP_ENV=prod

[Install]
WantedBy=multi-user.target

几个容易写错的点：User 要改成实际运行用户，
且该用户对 /opt/myapp 有读取和执行权限；WorkingDirectory 要和程序读取配置文件、
日志的相对路径一致，
否则会报找不到文件。

加载并启动：

sudo systemctl daemon-reload
sudo systemctl enable --now myapp
sudo systemctl status myapp

状态里看到 active (running) 即启动成功。
如果显示 failed，用 journalctl -u myapp -n 50 --no-pager 看最近 50 行日志定位原因。

配置 Nginx 反向代理

假设 Go 程序监听 127.0.0.1:8080。
先确认它只绑本地，避免直接暴露公网端口。
Nginx 站点配置示例：

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

检查配置并重载：

sudo nginx -t
sudo systemctl reload nginx

nginx -t 输出 syntax is ok 和 test is successful 才能重载。
若你的程序要拿到真实客户端 IP，程序里需读取 X-Real-IP 或 X-Forwarded-For 请求头，不能只看 RemoteAddr。

端口、防火墙与验证

先本地验证程序是否真的在监听：

ss -tlnp | grep 8080
curl -I http://127.0.0.1:8080

本地能通、外网访问 80 端口不通，多半是防火墙没放行。
Ubuntu 用 ufw，CentOS 用 firewalld：

# Ubuntu
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

# CentOS
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload

另外云服务器还有一层安全组，需要在控制台放行 80、443 端口，这一步和系统防火墙是两回事，两边都要检查。

常见报错怎么排查

502 Bad Gateway：Nginx 连不上后端。
先 systemctl status myapp 看进程是否活着，再 ss -tlnp | grep 8080 确认端口在听，最后检查 proxy_pass 里的地址和端口是否和程序实际监听一致。

404 或路由异常：程序正常但路径不对，检查 proxy_pass 末尾是否多写或少写斜杠，以及程序本身的路由前缀。

端口被占用：启动报 address already in use，用 ss -tlnp | grep 端口号 找到占用进程，确认是否旧实例没停干净。

改完配置不生效：Systemd 服务改了 .service 文件后必须 daemon-reload 再 restart；
Nginx 改完要 nginx -t 通过后 reload。

几个值得记住的避坑点

不要把 Go 程序用 root 直接前台运行，用 Systemd 指定普通用户，降低权限风险。
程序监听的端口尽量绑 127.0.0.1，由 Nginx 对外，避免绕过代理直连。
二进制文件路径和 WorkingDirectory 要固定，别用相对路径启动，否则开机自启容易找不到文件。
上线前先 curl -I http://127.0.0.1:端口 自测，比直接怀疑网络更快定位问题。

整套流程走完后，你的 Go 程序就具备了开机自启、崩溃自动重启、外部通过域名访问的能力。
如果换了新服务器或迁移环境，按本文顺序重做一遍即可，遇到异常优先回到端口监听和日志这两个检查点。

服务器Java环境搭建：Linux安装JDK与Tomcat部署实战教程