jsonscraper
市场

GitHub 新增 Webhook IP 网段:如何更新允许列表

10 月 29 日,GitHub 扩展了 Meta API 中的 hooks 字段。本文介绍此次变更的影响范围,以及如何同步网络规则,避免手动复制地址。

编辑政策 报告错误

如果服务器只接受来自已允许 IP 地址的 GitHub webhook,请将三个新前缀加入允许列表。GitHub 于 2026 年 10 月 29 日宣布,用于发往 github.com 的新网段已加入 Meta API 的 hooks 字段。此变更适用于所有套餐中发往 github.com 的 webhook,包括 GitHub Enterprise Cloud。

文章:GitHub 新增 Webhook IP 网段:如何更新允许列表
摘要:GitHub 为 github.com 的入站 webhook 新增了三个 CIDR 前缀。如果服务器只接受允许列表中的地址,请从 Meta API 的最新响应更新列表,并确认旧网段仍然保留。
图片用途:封面——核心主题
章节:
视觉主体:网络防火墙配置示意图的特写,展示 webhook 传送路由和三个新增的 CIDR 网段
© jsonscraper · AI 生成插图

需要添加哪些网段

手动更新时,GitHub 列出了以下 CIDR 前缀:

  • 9.234.98.160/28
  • 9.234.98.176/28
  • 9.234.106.48/28

将这些前缀与已允许的 GitHub 地址一并保留,并加入列表。如果允许列表已通过 Meta API 更新,则无需单独修改这些前缀:最新的 webhook 列表会在 hooks 字段中返回。Meta API 文档提醒,示例响应中的值仅供演示;实际配置应直接请求最新数据。

检查允许列表的生成方式

首先,确认允许地址列表配置在哪里:应用的网络防火墙、反向代理、云策略或企业防火墙。接着,检查系统是从 GET /meta 更新整套地址,还是只保存手动添加的条目。若属于前一种情况,请确认同步包含 hooks 字段;若属于后一种情况,则添加这三个前缀,同时保留之前的条目。

无需身份验证即可访问 GET /meta 的公开数据。GitHub 建议定期更新允许列表,因为服务地址可能发生变化。自动化时,从响应中提取 hooks 字段,并在应用网络规则前将完整列表与本地配置进行核对。

更新后需要检查什么

确认新 CIDR 前缀已出现在生效配置中,并且旧条目仍然保留。然后检查 webhook 投递记录和网络日志,确认变更后没有请求被拒绝。IP 过滤最好与其他检查配合使用:GitHub 的建议包括使用经过证书验证的 HTTPS、设置 webhook 密钥,以及在处理前检查事件类型。

GitHub 建议在 10 秒内以 2xx 状态码响应投递;耗时较长的处理可以放入队列。X-GitHub-Delivery 标头有助于识别唯一投递,并防止请求被重复重放。

对于静态允许列表,请手动添加所有三个已公布的前缀。如果配置由系统自动管理,则通过 Meta API 更新 hooks 字段,并定期将其当前值与本地列表核对。这样,过滤入站 webhook 的规则就不会漏掉新地址。

人们

尚未列出本文的人员。

继续阅读GitHub CLI 新增可过期 OAuth 令牌:如何启用并检查集成
阅读下一篇文章

将阅读内容转化为可用的集成

探索 jsonscraper 社交数据 API、测试请求并构建下一个工作流。

查看 API