1Panel-Appstore/apps/forgejo-runner

Forgejo Actions Runner

Forgejo Actions Runner 是 Forgejo 的官方运行器组件，用于执行 CI/CD 工作流中的各类任务。它与 Forgejo Actions 系统集成，支持本地或远程运行任务，帮助用户构建自动化 DevOps 流程。

适合希望完全自托管 CI/CD 流水线的个人或组织部署使用。

✨ 特性

• 与 Forgejo Actions 完全集成
• 支持自定义容器或直接在主机运行
• 多 Runner 支持并行执行
• 支持 amd64 / arm64 等架构
• 简单易用，部署轻量

⚙️ 快速开始（Docker 部署）

1. 启动 Forgejo 主服务（略）

确保 Forgejo 主程序已部署并启用了 Actions 功能。

2. 运行 Action Runner 容器

docker run -d --name forgejo-runner \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /opt/runner:/data \
  codeberg.org/forgejo/runner:latest

3. 初始化注册

首次运行后，进入容器进行注册：

docker exec -it forgejo-runner forgejo-runner register

你需要提供：

• Forgejo 实例 URL（例如 https://git.example.com）
• Runner Token（从仓库或组织设置中获取）
• 运行模式（Docker / shell 等）
• 标签（可选，便于任务调度）

🔄 自动启动示例（Docker Compose）

version: '3'
services:
  forgejo-runner:
    image: codeberg.org/forgejo/runner:latest
    container_name: forgejo-runner
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./runner-data:/data
    restart: unless-stopped

📘 文档与资源

• 项目主页：https://forgejo.org/docs/latest/admin/actions/
• 源码仓库：https://code.forgejo.org/forgejo/runner

🧑‍🤝‍🧑 关于 Forgejo Runner

Forgejo Runner 是社区主导的 CI 执行器，致力于提供安全、可控、可扩展的构建环境。它是 Forgejo 构建完整 DevOps 生态的重要组成部分。