本文由 壹贰线报 首发于 壹贰云测评 公众号,事实均以 GitHub 官方文档为准(核实时点:2026 年 11 月)
一句话讲清它能干嘛
GitHub Actions — 公共仓库免费,私有仓库每月 2000 分钟,可以跑任意语言的测试、构建矩阵、跨平台构建,并支持接入自托管运行器(Self-hosted Runner)把自己的机器拉进来当构建节点,跑掉配额、跑大规格 GPU/ARM 都免费。
它是 GitHub 官方原生 CI/CD:代码一 push 就触发,YAML 写流水线,跑在 Linux / Windows / macOS 三种官方 Runner 上;也能接入自己的服务器、树莓派、K8s 集群做 Runner,分钟数一分不扣。全球数百万开源项目都在它上面跑测试、发版、构建镜像、部署到云。
免费额度能做多少事
能力项 | 免费额度(私有仓库) | 公共仓库 | 备注 |
|---|---|---|---|
GitHub 托管 Runner(Linux 2核) | 2,000 分钟/月 | 不限量、全免费 | 包含 macOS Runner 也全免费 |
存储(Artifact+Cache) | 500 MB,按 GB-Hour 计 | 不限 | 缓存不占 Artifact 配额 |
并发任务 | 20 个 | 20 个 | Free 账号 |
自托管 Runner | 永久免费、不扣分钟 | 永久免费 | Runner 版本需≥v2.329.0 |
支持操作系统 | Ubuntu/Windows/macOS(含 Apple Silicon) | 同左 | 分钟乘数 1×/2×/10× |
Marketplace Actions | 20,000+ 个全部可用 | 全部可用 | 第三方 Action 生态 |
矩阵构建(matrix) | 不限 | 不限 | 多 Node 版本/多 OS 并行 |
Secrets 密钥管理 | 无限 Secrets | 无限 Secrets | 环境级加密+OIDC 联邦 |
Environments 审批 | 全部可用 | 全部可用 | 生产环境人工门禁 |
定时触发(schedule cron) | 可用 | 可用 | 注意 UTC 时区 |
Reusable Workflow | 支持 | 支持 | 工作流复用 |
Pages/Releases/Packages | 打通 | 打通 | 一键部署 |
自托管 GPU/大内存 | 不限(自带机器) | 不限 | 版本管理需自己运维 |
Copilot Code Review | 消耗 Actions 分钟 | 消耗分钟 | 不是独立额度 |
数据中心 | 美国/欧洲/亚太 | 同左 | 国内访问约 200-400ms |
📌 上手前要看的 4 个细节
分钟是"加权分钟"不是真实分钟:Linux 2核=1×、Windows 2核=2×、macOS Intel/Apple Silicon=10×;三平台矩阵并行一次 = 1+2+10 = 13 分钟消耗,macOS 任务非常吃额度;2026-01-01 新单价 Linux $0.006/min、Windows $0.010/min、macOS $0.062/min;
500 MB 是 Artifact+Cache 共享存储,采用 GB-Hour 计费(0.5GB × 30天 × 24h = 360 GB-Hour/月),默认保留 90 天,不设 retention-days 极容易 7 天内打满锁流水线;私有仓库 retention 最小可设 1 天,公共仓库最大 90 天;
自托管 Runner 真·永久免费不扣分钟,可以跑 GPU/ARM/大内存任意规格;但 2026 年起 Runner 版本管理是日常运维——新注册 Runner 必须≥v2.329.0(2026-09-25 起执行),已有 Runner 超新版本发布 30 天没升级会停止接任务(当前最新 v2.337.0),2026-09-23 起 Runner 内 Node 20 已移除、JS Action 必须支持 Node 24,ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION 开关失效;
2026-12-02 重要安全变更:公共仓库默认拦截
pull_request_target触发器(除非 Actions 事件策略明确放行),用来阻断 "pwn request" 供应链攻击——PR 作者代码不能借该触发器拿到仓库密钥,fork PR 的打标签/自动评论需拆分工作流或切到pull_request。
🎁 两个隐藏福利:
Copilot Code Review 共用 Actions 分钟:PR 自动 AI Review 不单独计费;
Actions Cache 不占 Artifact 存储配额:node_modules / pip cache / Maven 依赖走 Cache 免费加速构建,不会挤占 500MB Artifact 额度。
为什么免费版值得上手
🔧 全语言+全生态支持:Node.js/Python/Go/Java/Rust/Docker/.NET 全都能跑,Marketplace 20,000+ Action 直接复用,无需自己写发布脚本
🧱 矩阵构建原生支持:
strategy.matrix一次定义多个 Node 版本+多个 OS,并行测试同时完成,不用串行等🔐 Secrets + OIDC 免密钥:仓库/环境级加密 Secrets,支持 AWS/GCP/Azure OIDC 联邦身份,不用长期 AK/SK
🚪 Environments 审批门禁:production 环境强制人工 review 后再部署,适合团队上线流程
⏰ Cron 定时触发:支持 schedule 定时任务(UTC 时区注意换算),能做日报/备份/AI Agent 定时任务
📦 Reusable Workflow 复用:多个仓库共用同一份 CI 模板,一处修改全组织生效
🤖 自托管 Runner 永久 0 成本:接入自己的物理机/云主机/树莓派/K8s(ARC),跑 GPU 训练、ARM 构建、大内存构建都不扣分钟
⚡ Cache 依赖缓存:npm/pip/Maven/Go mod 依赖缓存到 Actions Cache,下次构建秒级启动,Cache 不占 Artifact 配额
🔗 GitHub 全家桶打通:Pages 部署/Releases 发版/Packages 镜像/Issues/PR 评论/Security Advisories 一条流水线打通
🪪 开源项目全免费:公共仓库 GitHub 托管 Runner 连 macOS 都全免费,是开源 CI 的事实标准
上手 4 步走
Step 1:在仓库新建 workflow 文件
mkdir -p .github/workflows
Step 2:写一个最小 CI(npm install + test + build + 三平台矩阵)
.github/workflows/ci.yml:
name: CI
on:
push:
branches: [main]
pull_request:
branches: [main]
jobs:
build:
runs-on: ${{ matrix.os }}
strategy:
matrix:
os: [ubuntu-latest, windows-latest, macos-latest]
node: [18, 20, 22]
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: ${{ matrix.node }}
cache: 'npm'
- run: npm ci
- run: npm test
- run: npm run build
- uses: actions/upload-artifact@v4
if: matrix.os == 'ubuntu-latest' && matrix.node == '20'
with:
name: dist
path: dist/
retention-days: 1 # ← 关键:免费档设 1 天,500MB 才不会爆
Step 3:接自托管 Runner(永久免费不扣分钟)
Settings → Actions → Runners → New self-hosted runner,按系统选指令(Linux 为例):
# 在你的服务器/树莓派上执行
mkdir actions-runner && cd actions-runner
curl -o actions-runner-linux-x64-2.337.0.tar.gz -L \
https://github.com/actions/runner/releases/download/v2.337.0/actions-runner-linux-x64-2.337.0.tar.gz
tar xzf ./actions-runner-linux-x64-2.337.0.tar.gz
./config.sh --url https://github.com/你的用户名/你的仓库 --token <REGISTRATION_TOKEN>
./run.sh # 前台跑;安装成服务用 sudo ./svc.sh install && sudo ./svc.sh start
workflow 里把 runs-on: ubuntu-latest 改成 runs-on: self-hosted 就可以了。
Step 4:配置 OIDC 免 AK/SK 部署到云(以 AWS 为例)
permissions:
id-token: write
contents: read
steps:
- uses: aws-actions/configure-aws-credentials@v4
with:
role-to-assume: arn:aws:iam::123456789012:role/github-actions-role
aws-region: cn-north-1
3 个避坑提醒
分钟乘数别忽视:macOS 10×,免费 2000 分钟跑 macOS 只能跑 200 真实分钟(≈3.3小时),矩阵里加 macOS 任务前先算一下;
Artifact retention-days 默认 90 天是陷阱:每天 build 一次存 10MB 构建产物,90 天就是 900MB,7 天内就会爆 500MB 额度导致流水线 429 锁死;所有 artifact 都建议显式写 retention-days: 1~7;
自托管 Runner 必须及时升级:低于 v2.329.0 的 Runner 2026-09-25 起停止接任务,发布 30 天内必须升级;JS Action 必须支持 Node 24,老 Action 跑不了。
适合 / 不适合谁
✅ 适合:
GitHub 上的开源项目(直接免费无限跑)
个人私有项目、独立开发者的小团队(2000 Linux 分钟 + 自托管足够)
需要 macOS 构建 iOS/Mac 应用(公共仓库 macOS 全免费)
想把自己机器/家庭服务器当构建节点的人(Self-hosted 永久免费)
已经在 GitHub 上管理代码、不想再单独接一套 CI 的团队
❌ 不适合:
重度 macOS 构建的商业团队(10× 乘数很快打满)
需要大规模并行(>20 并发)的中大型团队(付费档才能开更高并发)
自托管但不想做 Runner 运维升级的团队(版本更新压力大)
所有 Runner 必须在国内机房且不能出海的场景(GitHub 托管 Runner 在海外)
8 款免费 CI/CD 横向对比
工具 | 免费额度 | Runner | 自托管 | 国内速度 | 适合场景 |
|---|---|---|---|---|---|
GitHub Actions | 私有 2000min+500MB / 公共无限 | Linux/Win/macOS | ✅ 永久免费 | 一般(200-400ms) | GitHub 项目首选 |
GitLab CI | 400 分钟/月 | Linux shared | ✅ | 一般 | GitLab 项目 |
CircleCI | 6,000 credits/月(≈6000min) | Linux Docker | ✅ macOS Windows要付费 | 一般 | 容器化构建 |
Travis CI | 10,000 credits/月 | Linux/Win/macOS | ❌ | 一般 | 开源历史项目 |
云效 Flow | 1800 分钟/月 | 国内节点 | ✅ 企业版 | 快 | 阿里云部署 |
Gitee Go | 300 分钟/月 | 国内节点 | ✅ | 快 | Gitee 项目 |
Drone CI | 自托管永久免费 | 自带 | ✅ | 视部署位置 | Docker 原生 |
ArgoCD | K8s 自托管永久免费 | K8s Pod | ✅(K8s) | 视部署位置 | K8s GitOps |
付费档参考(官方定价,2026-01-01 新价)
Free:$0 永久(2000 Linux 分钟/月 + 500MB 存储)
Pro:$4/用户/月(3000 分钟 + 1GB 存储,需组织付费)
Team:$4/用户/月(3000 分钟 + 2GB 存储 + 团队协作)
Enterprise Cloud:$21/用户/月(50,000 分钟 + 50GB + SSO/SAML/审计)
超量价(标准 2 核):Linux $0.008/min、Windows $0.016/min、macOS $0.08/min
公共仓库无论哪个档都免费不限量(含 macOS Runner),这也是开源项目几乎都在 Actions 上的原因。
你现在项目的 CI/CD 是跑在哪家?GitHub Actions 公共仓库无限量是真香,但私有仓库 2000 分钟 + 500MB 对个人项目够用吗?你是怎么绕开分钟数限制的——是接自托管 Runner、切 GitLab CI 还是国内云效?
核实时点:2026 年 11 月,所有免费额度、乘数、Runner 版本、2026-12-02 pull_request_target 变更、价格均以 GitHub 官方 docs.github.com 计费页为准;分钟乘数和超量价格自 2026-01-01 起执行新表。