GitLab Runner 安装注册全攻略：从 Token 获取到环境就绪

大家好，我是浮生若梦。

在上一期中，我们已经完成了 GitLab 与 Gitee 之间 SSH 公钥的配置，实现了从 GitLab 服务器免密访问 Gitee 仓库，也介绍了如何通过 config 文件解决配置公钥后仍无法克隆的问题（本质是私钥路径未指定）。

今天这一期，我们要完成自动部署的关键环节——安装并注册 GitLab Runner。Runner 是 GitLab CI/CD 的执行器，有了它，GitLab 才能在代码推送后自动执行流水线任务。

GitLab Runner 是什么？

简单来说，GitLab Runner 就是一个任务执行器。当你推送代码到 GitLab 后，CI/CD 流水线需要一个"工人"来执行编译、测试、部署等任务——这个"工人"就是 Runner。

你不需要深入理解它的底层原理，只需要按照以下步骤完成安装和注册，配好环境后直接用就行了。后续站长带大家做 AI 自动化项目时，这些都是现成的基础设施。

第一步：获取注册 Token

安装 Runner 之前，我们需要先从 GitLab 管理后台获取注册令牌（Registration Token）。

1. 打开浏览器，在地址栏输入 http://你的GitLab地址/admin 进入管理页面
2. 在左侧菜单中找到 CI/CD → Runner
3. 在 Runner 管理页面，点击右上角的三个点 "⋯"
4. 点击 "复制注册令牌"，Token 就被复制到剪贴板了

💡 这个注册 Token 加上你的 GitLab 服务器地址，就是安装 Runner 时需要的两个关键参数。

第二步：安装 GitLab Runner

获取到 Token 后，在你的服务器上依次执行以下步骤：

1. 下载 Runner 安装脚本

# 下载 GitLab Runner 官方安装仓库脚本并执行
curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash

2. 安装 GitLab Runner

# 安装最新版 GitLab Runner
sudo yum install -y gitlab-runner

3. 设置开机自启

# 启动 Runner 服务并设置开机自启
sudo systemctl enable gitlab-runner
sudo systemctl start gitlab-runner

这样每次服务器重启后，Runner 都会自动启动，无需手动操作。

第三步：注册 Runner

安装完成后，使用以下命令进行注册：

sudo gitlab-runner register \
  --non-interactive \
  --url "http://你的GitLab地址/" \
  --registration-token "你的注册Token" \
  --executor "shell" \
  --description "my-runner" \
  --tag-list "share,display,windows" \
  --run-untagged="true"

需要修改的地方：

• --url：替换为你自己的 GitLab 服务器地址
• --registration-token：替换为第一步中复制的注册 Token
• --tag-list：Runner 的标签，用于在 .gitlab-ci.yml 中指定使用哪个 Runner

⚠️ 关于标签（tag-list）：这个标签非常重要！后续在 .gitlab-ci.yml 配置文件中，通过 tags 字段指定标签名，流水线就会使用对应标签的 Runner 来执行任务。记住你设置的标签名。

第四步：配置 SSH 密钥（关键）

Runner 注册成功后，还需要配置 SSH 密钥，让 Runner 有权限向远程仓库推送代码。

复制私钥到 Runner

将你在上一期视频中生成的 SSH 私钥复制到 Runner 的工作目录下，并执行后续的配置命令（具体命令参考配置文档）。

修复密钥权限问题

如果你是从 Windows 系统复制私钥到 Linux 上的，可能会遇到权限问题导致无法连接。这是因为复制过来的密钥文件权限不是 600。执行以下命令修复：

# 修改私钥文件权限为 600（仅所有者可读写）
chmod 600 ~/.ssh/id_ed25519

💡 如果你的私钥是通过 ssh-keygen 命令直接在 Linux 上生成的，权限默认就是正确的，不需要额外修改。只有从 Windows 复制过来的私钥才需要执行这一步。

第五步：验证 Runner 状态

所有配置完成后，回到 GitLab 管理后台查看 Runner 状态：

1. 进入 管理中心 → CI/CD → Runner
2. 确认你的 Runner 显示为 🟢 在线 / 空闲 状态

如果 Runner 显示在线，说明安装和注册全部成功，CI/CD 执行环境已经就绪！

本期总结

本期我们完成了两件关键的事情：

• ✅ 安装并注册 GitLab Runner — CI/CD 流水线的执行引擎
• ✅ 配置 SSH 密钥 — 让 Runner 有权限向远程仓库推送代码

下一期，我们将正式配置 .gitlab-ci.yml 文件，实现 GitLab 代码自动提交到 Gitee 的完整流水线。有了 Runner 这个执行器，再加上流水线配置，就能真正实现代码提交后自动部署上线的全流程自动化。

前期的环境配置虽然繁琐，但都是一次性的。配好之后，后续做 AI 自动化项目时，你只需要一句提示词就能搞定所有事情——这就是自动化的魅力。