讲师中心 微信公众号
AI工具推荐 视频效率加速

如何处理因 GitLab Runner 所在主机物理时钟与中心化 GitLab 实例漂移超过 60 秒导致的 Token 校验被拒

星宇君_9553

星宇君_9553

发布时间:2026-06-03 07:34:26

|

648人浏览过

|

来源于php中文网

原创

直接同步主机时钟即可解决,核心是消除服务端与Runner间系统时间差;需用timedatectl status确认时钟同步状态、校验GitLab实例时间一致性、排查NTP异常,并强制校准或启用chrony等高精度同步方案。

如何处理因 gitlab runner 所在主机物理时钟与中心化 gitlab 实例漂移超过 60 秒导致的 token 校验被拒

直接同步主机时钟即可解决,核心是消除服务端与 Runner 之间的系统时间差,而非调整 Token 配置或放宽验证策略。

确认时钟漂移是否真实存在

在 GitLab Runner 所在主机上执行:

  • 对比本地时间与权威时间源:运行 timedatectl status 查看系统时钟状态,重点关注 System clock synchronized 是否为 yes,以及 RTC timeUniversal time 的偏差
  • 校验与 GitLab 实例时间的一致性:访问 GitLab 实例的 API 端点(如 /api/v4/version),检查响应头中的 Date 字段;同时在 Runner 主机运行 date -R,两者应相差 ≤5 秒
  • 排查 NTP 服务异常:若 timedatectl 显示未同步,检查 systemd-timesyncdchronyd 是否运行,日志可用 journalctl -u systemd-timesyncd -n 20

强制并持续同步系统时间

不要依赖默认的 NTP 拉取间隔,尤其在虚拟机或云环境中易出现漂移累积:

MergeIQ: Automatically Score & Prioritise PR Complexity for GitLab and GitHub
MergeIQ: Automatically Score & Prioritise PR Complexity for GitLab and GitHub

使用四维度框架评估任意 GitLab MR 或 GitHub PR 的复杂度:规模(20%),认知负荷(30%),审查工作量(30%),风险/影响(20%)...

下载
  • 立即校准:sudo timedatectl set-ntp false && sudo ntpdate -s time.google.com && sudo timedatectl set-ntp true
  • 更换更稳定的 NTP 源(如内网 NTP 服务器或 time1.aliyun.com),编辑 /etc/systemd/timesyncd.conf 中的 NTP=
  • 启用 chrony(比默认 systemd-timesyncd 更适合高精度场景):sudo apt install chrony(Debian/Ubuntu)或 sudo apk add chrony(Alpine),再配置 /etc/chrony/chrony.conf

避免临时绕过验证带来的风险

虽然 jwt.WithLeeway(60*time.Second) 类似机制在某些 JWT 库中可用,但 GitLab Runner 的认证流程不暴露该配置项,强行修改底层逻辑既不可靠也不被支持:

  • GitLab Runner 使用的是 GitLab 自研的 CI token 签发与校验链,其 nbf(not before)和 exp(expires)验证由 GitLab Rails 后端统一执行,Runner 仅负责携带并传递 token
  • 所谓“Token 校验被拒”,本质是 GitLab 应用层拒绝了该 token,错误日志通常含 token expiredtoken not active yet,而非 Runner 报错
  • 试图在 Runner 配置中注入 leeway、伪造时间头、或降级 TLS 验证,均无法影响 GitLab 服务端的时间判断,反而可能引入安全或兼容性问题

验证修复效果

完成时间同步后,需触发一次真实作业验证端到端行为:

  • 手动触发一个简单 CI 作业(如 echo "test"),观察 Runner 日志是否仍出现 401 Unauthorizedtoken signed by untrusted key 类错误
  • 检查 GitLab 侧作业详情页的 Running on 信息旁是否有黄色感叹号提示“runner offline”或“stale token”
  • 抓包验证(可选):用 tcpdumpmitmproxy 观察 Runner 向 /api/v4/jobs/request 发起的请求中,Authorization header 是否正常携带 token,且响应状态码为 200 OK

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

199

2026.02.11

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

3610

2023.06.21

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

3133

2023.06.29

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2193

2023.06.30

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

5210

2023.07.05

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

4882

2023.07.06

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2933

2023.07.20

linux查看ip命令
linux查看ip命令

本专题为大家提供linux查看ip命令相关文章内容,感兴趣的朋友可以免费下载体验试试。

2445

2023.07.20

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

0

2026.09.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
vscode手册
vscode手册

共0课时 | 0人学习

Git 教程
Git 教程

共21课时 | 7.9万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn