Jenkins（K8S部署）对接GitHub Webhook提示无法连接主机故障排查

1. 修复Webhook回调URL的核心错误 #

GitHub自动注册的Webhook URL显示为www..com/github-webhook，存在域名缺失的格式问题，这是导致无法连接的直接原因：

• 进入Jenkins全局配置（Manage Jenkins → Configure System），检查并修正Jenkins URL为GitHub可访问的完整地址（如https://jenkins.yourdomain.com），确保生成的Webhook URL为https://jenkins.yourdomain.com/github-webhook/（注意末尾斜杠，部分场景下需保留）。
• 删除GitHub仓库中已存在的无效Webhook，重新触发Jenkins组织扫描或手动创建Webhook，确认新生成的URL格式正确。

2. 验证Jenkins的外部可达性 #

Pod内能访问GitHub不代表GitHub能反向访问Jenkins，需确认：

• 在外部网络环境（可访问公网的机器）执行curl -v <正确的Jenkins Webhook URL>，若返回403则说明连接正常（无payload时的预期响应）；若连接超时/拒绝，则说明：
  • K8S集群未暴露Jenkins的公网访问入口，需检查Ingress配置是否正确映射Jenkins Service，Ingress Controller是否正常运行。
  • 防火墙/安全组未开放Jenkins服务的80/443端口，需调整规则允许GitHub IP段的访问。
  • HTTPS证书问题：若Jenkins使用自签名证书，GitHub会拒绝连接，需配置可信的SSL证书。

3. 确认Webhook事件与令牌权限 #

• 检查GitHub仓库的Webhook配置（仓库→Settings→Webhooks），确保勾选了Push事件（选择Just the push event或手动勾选Push选项）。
• 验证GitHub访问令牌的权限：确保令牌拥有repo（全仓库权限）和admin:repo_hook（Webhook管理权限），可在GitHub个人设置→Developer settings→Personal access tokens中查看权限范围。

4. 排查Jenkins与K8S层面的日志 #

• 开启Jenkins Webhook调试日志：进入Manage Jenkins→System Log，添加日志记录器org.jenkinsci.plugins.github.webhook并设置级别为DEBUG，触发Push事件后查看是否有请求到达的日志。
• 查看Jenkins Pod日志：执行kubectl logs <jenkins-pod-name>，排查是否有Webhook请求的报错信息。
• 临时端口转发测试：执行kubectl port-forward svc/<jenkins-service-name> 8080:8080，在本地使用工具模拟GitHub Push payload发送到http://localhost:8080/github-webhook/，确认Jenkins能否接收并触发构建，排除Ingress层面的问题。

内容的提问来源于stack exchange，提问作者EilonA