DDNS 换 IP 一分钟内收到通知：Lucky Webhook 变更通知实战

DDNS 换 IP 一分钟内收到通知Lucky Webhook 变更通知实战【免费下载链接】lucky软硬路由公网神器,ipv6/ipv4 端口转发,反向代理,DDNS,WOL,ipv4 stun内网穿透,cron,acme,rclone,ftp,webdav,filebrowser项目地址: https://gitcode.com/GitHub_Trending/luc/lucky凌晨两点公网 IP 切换你却是第二天翻日志才发现远程访问已经断了 8 小时。Lucky Webhook 解决的就是这件事DDNS 任务完成域名更新后自动向预设地址发一次 HTTP 回调把新 IP 和域名状态带过去DDNS 变更通知直接推到你面前。花 30 秒看懂 DDNS 通知的触发时机Lucky 的 Webhook 就是一个 HTTP 回调DDNS 任务执行后只要域名记录发生了变化就按你设定的方法向预设 URL 发请求收到响应后做什么由你决定——发消息、跑脚本、写日志库都行。核心逻辑在 ddnscore.go/webhook.go。默认只在 IP 有变化、且域名更新成功或失败时才回调在任务设置里勾选获取 IP 失败时触发后IP 获取失败也会发出通知。配置入口在任务编辑页对应前端组件 DDNS.vue。触发时机典型用途IP 变化、域名更新成功即时消息通知、自动化运维IP 变化、域名更新失败失败告警、人工跟进获取 IP 失败需开启对应开关可用性监控提醒手动点击Webhook 手动触发测试验证接口连通不动 DNS 记录配置 Webhook 五分钟推送第一条通知第一步打开开关、填 URL在 DDNS 任务编辑页打开 Webhook 开关把接收地址粘进 Webhook URL。钉钉、飞书、企业微信群机器人地址或你自己写的接口都能直接填。第二步填最简请求体方法选 POST默认以钉钉机器人为例复制下面这段即可{ msgtype: text, text: { content: DDNS通知\n新IP#{ipAddr}\n成功域名#{successDomains} } }第三步点测试按钮验证点击Webhook 手动触发测试它会用假数据IP 固定为 66.66.66.66发一次真实请求不会改动你的 DNS 记录返回成功就说明配置通了。保存后DDNS 任务列表里的每张任务卡片都会显示 Webhook 触发时间和触发结果调不通时点开错误原因能看到接口的原始响应。查一份变量替换速查表URL、请求头、请求体三个位置都支持变量触发时 Lucky 会先把#{}占位符做文本替换再发请求。说白了模板里写占位符、收到的是真实值。变量含义示例值#{ipAddr}当前公网 IP获取 IP 失败时显示获取 IP 失败2408:8256:xxxx::1#{successDomains}本次更新成功的域名逗号分隔home.example.com,www.example.com#{failedDomains}本次更新失败的域名逗号分隔sub.example.com#{successDomainsLine}成功域名换行分隔方便消息排版多行域名#{failedDomainsLine}失败域名换行分隔多行域名#{time}触发时间格式 2006-01-02 15:04:052026-09-19 14:05:33这里有个坑获取 IP 失败时成功/失败域名都是空#{ipAddr}会显示获取 IP 失败这段文字模板要按这个情况来写。落地三个场景通知、运维与归档用钉钉机器人接收 DDNS 变更通知家里服务器 IP 一变群里就该先收到消息。钉钉群机器人 Webhook 地址填 URL请求体用上面的 JSON 形式域名多时改用 Line 变量换行希望获取 IP 失败也提醒的话把获取 IP 失败时触发开关打开效果IP 一切换钉钉群直接收到新 IP 和受影响的域名。IP 变化时自动更新网关白名单出口 IP 变了网关的访问白名单还是旧 IP更新完访问就被拦用回调自动刷一下。自研接口收 POST解析#{ipAddr}再调网关 API 更新白名单规则回调请求有 20 秒超时接收端要快速返回别在里面串长耗时操作接口需要鉴权的话token 放请求头里效果DDNS 更新完成后网关白名单自动刷新全程无人工。把域名变更记录归档进日志库排查问题和审计都需要每次 IP 变化留痕、带时间戳。URL 指向 ELK 的 Filebeat HTTP input 或任意归档接口IP、域名、时间都放进 JSON 请求体纯归档场景可开启禁用成功字符串检测只以 HTTP 200 判定成功效果每一条域名变更在日志库里都变成一条可检索的审计记录。用速查表处理常见故障现象现象可能原因处理动作完全不触发开关没开或本次域名并没有实际变化确认 Webhook 开关与 URL先用测试按钮验证连通性测试通过、真实事件却没反应接口返回值没匹配到预设的成功内容把接口真实返回内容加进成功字符串或开启禁用成功字符串检测回调 400 / 401请求体格式不符、或缺少鉴权请求头用测试按钮发一次看错误详情补上 Content-Type 和 token 请求头IP 显示获取 IP 失败本次 IP 获取失败且开了获取失败触发检查获取 IP 方式网卡/URL与网络状态生产上建议把获取 IP 失败时触发打开——最难受的故障恰恰是 IP 没取到却没人告诉你。另外回调有 20 秒超时接收端务必快速响应能走 HTTPS 的接口尽量别用明文 HTTP。【免费下载链接】lucky软硬路由公网神器,ipv6/ipv4 端口转发,反向代理,DDNS,WOL,ipv4 stun内网穿透,cron,acme,rclone,ftp,webdav,filebrowser项目地址: https://gitcode.com/GitHub_Trending/luc/lucky创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考