| # 统一 Webhook 模式 |
|
|
| 在 v4.8.0 版本开始,AstrBot 支持统一 Webhook 模式 (unified_webhook_mode)。开启该模式后,所有支持该模式的平台适配器都将使用同一个 Webhook 回调接口,从而简化了反向代理和域名配置,不再需要给每一个机器人适配器单独配置端口、域名和反向代理。 |
|
|
| 支持统一 Webhook 模式的平台适配器包括: |
|
|
| - Slack Webhook 模式 |
| - 微信公众平台 |
| - 企业微信客服机器人 |
| - 企业微信智能机器人 |
| - 微信客服机器人 |
| - QQ 官方机器人 Webhook 模式 |
| - ... |
|
|
| ## 如何使用统一 Webhook 模式 |
|
|
| 1. 拥有一个域名(如 example.com)和公网 IP 服务器 |
| 2. 配置 DNS 解析(如 astrbot.example.com) |
| 3. 配置反向代理,将域名的 80 或 443 端口请求转发到 AstrBot 的 WebUI 端口(默认为 7860) |
| 4. 前往 AstrBot `配置文件` 页,点击 `系统`,将 `对外可达的回调接口地址` 为配置的 URL 地址。(如 https://astrbot.example.com),点击保存,等待重启。 |
|
|
|
|
| 在之后配置各个平台适配器时,选择开启 `统一 Webhook 模式 (unified_webhook_mode)`。 |
|
|
| > [!TIP] |
| > 如果您正在尝试更新 v4.8.0 之前配置的机器人适配器,你可能无法看到 `统一 Webhook 模式 (unified_webhook_mode)` 选项。请重新创建一个新的适配器实例,即可看到该选项。 |
|
|
|  |
|
|
| 开启该模式后,AstrBot 会为你生成一个唯一的 Webhook 回调链接,你只需要将该链接填写到各个平台的回调地址处即可。 |
|
|
|  |
|
|