派生仓库是最初作为另一个仓库的副本创建的仓库,另一个仓库称为上游仓库。 分支具有自己的设置和权限,但会一直连接到上游存储库。
当您在 GitHub 上查看某个派生仓库时,其上游仓库会标示在该派生仓库名称下方。
分叉与分支有何不同
分支是一个存储库的一部分。 分叉是一个单独的存储库,其自己的设置和协作空间。
每个分叉可以有自己的分支:
- 分支
- 成员和讨论
- 议题和拉取请求
- 操作和项目
- 标记、标签和 Wiki
可将哪些存储库进行分叉?
可将任何公共存储库分叉到:
- 你的个人帐户
- 你有权在其中创建存储库的组织
如果你有权访问专用存储库,并且所有者允许分叉,则可以将存储库分叉到:
- 你的个人帐户
- 你有权在其中创建存储库的 GitHub Team 上的组织
不能使用 GitHub Free 将专用存储库分支创建到组织。 有关 GitHub Team 和 GitHub Free 的详细信息,请参阅“GitHub的计划”。
存储库、组织和企业策略可以限制是否可以创建存储库分叉和创建分支的位置。 对于专用 存储库,对分叉的访问权限也取决于存储库可见性、组织成员资格和管理员设置。
如果你是某个 具有托管用户的企业成员,则其他限制适用于可以分叉的存储库。 请参阅文档中的 GitHub Enterprise Cloud。
请参阅 管理组织的复刻政策。
分叉的可见性
分支的可见性与上游存储库的存储库网络相关联。 公共存储库分支是公共的,专用存储库分支是专用的。 不能自行更改分叉的可见性。
存储库网络中的所有存储库共享相同的可见性设置。 存储库网络包括上游存储库、其分支和这些分支的分支。 请参阅“了解仓库之间的连接”。
删除存储库或更改其可见性可能会影响网络。 如果删除分叉,则存储库网络仍可访问该分叉中的代码贡献。
删除存储库或更改可见性时分支会发生什么情况
警告
可见性更改可以将分支分隔到新的存储库网络中,以便现有分支所有者可以继续工作,而不会意外丢失访问权限。
| Action | 对分叉的影响 |
|---|---|
| 已删除专用存储库 | 还会删除其专用分支。 |
| 删除公共存储库 | 活动公共分支将成为网络的新上游存储库。 |
| 公开仓库被设为私有 | 其公共分支在单独的网络中保持公共状态。 |
| 专用存储库公开 | 专用分支保持专用,但断开连接到单独的专用网络。 |
将公开仓库更改为私有仓库也会影响星标、关注者、依赖关系图、Dependabot alerts 和 code scanning 的可用性。 在更改存储库之前,请仔细查看存储库可见性设置。
分叉的权限
专用分支继承上游存储库的权限结构。 这有助于私有仓库的所有者保持对其代码的控制。 例如,如果上游仓库是私有的,并授予团队读/写访问权限,则同一团队对该私有上游仓库的任何复刻拥有读/写权限。 专用分支仅继承团队权限(而不是个人权限)。
注意
更改组织的基本权限时,不会对专用分支的权限进行自动更新。 有关详细信息,请参阅“为组织设置基本权限”。
公共分支不继承上游存储库的权限结构。 分叉所有者控制对其分支的访问,但存储库网络仍共享 Git 数据。 推送到某个网络中任一仓库的提交,都可能被该网络中的其他仓库访问到,包括上游仓库。
将公共存储库分叉到个人帐户时,可以允许上游存储库的维护人员推送到拉取请求分支。 这有助于维护人员在合并之前更新分支、运行测试或解决小问题。 不能向组织拥有的分支授予推送权限。 请参阅“Allowing changes to a pull request branch created from a fork”。
分支存储库的推送规则集
推送规则适用于存储库的整个分支网络,以确保存储库的每个入口点均受到保护。 例如,如果将已启用推送规则集的存储库创建为分支,则相同的推送规则集也适用于已创建分支的存储库。
对于已创建分支的存储库,只有对推送规则具有旁路权限的人员是根存储库中具有旁路权限的人员。
请参阅“关于规则集”。
重要的安全注意事项
分支是功能强大的协作工具,但它们可以通过易于忽略的方式公开代码和历史记录。
- 分支具有其自己的权限,这些权限独立于上游存储库。
- 上游存储库的所有者可以读取存储库网络中的所有分支。
- 组织所有者可能具有对个人命名空间中创建的分支的管理访问权限。
- 删除某人对上游存储库的访问权限并不总是删除其他组织中的分支。
- 即使在删除分叉后,提交仍可在存储库网络中保持可访问性。
在允许敏感工作分支之前,请查看存储库或组织的权限和可见性模型。
组织内的分叉
同一组织中的分支从上游存储库复制协作者和团队设置。 组织控制这些分支的权限,现有可见团队可能会保留访问权限。
企业内部的派生版本
内部存储库支持单一级别的分叉。 不能为内部存储库的专用分支分叉。 这样,企业中可见的存储库的访问和管理更简单。