Windows 11本地GitLab Runner证书配置失败求助

问题本质 #

这是Windows环境下GitLab Runner用bash作为shell executor时，路径转义与POSIX/Windows路径格式冲突导致的环境变量传递错误，核心是CI_SERVER_TLS_CA_FILE的路径被错误拼接或转义。

解决方案 #

1. 修正config.toml的证书路径格式 #

把config.toml里的tls-ca-file改成正斜杠或双反斜杠格式，杜绝单反斜杠的转义问题：

[[runners]]
  name = "Windows Shell Runner"
  url = "https://your-gitlab-instance.com/"
  token = "your-runner-token"
  executor = "shell"
  shell = "bash"
  tls-ca-file = "C:/path/to/your/ca.crt"
  # 或者双反斜杠写法："C:\\path\\to\\your\\ca.crt"

2. 不要手动设置CI_SERVER_TLS_CA_FILE #

删掉.gitlab-ci.yml里手动定义这个变量的代码，让Runner从config.toml自动读取并转换路径：

# 移除这类配置
variables:
  CI_SERVER_TLS_CA_FILE: "C:/path/to/ca.crt"

3. 开启MSYS_NO_PATHCONV禁用路径转换 #

因为用的是Git Bash，它的路径转换会干扰Runner传递的变量，给Runner启动脚本加环境变量：

• 找到GitLab Runner安装目录（默认C:\GitLab-Runner）
• 编辑runner.bat或新建启动脚本，开头加：

set MSYS_NO_PATHCONV=1

• 重启Runner服务：

gitlab-runner stop
gitlab-runner start

4. 重新注册Runner（清除残留错误配置） #

如果之前注册时参数传递有误，直接重新注册，确保--tls-ca-file用正斜杠路径：

gitlab-runner register --url "https://your-gitlab-instance.com/" --token "your-runner-token" --executor "shell" --shell "bash" --tls-ca-file "C:/path/to/your/ca.crt"

注册后别乱改shell相关配置，用自动生成的即可。

5. 检查bash启动配置 #

查看Git Bash的~/.bashrc或~/.profile，删掉里面自动修改路径的脚本，避免干扰Runner的环境变量。

验证方法 #

1. 重启GitLab Runner服务
2. 跑一个测试流水线，加个打印变量的步骤：

test-cert-path:
  script:
    - echo $CI_SERVER_TLS_CA_FILE

3. 看日志输出，确认路径是正常的C:/path/to/ca.crt或C:\path\to\ca.crt，没有重复前缀或C;这种异常格式

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