GitHub Ruleset 启用状态不生效5 分钟自检清单【免费下载链接】docsThe open-source repo for docs.github.com项目地址: https://gitcode.com/GitHub_Trending/do/docs规则集Ruleset显示已启用可一推送照样放行这是 GitHub 规则集启用状态最常见的翻车现场。先别急着重建规则90% 的情况出在四处——作用域没命中、用户进了绕过列表、模式停在 Evaluate、上级规则集强制继承。本清单带你按顺序自查5 分钟定位真凶。先把概念说清一个 GitHub Ruleset 是一组绑定在仓库或组织、企业上的规则盯着特定动作推送到某分支、发起合并、打标签。它把原来散落在分支保护推送保护里的开关整合成一处管理并支持 UI 和 API 两种配置方式、审计日志和 bypass 列表。但注意一个关键区别界面上的已启用只表示规则已配置且开关打开不代表它正在拦截任何动作。可以把它类比成门禁系统设备通电了不等于这张门禁卡会被刷——还要看卡种对不对、这个人是不是在免检名单、系统是仅登记还是真拦人、总部有没有下发强制策略。规则集不生效基本逃不出五个变量规则类型对不对、作用域盖没盖住、操作人在不在绕过列表、模式是 Enforce 还是 Evaluate、上级有没有强制继承规则。下面按症状对号入座。规则集不生效症状自查清单症状一我明明改了仓库规则还是被上级规则盖住原因企业级或组织级规则集可以覆盖仓库级规则。部分企业配置中上级规则集是强制应用的——此时你在仓库里改动、加人、放宽限制都不会生效执行的是上级版本。这是 GHES 企业级规则集enterprise-level rulesets的典型表现。处理请企业管理员查看该作用域的 rulesets 列表确认是否有上级规则集处于强制状态。有就改上级规则集本身仓库侧任何操作都是徒劳。症状二用推送规则集限制提交信息永远不触发原因两类规则集边界不同。推送规则集push rulesetsGHES 3.17 起正式可用只关心文件类型、路径、大小用来阻止特定内容进入私有/内部仓库提交信息格式、PR 审核人数、状态检查这些属于分支规则集的合并流程管控。把提交信息规则塞进推送规则集等于在火车站安检口检查乘客的机票。处理对号入座——限制推什么内容进仓库用推送规则集限制PR 怎么合、提交长什么样用分支规则集。放错位置的规则移到正确载体上再观察。症状三规则生效了但没人被拦原因规则集有两种模式。Evaluate评估模式只把违规行为记进审计日志不拦截任何动作Enforce执行模式才会真正阻止。停在 Evaluate 的规则集界面上看起来和正常启用没区别。处理打开规则集详情确认状态是Enforce而不是 Evaluate。典型信号是审计日志里有违规记录、但推送没被拦——那几乎可以断定是评估模式。确认无误后再切到 Enforce。症状四同一个操作A 账号被拦、B 账号畅通原因每个规则集都带 bypass 列表列表里的用户或角色跳过全部检查。B 账号违规能过多半就在这个列表里。另外注意某些 GHES 版本中企业所有者enterprise owner默认属于可绕过角色管理员身份本身就带豁免。处理检查该规则集的 bypass 列表确认 B 账号或其所在角色是否在内。定期清理长期挂名但无必要的条目——bypass 是排查期工具不该是长期配置。一步到位的自诊断流程按下面的顺序走一遍基本能收敛到根因查作用域规则集的目标分支/标签是否覆盖被操作的分支范围没盖住后面全白搭。查用户操作者是否在该规则集的 bypass 列表中含默认豁免角色查规则类型限制的动作和规则类型是否匹配推送类 vs 合并类查模式是 Enforce 还是 Evaluate查审计日志搜索 ruleset 相关事件。有记录没拦截 → 看第 4 步连记录都没有 → 回到第 1、3 步说明作用域或规则类型没命中。版本升级自检GHES 规则集差异对照不同 GHES 版本的规则集能力差别不小升级前对一下版本关键变化升级注意GHES 3.17推送规则集正式可用支持 Evaluate 模式与 bypass 列表标签保护规则迁移进规则集原标签保护功能下线见 3.17 发布说明升级前必须完成标签保护规则迁移否则旧规则失效GHES 3.18企业级规则集可用新增合并方式merge method规则可管控 merge commit / squash / rebase见 3.18 发布说明企业侧可统一下发规则注意与仓库级规则的优先级关系GHES 3.19规则集历史可回滚、导入/导出、规则集模板recipes正式可用见 3.19 发布说明可用历史记录追溯谁在何时改了规则标签保护规则迁移四步3.17 升级必做盘点现有标签保护规则记录每条的分支范围和限制内容创建等效的规则集规则类型选标签保护对应项范围与原规则一致先开 Evaluate 模式在测试仓库观察拦截对象是否如预期切 Enforce、验证通过后再移除旧标签保护规则。⚠️ 本仓库的发布说明目录从 3.17 开始收录见 data/release-notes/enterprise-server/更早版本的规则集差异请升级前以官方发布说明为准。按场景选配置仓库类型推荐规则集组合关键限制公共开源基础分支规则集合并前要求 PR 审核与状态检查通过内部开发分支规则集 推送规则集限制二进制/特定路径文件入库要求签名提交敏感数据企业级规则集 推送保护阻止密钥内容推送配合 secret scanning强制代码扫描bypass 列表最小化企业规模建议组织级建一套基础规则模板再按仓库分类下发针对性规则集避免逐仓库手配。容易踩的误区Q1规则集已启用是不是就等于生效了不是。启用只是开关状态是否拦截还要看作用域、用户、模式、上级规则四个变量——这正是本清单的结构。Q2审计日志里什么都没有能说明规则没触发吗不一定。先确认日志筛选条件包含了 ruleset 事件日志干净也可能说明作用域或规则类型压根没匹配。Q3推送规则集能管提交信息格式吗不能。推送规则集只管文件类型、路径、大小提交信息格式归分支规则集的合并流程管。Q4仓库管理员为什么改不动规则大概率命中上级企业级/组织级规则集的强制继承。找企业管理员别在仓库侧反复试。Q5为什么有人永远不触发规则查 bypass 列表和默认豁免角色。企业所有者在部分版本默认拥有绕过权限这是设计行为不是 bug。收尾规则集启用状态问题大多不是玄学而是作用域 × 用户 × 模式 × 继承四个变量里有一个没对齐。按上面的自查清单走一遍多数情况当天下班前就能定位。官方规则集文档content/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/规则集 REST API 参考content/rest/repos/特性开关溯源data/features/repo-rules.yml、data/features/repo-rules-enterprise.yml【免费下载链接】docsThe open-source repo for docs.github.com项目地址: https://gitcode.com/GitHub_Trending/do/docs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考