什么是 Forgejo Runner?
Forgejo Runner 是 Forgejo Actions 的CI 运行器。它是一个轻量级守护进程,连接到你的 Forgejo 实例,获取排队中的工作流任务,并在你自己的基础设施上执行——可使用 Docker、LXC 或直接在主机上运行——为你提供完全自托管、兼容 GitHub Actions 的 CI/CD 流水线。
⚡ Forgejo Runner 的核心功能
🔁 兼容 Actions
使用与 GitHub Actions 相同的语法和 action 生态系统运行工作流。
🐳 灵活执行
可在 Docker 容器、LXC 中执行任务,或直接在主机上运行。
🔐 自托管
将你的 CI/CD 完全保留在自己的基础设施上,无需依赖任何第三方。
⚖️ 可扩展
注册多个带标签的运行器,以分发和定向工作负载。
🎯 为什么选择 Forgejo Runner?
- 掌控你的 CI:在你掌控的硬件上运行流水线
- Actions 生态系统:复用现有的 GitHub 风格工作流定义
- 灵活隔离:Docker、LXC 或主机执行,满足你的不同需求
- 轻量级:单个 Go 二进制文件,部署简单
🆕 主要亮点
- 任务执行:运行排队中的 Forgejo Actions 工作流
- 标签:将任务定向到指定运行器
- 容器支持:通过 Docker 实现隔离构建
- 守护进程模式:作为服务持续运行
📦 从 deb.griffo.io 安装
步骤 1:添加仓库
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update🆓 有一个永久免费的镜像。 deb-free.griffo.io 永久免费提供软件包 — 无需账号、无需订阅,最多落后上游 2 个月,安全修复立即发布。目前收录 cliamp、Ghostty、lazydocker、Oh My Posh 和 Zed;Forgejo Runner 不在其中,因此今天只能通过上面的仓库安装 — 提出请求即可将其加入。
步骤 2:安装 forgejo-runner
# Install latest forgejo-runner
sudo apt install forgejo-runner
# Verify installation
forgejo-runner --version# Install latest forgejo-runner
apt install forgejo-runner
# Verify installation
forgejo-runner --version🎯 基本使用示例
# Show version
forgejo-runner --version
# Generate a default config file
forgejo-runner generate-config > config.yaml
# Register the runner with your Forgejo instance
forgejo-runner register --instance https://forgejo.example.com --token <TOKEN>
# Start the runner daemon
forgejo-runner daemon🚀 为什么选择 deb.griffo.io?
- 官方 Ubuntu:通常落后数月,缺少最新功能
- deb.griffo.io:发布后数小时内即可获取最新版本
- 手动安装:需要手动下载并配置 PATH
- 我们的仓库:预编译、开箱即用的软件包
- ✅ 最新功能:立即获取 Forgejo Runner 的最新功能和改进
- ✅ 无需手动配置:预编译二进制文件,通过 apt 安装和更新
- ✅ 自动更新:软件包在上游发布后数小时内更新
- ✅ 正确的依赖管理:正确打包所有必需的库
- ✅ 多发行版支持:支持 Jammy 和 Noble
- ✅ 易于维护:简单的 apt 命令即可完成更新
📦 软件包构建仓库
Ubuntu 软件包在此 GitHub 仓库中自动构建和维护:
- 📁 forgejo-runner-debian - Latest release builds
🔗 相关软件包
也可从 deb.griffo.io 获取:
💝 支持此项目
如果这个仓库为你节省了时间和精力,请考虑支持它!