blackoutsecure/github-runner

blackoutsecure/github-runner

镜像概述

本镜像为GitHub Actions Runner的非官方社区版本，基于LinuxServer.io容器模式构建（包含s6-overlay进程监督、强化默认配置），支持amd64/arm64多架构，提供Balena部署支持，由Blackout Secure维护，用于实现自托管的CI/CD运行环境。

核心功能

1. 多架构支持：自动适配amd64（x86-64）和arm64（ARM 64位）平台；
2. 运行器模式：支持临时（任务完成后销毁）和持久（通过/config卷保存配置）两种运行器类型；
3. 自动扩展：内置自动扩展脚本，可根据任务负载动态调整运行器数量；
4. Docker-in-Docker：支持容器内运行Docker任务，满足容器化构建需求；
5. 健康监控：自动检测运行器状态，断线时自动恢复；
6. 非root兼容：支持LinuxServer.io的非root用户模式（uid 911）。

使用场景

1. 私有仓库CI/CD：为企业私有GitHub仓库提供自托管构建环境；
2. 边缘设备部署：通过Balena平台在ARM设备（如树莓派）上部署运行器；
3. 动态扩展集群：针对高负载场景，自动调整运行器数量以优化资源利用；
4. 定制化构建：通过自定义脚本或包注入，满足特定构建环境需求。

配置说明

Docker部署示例

基础持久运行器

bash
docker run -d \
  --name=gh-runner \
  --restart unless-stopped \
  -e TZ=Asia/Shanghai \
  -e RUNNER_URL=https://github.com/你的用户名/你的仓库 \
  -e RUNNER_TOKEN=你的注册令牌 \
  -v runner-config:/config \
  docker.xuanyuan.run/blackoutsecure/github-runner:latest

Docker Compose（推荐）

yaml
version: "3.8"
services:
  gh-runner:
    image: docker.xuanyuan.run/blackoutsecure/github-runner:latest
    container_name: gh-runner
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai
      - RUNNER_URL=https://github.com/你的用户名/你的仓库
      - RUNNER_TOKEN=你的注册令牌
      - RUNNER_NAME=my-self-hosted-runner
    volumes:
      - runner-config:/config

volumes:
  runner-config:

关键参数

• 环境变量：
  • RUNNER_URL：GitHub仓库或组织的URL（如https://github.com/owner/repo）；
  • RUNNER_TOKEN：GitHub生成的注册令牌（用于绑定运行器）；
  • TZ：时区设置（如Asia/Shanghai）；
  • RUNNER_SUDO：是否允许运行器使用sudo（默认true）；
  • RUNNER_ROLE：运行器角色（runner默认，autoscaler为自动扩展模式）。
• 卷：
  • /config：保存运行器配置的持久化卷（用于持久运行器）。

注意事项

• 若启用--security-opt no-new-privileges:true，需同时设置RUNNER_SUDO=false，否则会导致sudo命令失效；
• 生产环境建议使用固定版本标签（如2.333.1）而非latest，确保稳定性；
• 自动扩展模式需配置相关环境变量（如AUTOSCALE_MIN、AUTOSCALE_MAX）以控制运行器数量范围。