mirror of
https://github.com/AstrBotDevs/AstrBot
synced 2026-07-15 17:30:13 +08:00
* fix: remove trailing comma in JSON example in plugin-config doc * fix: remove trailing comma in JSON example in plugin-config doc * Update knowledge-base.md * Update knowledge-base.md * Update websearch.md * Update websearch.md * Update websearch.md * Update plugin-publish.md * Update lark.md * Update unified-webhook.md * Update discord.md * Update wecom.md * html * html * Update websearch.md * html * Update start.md * Update start.md * Apply suggestions from code review Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
1.7 KiB
1.7 KiB
统一 Webhook 模式
在 v4.8.0 版本开始,AstrBot 支持统一 Webhook 模式 (unified_webhook_mode)。开启该模式后,所有支持该模式的平台适配器都将使用同一个 Webhook 回调接口,从而简化了反向代理和域名配置,不再需要给每一个机器人适配器单独配置端口、域名和反向代理。
支持统一 Webhook 模式的平台适配器包括:
- Slack Webhook 模式
- 微信公众平台
- 企业微信客服机器人
- 企业微信智能机器人
- 微信客服机器人
- QQ 官方机器人 Webhook 模式
- ...
如何使用统一 Webhook 模式
- 拥有一个域名(如 example.com)和公网 IP 服务器
- 配置 DNS 解析(如 astrbot.example.com)
- 配置反向代理,将域名的 80 或 443 端口请求转发到 AstrBot 的 WebUI 端口(默认为 6185)
- 前往 AstrBot
配置文件页,点击系统,将对外可达的回调接口地址填写为配置的 URL 地址。(如 https://astrbot.example.com),点击保存,等待重启。
在之后配置各个平台适配器时,选择开启 统一 Webhook 模式 (unified_webhook_mode)。
Tip
如果您正在尝试更新 v4.8.0 之前配置的机器人适配器,你可能无法看到
统一 Webhook 模式 (unified_webhook_mode)选项。请重新创建一个新的适配器实例,即可看到该选项。
开启该模式后,AstrBot 会为你生成一个唯一的 Webhook 回调链接,你只需要将该链接填写到各个平台的回调地址处即可。

