Docker构建时提示SSH代理套接字不存在但实际文件已存在的原因排查

看起来你碰到了一个有点迷惑的问题——明明ls能看到代理套接字文件，可Docker就是报找不到。结合你给出的命令执行细节，我总结了几个最可能的原因和对应的解决办法：

1. SSH代理进程PID不匹配 #

你启动ssh-agent后显示的是Agent pid 28199，但Docker报错找的是agent.28198，这说明当前shell的SSH_AUTH_SOCK环境变量指向的是旧代理的套接字，和正在运行的代理进程不匹配。

当你执行eval $(ssh-agent -s)时，ssh-agent会设置SSH_AUTH_SOCK环境变量来指定它的套接字路径。如果之前有未清理的旧代理进程，或者你在不同shell会话间切换操作，就容易出现这种环境变量和实际进程脱节的情况。

解决步骤：

• 先检查当前环境变量的代理路径：echo $SSH_AUTH_SOCK，确认是不是指向/tmp/ssh-qpL02JZP5k7x/agent.28198
• 如果确实不匹配，先杀掉旧代理进程：kill 28198
• 重新启动ssh-agent并刷新环境：eval $(ssh-agent -s)，再执行ssh-add，最后重新运行docker build命令

2. Docker进程没有套接字访问权限 #

你看到套接字的权限是srw-------，这意味着只有创建它的ubuntu用户能访问。但Docker默认以root身份运行BuildKit进程，root用户没办法直接访问属于普通用户的套接字文件，这就导致Docker“看不到”它。

解决办法：

• 更安全的方式：明确指定套接字路径给Docker，同时确保BuildKit能继承权限。执行以下命令：

  export DOCKER_BUILDKIT=1
  docker build --ssh default=$SSH_AUTH_SOCK -t my_image .
  

• 临时应急（注意有安全风险）：修改套接字权限让其他用户可访问：chmod 777 /tmp/ssh-qpL02JZP5k7x/agent.28198

3. 临时目录文件被自动清理 #

/tmp目录下的文件会被系统的临时文件清理服务（比如systemd-tmpfiles）定期清理，虽然你执行ls时文件还在，但可能在Docker尝试访问的瞬间被清理了（这种情况概率不高，但值得排查）。

解决办法：

• 手动指定一个非临时目录的套接字来启动ssh-agent，避免被自动清理：

  ssh-agent -a ~/.ssh/agent.sock
  export SSH_AUTH_SOCK=~/.ssh/agent.sock
  ssh-add
  docker build --ssh default=$SSH_AUTH_SOCK -t my_image .
  

4. 环境变量未正确传递给Docker #

如果你的命令是在脚本中执行，或者通过子shell运行，SSH_AUTH_SOCK环境变量可能没有被正确传递给Docker进程，导致它找不到套接字。

解决办法：

• 强制在docker build命令中传递环境变量：

  env SSH_AUTH_SOCK=$SSH_AUTH_SOCK docker build --ssh default -t my_image .
  

• 确保所有命令在同一个shell会话中执行，避免子shell导致的环境变量丢失。

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