下载 龙芯架构 GitHub Actions Runner
curl -LO https://github.com/loong64/runner/releases/download/v2.335.1/actions-runner-linux-loongarch64-2.335.1.tar.gz
解压
mkdir -p actions-runner
tar -zxvf actions-runner-linux-loongarch64-2.335.1.tar.gz -C actions-runner
检查
./actions-runner/externals/node20/bin/node -v
./actions-runner/externals/node24/bin/node -v
安装依赖
如果不安装依赖，可能会提示依赖缺失
Libicu's dependencies is missing for Dotnet Core 6.0
Execute sudo ./bin/installdependencies.sh to install any missing Dotnet Core 6.0 dependencies.
执行依赖安装
sudo ./bin/installdependencies.sh
在不同 Debian 系统中，软件名称可能不同，有些软件可能需要手动安装其他名称，详情见：installdependencies.sh: add fallback to libssl-dev / libicu-dev for Debian 14+ · Issue #4600 · actions/runner · GitHub
apt update
apt install -y libssl-dev libicu-dev ca-certificates
创建 GitHub Actions Runner 用户
不能使用 sudo 用户，否则提示
Must not run with sudo
执行创建用户
useradd -m actions-runner
# adduser actions-runner
文件夹授权
chown -R actions-runner:actions-runner ./actions-runner
配置 GitHub Actions Runner
GitHub 在项目中点击菜单：
Settings→Actions→Runners，点击按钮New runner→New self-hosted runner
GitHub 在组织中创建
New self-hosted runner，可能需要进行权限分配：Settings→Actions→Runner groups
不需要选择任何系统和架构：因为选择系统是提示对应系统下载软件的链接，此处我们需要使用上述龙芯架构的 GitHub Actions Runner，因为 GitHub 官方暂不支持龙芯架构
使用上述创建的普通用户
actions-runner执行下列命令：切换用户sudo su actions-runner
复制
./config.sh命令，在 actions-runner-linux-loongarch64-2.335.1.tar.gz 解压后的文件夹下运行即可
如果执行
./config.sh命令，提示：./bin/Runner.Listener: /lib64/libstdc++.so.6: version `GLIBCXX_3.4.32’ not found (required by ./bin/Runner.Listener) 等问题，可以在 Docker 容器中运行。如果要在 Actions 中使用 Docker 命令，可以参考：Docker 命令 中的 执行优先级
./config.sh --url https://github.com/项目地址 --token xxxxxx
actions-runner@debian-14:/srv/actions-runner$ ./config.sh --url https://github.com/项目地址 --token xxxxxx
--------------------------------------------------------------------------------
| ____ _ _ _ _ _ _ _ _ |
| / ___(_) |_| | | |_ _| |__ / \ ___| |_(_) ___ _ __ ___ |
| | | _| | __| |_| | | | | '_ \ / _ \ / __| __| |/ _ \| '_ \/ __| |
| | |_| | | |_| _ | |_| | |_) | / ___ \ (__| |_| | (_) | | | \__ \ |
| \____|_|\__|_| |_|\__,_|_.__/ /_/ \_\___|\__|_|\___/|_| |_|___/ |
| |
| Self-hosted runner registration |
| |
--------------------------------------------------------------------------------
# Authentication
√ Connected to GitHub
# Runner Registration
Enter the name of the runner group to add this runner to: [press Enter for Default]
Enter the name of runner: [press Enter for debian-14]
This runner will have the following labels: 'self-hosted', 'Linux', 'LOONGARCH64'
Enter any additional labels (ex. label-1,label-2): [press Enter to skip]
√ Runner successfully added
# Runner settings
Enter name of work folder: [press Enter for _work]
√ Settings Saved.
actions-runner@debian-14:/srv/actions-runner$
创建完成，显示离线：需要执行
./run.sh命令才能启动
启动 GitHub Actions Runner
./run.sh
actions-runner@debian-14:/srv/actions-runner$ ./run.sh
√ Connected to GitHub
Current runner version: '2.335.1'
2026-08-03 02:28:22Z: 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.
