GitHub Actions Runner 镜像是用于执行GitHub Actions工作流中作业的容器化应用程序,是GitHub Actions生态系统的核心组件之一。它负责接收并运行工作流文件中定义的自动化任务,支持各类CI/CD操作,如代码构建、测试执行、应用部署等,为软件开发流程提供自动化执行环境。
通过docker run直接启动Runner容器:
bashdocker run -d \ --name github-actions-runner \ -e REPO_URL="https://github.com/[用户名]/[仓库名]" \ -e RUNNER_TOKEN="[Runner注册令牌]" \ -e RUNNER_NAME="docker-runner-01" \ -e RUNNER_LABELS="docker,linux,x64" \ --restart unless-stopped \ github/runner:latest
创建docker-compose.yml文件:
yamlversion: '3.8' services: github-runner: image: github/runner:latest container_name: github-actions-runner environment: - REPO_URL=https://github.com/[用户名]/[仓库名] - RUNNER_TOKEN=[Runner注册令牌] - RUNNER_NAME=docker-runner-01 - RUNNER_LABELS=docker,linux,x64 - RUNNER_WORKDIR=/home/runner/work volumes: - runner-workdir:/home/runner/work restart: unless-stopped volumes: runner-workdir:
启动服务:
bashdocker-compose up -d
| 参数名称 | 环境变量名 | 描述 | 是否必填 | 默认值 |
|---|---|---|---|---|
| 仓库URL | REPO_URL | 目标GitHub仓库的HTTPS地址(格式:https://github.com/%E7%94%A8%E6%88%B7%E5%90%8D/%E4%BB%93%E5%BA%93%E5%90%8D%EF%BC%89 | 是 | - |
| 注册令牌 | RUNNER_TOKEN | 用于将Runner注册到仓库的临时令牌,从GitHub仓库设置中获取 | 是 | - |
| Runner名称 | RUNNER_NAME | 自定义Runner名称,用于在GitHub仓库的Runner列表中标识 | 否 | 自动生成的随机名称 |
| 标签 | RUNNER_LABELS | 为Runner添加的标签(逗号分隔),用于工作流中通过runs-on指定执行器 | 否 | - |
| 工作目录 | RUNNER_WORKDIR | Runner执行作业时的工作目录路径 | 否 | /home/runner/work |
| 日志级别 | RUNNER_LOG_LEVEL | 日志输出级别(debug/info/warn/error) | 否 | info |
1. 获取Runner注册令牌
AXXXXXXX...)2. 启动与注册
启动容器后,Runner会自动使用提供的REPO_URL和RUNNER_TOKEN完成注册,注册成功后可在GitHub仓库的Runner列表中看到该实例,状态显示为"Idle"
3. 状态监控与管理
docker logs -f github-actions-runnerdocker stop github-actions-runnerdocker pull github/runner:latest)以获取安全更新和功能改进您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。




探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务