cloudtokstok/github-runner
cloudtokstok
GitHub自托管运行器的自定义运行器，集成多种开发工具与系统工具，适用于扩展自托管运行器功能，支持CI/CD流程及各类自动化任务。
下载次数: 0状态：社区镜像维护者：cloudtokstok仓库类型：镜像最近更新：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自托管运行器自定义镜像
概述
该镜像为GitHub自托管运行器（GitHub Self Hosted Runners）提供自定义运行环境，集成了丰富的开发工具、系统工具及自动化工具，旨在扩展自托管运行器的功能，满足多样化CI/CD流程和自动化任务需求。
核心功能与特性
集成工具列表
- 开发工具：build-essential（编译工具集）、git（版本控制）、python3-pip（Python包管理）、ansible（自动化配置工具）、gh（GitHub CLI）
- 系统工具：curl（HTTP客户端）、wget（文件下载工具）、ca-certificates（证书管理）、dnsutils（DNS工具）、iproute2（网络配置）、iputils-ping（ping工具）、iptables（防火墙配置）、netcat（网络工具）、net-tools（网络实用工具）、openssh-client（SSH客户端）、rsync（文件同步）、telnet（远程登录）
- 辅助工具：jq（JSON处理）、shellcheck（Shell脚本检查）、parallel（并行执行）、sudo（权限管理）、tzdata（时区数据）、unzip/zip（压缩工具）、upx（可执行文件压缩）、zstd（高效压缩算法）、locales（本地化支持）、time（计时工具）、ftp（FTP客户端）、libunwind8（ unwind库）、software-properties-common（软件源管理）
使用场景与适用范围
- 自定义CI/CD环境：适用于需要特定工具链的GitHub Actions工作流，如编译、测试、部署等场景
- 自动化任务：支持通过ansible、shell脚本等实现服务器配置、应用部署等自动化操作
- 企业内部环境：满足企业自托管GitHub运行器对工具多样性和环境定制化的需求
使用方法与配置说明
基本部署（docker run）
bashdocker run -d \ --name github-runner \ -e RUNNER_NAME="custom-runner-01" \ -e RUNNER_TOKEN="YOUR_RUNNER_TOKEN" \ -e RUNNER_REPOSITORY_URL="https://github.com/your-org/your-repo" \ -e RUNNER_WORKDIR="/home/runner/work" \ docker.xuanyuan.run/your-image-name:tag
环境变量说明
| 环境变量 | 描述 | 是否必填 |
|---|---|---|
RUNNER_NAME | 运行器名称，用于在GitHub仓库中标识该运行器 | 是 |
RUNNER_TOKEN | 注册运行器的令牌，从GitHub仓库的「设置 > Actions > 自托管运行器」获取 | 是 |
RUNNER_REPOSITORY_URL | 目标GitHub仓库URL（如https://github.com/your-org/your-repo） | 是 |
RUNNER_WORKDIR | 运行器工作目录，默认为/home/runner/work | 否 |
TZ | 时区设置（如Asia/Shanghai），默认为UTC | 否 |
docker-compose配置示例
yamlversion: '3.8' services: github-runner: image: docker.xuanyuan.run/your-image-name:tag container_name: github-runner environment: - RUNNER_NAME=custom-runner-01 - RUNNER_TOKEN=YOUR_RUNNER_TOKEN - RUNNER_REPOSITORY_URL=https://github.com/your-org/your-repo - RUNNER_WORKDIR=/home/runner/work - TZ=Asia/Shanghai restart: unless-stopped
注意事项
- 运行器令牌（
RUNNER_TOKEN）具有时效性，需从GitHub仓库获取最新令牌 - 确保容器具有足够的资源（CPU/内存）以支持目标任务运行
- 如需持久化工作目录，可通过挂载卷（
-v /host/path:/home/runner/work）实现
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 github-runner 镜像标签
docker pull docker.xuanyuan.run/cloudtokstok/github-runner:<标签>
DockerHub 原生拉取命令
docker pull cloudtokstok/github-runner:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"