systemd部署GO二进制文件时SSH_AGENT_SOCK未指定报错求助

这个问题很常见——当你在登录shell里手动运行程序时，shell会自动帮你设置SSH_AUTH_SOCK环境变量，指向当前会话的SSH agent socket；但systemd系统服务默认运行在一个干净的环境里，不会继承用户会话的这些环境变量，所以你的GO程序找不到agent就报错了。

下面给你几个可行的解决方案，按需选择：

方案1：直接指定SSH_AUTH_SOCK路径到用户会话的agent #

首先，在你登录的shell里执行echo $SSH_AUTH_SOCK，得到类似/run/user/1000/ssh-agent.sock的路径（1000是你的用户UID）。

然后修改你的systemd单元文件，添加User字段指定运行服务的用户，再通过Environment变量注入SSH_AUTH_SOCK：

[Unit]
Description=service
[Service]
Type=simple
Restart=always
RestartSec=5s
# 替换成你的实际用户名
User=your_username
# 替换成你刚才查到的SSH_AUTH_SOCK路径
Environment="SSH_AUTH_SOCK=/run/user/1000/ssh-agent.sock"
ExecStart=/home/your_username/go/src/dir/binary
[Install]
WantedBy=multi-user.target

修改后重新加载systemd配置并重启服务：

sudo systemctl daemon-reload
sudo systemctl restart your-service-name.service

⚠️ 注意：如果你的SSH agent重启（比如重新登录），这个socket可能会失效，服务可能需要重启才能继续使用agent。

方案2：让服务自己启动一个专属的SSH agent #

如果你的服务需要长期稳定的SSH agent，不想依赖用户会话的agent，可以让systemd在启动服务前自动启动一个agent，并让程序使用它：

修改单元文件如下：

[Unit]
Description=service
[Service]
Type=simple
Restart=always
RestartSec=5s
User=your_username
# 启动专属的SSH agent，将环境变量写入临时文件
ExecStartPre=/usr/bin/ssh-agent -a /run/user/%u/service-ssh-agent.sock -s > /tmp/service-ssh-agent-env
# 加载agent环境变量后再启动你的二进制
ExecStart=/bin/bash -c "source /tmp/service-ssh-agent-env && /home/your_username/go/src/dir/binary"
# 停止服务时关闭agent
ExecStopPost=/usr/bin/ssh-agent -k
[Install]
WantedBy=multi-user.target

之后别忘了把你的SSH私钥添加到这个专属agent里（可以手动执行ssh-add，或者在服务启动前添加）：

sudo -u your_username ssh-add /path/to/your/private-key

方案3：改用systemd用户级服务 #

如果你的服务不需要以root权限运行，推荐改成用户级systemd服务，这样服务会自动继承用户会话的环境变量（包括SSH_AUTH_SOCK）：

1. 把单元文件移动到用户的systemd配置目录：

mkdir -p ~/.config/systemd/user/
mv your-service.service ~/.config/systemd/user/

2. 修改单元文件的WantedBy字段：

[Install]
WantedBy=default.target

3. 启用并启动服务：

systemctl --user enable --now your-service.service
# 如果需要开机自启，还要启用 linger
loginctl enable-linger your_username

这个方案最省心，因为用户级服务完全复用你的用户环境，不需要手动设置环境变量。

内容的提问来源于stack exchange，提问作者ecl0