Azure DevOps自托管Docker容器Agent执行Docker命令遇daemon未运行问题求助

核心问题分析 #

你的Agent运行在Docker容器中时，容器本身没有独立的Docker daemon，必须依赖主机的Docker服务；同时执行sudo命令需要密码导致无法手动启动daemon，需要通过容器挂载、权限配置来解决。

解决方案步骤 #

1. 挂载主机Docker Socket到Agent容器

停止当前Agent容器，重新启动时挂载主机的Docker socket和Docker二进制文件，让容器能直接调用主机的Docker服务：

# 停止现有Agent容器
docker stop <your-agent-container-name>

# 重新启动容器并挂载必要资源
docker run -d \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /usr/bin/docker:/usr/bin/docker \
  <your-agent-image-tag>

2. 配置主机Docker Daemon开机自启（一次性操作）

在主机上执行以下命令（输入一次sudo密码即可完成配置）：

# 设置Docker开机自启
sudo systemctl enable docker

# 立即启动Docker daemon
sudo systemctl start docker

# 验证运行状态
sudo systemctl status docker

确保输出显示active (running)状态。

3. 解决容器内Docker权限问题

挂载socket后，容器内用户可能因权限不足无法访问，可通过以下两种方式解决：

• 临时方案（快速生效）：在主机上修改socket权限：

  sudo chmod 666 /var/run/docker.sock
  

• 永久方案（更安全）：将容器内Agent用户的UID添加到主机的docker用户组：
  1. 查看容器内用户UID：docker exec <your-agent-container-name> id -u
  2. 在主机上执行：sudo usermod -aG docker -u <container-user-uid> root

4. 验证修复效果

在Azure DevOps流水线中添加测试步骤：

steps:
- script: docker ps
  displayName: 测试Docker命令可用性

运行流水线，确认不再出现“docker daemon未运行”的错误。

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