GitLab CI/CD 加速：配置 Helper 镜像解决拉取失败问题

本文基于参考博客《GitLab Runner 配置详解》，系统梳理 GitLab Runner Helper 镜像的配置方法与版本对照关系。

核心内容包括：

配置文件详解：完整展示 /etc/gitlab-runner/config.toml 的真实配置示例，涵盖全局并发设置、会话服务器、Docker 执行器等核心参数，重点标注 helper_image 的配置位置
版本对照表：整理 GitLab 14.8.2、17.11.7、18.7.6 三个版本与对应 GitLab Runner 版本的映射关系，提供官方 Helper 镜像地址与阿里云镜像加速地址
镜像加速方案：针对国内网络环境，提供阿里云镜像仓库的替代方案，解决官方镜像拉取慢或失败的问题

通过本文，读者可以快速掌握 GitLab Runner Helper 镜像的配置方法，并根据自身 GitLab 版本选择正确的 Helper 镜像版本。

Gitlab Runner 官方仓库

GitLab Runner Tags

Gitlab Runner 真实配置示例

在 /etc/gitlab-runner/config.toml 中配置 Helper 镜像：

toml
# 全局并发设置：最大同时运行的作业数
concurrent = 1
# 检查新作业的时间间隔（秒），0表示使用默认值
check_interval = 0
# 会话服务器配置
[session_server]
    # 会话超时时间（秒）
    session_timeout = 1800
# Runner配置（可以有多个Runner实例）
[[runners]]
    # Runner的名称，用于在GitLab中标识此Runner
    name = "builder"
    # GitLab实例的URL地址
    url = "http://127.0.0.1:8000"
    # Runner的注册令牌，用于与GitLab实例进行身份验证
    token = "xxxxxxxxx"
    # 执行器类型，这里使用Docker执行器
    executor = "docker"
    # 自定义构建目录配置
    [runners.custom_build_dir]
    # 缓存配置
    [runners.cache]
        # S3缓存配置
        [runners.cache.s3]
        # Google Cloud Storage缓存配置
        [runners.cache.gcs]
        # Azure缓存配置
        [runners.cache.azure]
    # Docker执行器特定配置
    [runners.docker]
        # 是否验证Docker守护进程的TLS证书
        tls_verify = false
        # 默认使用的Docker镜像
        image = "registry.cn-shanghai.aliyuncs.com/odboy/kenaito-cicd:system-alinux3"
        # ⬇️ 此处配置 Helper 镜像，用于辅助操作
        helper_image = "registry.cn-shanghai.aliyuncs.com/odboy/kenaito-cicd:gitlab-runner-helper-14.8.3"
        # 特权模式：必须开启，允许容器运行需要特权的操作（如Docker in Docker）
        privileged = true
        # 是否禁用入口点覆盖
        disable_entrypoint_overwrite = false
        # 如果发生内存不足 (OOM) 错误，不终止容器中的进程
        oom_kill_disable = false
        # 是否禁用缓存
        disable_cache = false
        # 挂载的卷，这里将/cache目录挂载为持久化存储
        volumes = ["/cache"]
        # 镜像的共享内存大小（以字节为单位），0表示使用Docker默认值
        shm_size = 0
        # CPU 数量
        cpus = "1"
        # 内存软限制
        memory_reservation = "512m"
        # 内存限制
        memory = "1024m"
        # 总内存限制
        memory_swap = "2048m"
        # DNS 服务器列表
        dns = ["8.8.8.8", "223.5.5.5"]
        # 镜像拉取策略
        pull_policy = "always"

版本对照表

gitlab	gitlab url	linux	gitlab-runner版本	gitlab-runner 发行版本	gitlab-runner sha	gitlab-helper (官方镜像)	gitlab-helper (阿里云镜像)
14.8.2	https://packages.gitlab.com/gitlab/gitlab-ce/packages/el/7/gitlab-ce-14.8.2-ce.0.el7.x86_64.rpm/download.rpm	centos7	14.8.3	https://gitlab.com/gitlab-org/gitlab-runner/-/releases/v14.8.3	16ae0625	registry.gitlab.com/gitlab-org/gitlab-runner/gitlab-runner-helper	registry.cn-shanghai.aliyuncs.com/odboy/devops .8.3
17.11.7	https://packages.gitlab.com/gitlab/gitlab-ce/packages/el/8/gitlab-ce-17.11.7-ce.0.el8.x86_64.rpm/download.rpm	centos8	17.11.4	https://gitlab.com/gitlab-org/gitlab-runner/-/releases/v17.11.4	cc77edaf	registry.gitlab.com/gitlab-org/gitlab-runner/gitlab-runner-helper	registry.cn-shanghai.aliyuncs.com/odboy/devops .11.4
18.7.6	https://packages.gitlab.com/gitlab/gitlab-ce/packages/ol/8/gitlab-ce-18.7.6-ce.0.el8.x86_64.rpm/download.rpm	centos8	18.9.0	https://gitlab.com/gitlab-org/gitlab-runner/-/releases/v18.9.0	07e534ba	registry.gitlab.com/gitlab-org/gitlab-runner/gitlab-runner-helper	registry.cn-shanghai.aliyuncs.com/odboy/devops .9.0