Gitlab Kubernetes执行器Job无法连接Docker守护进程求助

以下是几个最可能的原因和对应的解决办法：

• Docker-in-Docker服务未正确配置TCP监听
  默认docker:dind容器使用Unix socket而非TCP端口提供服务，你需要显式配置它监听2375端口，同时在Job里指定正确的DOCKER_HOST变量。检查你的.gitlab-ci.yml：

  services:
    - name: docker:dind
      command: ["--host=tcp://0.0.0.0:2375"]
  variables:
    DOCKER_HOST: tcp://docker:2375
    DOCKER_TLS_CERTDIR: ""  # 禁用TLS验证，避免证书问题阻断连接
  

• GitLab Runner未启用特权模式
  docker:dind需要特权权限才能启动Docker守护进程（比如创建网络、访问宿主机设备）。如果你用Helm部署Runner，检查values.yaml里的配置：

  runners:
    privileged: true
  

  如果是手动配置Runner，确保config.toml里的[[runners]]段有privileged = true。没有特权模式的话，docker:dind容器会启动失败，自然连不上守护进程。

• 网络策略或防火墙阻断了端口访问
  检查VK Cloud托管K8s集群的NetworkPolicy规则，是否限制了同一Pod内容器之间的TCP 2375端口通信。Job容器和docker:dind服务容器在同一个Pod里，需要确保允许它们之间的流量。另外，也可以临时禁用NetworkPolicy测试是否是这个问题。

• Docker-in-Docker容器启动失败
  查看docker:dind服务容器的日志，用命令：

  kubectl logs <你的Job Pod名称> -c docker
  

  日志里会显示启动失败的具体原因，比如权限不足、文件系统挂载错误等。如果是权限问题，回到上一点确认特权模式是否开启。

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