由于这个是跑ci,所以首先要clone一手,不要在目前开发的项目上搞
然后阅读 Adding self-hosted runners - GitHub Docs ,给测试机配一下(需要有两台机器哦!原因如下)
不想用自己的日常电脑跑任务(怕影响性能、怕环境被搞乱),就单独拿一台闲置的电脑 / 服务器当专用运行器,自己日常开发用另一台。
要部署到正式服务器,不会直接让 GitHub Actions 连生产机,而是用一台中间的运行器来中转,避免直接暴露生产环境。
然后上面提到的github给的文档已经落后太多版本了!导致很多操作位置都变了(无语
在项目里面找actions 然后二选一运行模式(这些操作是在测试机哦!)
| 模式 | 运行机器 | 特点 | 是否需要额外机器 |
|---|---|---|---|
| GitHub 托管运行器 | GitHub 提供的云服务器(临时) | 开箱即用,免费额度够用,适合大部分项目 | ❌ 不需要你额外准备机器 |
| 自托管运行器 | 你自己的电脑 / 服务器 | 用你自己的机器跑任务,适合特殊环境、内网项目 |
有条件的情况下选自托管
但是前提是!!!项目管理者要给你很高的权限!不然你是搞不了workflows的

然后大差不差
一、先确认你要在哪台机器上跑
你当前选的是 macOS + x64,这些命令是给 macOS 系统用的。
- 如果你的电脑是 Mac:直接用这些命令
- 如果是 Windows/Linux:点一下页面上方的
Windows/Linux标签,会自动生成对应系统的命令
二、按顺序执行这些命令(macOS 为例)
1. 新建一个文件夹并进入
bash
mkdir actions-runner && cd actions-runner
这一步会在当前目录创建一个 actions-runner 文件夹,所有文件都存在这里,方便管理。
2. 下载运行器安装包
bash
curl -o actions-runner-osx-x64-2.334.0.tar.gz -L https://github.com/actions/runner/releases/download/v2.334.0/actions-runner-osx-x64-2.334.0.tar.gz
这一步会从 GitHub 下载官方的运行器程序包,你不用管版本号,页面上的命令已经自动帮你填好了最新版本。
3. (可选)校验文件完整性
bash
echo "73a979ff7e9ce8a70244f3a959d896870be486fac92bb08ed90684f961474e0d actions-runner-osx-x64-2.334.0.tar.gz" | shasum -a 256 -c
这一步用来验证下载的文件没被篡改,输出 OK 就说明没问题。如果提示错误,说明下载失败了,需要重新执行第 2 步。
4. 解压安装包
bash
tar xzf ./actions-runner-osx-x64-2.334.0.tar.gz
把压缩包解压到当前文件夹里,解压后会出现一堆脚本文件。
三、配置并注册到 GitHub(关键步骤)
执行配置脚本,把你的机器和仓库绑定:
bash
./config.sh --url https://github.com/RoboPocket/Ardc2 --token BZ5LQ4G26Z3H7Q5PDSBQ2LJ6NNF6
--url:你的仓库地址,页面上已经自动填好了--token:GitHub 给你的一次性注册令牌,有效期很短,页面上也帮你生成好了
执行完这个命令,会出现几个选项:

- 给运行器起个名字(默认是你电脑的主机名,直接回车就行)
- 给运行器加标签(默认是
self-hosted,也可以加自定义标签,直接回车) - 要不要给运行器分配到某个组(默认就行,直接回车)
全部回车走完,就注册成功了!
四、启动运行器,让它开始干活
bash
./run.sh
执行这个命令,运行器就会启动,开始监听 GitHub 上的任务了。
- 窗口会一直挂着,只要不关闭,它就会一直运行
- 你可以在 GitHub 页面看到它的状态变成「Idle(空闲)」,说明已经在线了
为什么clone在开发机 运行器可以在测试机呢?
因为我们触发器可以改为push,至于触发器可以看上一篇,所以整体来看是靠着github桥接的
所以现在回到开发机 ,去 clone 项目 → 修改 workflows 里的 yaml 文件 → 推送到 GitHub,任务就会自动在测试机上跑了。