LoongArch64 (loong64) 龙芯 基于 Docker 安装配置 GitHub Actions Runner

说明

该话题是为了解决某些系统无法运行 GitHub Actions Runner 的情况

[actions-runner@anolis actions-runner]$ ./run.sh 
/srv/actions-runner/bin/Runner.Listener: /lib64/libstdc++.so.6: version `GLIBCXX_3.4.32' not found (required by /srv/actions-runner/bin/Runner.Listener)
Runner listener exit with terminated error, stop the service, no retry needed.
Exiting runner...
[actions-runner@anolis actions-runner]$ 

docker-compose.yml

已经集成了 Docker 客户端

已经集成了 sudo 命令

如果需要运行 Docker,可以将宿主机的 docker.sock 挂载到容器内,更多 Docker 用法见:Docker 命令

services:
  actions-runner:
    image: registry.cn-qingdao.aliyuncs.com/kubernetesloong64/actions-runner-loong64:v2.335.1-debian-slim
    container_name: actions-runner
    restart: always
    volumes:
      - /run/docker.sock:/run/docker.sock
    environment:
      GITHUB_TOKEN: # Token
      GITHUB_URL: # 项目地址
      RUNNER_NAME: # Runner 名称

部署

docker compose up -d

容器日志

[root@anolis ~]# docker logs -f actions-runner 
Mon Aug  3 10:32:52 UTC 2026 - Configuring runner: test-1
Mon Aug  3 10:32:52 UTC 2026 - GitHub URL: https://github.com/kubernetes-loong64/actions-runner-loong64

--------------------------------------------------------------------------------
|        ____ _ _   _   _       _          _        _   _                      |
|       / ___(_) |_| | | |_   _| |__      / \   ___| |_(_) ___  _ __  ___      |
|      | |  _| | __| |_| | | | | '_ \    / _ \ / __| __| |/ _ \| '_ \/ __|     |
|      | |_| | | |_|  _  | |_| | |_) |  / ___ \ (__| |_| | (_) | | | \__ \     |
|       \____|_|\__|_| |_|\__,_|_.__/  /_/   \_\___|\__|_|\___/|_| |_|___/     |
|                                                                              |
|                       Self-hosted runner registration                        |
|                                                                              |
--------------------------------------------------------------------------------

# Authentication

√ Connected to GitHub

# Runner Registration

√ Runner successfully added

# Runner settings

√ Settings Saved.

Mon Aug  3 10:33:01 UTC 2026 - Runner configured successfully
Mon Aug  3 10:33:01 UTC 2026 - Starting runner...

√ Connected to GitHub

Current runner version: '2.335.1'
2026-08-03 10:33:10Z: Listening for Jobs
Runner update failed: A package with type agent, platform linux-loongarch64, version 2.336.0 was not found.
Runner update process finished.

使用示例

示例日志

docker logs -f actions-runner
[root@anolis ~]# docker logs -f actions-runner 
Mon Aug  3 10:32:52 UTC 2026 - Configuring runner: test-1
Mon Aug  3 10:32:52 UTC 2026 - GitHub URL: https://github.com/kubernetes-loong64/actions-runner-loong64

--------------------------------------------------------------------------------
|        ____ _ _   _   _       _          _        _   _                      |
|       / ___(_) |_| | | |_   _| |__      / \   ___| |_(_) ___  _ __  ___      |
|      | |  _| | __| |_| | | | | '_ \    / _ \ / __| __| |/ _ \| '_ \/ __|     |
|      | |_| | | |_|  _  | |_| | |_) |  / ___ \ (__| |_| | (_) | | | \__ \     |
|       \____|_|\__|_| |_|\__,_|_.__/  /_/   \_\___|\__|_|\___/|_| |_|___/     |
|                                                                              |
|                       Self-hosted runner registration                        |
|                                                                              |
--------------------------------------------------------------------------------

# Authentication

√ Connected to GitHub

# Runner Registration

√ Runner successfully added

# Runner settings

√ Settings Saved.

Mon Aug  3 10:33:01 UTC 2026 - Runner configured successfully
Mon Aug  3 10:33:01 UTC 2026 - Starting runner...

√ Connected to GitHub

Current runner version: '2.335.1'
2026-08-03 10:33:10Z: Listening for Jobs
Runner update failed: A package with type agent, platform linux-loongarch64, version 2.336.0 was not found.
Runner update process finished.

2026-08-03 10:34:06Z: Running job: checkout-v7
2026-08-03 10:34:23Z: Job checkout-v7 completed with result: Succeeded
2026-08-03 10:34:27Z: Running job: os-release
2026-08-03 10:34:40Z: Job os-release completed with result: Succeeded
2026-08-03 10:34:43Z: Running job: checkout-v5
2026-08-03 10:35:01Z: Job checkout-v5 completed with result: Succeeded
2026-08-03 10:35:04Z: Running job: checkout-v3
2026-08-03 10:35:22Z: Job checkout-v3 completed with result: Succeeded
2026-08-03 10:35:25Z: Running job: checkout-v4
2026-08-03 10:35:42Z: Job checkout-v4 completed with result: Succeeded
2026-08-03 10:35:46Z: Running job: checkout-v6
2026-08-03 10:36:04Z: Job checkout-v6 completed with result: Succeeded

使用 root 用户进入容器内

docker exec -it --user root actions-runner bash

相关文档