GitLab Runner配置host网络后出现network-scoped alias错误的解决咨询

看起来你遇到的问题是GitLab Runner Docker执行器和docker:dind服务在host网络模式下的兼容性冲突，我来帮你拆解原因和可行的解决办法：

问题根源 #

当你在Runner的config.toml里全局设置network_mode = "host"后，所有Runner启动的容器（包括docker:dind这个服务容器）都会强制使用host网络。但Docker的host网络模式不支持"网络作用域别名（network-scoped alias）"，而GitLab Runner的Docker执行器默认会给服务容器自动添加这个别名来方便Job容器访问，这就直接触发了你看到的报错。

解决办法 #

1. 只为特定Job设置host网络（推荐方案）

不要在Runner全局配置里设置host网络，而是在需要的Job中单独指定。这样既满足你的Job使用host网络的需求，又不会影响docker:dind服务的正常运行（它会继续使用默认的用户自定义网络，支持别名）。

修改你的.gitlab-ci.yml，给build_job添加变量配置：

stages:
- build
- test
- deploy

before_script:
- docker-compose --version
- docker --version

build_job:
  stage: build
  services:
  - docker:dind
  tags:
  - build
  - docker
  script:
  - echo "Building the application..."
  - docker run --network host hello-world
  only:
  - project
  # 添加以下变量，只为当前Job的主容器设置host网络
  variables:
    DOCKER_HOST: tcp://docker:2376
    DOCKER_TLS_CERTDIR: "/certs"
    CI_CONTAINER_NETWORK: host

这个方案的优势是不改动Runner全局配置，只针对需要的Job生效，其他Job不受影响，而且能正常使用docker:dind服务。

2. 全局设置host网络并禁用服务别名（备选）

如果你必须在Runner全局配置里使用host网络，可以通过禁用Runner的服务别名功能来规避报错。但这样你就不能在Job里使用services字段，需要手动启动docker:dind服务。

修改你的Runnerconfig.toml文件：

[[runners]]
  name = "DevOpsCourseRunner"
  url = "你的GitLab实例地址"
  token = "AcswPCaLi"
  executor = "docker"
  [runners.docker]
    tls_verify = false
    image = "ubuntu:latest"
    privileged = true
    network_mode = "host"
    # 添加这行禁用服务别名
    disable_services = true
  [runners.cache]
    [runners.cache.s3]
    [runners.cache.gcs]

然后在Job的script里手动启动docker:dind：

- docker run -d --name docker-dind --privileged docker:dind
- export DOCKER_HOST=tcp://localhost:2376

这种方案比较繁琐，除非有特殊需求，否则不推荐。

注意事项 #

• 你的Runner是Linux环境，host网络模式会直接复用主机的网络栈，要确保主机上的端口没有被其他服务占用，避免冲突。
• CI_CONTAINER_NETWORK变量需要GitLab Runner 13.0及以上版本支持，你用的16.6.1版本完全没问题。

备注：内容来源于stack exchange，提问作者chrysa