如何用Gogs Webhooks打通Slack、Discord与钉钉Git事件推送与签名验证实战教程【免费下载链接】gogsThe painless way to host your own Git service项目地址: https://gitcode.com/GitHub_Trending/go/gogsGogs Webhooks 是把你的 Git 仓库动态实时推送到 Slack、Discord 与钉钉群的利器每当有人 push 代码、提 Issue 或发起 Pull RequestGogs 就会自动向预设的 URL 发送一次 HTTP POST 请求。本文手把手带你完成三大平台的接入配置并讲透X-Gogs-Signature签名验证实战方法让团队通知又快又安全。Gogs Webhook 是什么一次 POST 搞定所有 Git 事件Gogs 内置了 4 种 Webhook 类型覆盖不同接收端类型说明适用场景Gogs原生 JSON 格式包含完整事件详情自建 CI、告警系统Slack自动转成 Slack 消息格式Slack 团队群通知Discord自动转成 Discord Embed 富文本Discord 社区/频道DingTalk自动转成钉钉 ActionCard 卡片钉钉工作群推送支持的事件类型共 8 种Push、Issues、Issue Comment、Pull Request、Fork、分支/Tag 创建、分支/Tag 删除、Release全部在 internal/database/webhook.go 中定义。 三种聊天平台类型无需写任何代码Gogs 会自动把 payload 转成对方平台认识的格式这是新手最省心的地方。三步添加 Gogs Webhook选择事件与格式进入目标仓库点击设置 → Webhooks对应 templates/repo/settings/webhook/new.tmpl 渲染的页面选择Add Webhook在列表顶部切换类型gogs / slack / discord / dingtalk填写 Payload URL 与事件开关保存即可。事件开关有三种模式Push Only只推送 push 事件Send Everything所有 8 种事件全推Choose Events自由勾选比如只关注 push pull_request。建议新手先用 Choose Events 只勾 Push验证成功后再逐步放开避免群里消息刷屏。Slack 接入步骤Payload URL、Channel 与配色设置Slack 侧在任意频道中创建一个 Incoming Webhook得到一条专属的https://hooks.slack.com/services/...地址。Gogs 侧需要填写定义见 internal/form/repo.go 的NewSlackHookPayload URL粘贴 Slack Webhook 地址必填Channel目标频道如#general必填不填会校验失败Username消息署名例如GogsIcon URL机器人头像图片地址Color附件左侧色条支持#dd4b39这类色值或good、warning、danger预设。payload 组装逻辑在 internal/database/webhook_slack.gopush 事件会生成谁向哪个分支推了 N 个 commit的消息并逐条附上 commit 短链接Issue 和 PR 事件则带出标题、正文与操作人。Discord Webhook 接入指南Embed 卡片一次配好Discord 侧进入频道设置 → 集成 → Webhooks创建一个频道 Webhook 并复制 URL。Gogs 侧字段与 Slack 类似NewDiscordHook表单Payload URLDiscord Webhook 地址必填Username / Icon URL机器人显示名与头像ColorEmbed 卡片主题色。Discord 的 payload 由 internal/database/webhook_discord.go 生成特点是带彩色 Embed 卡片push 事件显示 commit 数量链接Issue 事件会把指派人、标签、里程碑等信息做成卡片字段Fields合并 PR 时会明确显示 Pull request merged。钉钉自定义机器人接入方法ActionCard 卡片推送钉钉侧在目标群中添加自定义机器人安全设置建议选加签或关键词关键词填Gogs即可放行全部通知复制机器人返回的 Webhook 地址。Gogs 侧只需一个字段Payload URL直接粘贴钉钉机器人地址表单定义见 internal/form/repo.go 的NewDingtalkHook。钉钉消息由 internal/database/webhook_dingtalk.go 组装为 ActionCard 卡片Push 事件列出全部 commit序号 短链 作者 提交说明底部附 View Changes 跳转按钮Issue / PR 事件卡片直接嵌入问题正文或 PR 描述点击 View Issue 一键跳转。⚠️ 注意若钉钉机器人开启了加签安全设置钉钉侧要求带timestamp与sign参数Gogs 的固定 URL 无法满足请改用关键词或IP 段方式验证否则消息会被钉钉拒收。X-Gogs-Signature 签名验证实战指南如果接收端暴露在内网外一定要校验签名防止伪造请求。Gogs 每次投递都会带上三个请求头见 docs/advancing/webhooks.mdx请求头含义X-Gogs-Delivery本次投递的唯一 UUID可用于幂等去重X-Gogs-Event事件类型如push、issuesX-Gogs-Signature用你的 Secret 对 payload 做 HMAC-SHA256 后的十六进制摘要在 Webhook 设置页填写Secret后Gogs 会在 internal/database/webhook.go 的prepareHookTasks中对最终 payload 计算 HMAC-SHA256 并随请求发出。接收端只需几行 Python 即可校验import hashlib, hmac, json body request.get_data() expected request.headers[X-Gogs-Signature] calc hmac.new(SECRET.encode(), body, hashlib.sha256).hexdigest() if not hmac.compare_digest(calc, expected): abort(403) # 签名不符拒绝处理校验通过后再解析X-Gogs-Event分发事件即可。Gogs 原生格式的 push payload 中包含pusher/sender用户对象含avatar_url头像方便接收端渲染谁触发了事件。Webhook 投递失败调试清单Gogs 的投递是异步执行的事件先入队HookQueue由后台DeliverHooks循环逐条发出并记录每次请求/响应的完整报文。排查时按下面顺序看看历史Webhook 列表页可展开每条任务的投递历史状态码、请求头、响应体模板见 templates/repo/settings/webhook/history.tmpl看状态只有 2xx 响应才算投递成功Slack/Discord 返回 200 不代表消息发成功需在平台侧确认看网络Gogs 会拒绝跟随任何重定向防止签名 payload 被偷偷转投且默认拦截指向内网地址的 Payload URL先测试保存后点击Test Push不依赖真实提交即可立刻验证链路是否通。常见问题 FAQQ1选了 Slack 类型Slack 里收到的是原始 JSON 吗不是。Slack/Discord/DingTalk 类型会自动转换成平台原生消息格式只有 Gogs 类型发送的是完整原生 JSON payload。Q2签名 Secret 对所有类型都生效吗是的。无论哪种类型只要填写了 SecretGogs 都会对转换后的最终 payload 计算X-Gogs-Signature接收端统一校验即可。Q3能对整个组织统一推送吗可以。组织仓库会自动叠加组织级 Webhook见 internal/database/webhook.go 的prepareWebhooks适合把全组织的 push/PR 动态集中推到一个总群。Q4投递是实时的吗事件先写入数据库再由后台队列异步投递通常秒级到达同一仓库的投递按队列串行天然避免并发冲击。至此你已经掌握了 Gogs Webhook 的完整链路添加 Hook → 三大平台接入 → 签名验签 → 投递调试。从仓库的templates/repo/settings/webhook/目录dingtalk.tmpl、discord.tmpl 等还能进一步对照每种类型的表单字段按需扩展你的 Git 事件通知体系。【免费下载链接】gogsThe painless way to host your own Git service项目地址: https://gitcode.com/GitHub_Trending/go/gogs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何用Gogs Webhooks打通Slack、Discord与钉钉：Git事件推送与签名验证实战教程
如何用Gogs Webhooks打通Slack、Discord与钉钉Git事件推送与签名验证实战教程【免费下载链接】gogsThe painless way to host your own Git service项目地址: https://gitcode.com/GitHub_Trending/go/gogsGogs Webhooks 是把你的 Git 仓库动态实时推送到 Slack、Discord 与钉钉群的利器每当有人 push 代码、提 Issue 或发起 Pull RequestGogs 就会自动向预设的 URL 发送一次 HTTP POST 请求。本文手把手带你完成三大平台的接入配置并讲透X-Gogs-Signature签名验证实战方法让团队通知又快又安全。Gogs Webhook 是什么一次 POST 搞定所有 Git 事件Gogs 内置了 4 种 Webhook 类型覆盖不同接收端类型说明适用场景Gogs原生 JSON 格式包含完整事件详情自建 CI、告警系统Slack自动转成 Slack 消息格式Slack 团队群通知Discord自动转成 Discord Embed 富文本Discord 社区/频道DingTalk自动转成钉钉 ActionCard 卡片钉钉工作群推送支持的事件类型共 8 种Push、Issues、Issue Comment、Pull Request、Fork、分支/Tag 创建、分支/Tag 删除、Release全部在 internal/database/webhook.go 中定义。 三种聊天平台类型无需写任何代码Gogs 会自动把 payload 转成对方平台认识的格式这是新手最省心的地方。三步添加 Gogs Webhook选择事件与格式进入目标仓库点击设置 → Webhooks对应 templates/repo/settings/webhook/new.tmpl 渲染的页面选择Add Webhook在列表顶部切换类型gogs / slack / discord / dingtalk填写 Payload URL 与事件开关保存即可。事件开关有三种模式Push Only只推送 push 事件Send Everything所有 8 种事件全推Choose Events自由勾选比如只关注 push pull_request。建议新手先用 Choose Events 只勾 Push验证成功后再逐步放开避免群里消息刷屏。Slack 接入步骤Payload URL、Channel 与配色设置Slack 侧在任意频道中创建一个 Incoming Webhook得到一条专属的https://hooks.slack.com/services/...地址。Gogs 侧需要填写定义见 internal/form/repo.go 的NewSlackHookPayload URL粘贴 Slack Webhook 地址必填Channel目标频道如#general必填不填会校验失败Username消息署名例如GogsIcon URL机器人头像图片地址Color附件左侧色条支持#dd4b39这类色值或good、warning、danger预设。payload 组装逻辑在 internal/database/webhook_slack.gopush 事件会生成谁向哪个分支推了 N 个 commit的消息并逐条附上 commit 短链接Issue 和 PR 事件则带出标题、正文与操作人。Discord Webhook 接入指南Embed 卡片一次配好Discord 侧进入频道设置 → 集成 → Webhooks创建一个频道 Webhook 并复制 URL。Gogs 侧字段与 Slack 类似NewDiscordHook表单Payload URLDiscord Webhook 地址必填Username / Icon URL机器人显示名与头像ColorEmbed 卡片主题色。Discord 的 payload 由 internal/database/webhook_discord.go 生成特点是带彩色 Embed 卡片push 事件显示 commit 数量链接Issue 事件会把指派人、标签、里程碑等信息做成卡片字段Fields合并 PR 时会明确显示 Pull request merged。钉钉自定义机器人接入方法ActionCard 卡片推送钉钉侧在目标群中添加自定义机器人安全设置建议选加签或关键词关键词填Gogs即可放行全部通知复制机器人返回的 Webhook 地址。Gogs 侧只需一个字段Payload URL直接粘贴钉钉机器人地址表单定义见 internal/form/repo.go 的NewDingtalkHook。钉钉消息由 internal/database/webhook_dingtalk.go 组装为 ActionCard 卡片Push 事件列出全部 commit序号 短链 作者 提交说明底部附 View Changes 跳转按钮Issue / PR 事件卡片直接嵌入问题正文或 PR 描述点击 View Issue 一键跳转。⚠️ 注意若钉钉机器人开启了加签安全设置钉钉侧要求带timestamp与sign参数Gogs 的固定 URL 无法满足请改用关键词或IP 段方式验证否则消息会被钉钉拒收。X-Gogs-Signature 签名验证实战指南如果接收端暴露在内网外一定要校验签名防止伪造请求。Gogs 每次投递都会带上三个请求头见 docs/advancing/webhooks.mdx请求头含义X-Gogs-Delivery本次投递的唯一 UUID可用于幂等去重X-Gogs-Event事件类型如push、issuesX-Gogs-Signature用你的 Secret 对 payload 做 HMAC-SHA256 后的十六进制摘要在 Webhook 设置页填写Secret后Gogs 会在 internal/database/webhook.go 的prepareHookTasks中对最终 payload 计算 HMAC-SHA256 并随请求发出。接收端只需几行 Python 即可校验import hashlib, hmac, json body request.get_data() expected request.headers[X-Gogs-Signature] calc hmac.new(SECRET.encode(), body, hashlib.sha256).hexdigest() if not hmac.compare_digest(calc, expected): abort(403) # 签名不符拒绝处理校验通过后再解析X-Gogs-Event分发事件即可。Gogs 原生格式的 push payload 中包含pusher/sender用户对象含avatar_url头像方便接收端渲染谁触发了事件。Webhook 投递失败调试清单Gogs 的投递是异步执行的事件先入队HookQueue由后台DeliverHooks循环逐条发出并记录每次请求/响应的完整报文。排查时按下面顺序看看历史Webhook 列表页可展开每条任务的投递历史状态码、请求头、响应体模板见 templates/repo/settings/webhook/history.tmpl看状态只有 2xx 响应才算投递成功Slack/Discord 返回 200 不代表消息发成功需在平台侧确认看网络Gogs 会拒绝跟随任何重定向防止签名 payload 被偷偷转投且默认拦截指向内网地址的 Payload URL先测试保存后点击Test Push不依赖真实提交即可立刻验证链路是否通。常见问题 FAQQ1选了 Slack 类型Slack 里收到的是原始 JSON 吗不是。Slack/Discord/DingTalk 类型会自动转换成平台原生消息格式只有 Gogs 类型发送的是完整原生 JSON payload。Q2签名 Secret 对所有类型都生效吗是的。无论哪种类型只要填写了 SecretGogs 都会对转换后的最终 payload 计算X-Gogs-Signature接收端统一校验即可。Q3能对整个组织统一推送吗可以。组织仓库会自动叠加组织级 Webhook见 internal/database/webhook.go 的prepareWebhooks适合把全组织的 push/PR 动态集中推到一个总群。Q4投递是实时的吗事件先写入数据库再由后台队列异步投递通常秒级到达同一仓库的投递按队列串行天然避免并发冲击。至此你已经掌握了 Gogs Webhook 的完整链路添加 Hook → 三大平台接入 → 签名验签 → 投递调试。从仓库的templates/repo/settings/webhook/目录dingtalk.tmpl、discord.tmpl 等还能进一步对照每种类型的表单字段按需扩展你的 Git 事件通知体系。【免费下载链接】gogsThe painless way to host your own Git service项目地址: https://gitcode.com/GitHub_Trending/go/gogs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考