为何systemd服务无法访问用户主目录，手动重启后却正常运行？

这种情况我在运维多台服务器时碰到过好几次，核心矛盾点很清晰：systemd自动启动服务时的运行上下文（用户身份、环境变量、依赖状态）和你手动执行sudo systemctl restart时完全不一样，而日志指向~/.ssh目录，说明问题大概率出在权限、路径解析或者用户环境上。下面分几个方向排查和解决：

1. 检查服务的用户身份与.ssh目录权限 #

首先确认你的systemd服务是以哪个用户身份运行的：

• 打开服务配置文件（通常在/etc/systemd/system/ssh-tunnel.service），查看[Service]段是否有User=字段。
  • 如果没配置User=，服务默认以root身份运行，此时~指向/root/.ssh，而不是你手动执行时的普通用户主目录；
  • 如果配置了User=xxx，要确保/home/xxx/.ssh的权限完全正确：

    # 检查目录权限（必须是700，只有所有者能访问）
    ls -ld /home/xxx/.ssh
    # 检查密钥文件权限（必须是600，禁止其他用户读取）
    ls -l /home/xxx/.ssh/id_rsa
    

    要是权限不对，用下面的命令修正：

    chown -R xxx:xxx /home/xxx/.ssh
    chmod 700 /home/xxx/.ssh
    chmod 600 /home/xxx/.ssh/id_rsa
    

2. 强制指定HOME环境变量 #

systemd启动服务时不会加载用户的shell环境变量，这会导致~符号无法正确解析到用户主目录（哪怕你指定了User=）。解决方法很直接：
在服务文件的[Service]段添加环境变量声明，明确指定HOME路径：

[Service]
# 其他配置...
Environment="HOME=/home/xxx"
# 同时把ExecStart里的~换成绝对路径更保险
ExecStart=/usr/bin/ssh -N -R 2222:localhost:22 central-user@central-server -i /home/xxx/.ssh/id_rsa

3. 确保服务在网络就绪后启动 #

服务器重启后，systemd可能在网络完全初始化前就尝试启动SSH隧道，导致连接失败（虽然日志指向.ssh，但也有可能是网络未就绪引发的连锁问题）。给服务添加网络依赖：
在[Unit]段补充：

[Unit]
Description=Reverse SSH Tunnel to Central Server
After=network-online.target
Wants=network-online.target

network-online.target会确保网络完全就绪后再启动你的服务，比network.target更严格。

4. 排除密钥密码短语的干扰 #

如果你的SSH密钥设置了密码短语，手动启动时可能通过终端输入了密码，但systemd自动启动时没有交互环境，会导致密钥验证失败。这种情况下：

• 要么换成无密码的SSH密钥（确保密钥文件权限严格，且只在可信服务器间使用）；
• 要么配置ssh-agent集成到systemd服务中，自动解锁密钥（步骤稍复杂，适合必须用密码短语的场景）。

修正后的完整服务示例 #

把上面的调整整合后，你的服务文件大概是这样：

[Unit]
Description=Reverse SSH Tunnel to Central Server
After=network-online.target
Wants=network-online.target

[Service]
User=xxx
Environment="HOME=/home/xxx"
ExecStart=/usr/bin/ssh -N -R 2222:localhost:22 central-user@central-server -i /home/xxx/.ssh/id_rsa
Restart=always
RestartSec=60
KillMode=process

[Install]
WantedBy=multi-user.target

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

sudo systemctl daemon-reload
sudo systemctl enable ssh-tunnel.service

按这个流程排查，基本能解决“自动启动失败但手动重启正常”的问题——本质就是让systemd服务的运行环境和你手动执行时保持一致。

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