VSTS自托管代理Docker Compose任务连接Docker守护进程失败求助

我之前碰到过完全一样的情况——直接在服务器上跑docker-compose一切正常，一通过VSTS任务触发就报连接不上Docker守护进程的错，折腾了好几个小时才找到根源，给你几个靠谱的排查和解决方向：

核心原因分析 #

问题出在VSTS自托管代理的运行上下文和你交互式登录服务器的上下文不一样：虽然你把代理运行用户加入了docker组，但如果代理是作为系统服务（比如systemd）运行的，它不会自动继承用户组的权限变更；另外，代理进程的环境变量里可能没有正确设置DOCKER_HOST，导致找不到Docker守护进程的套接字。

具体解决方案 #

1. 确保代理服务加载docker组权限 #

如果你的VSTS代理是用systemd管理的服务：

• 打开代理的systemd配置文件（通常路径是/etc/systemd/system/vsts-agent.service）
• 在[Service]区块添加以下配置：

  Environment="DOCKER_HOST=unix:///var/run/docker.sock"
  Group=docker
  

• 重新加载systemd配置并重启代理服务：

  sudo systemctl daemon-reload
  sudo systemctl restart vsts-agent.service
  

2. 验证代理用户的Docker访问权限 #

切换到VSTS代理的运行用户，执行以下命令确认权限：

# 查看当前用户所属组，确认包含docker
groups
# 测试Docker连接
docker ps
# 测试Docker Compose运行
docker-compose up -d

如果这里执行失败，说明用户组的变更没生效，可能需要重新创建代理服务或者重启代理（后台服务不会自动感知用户组变更，必须重启）。

3. 显式配置VSTS Docker Compose任务的Docker主机 #

在VSTS的Docker Compose任务配置里：

• 找到Advanced（高级）选项卡
• 在Docker host URI字段填入unix:///var/run/docker.sock
• 保存任务配置后重新触发构建

4. 检查代理的环境变量传递 #

有时候代理进程的环境变量里没有包含Docker相关的配置，可以在代理目录下的.env文件里手动添加：

DOCKER_HOST=unix:///var/run/docker.sock

添加完成后重启代理服务即可。

为什么你的Dockerfile和docker-compose没问题？ #

因为你交互式登录服务器时，用户的环境变量和权限都是正常的，直接运行命令能访问Docker套接字；但VSTS代理作为后台服务运行，它的环境是隔离的，所以需要手动配置这些参数。

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