自建 GitHub Actions runner 这件事,动手之前值得先算一笔账:一台 2 核 4G 的便宜 VPS,能不能真的替掉每月几十美元的托管 runner 额度?答案取决于你的工作流在跑什么——是几分钟就结束的 lint 与构建,还是动辄二十分钟的 Docker 镜像编译与端到端测试。这两类负载对 CPU、磁盘与内存的要求差别巨大,选错规格的结果是任务排队、构建超时、磁盘写满。
这篇按”跑得动”与”跑得省”两条线来讲:先看自建 runner 的真实资源消耗在哪,再给不同工作流类型的规格建议,最后是几个踩过才知道的坑——缓存、磁盘清理、并发控制、以及为什么不该把 runner 放在和生产同一台机器上。
先搞清楚自建 runner 消耗的是什么
GitHub 托管的 runner 是每次任务起一台干净虚拟机,任务结束就销毁;自建 runner 是一台长期在线的机器,反复跑任务。这个差别决定了两件事:一是磁盘会越用越满,因为依赖、缓存、镜像层、日志都留在本地;二是环境会被”污染”,上一个任务留下的文件与进程会影响下一个任务。
所以自建 runner 的资源瓶颈通常不在 CPU,而在磁盘与内存。一个带 Node 与 Docker 的项目,跑几十次之后本地镜像与缓存轻松占掉十几 GB;并发跑两个容器化任务,2GB 内存的机器就可能开始 swap,构建时间翻倍。判断自己的负载可以简单估算:单次任务峰值内存、单次任务产生的临时文件、以及每天的任务次数,三个数相乘大致就是需求。

规格怎么选:按工作流类型分三档
第一档是”轻量型”:只有 lint、单元测试、静态站点构建,单次任务几分钟内结束,不用 Docker。这类工作流 2 核 2G 就够,磁盘 40GB 能撑很久,关键是配好缓存与定期清理。第二档是”中等型”:带 Docker 构建、前端打包、多语言矩阵,单次任务十几分钟。这类建议 2 核 4G 起,磁盘至少 60GB,并且把 Docker 数据目录定期清理。
第三档是”重型”:编译大项目、跑端到端测试、构建多架构镜像。这类不适合放在便宜的小机上——编译吃 CPU 与内存,镜像构建吃磁盘,两者叠加很快把 4G 内存打满。真要自建就上 4 核 8G 起,或者干脆保留托管 runner 跑重型任务,自建只承担轻量与中等的部分。混合是最常见的做法:日常任务走自建省额度,重型任务用托管 runner 保证不拖慢发布。
| 工作流类型 | 建议规格 | 磁盘 | 注意事项 |
|---|---|---|---|
| lint / 单测 / 静态站构建 | 2 核 2G | 40GB | 配好依赖缓存与日志清理 |
| Docker 构建 / 前端打包 / 矩阵 | 2 核 4G | 60GB 起 | 定期 prune 镜像与构建缓存 |
| 大项目编译 / E2E / 多架构 | 4 核 8G 起 | 100GB 起 | 考虑保留托管 runner |
安装与注册的正确顺序
顺序是:先在 GitHub 侧生成注册令牌(组织或仓库级别都行),再在服务器上装依赖、创建专用用户、下载 runner 包、解压、配置、安装服务。用专用用户跑 runner 是硬要求,别用 root——任何一次恶意 PR 都能在 runner 上执行代码,root 等于把整台机器交出去。
配置时选对范围:仓库级别的 runner 只在那个仓库可用,组织级别的可以给多个仓库共用。小团队建议走组织级别,一台机器服务多个项目,利用率高;但要注意不同项目的依赖会互相污染,需要用容器或工作目录隔离。安装成系统服务之后,重启机器会自动拉起,别用 nohup 手动跑,机器一重启就断。
几个一定会踩的坑
第一个是磁盘写满。Docker 的镜像层、构建缓存、以及 actions/cache 的本地目录都会持续增长,最常见的表现是”某天开始所有任务都失败,报 no space left on device”。解决办法是加一条定时清理任务,定期执行 docker system prune 并把旧的构建目录删掉,同时给磁盘使用率加告警。
第二个是并发与资源竞争。一台 runner 默认一次只跑一个任务,如果你在设置里开了多并发而机器只有 2 核,两个任务会互相拖慢,最终双双超时。要么保持单并发,要么按 CPU 核数设置并发上限,并且给每个任务设超时。
第三个是网络与出网限制。runner 需要访问 GitHub 与各类包仓库,如果机器在受限网络里,会表现为”任务卡在下载依赖”。这类问题不是 runner 本身的问题,排查时先手动在机器上跑一遍相同的下载命令。站内那篇 Docker 私有部署的实操记录里对镜像拉取与网络排错有具体步骤,可以对照着看。

安全边界:为什么别和生产同机
runner 执行的是仓库里的代码,包括来自 PR 的代码。只要有人提了一个恶意 PR 并且触发了工作流,这段代码就会在你的服务器上运行。如果把 runner 和生产环境放在同一台机器上,等于把生产环境的钥匙交给了任何一个能提 PR 的人。
最低要求是分开:runner 单独一台机器,机器上不放生产数据、不放密钥,用专用用户运行,能出网的端口按需开放。进一步的做法是把 runner 放进容器或用虚拟机隔离,任务结束即销毁环境。这些做法会多花一点配置时间,但它决定的是”最坏情况下损失有多大”。想先看看基础加固怎么做,站内那篇 安全组端口配置把真正需要开放的端口讲得很清楚,runner 机器同样适用。
账单怎么算才不亏
自建的账不能只算机器钱。要加的是:机器月费、备份与快照、以及你自己花在维护 runner 上的时间。托管 runner 的账是:超出免费额度后的按分钟计费。判断方式很直接——统计一个月的总构建分钟数,乘以托管单价,与”机器月费 + 维护时间折算”对比,哪边低用哪边。
多数团队的结果是混合:日常轻量任务自建,重型与发布任务用托管。这样既压住了账单,又不会因为自建机器的性能瓶颈拖慢关键发布。如果决定自建,选一台网络稳定的便宜机器起步就够——Vultr 的按小时实例这类方案适合先跑一个月验证负载,确认规格合适再换成长期方案,避免一上来就买大配置空转。
成本复盘的三个数字
跑了三个月之后,判断该不该继续自建,看三个数字就够了:每月的总构建分钟数、单次任务的平均耗时、以及磁盘清理触发的频率。第一个数字决定你省了多少额度,第二个数字反映机器是否成为瓶颈(平均耗时持续上升就是信号),第三个数字说明维护成本有多高——如果每周都要上去清理磁盘,那省下的钱其实是拿你的时间换的。
把这三个数字记在同一张表里,连续看三个月,结论会自己浮出来:任务量在涨但平均耗时稳定,说明机器够用;任务量没变而耗时上升,说明该加内存或换盘;清理变频繁,说明缓存策略要调。这比凭感觉判断”要不要继续自建”可靠得多。
总结与行动建议
2 核 4G 的 VPS 能自建 GitHub Actions runner,但只适合轻量与中等负载;重型工作流留在托管 runner 更省心。决策顺序是:统计一个月的构建分钟与单次峰值资源 → 按工作流类型选规格 → 单独一台机器、专用用户、装成服务 → 配磁盘清理与并发上限 → 用一个月后的账单复盘。
行动上建议先做两件小事:把最容易失败的”磁盘写满”提前防住(定时清理 + 使用率告警),再把 runner 与生产彻底分开。这两件事做完,自建 runner 才算真正可用,而不是一个随时会炸的实验。
常见问题解答(FAQ)
Q1:一台 runner 能同时跑多个任务吗?
可以配置,但不建议超过 CPU 核数。2 核机器开两个并发就会互相拖慢,构建时间可能翻倍。更稳的做法是单并发 + 队列,或者按任务类型拆到多台机器。
Q2:自建 runner 还需要买托管额度吗?
多数团队建议保留一部分。托管 runner 适合重型任务与紧急发布,自建适合日常轻量任务。全砍掉托管额度,遇到大项目编译时容易被小机拖住。
Q3:磁盘总是写满怎么办?
三件事:清理 Docker 镜像与构建缓存、限制 actions/cache 的本地占用、把日志轮转打开。再加一条磁盘使用率告警,超过八成时提前处理,别等任务失败才发现。
Q4:runner 机器需要多大带宽?
构建类任务主要吃下载,带宽影响的是依赖拉取与镜像拉取的速度。普通 100Mbps 级别的机器通常够用;如果频繁构建大镜像,带宽与流量上限要提前确认,避免月底被限速。
Q5:能不能用 Windows 或 macOS 跑 runner?
可以,但成本与复杂度高得多。除非项目必须用特定系统构建,否则用 Linux 更省资源、更好维护。跨平台构建建议用托管 runner 或容器化方案。
Q6:runner 上能放敏感密钥吗?
尽量不放。密钥应该放在 GitHub Secrets 里,任务运行时注入,任务结束即失效。长期把密钥写在 runner 的文件里,等于给任何能执行代码的 PR 留下了读取机会。
原创文章,作者:WanKe,如若转载,请注明出处:https://wankewu.com/linux/2156.html
