前言
通过 STUN 内网穿透获得的公网 IP 地址和端口号具有不确定性，而在管理页面中手动监控穿透地址的变化显然不现实。为此，WebHook 提供了一种有效的解决方案。
WebHook 是一种用户定义的 HTTP 回调机制，通常用于在特定事件发生时向指定的 URL 发送实时数据。它允许不同应用程序之间进行实时通信，广泛应用于集成和自动化任务。例如，当某个事件发生时，系统会向预先配置的 URL 发送一个 HTTP POST 请求，并携带相关数据。
在 STUN 内网穿透的应用场景中，WebHook 的主要作用包括：
- 事件通知：WebHook 可用于通知外部服务器或客户端某个事件的发生，例如穿透地址的变化等。
观前提醒： 本教程将演示 WebHook 在 Lucky 的 STUN 内网穿透功能中的应用，因此假设读者已提前安装 Lucky。Lucky 的 GitHub 项目网址及使用指南网站如下：
WebHook 简易教程
目录
- 1.1 Bark
- 1.1.1 安装软件
- 1.1.2 复制链接并细化设置
- 1.1.3 收尾
- 1.2 PushDeer（官方在线版）
- 1.2.1 安装软件
- 1.2.2 复制 Key 链接并细化设置
- 1.2.3 收尾
1.1 Bark
1.1.1 安装软件
在 App Store 中搜索“Bark”，找到 Bark - Custom Notifications 并下载安装。无需切换地区。
1.1.2 复制链接并细化设置
在 Bark 中，复制 https://api.day.app/deviceKey 并将其填入 Lucky 的 STUN 穿透规则的“接口地址”中。
在穿透规则编辑页面中，“请求方法”选择“GET”，“请求头”不填，“重试次数”与“重试间隔”按需填写，“接口调用成功包含的字符串”填写“success”。
为了让推送通知更容易理解，通常需要在接口地址后添加变量。Lucky 的 STUN 穿透规则支持以下变量：
- {time}：触发 WebHook 的时间
- {ipAddr}：当前 STUN 穿透获得的公网 IP 地址（含端口），比如 192.168.1.1:16666
- {ip}：当前 STUN 穿透获得的公网 IP 地址的 IP 部分，比如 192.168.1.1
- {port}：当前 STUN 穿透获得的公网 IP 地址中的端口部分，比如 16666
- {ruleName}：规则名称
假设需要推送通知的标题为“规则名称+触发时间”，内容为“穿透地址（含端口）”，则接口地址可以写为：
-
https://api.day.app/deviceKey/{ruleName}%20{time}/{ipAddr}
%20 在 URL 中表示空格。
1.1.3 收尾
保存规则修改并启用规则，在获取到公网 IP 地址后，若“WebHook 触发时间”中出现时间和“成功”且 iOS 设备收到通知，则意味着 WebHook 配置成功。在 iOS 设备中，可点击推送通知跳转到 Bark 并点击“Copy the Content”以复制通知内容。
只要 iOS 设备未离线，穿透地址变化时设备通常会立刻接收到推送通知。
1.2 PushDeer（官方在线版）
1.2.1 安装软件
在 App Store 中搜索“PushDeer”，找到 PushDeer（不是 PushDeer 自架版！） 并下载安装。无需切换地区。
1.2.2 复制 Key 与链接并细化设置
登录 PushDeer 后，在“Key”中，复制 Key 并填入以下地址，然后将地址填入 Lucky 的 STUN 穿透规则的“接口地址”中：
-
https://api2.pushdeer.com/message/push?pushkey=key&text=要发送的内容
在穿透规则编辑页面中，“请求方法”选择“GET”，“请求头”不填，“重试次数”与“重试间隔”按需填写，“接口调用成功包含的字符串”填写“success”。
为了让推送通知更容易理解，通常需要在接口地址中添加变量。Lucky 的 STUN 穿透规则支持以下变量：
- {time}：触发 WebHook 的时间
- {ipAddr}：当前 STUN 穿透获得的公网 IP 地址（含端口），比如 192.168.1.1:16666
- {ip}：当前 STUN 穿透获得的公网 IP 地址的 IP 部分，比如 192.168.1.1
- {port}：当前 STUN 穿透获得的公网 IP 地址中的端口部分，比如 16666
- {ruleName}：规则名称
假设需要推送通知的内容为“规则名称+穿透地址（含端口）”，则接口地址可以写为：
-
https://api2.pushdeer.com/message/push?pushkey=key&text={ruleName}%20{ipAddr}
%20 在 URL 中表示空格。
1.2.3 收尾
保存规则修改并启用规则，在获取到公网 IP 地址后，若“WebHook 触发时间”中出现时间和“成功”且 iOS 设备收到通知，则意味着 WebHook 配置成功。在 iOS 设备中，可点击推送通知跳转到 PushDeer 并在“Message”中复制通知内容。
只要 iOS 设备未离线，穿透地址变化时设备通常会立刻接收到推送通知。
Extra
十教程帖数已到，站长火速给称号！（
后续随缘更新捏~
jA0ECQMIIgzW9enl6hX/0mUBZBShZg9pNYVwkWmbmTGdO8f7shfiGzrWuBUERE74
zY0z3JtCUbb+Ka6UBW2w1gTKXFTcpfq5FlZVMPFkbiXL5GOnkrpC9uYhqz94G1y7
vMIZJaYu4eICaQeOxAe7JawK1VbWEw==
=t+0i
