alexbocharov/github-runner

GitHub Actions Runner

GitHub Actions Runner Docker镜像包含Docker CLI和Docker Compose（2.283.1+），用于在自托管环境中运行GitHub Actions工作流，支持组织和仓库级别的部署配置。

构建状态

标签列表

Linux镜像

核心功能和特性

• 内置Docker CLI和Docker Compose（2.283.1+），支持容器化工作流
• 支持组织级和仓库级两种部署模式
• 基于Ubuntu 20.04（focal）和22.04（jammy）系统，提供稳定运行环境
• 可通过环境变量灵活配置运行器参数
• 支持自定义运行器名称、标签和工作目录

使用场景和适用范围

• 自托管CI/CD环境，需要运行GitHub Actions工作流
• 需要在工作流中使用Docker构建和运行容器的场景
• 组织或仓库专属的私有运行器需求
• 对运行环境有特定配置要求的工作流

使用方法和配置说明

运行容器

组织级运行器

bash
docker run -d --restart always --name github-runner \
  -e RUNNER_NAME="your-runner-name" \
  -e GITHUB_ACCESS_TOKEN="your-github-access-token" \
  -e RUNNER_GROUP="your-runner-group" \
  -e RUNNER_ORGANIZATION_URL="https://github.com/your-org" \
  -e RUNNER_LABELS="your-runner-labels,your-other-runner-labels" \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /tmp:/tmp \
  alexbocharov/github-runner:${TAG}

仓库级运行器

bash
docker run -d --restart always --name github-runner \
  -e RUNNER_NAME="your-runner-name" \
  -e GITHUB_ACCESS_TOKEN="your-github-access-token" \
  -e RUNNER_GROUP="your-runner-group" \
  -e RUNNER_REPOSITORY_URL="https://github.com/your-repo" \
  -e RUNNER_LABELS="your-runner-labels,your-other-runner-labels" \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /tmp:/tmp \
  alexbocharov/github-runner:${TAG}

环境变量

以下环境变量用于控制运行器配置参数：

许可证

该Docker镜像基于MIT许可证发布。

许可详情

反馈

请在GitHub Issues中报告问题或提出建议。