使用二进制部署 Gitea Runner 指南（实战二）

type

status

date

slug

summary

📝 前言

回顾一下，在 DevOps 专题的前几期，我们分别介绍了以下内容：

Gitea 是什么，有哪些核心功能：《从阿里云效到自建DevOps平台：Gitea入门介绍》

如何部署 Gitea：《使用 Docker 快速部署 Gitea 指南(实战一)》

如果想要通过 Gitea 来完成 DevOps 的 CI/CD，那还需要安装一个 Runner 组件，这一期我们就再来介绍 Gitea Runner。

🧭 背景介绍

Gitea 是一个开源、轻量级的 Git 托管服务，支持自建 CI/CD 工作流。

Gitea Runner 是 Gitea Actions 的执行器，相当于 GitHub Runner，可以执行在项目根目录 .gitea/workflows 中定义的流程。

虽然 Gitea 官方提供了 Docker 和 Docker Rootless 安装方法，但使用二进制部署更适合资源受限或个人自己使用的用户，不仅更节省资源而且构建速度更快。

如果是团队使用，那建议还是用 Docker 更方便些。

📋 前提条件

在开始之前，请确保已准备好以下条件：

已部署并运行中的 Gitea 实例（可参看文章：《使用 Docker 快速部署 Gitea 指南(实战一)》）

有一台可用的 Linux 服务器，并与 Gitea 实例网络互通（推荐使用 Ubuntu 24.04 或以上的 LTS 版）

🚀 详细步骤

1️⃣ 下载 Gitea Runner 二进制文件

访问 Gitea Runner 的发布页面选择与你系统匹配的版本。

2️⃣ 配置 Gitea Runner

使用以下命令生成并修改配置文件：

3️⃣ 注册 Gitea Runner

登录你的 Gitea 管理后台，进入：

设置 → Actions → Runners → 创建 Runner → 复制 Token，执行以下命令注册：

参数说明：

instance：部署的 Gitea 访问地址，比如：http://192.168.10.1:3000

token：就按照上面步骤复制的 Token

name：名称随便取，比如：master、node-1、node-2

labels：这里标签其实不填也没关系，在运行时会根据上面配置文件的内容自动进行替换。

当看到以下命令输出时，则表示已注册成功：

此时，进入管理后台，就可以看到我们刚注册的 Runner 了，但是其状态还是离线的，这就需要我们进行下一步启动 Runner。

4️⃣ 创建 systemd 服务并启动

我们将 Gitea Runner 作为 systemd 服务运行以实现开机自启和进程守护。

编辑脚本文件：

vim /etc/systemd/system/gitea-runner.service

保存后，执行以下命令启动：

现在再回到管理后台，就可以看到 runner 的状态从离线变为空闲了。

✅ 总结

使用二进制部署 Gitea Runner 是一种轻量、稳定、适用于各种 Linux 环境的方式。

通过 systemd 管理 Runner 可提升可用性，并避免容器或额外依赖的复杂性。

🔜 下期预告

部署完成只是第一步！

限于篇幅，下一篇我们将介绍如何使用 Gitea Runner 实现自动化构建与部署流程，轻松打造你的私有 DevOps 流水线，敬请期待：《Gitea Actions 工作流实战指南》！

💡

有关文章的任何疑问，欢迎您在底部评论区留言，一起交流~

若文章对您有帮助，欢迎请我喝杯咖啡~