Windows Server上Docker部署GitLab-Runner报OSType不匹配错误求助

首先咱们拆解下你遇到的报错根源：executor requires OSType=linux, but Docker Engine supports only OSType=windows，这说明你的GitLab Runner的Docker executor并没有连接到你已经配置好的、支持Linux容器的Docker引擎（也就是你暴露的tcp://10.99.0.12:2375），反而默认尝试连接了不兼容的Docker环境（比如Runner容器内部的Docker，或者未正确切换模式的Windows本地Docker）。

结合你「仅依赖Docker、配置存于代码仓库」的需求，给你一套针对性的解决方案：

1. 用Linux版GitLab Runner容器部署 #

Windows版GitLab Runner在对接Linux容器任务时容易出现OSType兼容性问题，所以一定要用官方Linux版镜像启动Runner：

docker run -d --name gitlab-runner-staging --restart always \
  # 告诉Runner要连接的远程Docker引擎地址
  -e DOCKER_HOST=tcp://10.99.0.12:2375 \
  # 挂载本地目录存储Runner配置（后续可将这个目录与代码仓库绑定，实现配置版本化）
  -v ./gitlab-runner-config:/etc/gitlab-runner \
  gitlab/gitlab-runner:latest

2. 注册Runner时指定正确的Executor参数 #

进入Runner容器完成注册，确保Docker executor指向Linux兼容环境：

docker exec -it gitlab-runner-staging gitlab-runner register \
  --url "https://你的GitLab实例地址/" \
  --registration-token "你的项目注册令牌" \
  --description "Staging Runner" \
  --executor "docker" \
  # 指定默认使用Linux版Docker镜像
  --docker-image "docker:latest" \
  # 全局传递DOCKER_HOST环境变量，让所有Job都能复用
  --env "DOCKER_HOST=tcp://10.99.0.12:2375" \
  # 可选：如果需要构建镜像等特权操作，可添加--docker-privileged

3. 优化CI/CD配置（.gitlab-ci.yml） #

在代码仓库的.gitlab-ci.yml里，确保部署Job的环境变量和依赖正确：

stages:
  - deploy

deploy-service:
  stage: deploy
  # 使用Linux版Docker镜像作为Job基础环境
  image: docker:latest
  variables:
    # 明确指定Docker引擎地址
    DOCKER_HOST: tcp://10.99.0.12:2375
    # 测试环境可禁用Docker TLS，生产环境建议启用加密
    DOCKER_TLS_CERTDIR: ""
  script:
    # 安装docker-compose（docker:latest镜像默认不带该工具）
    - apk add --no-cache docker-compose
    # 执行部署命令
    - docker-compose up -d

关键注意事项 #

• 确认Windows Server防火墙已开放2375端口，允许Runner容器访问你的Docker API；
• 全程避免使用Windows版GitLab Runner镜像，Linux镜像对Linux容器任务的兼容性更稳定；
• 如果要把Runner配置存于代码仓库，只需将挂载的./gitlab-runner-config目录同步到仓库，启动容器时直接挂载即可实现配置的版本化管理。

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