cloudtokstok/github-runner Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

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）

bash
docker run -d \
  --name github-runner \
  -e RUNNER_NAME="custom-runner-01" \
  -e RUNNER_TOKEN="YOUR_RUNNER_TOKEN" \
  -e RUNNER_REPOSITORY_URL="[***]" \
  -e RUNNER_WORKDIR="/home/runner/work" \
  your-image-name:tag

环境变量说明

docker-compose配置示例

yaml
version: '3.8'
services:
  github-runner:
    image: your-image-name:tag
    container_name: github-runner
    environment:
      - RUNNER_NAME=custom-runner-01
      - RUNNER_TOKEN=YOUR_RUNNER_TOKEN
      - RUNNER_REPOSITORY_URL=[***]
      - RUNNER_WORKDIR=/home/runner/work
      - TZ=Asia/Shanghai
    restart: unless-stopped

注意事项

1. 运行器令牌（RUNNER_TOKEN）具有时效性，需从GitHub仓库获取最新令牌
2. 确保容器具有足够的资源（CPU/内存）以支持目标任务运行
3. 如需持久化工作目录，可通过挂载卷（-v /host/path:/home/runner/work）实现