入口:登录 → 推送渠道 → 「新增推送渠道」→ 类型选「自定义 Webhook」。一句话:只要对方提供一个 HTTP 地址,就能把线报推过去——QQ 机器人、自建服务、NAS 通知、企业内网接口都行。老版"万能推送"已渠道化,老教程里的旧版脚本跨域放行、"推送分离/推送内容格式"渠道级设置均已下线或迁移。
一、它能做什么
自定义 Webhook 是万能接入通道:任意支持 HTTP 的机器人/推送程序(QQ 机器人、自建服务、NAS 通知、企业内部接口……)都能接。特性:
- 请求方式 GET / POST 可选;
- 自定义推送地址、Headers、data 模板;
- 循环参数一次配置多目标并发(多个群号/多个设备);
- 丰富的变量占位符,点弹窗里的变量芯片直接插入。
二、字段详解(渠道配置弹窗)
| 字段 | 说明 |
|---|---|
| 接口备注名 | 必填;规则页按备注名勾选本渠道 |
| 请求方式 | GET 或 POST,按你的程序 API 文档定 |
| 推送地址 | 接口 URL;支持 {标题}{链接}{分类名} 等变量;GET 可填多行=一次多请求(逐条推送) |
| Headers | JSON 请求头,如 {"Content-Type": "application/json"};可放 Cookie/UA/鉴权 |
| data 模板 | POST 请求体;JSON 或表单字符串,支持全部变量 |
| 循环参数 | 多目标用 # 分隔(如 3 个群号),data 里用 {推送循环参数} 占位,逐个值并发提交 |
| 循环间隔(秒) | 多目标之间的发送间隔,默认 2 秒(防触发对方限频) |
| 快速模板 | 常见应用一键填好请求参数,改循环参数即可用 |
三、变量全集
内容变量(取线报原文):{标题} {纯文字内容} {Html内容} {Markdown内容} {链接} {分类名} {分类ID} {日期} {时间} {楼主} {内容摘要}(前 100 字){价格} {商城} {品牌} {图片}(值得买内容)。
组装变量:{推送内容} = 该规则「推送格式」拼好的整条消息(聚合推送时=合并后的整批文本);{推送循环参数} = 循环参数的当前值。
单条消息的推送格式(如 {标题}【{分类名}】{链接})在「推送规则」里按规则配置,渠道不再设置——同一渠道可被不同规则以不同格式推送。
四、两个典型示例
示例1|QQ 机器人(JSON POST,3 个群并发)
循环参数:44654878#54568789#5645671
Headers:{"Content-Type": "application/json"}
data:{"group_id": "{推送循环参数}", "message": "{推送内容}"}
引擎会用 3 个群号逐个替换占位符,并发提交 3 个请求。
示例2|表单格式(x-www-form-urlencoded)
Headers:{"Content-Type": "application/x-www-form-urlencoded"}
data:group_id={推送循环参数}&message={推送内容}
五、成功判定与排错
- HTTP 2xx = 成功;4xx(除 429)= 永久失败(检查参数);429 = 对方限频(降频或加循环间隔);5xx/超时 = 瞬时失败自动重试;
- 云端推送由服务器发起、设备托管由浏览器扩展或托管脚本代发,均无跨域限制(老教程里的域名放行设置已不需要);
- 云端推送会拦截内网/本机地址(安全校验,如 127.0.0.1、192.168.x.x)。要推给内网服务,请把该渠道设为设备托管,由你自己的设备去请求;
- 失败原因看查看推送报错(推送日志逐条带错误信息)。
常见问题
填了内网地址保存不了 / 一直失败?
云端推送出于安全不允许请求内网地址。把渠道的推送方式改为「设备托管」,并确保扩展或托管脚本与目标服务在同一网络即可。
{推送内容} 和我自己写的模板有什么区别?
{推送内容} 是该规则「推送格式」拼好的整条消息,适合“直接转发”;自己写 data 模板则完全自定义结构。两种可以混用。
最近更新
- 2026-10:万能推送渠道化为「自定义 Webhook」;新增快速模板与变量芯片;{正文} 更名 {纯文字内容},{内容} 并入 {推送内容};推送格式迁到规则级;新增循环间隔与成功判定状态机。
此页内容对你有帮助吗?
感谢你的反馈!我们会持续改进文档质量。
