什么是 Forgejo Runner？
Forgejo Runner 是 Forgejo Actions 的CI 运行器。它是一个轻量级守护进程，连接到您的 Forgejo 实例，获取排队中的工作流任务，并在您自己的基础设施上执行——可使用 Docker、LXC 或直接在主机上运行——为您提供完全自托管、兼容 GitHub Actions 的 CI/CD 流水线。
🚀 为什么最新版本很重要：该运行器紧跟 Forgejo 的版本发布，持续加入对新工作流功能的支持、更好的隔离机制以及错误修复。保持最新可确保与最新的 Forgejo Actions 功能兼容。
⚡ Forgejo Runner 的核心功能
🔁 兼容 Actions
使用与 GitHub Actions 相同的语法和 action 生态系统运行工作流。
🐳 灵活执行
可在 Docker 容器、LXC 中执行任务，或直接在主机上运行。
🔐 自托管
将您的 CI/CD 完全保留在自己的基础设施上，无需依赖任何第三方。
⚖️ 可扩展
注册多个带标签的运行器，以分发和定向工作负载。
🎯 为什么选择 Forgejo Runner？
- 掌控您的 CI：在您掌控的硬件上运行流水线
- Actions 生态系统：复用现有的 GitHub 风格工作流定义
- 灵活隔离：Docker、LXC 或主机执行，满足您的不同需求
- 轻量级：单个 Go 二进制文件，部署简单
🆕 主要亮点
- 任务执行：运行排队中的 Forgejo Actions 工作流
- 标签：将任务定向到指定运行器
- 容器支持：通过 Docker 实现隔离构建
- 守护进程模式：作为服务持续运行
📦 从 deb-free.griffo.io 安装
步骤 1：添加仓库
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
sudo apt update
install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
apt update
步骤 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
# Start the runner daemon
forgejo-runner daemon
🚀 为什么选择 deb-free.griffo.io？
📊 仓库对比：
- 官方 Ubuntu：通常落后数月，缺少最新功能
- deb.griffo.io（主仓库）：发布后数小时内即可获取最新版本
- 手动安装：需要手动下载并配置 PATH
- 我们的仓库：预编译、开箱即用的软件包
- ✅ 最新功能：Forgejo Runner 的最新版本最多延迟上游 2 个月，安全修复立即发布
- ✅ 无需手动配置：预编译二进制文件，通过 apt 安装和更新
- ✅ 自动更新：通过 apt upgrade 自动获取免费通道的最新构建
- ✅ 正确的依赖管理：正确打包所有必需的库
- ✅ 多发行版支持：支持 Jammy 和 Noble
- ✅ 易于维护：简单的 apt 命令即可完成更新
📦 软件包构建仓库
Ubuntu 软件包在此 GitHub 仓库中自动构建和维护：
- 📁 forgejo-runner-debian - Latest release builds
🔗 相关软件包
也可从 deb-free.griffo.io 获取：
🎯 适用人群：自托管 Forgejo 的团队和个人用户，希望运行自己的 CI/CD 流水线，并完全掌控构建环境和基础设施。
💝 支持此项目
如果这个仓库为您节省了时间和精力，请考虑支持它！