个人开源项目怎么托管？腾讯云 CNB 免费仓库上手

摘要：

想把个人开源项目托管到云端却担心存储和构建成本？本文以腾讯云云原生构建（CNB）社区版为例，从创建仓库、推送代码到配置 .cnb.yml 自动化流水线，手把手带你用免费额度跑通开源项目托管全流程。

一、个人开源项目托管，到底在纠结什么

很多开发者做出第一个开源项目时，最先碰到的不是代码问题，而是"放哪儿"。代码托管平台不少，但个人开发者真正在意的是几件小事：仓库存储够不够用、私有仓库要不要收费、顺手能不能把构建和 Issue 也一起解决。如果每样都要单独付费或者单独搭一套服务，个人项目的维护成本很快就会超过写代码本身。

腾讯云云原生构建（CNB）把代码托管、云原生构建、云原生开发、制品库和 AI 能力整合在同一个平台里，社区版采用"免费额度 + 超额按量计费"的模式，对个人开源项目比较友好。它的代码托管基于 Git，支持无限数量的公开和私有仓库，同时把分支保护、代码审查、Issue 跟踪、Wiki 和 LFS 这些标准 Git 工作流能力一并内置，意味着托管代码的同时，项目协作所需的基础设施也就位了。

对于个人开发者来说，CNB 社区版提供的免费额度覆盖了开源项目日常维护的主要消耗：仓库存储 100 GiB、对象存储 100 GiB、云原生构建 160 核时/月、云原生开发 1600 核时/月，以及 500 credits/月的 AI Credits。其中仓库存储用于 Git 对象，对象存储用于制品、LFS 对象、图片和附件。只要项目体量还在免费额度范围内，托管和自动化构建都不会产生额外费用。需要注意的是 GPU 不提供免费额度，使用即按 0.5 元/核时计费，普通开源项目的常规构建一般用不到 GPU，因此基本不受影响。

二、创建第一个 CNB 仓库

托管项目的第一步是建立仓库。登录 CNB 平台后，进入组织或个人的仓库列表页面，点击新建仓库即可创建一个空的 Git 仓库。创建时需要填写仓库名称和描述，选择公开或私有，如果后续要用到云原生构建，建议勾选初始化 README 的选项。

仓库创建完成后，平台会给出两种推送代码的方式：一种是直接在浏览器里新建文件提交，适合快速放一个 README 或许可证文件；另一种是通过 Git 命令行把本地已有的项目推送上去，适合已经有代码的成熟项目。对于个人开源项目，通常的做法是在本地初始化好工程、写好 LICENSE 和 README，然后用命令行推送到 CNB 远程仓库。

这里有一个实践建议：仓库描述和 README 要写清楚项目是做什么的、怎么安装、怎么使用。CNB 每个仓库都支持独立的 Wiki 页面，可以把更详细的使用文档、贡献指南放到 Wiki 里维护，让主页保持简洁，文档保持完整。如果项目里有较大的二进制文件，比如设计稿、测试数据集，可以启用 Git LFS 来管理，LFS 对象会计入对象存储的免费额度。

三、用 .cnb.yml 给项目配上自动化构建

仓库托管好之后，个人开源项目最值得投入的一件事就是配置自动化构建。CNB 的云原生构建采用声明式配置，核心是仓库根目录下的一份 .cnb.yml 文件，用 YAML 语法定义构建、测试、部署的整个流程。相比可视化拖拽编排，声明式配置可以直接放进 Git 仓库版本管理，做到"一切皆代码"，别人 fork 你的项目时也能直接复用同一套流水线。

CNB 的流水线是 Pipeline/Stage/Job 三层结构。Pipeline 是一次触发事件产生的一次完整执行过程；Stage 是 Pipeline 里的执行单元；Job 是最小执行单元，在独立的 Docker 容器中运行。同一个 Stage 内的多个 Job 既可以串行也可以并行，取决于 jobs 的写法：写成数组形式时按顺序串行执行，写成对象形式时并行执行。这样的结构让配置既清晰，又能在需要时利用并行能力加速构建。

下面是一个前端开源项目常见的 .cnb.yml 示例，演示在 push 到 main 分支时自动安装依赖、运行测试并构建产物：

main:
  push:
    - docker:
        image: node:20
      stages:
        - name: install
          script: npm ci
        - name: test
          script: npm test
        - name: build
          script: npm run build

这份配置的含义是：当 main 分支收到 push 事件时，使用 node:20 官方 Docker 镜像作为构建环境，依次执行安装依赖、运行测试、构建产物三个阶段。因为 install、test、build 写在同一个 stages 列表里，它们会按顺序串行执行。如果需要让某些任务并行，可以把同一 Stage 内的 jobs 写成对象形式（用 key 命名而非数组的 - name），这些任务就会并行跑起来；而拆到不同的 Stage 则用于划分执行阶段、让流程更清晰。

配置写好后提交到仓库，下一次推送代码就会自动触发流水线。构建是否成功、每一步的日志输出，都可以在仓库的构建页面里查看。个人项目用 1 核 2GiB 的节点规格就足够日常测试和构建，免费额度 160 核时/月按这个规格折算成可用时长相当可观，月底清零不叠加到次月。如果偶尔需要更猛的算力，也可以临时声明更高核数的节点，从免费额度里抵扣。

四、把协作和文档一起托管起来

个人开源项目虽然只有一两个人维护，但一旦有外部贡献者进来，协作流程是否清晰会直接影响维护体验。CNB 的代码审查通过 Pull Request 机制完成，支持多人评审、评论讨论和代码变更建议，配合分支保护规则，可以要求合并前必须通过 CI 检查或代码审查，避免主分支被误改。

Issue 跟踪也是内置能力，支持标签分类、里程碑规划和任务指派。开源项目常见的"求功能""报 bug""问用法"都可以在 Issue 里分流。建议给 Issue 预设几类标签，比如 bug、enhancement、documentation、good first issue，让新贡献者能快速找到适合自己的任务。

文档方面，除了前面提到的 Wiki，CNB 还支持在仓库里直接维护 Markdown 文档。把贡献指南、行为准则、更新日志都纳入版本管理，好处是文档和代码同步演进，不会出现文档站点和代码仓库各说各话的情况。

五、免费额度怎么算，心里有数才不慌

个人项目托管最怕的是"用着用着突然要钱"。CNB 社区版的计费逻辑比较透明：每月月初按上个自然月的实际用量自动扣费，免费额度内的部分不收费，超出部分才按量计费，无需主动续费，也不涉及预付费充值。各项免费额度如下：

存储资源按自然月内日均用量减去免费额度计算，计算资源按自然月内累积用量减去免费额度计算。核时是计算资源的计量单位，8 核使用 1 小时等于 8 核时。启动构建或云原生开发后，系统每 5 分钟冻结一次用量，如果检测到可用额度不足会立即终止任务，避免产生额外费用，构建完成后按实际运行时间上报用量。

对个人开源项目来说，100 GiB 的仓库存储和 160 核时的构建额度通常用不完，除非项目体量特别大或者构建任务非常密集。如果真的超过了免费额度，可以在平台的"组织 > 设置 > 用量管理"里绑定腾讯云预算来提升用量上限，组织用量上限等于免费额度加上预算配置的用量上限。用量是否超标，也可以随时在"仓库 > 设置 > 用量统计"里查看仓库级别的明细。

六、小结

个人开源项目托管，核心诉求是"省心"——代码有地方放、构建能自动跑、协作有工具用，而且成本可控。腾讯云云原生构建（CNB）社区版把 Git 代码托管、声明式云原生构建、Issue 协作、Wiki 文档和制品管理整合在一个平台里，免费额度覆盖了个人项目的主要消耗，配合一份 .cnb.yml 就能把自动化流水线纳入版本管理，对个人开发者和开源维护者是比较完整的一套方案。如果你正准备给手头的开源项目找个长期落脚点，不妨先到 腾讯云 CNB 上创建一个仓库试试看。