各位站长、开发者,今天给大家带来一期逐项核对过 CircleCI 官方定价页与文档的 CI/CD 线报。
CircleCI 在海外 CI/CD 圈里是资历最老的一批:不用自己搭构建机、不用维护 Runner,代码连上 GitHub 或 Bitbucket,.circleci/config.yml 一提交,流水线就转起来了。它对 Docker 的支持做得尤其成熟——容器镜像、服务容器、Docker Layer Caching 都是原生能力,.circleci/config.yml 也是很多团队心里"最像样的 CI 配置格式"。
免费政策上,CircleCI 给的量也相当大:每月 30,000 免费积分、项目不限数量、30 个并发作业、支持 Docker / Linux / Arm / Windows / macOS 五种执行环境,而且注册不需要绑信用卡。
但这条线报必须先做两处更正,因为你手上的资料把"并发数"和"用户数"混了,而且"6000 分钟"这个数字是一个理想上限,不是实打实的时间。这两件事不搞清楚,你会严重高估自己的可用额度。
先更正两处:并发 30 不是 5,"6000 分钟"要打折
更正一:并发作业数是 30,不是 5;5 是"活跃用户数"。
这是最需要纠正的一点,而且错得很典型——数字对得上,含义全错了。
按 CircleCI 官方定价页当前口径:
免费计划免费积分:30,000 credits/月
包含活跃用户:5 个 active users/month ←——"5"来自这里
并发作业数(Concurrent job runs):
所以准确的说法是:免费计划给你 30 个并发作业,但那 5 个名额是"活跃用户"——官方对活跃用户的定义是"任何在你 CircleCI 项目上提交过代码的人"。也就是说,这个账号最多 5 个人参与提交,超了就要额外买席位(每增加一个活跃用户约 25,000 credits/月)。
要注意的是,macOS 是唯一的例外:只有 1 个并发。想同时跑多个 iOS 构建,免费版做不到。
更正二:"6000 分钟"是按最小规格算的上限,默认规格只有一半。
这一条是本文最需要记住的。CircleCI 现在不按"分钟"给额度,而是按"积分(credits)"——积分才是真正的计量单位。同样一个月,你选什么规格的机器,能跑的时间完全不一样。
官方的换算逻辑是"积分 ÷ 每分钟消耗速率":
(Linux Small / Medium / Large / XL 的速率为第三方整理的常见口径,其中 Medium 的 10 credits/分钟有官方文档原文印证;macOS 的 200 credits/分钟来自 2026 年 10 月的实测资料,请以官方资源类目单价表为准。)
这几行数字说明了三件事:
"6,000 分钟"是按最小的 Docker Small 算的。而你如果没特别指定,很多模板默认就跑在更大的规格上——Medium 直接减半,只剩 3,000 分钟。圈内流传的"CircleCI 免费给 6000 分钟",严格说只是"最多 6000 分钟"。
规格越大,能跑的时间成比例缩水。这和你选哪档机器直接挂钩,不是固定的。
macOS 是"额度杀手"。 按 200 credits/分钟算,30,000 积分在 macOS 上只够跑约 150 分钟——两次稍长的 iOS 构建就没了。想在免费版上跑 macOS 任务,必须把它当成"极稀缺资源"来用。
一个公开资料很少提的重大利好:开源项目有 400,000 积分
这是本次核实中价值最高的一条,很多教程都没写。
官方定价页明确写着:开源项目(组织)每月可获得最多 400,000 credits,相当于 80,000 构建分钟,可用于 Linux、Arm 和 Docker 执行环境。
作为对比,私有仓库和新用户的免费计划只有 30,000 积分。开源项目拿到的是它的 13 倍还多。
另外官方对 macOS 也有一条专门说明:免费计划上的组织,还可以每月用那 30,000 积分来跑 macOS 开源构建。
这条对做开源的朋友意义很大:如果你维护的开源项目需要频繁跑 CI,直接把项目组织配置成开源组织,额度能直接上一个量级,多平台矩阵、并行测试都可以放开跑。这是 CircleCI 相对 GitHub Actions"公开仓库不限量"政策的一种对标。
逐项核实:免费版完整权益清单
按官方定价页与文档,CircleCI Free 计划的完整情况如下:
价格:0 美元/月,无需信用卡
注册就能用,不用绑卡——在同类里这点算友好(对比 Koyeb 现在要 29 美元预授权)。免费积分:30,000 credits/月(开源组织 400,000/月)
积分一个月后过期,不结转。这个月没用完,下个月不会攒着——官方原文写的是"Credits on the Free plan expire after a month and do not roll over"。活跃用户:5 个
定义很关键:"任何在你 CircleCI 项目上提交代码的人" 都算活跃用户,不只是项目管理员。所以"5 个人"是真实的协作人数上限。并发作业数:30(macOS 为 1)
Docker / Linux VM / Arm VM / Windows VM 都是 30,macOS 只有 1。另外官方说明,不同资源类目还有各自的软并发限制,触顶时作业会排队。项目数量:不限
这一点你的资料说得对。CircleCI 不对免费计划的项目数设限。执行环境:Docker、Linux VM、Arm、Windows、macOS 全覆盖
免费计划开放的资源类目(按官方 pricing 页的勾选表):Docker(x86 / Arm):Small、Medium、Medium+、Large 可用;X-large 及以上要付费;
Linux VM:Medium、Large 可用;
Windows VM:Medium、Large 可用;
macOS VM:仅 M4 Pro Medium 一档(M4 Pro Large 要 Performance 计划);
GPU:免费计划不可用(全部是付费专属)。
网络与存储额度
网络传输 1 GB、存储 2 GB(免费计划)。网络额度官方限定为仅用于自托管 Runner 恢复缓存和工作区;超额按 420 credits/GB 计费。SSH 调试:支持,但会计费
这一点你的资料提到了,但漏了最关键的一句。官方支持中心的原文是:"用 SSH 重跑作业会对所用执行环境和资源类目收取积分。所以如果你重跑一个原本跑在 Docker Medium 容器上的作业并开启 SSH,会被收取 10 credits/分钟。"
也就是说——SSH 调试不是免费的,它是按你那个 job 原本的规格照常烧积分,而且你挂在那儿调试的每一分钟都在扣。Docker 支持
这是它的强项:dockerexecutor(自定义镜像)、服务容器(起 MySQL、Redis 等依赖)、远程 Docker 环境(Remote Docker,用于在 CI 里构建镜像)、以及 Docker Layer Caching(缓存镜像层加速构建,属于附加功能、区分计费)。并行测试(Parallelism / Test Splitting)
可以把同一个作业拆到多个容器上并行跑,自动把测试用例分组分发。注意:并行是按倍数消耗积分的——开 4 路并行,消耗就是单路的 4 倍。官方也把这形容成"双刃剑"。Orb 库(可复用配置包)
这一点你的资料说得对。Orb 是把常用 CI/CD 流程封装成的可复用 YAML 配置包,分公共 Orb和私有 Orb。直接用现成 Orb 能少写一大堆配置,这是 CircleCI 生态里比较有价值的部分。Insights 用量看板
免费的用量分析面板,能看到工作流状态、耗时、积分消耗和成本。对控制额度很有用。Flaky Test 检测
免费计划可以用,但限制为 5 个测试。排队和准备阶段不计费
官方明确:作业处于 queued(排队)或 preparing(准备) 状态时不计费——因为这时候它没在真正占用计算资源。这对免费用户是个好消息:排队不花钱,只是花时间。
实测踩坑:这几条一定要提前确认
结合起来看,CircleCI 免费版的坑集中在"规格"和"计费细节"上。
别按"6000 分钟"作预算,先确认你的规格。 默认跑 Medium 就只有 3,000 分钟,Large 只剩 1,500。上手第一步就是去 Insights 面板看一次 job 的实际积分消耗,用真实数据估。
macOS 是额度黑洞。 按 200 credits/分钟算,30,000 积分只够约 150 分钟,而且并发只有 1。想在免费版跑 iOS 构建,务必控制次数和时长,或者只在打 tag 时触发。
SSH 调试会持续扣积分。 它按原 job 的资源类目照常计费,你人挂在 SSH 里没操作,分钟数也在走。调试完记得尽快结束会话。
"5 个活跃用户"是按提交行为算的。 任何在项目上提交过代码的人都算,不是只有协作者。小团队共享一个账号要留意——超出后每人约 25,000 credits/月。
积分一个月过期、不结转。 别想着"这个月省着用、下个月一次跑完",用不完就是作废。
并行测试会成倍消耗。 4 路并行 = 4 倍积分。开并行是为了缩短墙钟时间,代价是额度消耗,要权衡。
免费计划用不了 GPU,macOS 也只有一档规格。 如果你需要跑 GPU 任务或 macOS 高性能实例,免费版直接不适用。
开源组织记得去争取那 400,000 积分。 这是本文最实用的一条——维护开源项目的朋友,把项目按开源组织配置,额度是普通免费账号的 13 倍以上。
先分清"30 个作业并发"和"自托管 Runner 的 5 个任务并发"。 这两个是不同体系:机器/容器形态的自托管 Runner 在免费计划下并发上限是 5 个任务,和云上 30 个并发不是一回事。如果你打算接自托管 Runner 提额度,注意这条限制。
实操:从零到跑通一条流水线
第一步:用 Git 账号登录
支持 GitHub、Bitbucket 等。不用绑信用卡,选 Free 计划即可开始。
第二步:添加项目
在面板里选中要构建的仓库,CircleCI 会自动识别技术栈并给出一套初始配置。项目数量不设限。
第三步:写配置文件
在仓库根目录建 .circleci/config.yml,定义版本、执行环境(executor)和作业(jobs)。用 docker executor 指定镜像是最常见写法;需要数据库等依赖时,在 docker 下加 services。
第四步:选对执行环境和资源类目(关键)
这一步直接决定烧积分速度。免费计划可用的范围是:Docker Small/Medium/Medium+/Large、Linux VM Medium/Large、Windows VM Medium/Large、macOS M4 Pro Medium。 能用 Small 就别上 Medium,能不用 macOS 就别用。
第五步:配缓存与并行
缓存:用
save_cache/restore_cache缓存依赖目录(npm、pip、Maven),这是缩短构建时间、间接省积分最有效的一招;并行:用
parallelism做测试分片,但记住它会成倍消耗积分。
第六步:用 Orb 少写配置
在配置里引入官方或社区的公共 Orb(比如各类部署、语言专用 Orb),能省掉大量重复的 YAML。私有 Orb 可以把团队内部流程封装起来复用。
第七步:SSH 调试(按需)
构建失败时可以点"Rerun job with SSH"进入容器排查。前提是你的 SSH 公钥已经加到了对应的 Git 账号上——这是很多人点了按钮却进不去的原因。记住这一操作会持续扣积分,查完及时退出。
第八步:盯住 Insights 用量面板
在 Insights 里查看积分消耗和成本趋势。接到额度提醒后,优先做三件事:把大规格作业降回 Small、茂弃不必要的 macOS 作业、给部署类作业加上分支限制。
壹贰线报专属:两套务实方案
开源项目方案(免费额度最划算的用法)
如果你维护开源项目,第一件事就是把它配置成开源组织,去拿那每月 400,000 积分——这是免费计划里最大的额度来源,比普通账号多 13 倍以上。有了这个额度,多平台矩阵(Linux + Arm + Docker)、并行测试、频繁构建都可以放开跑。macOS 仍然建议省着用,因为它消耗速率太高。这套方案基本等于"开源项目的 CI 自由",而且是零成本。
私有项目方案(要精打细算)
私有仓库的 30,000 积分要按"规格 × 时长"精算:坚持用 Docker Small 或 Medium,避免 Large 以上;把 save_cache 配好,别让每次构建都重新拉依赖;并行测试只在必要阶段开启;macOS 任务改成打 tag 时触发。唯一要注意的边界是:如果你用自托管 Runner 提额度,免费计划下并发上限是 5 个任务。 这套方案适合个人项目、小团队内部服务,日常构建完全够用。
需要提醒的是,CircleCI 的额度在几个同类平台里算比较宽松的(不需要绑卡、30 并发、开源有额外大额额度),但它的计费颗粒度比"给固定分钟数"的平台细得多,所以对"省着用"这件事的要求也更高。
最后提示
壹贰线报只发核实过的信息。CircleCI 这次核下来,有个挺明显的感受:它把免费额度做得"看起来很大、算起来很细"——30,000 积分、30 并发听上去很宽裕,但一旦你把规格从 Small 升到 Medium,可用的时间就直接腰斩;上了 macOS,额度更是所剩无几。
上手前建议想清楚四件事:一是你的项目是开源还是私有,前者记得去拿 400,000 积分的开源额度;二是你的作业用什么规格,Small 和 Medium 的可用时长差一倍;三是有没有 macOS 需求,它是免费版最贵的一环;四是有没有并行和 SSH 调试习惯,这两项都会额外消耗积分。
顺便说一句:如果你之前以为 CircleCI 免费版是"5 个并发",那大概率是记成了"5 个活跃用户"——这两者的区别,正是本文最想帮你搞清的地方。