MacOS下GitLab Runner无法正常工作问题求助

问题概述 #

在macOS系统中按GitLab官方步骤为指定项目注册新Runner后，Runner已出现在项目Runner列表中，但带有“New Runner, has not contacted yet”警示标识。推送代码后流水线执行失败，Runner无法正常工作。

配置文件信息 #

[[runners]]
  name = "mac"
  url = "https://*********/"
  id = 7944
  token = "*******************"
  token_obtained_at = 2023-03-13T11:41:22Z
  token_expires_at = 0001-01-01T00:00:00Z
  executor = "shell"

错误日志内容（翻译后） #

运行时平台：架构amd64，操作系统darwin，进程号******，版本16.0.1
从/Users/************/.gitlab-runner/config.toml启动多Runner实例... 构建数=0
[警告] 以用户模式运行。
[警告] 请使用sudo切换到系统模式：
[警告] $ sudo gitlab-runner...

配置已加载 构建数=0
未定义listen_address，指标与调试端点已禁用 构建数=0
未定义[session_server].listen_address，会话端点已禁用 构建数=0
初始化执行器提供程序 构建数=0
[错误] 检查作业时被禁止  Runner=****
[错误] 检查作业时被禁止  Runner=****
[错误] 检查作业时被禁止  Runner=****
[错误] Runner "https://git.****.**/*****" 状态异常，将被禁用1小时！ 异常请求数=3 异常请求数上限=3
[警告] [runWait] 收到停止信号  构建数=0 停止信号=terminated
[警告] 未正常完成优雅关闭。请使用SIGQUIT（ctrl-\）而非SIGINT（ctrl-c）来优雅清理运行中的插件  构建数=0 错误=收到停止信号：terminated
[警告] 开始强制关闭  停止信号=terminated 构建数=0 关闭超时=30秒
所有工作进程已停止。 构建数=0
正在关闭执行器提供程序 构建数=0 关闭超时=30秒
所有执行器提供程序已关闭。 构建数=0
现在可以退出！ 构建数=0

解决方案 #

• 重新验证Runner令牌：删除现有Runner，使用项目的项目级注册令牌重新注册（勿用实例级令牌），确保注册时指定正确的项目和标签（若需要）。
• 检查网络与权限：
  • 确认macOS防火墙未阻止Runner访问GitLab服务器URL，可通过curl https://你的GitLab地址/api/v4/runners测试连通性。
  • 日志提示以用户模式运行，尝试用sudo gitlab-runner start以系统模式启动，避免文件或权限访问限制。
• 检查Runner状态：在GitLab项目的「设置→CI/CD→Runner」中，确认该Runner未被禁用，且「锁定到当前项目」选项已勾选（如果是专属项目Runner）。
• 清理旧配置：删除/Users/你的用户名/.gitlab-runner/config.toml文件，重新注册生成全新配置，避免旧配置残留问题。

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