热门搜索:
mattermost/actions-runner
mattermost
该运行器是用于执行GitHub Actions工作流中作业的应用程序。
1 次收藏下载次数: 0状态：社区镜像维护者：mattermost仓库类型：镜像最近更新：1 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
GitHub Actions Runner 镜像文档
镜像概述
GitHub Actions Runner 镜像是用于执行GitHub Actions工作流中作业的容器化应用程序，是GitHub Actions生态系统的核心组件之一。它负责接收并运行工作流文件中定义的自动化任务，支持各类CI/CD操作，如代码构建、测试执行、应用部署等，为软件开发流程提供自动化执行环境。
核心功能与特性
- 工作流作业执行：接收并执行GitHub仓库中定义的GitHub Actions工作流作业，支持YAML配置文件中指定的所有步骤和命令
- GitHub Actions集成：与GitHub平台无缝对接，自动接收作业分配、汇报执行状态及结果
- 容器化隔离：以Docker容器形式运行，提供独立的执行环境，避免与主机系统或其他任务产生环境冲突
- 跨平台兼容性：支持在主流操作系统（Linux、Windows、macOS）的Docker环境中部署运行
- 资源可控：可通过Docker配置限制CPU、内存等资源使用，适应不同规模的任务需求
使用场景与适用范围
- 个人项目自动化：用于个人GitHub仓库的CI/CD流程，实现代码提交后的自动构建、测试和部署
- 团队协作开发：在团队项目中统一执行环境，确保所有成员的工作流在一致条件下运行
- 企业级DevOps：满足企业内部对自动化流程的定制化需求，可部署在私有环境中保障数据安全
- 多任务并行处理：通过部署多个Runner实例，支持同时执行多个工作流作业，提升自动化效率
- 特殊环境需求：为需要特定依赖或工具版本的工作流提供定制化执行环境
使用方法与配置说明
前提条件
- 已安装Docker引擎（推荐版本20.10及以上）
- 拥有GitHub账号及目标仓库的管理员权限（用于获取Runner注册令牌）
- 网络环境可访问GitHub API服务（https://api.github.com%EF%BC%89
Docker运行命令示例
通过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配置示例
创建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注册令牌
- 进入GitHub仓库 → Settings → Actions → Runners
- 点击 New self-hosted runner，选择操作系统类型为Linux
- 在"Download"步骤后，复制"Configure"部分的临时注册令牌（格式为
AXXXXXXX...）
2. 启动与注册
启动容器后，Runner会自动使用提供的REPO_URL和RUNNER_TOKEN完成注册，注册成功后可在GitHub仓库的Runner列表中看到该实例，状态显示为"Idle"
3. 状态监控与管理
- 查看容器日志：
docker logs -f github-actions-runner - 停止Runner：
docker stop github-actions-runner - 注销Runner：在GitHub仓库Runner列表中找到对应实例，点击Remove
注意事项
- 注册令牌有效期为60分钟，过期后需重新生成并更新环境变量
- 生产环境建议使用持久化卷（Volume）挂载工作目录，避免容器重启后丢失作业数据
- 确保容器时间与GitHub服务器时间同步，避免因时间偏差导致的认证问题
- 定期更新镜像版本（
docker pull github/runner:latest）以获取安全更新和功能改进 - 敏感环境中建议限制容器网络访问，仅允许与GitHub API及必要服务通信
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 actions-runner 镜像标签
docker pull docker.xuanyuan.run/mattermost/actions-runner:<标签>
DockerHub 原生拉取命令
docker pull mattermost/actions-runner:<标签>
更多 actions-runner 镜像推荐
airbyte/actions-runner
airbyte
暂无描述
1万+ 次下载
2 年前更新
summerwind/actions-runner
summerwind
暂无描述
14 次收藏1000万+ 次下载
1 个月前更新
settlemint/actions-runner
settlemint
暂无描述
10万+ 次下载
3 年前更新
shirkevich/actions-runner
shirkevich
暂无描述
5万+ 次下载
3 年前更新
appellation/actions-runner
appellation
暂无描述
5万+ 次下载
6 年前更新
tmnkgwa4/actions-runner
tmnkgwa4
暂无描述
1万+ 次下载
6 年前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"