本文按官方教程步骤整理,并补充匹配规则与排错细节,方便把小红书开播通知接到一号录播上,实现开播即录。
一、原理
官方教程里的原话:
通过拦截安卓端小红书的直播开播通知,提取关键信息转发到桌面端一号录播,一号录播根据主播名称找到已经开播的数据进行开播检测。
拆开看就是三段:
- 手机端:安卓手机收到小红书的开播通知;
- 转发:通知转发器把这条通知转成 HTTP 请求,发到电脑上;
- 电脑端:一号录播收到后,按通知里的主播名,在监控列表里找到对应条目,立刻检测是否开播;开播就开始录。
关键点:通知只负责「催一下」,真正录制的是你电脑上那条监控项。所以第一步必须先把主播加进软件。
二、准备清单
| 项目 | 要求 |
|---|---|
| 电脑 | 一号录播运行中,已添加该主播的监控项 |
| 手机 | 安卓手机(需安装小红书 App 并登录) |
| 转发工具 | 安卓版「蝌蚪通知转发器」(官方推荐,前往其首页下载即可) |
| 网络 | 手机与电脑在同一个内网(同一 Wi-Fi) |
| 关注关系 | 在小红书里关注目标主播,建议设为星标关注 |
三、执行步骤
步骤 1:在一号录播添加需要监控的主播
点左上角「解析」,粘贴主播的主页链接。官方教程给出的链接格式:
https://www.xiaohongshu.com/user/profile/627c529a000000002102bc21
也就是 https://www.xiaohongshu.com/user/profile/{用户ID}。
添加后软件会解析出主播昵称等信息,界面通常显示「识别网站: 小红书号监控(监控链接无需预解析)」之类。
按官方教程,这一步的目的是先拿到主播名称等信息,不需要开启监控——触发录制交给后面的开播通知。
如果你希望软件自己也轮询兜底(通知万一没送到也能录),可以把该条「自动录制」设为「是(需设置中开启自动录制)」,并在设置 → 开启自动录制打开总开关。
补充:如果只能拿到小红书号,也可以用「网站下拉选『小红书』+ 填小红书号」的方式,软件会拼成 https://www.xiaohongshu.com/red_id/profile/{小红书号},同样能识别。但官方推荐用 user/profile 主页链接,优先照这个来。
步骤 2:安装安卓「蝌蚪通知转发器」
- 在安卓手机上下载安装蝌蚪通知转发器(官方说明:直接前往其首页下载即可);
- 打开后授予通知读取权限(系统设置 → 通知使用权 / 通知访问),否则读不到小红书推送;
- 确保系统没有把它后台杀掉:关闭省电策略、允许后台运行、允许自启动。
步骤 3:获取内网回调地址
打开一号录播 → 设置 → 通知回调(窗口标题为「开播推送」):
- 勾选「启用开播推送」(不勾选不会监听端口);
- 窗口上方显示一行 Webhook 地址,点「复制地址」,例如:
官方教程特意提醒:内网地址会不一样,请确保手机和一号录播处于同一内网,通知才能转发过来。http://192.168.0.114:18081/live - 正常状态下会显示:「服务已启动。收到推送后会按 appLabel 匹配平台、streamer 匹配主播,并检测对应监控项是否已开播。最多保留 200 条。」若显示「服务未启动」,通常是 18081 端口被占用。
把这个地址填到转发器的推送配置里(POST)。地址约每 2 秒自动刷新,换了 Wi-Fi 后记得重新复制。
步骤 4:转发器监听小红书并推送
在蝌蚪通知转发器里:
- 新建 / 配置通知通道,把上一步复制的地址填进去;
- 选择监听小红书这一个应用(只放行小红书,避免其他 App 通知刷屏);
- 推送方式选推送到一号录播(即 HTTP POST 到该地址)。
步骤 5:在小红书里关注主播(关键)
官方教程最后一步:
去小红书关注监控的主播,最好设置为星标关注,这样每次开播都能推送;非星标要每次开播前都要预约开播通知。
这条很容易被忽略,但决定了整套流程能不能跑通:
- 星标关注:每次开播都会推通知 → 全自动;
- 普通关注:需要你每次手动点「预约开播」才会有通知 → 容易漏。
所以添加完监控项后,务必去小红书 App 里把该主播设为星标关注。
四、验证是否接通
在「开播推送」窗口里可以看到最近 200 条接收记录,四列为:接收时间 / 来源 IP / 匹配结果 / Body 预览。点一行可看完整详情(含 Content-Type、Query、User-Agent、原始 Body)。
验证方法:让主播开播一次,或自己发一条测试推送,看列表里是否出现新记录、匹配结果是否显示「已匹配 N 项,正在检测是否开播」。
五、进阶:推送字段与匹配规则
转发器推送的是一段 JSON,一号录播按这些字段识别(了解它有助于排查「为什么没匹配上」):
| 字段 | 是否必填 | 说明 |
|---|---|---|
packageName |
二选一 | 小红书包名,含 xingin / xiaohongshu / xhs 任一即可,如 com.xingin.xhs |
appLabel |
二选一 | 应用显示名,填「小红书」 |
title |
建议 | 通知标题 |
text |
建议 | 通知正文 |
dump |
可选 | 通知原始文本,识别率最高 |
streamer |
可选 | 显式指定主播名,优先级最高 |
平台识别包名优先,包名没匹配上才用 appLabel。
主播名提取顺序:
- 正文里的
@昵称 开播了; dump里的android.text/text;- 通知标题(会自动剥掉
[你的关注]、[你预约的]、[特别关注]等标签,以及「正在直播中」「刚刚开始直播」「开播了」等后缀); streamer字段;dump里的host_nickname=参数。
匹配方式:去掉空格和符号、忽略大小写后比较,再做相似度判断。小红书专门放宽了阈值(长名 0.6、≤3 字短名 0.62,比其他平台宽松),以适应昵称里的括号、表情、空格。
典型通知样例:
样例1:title=你预约的直播开始啦,text=@以茉的温柔日记(冲1000粉) 开播了
样例2:title=赴海(国一橘右京) [你的关注],text=正在直播:房间标题
六、收到推送后会发生什么
- 找到匹配项 → 立刻对该监控项做一次解析;
- 该项已在下载中 / 准备中 / 浏览器解析中 → 跳过,不会重复录;
- 该项已取消或已关闭 → 跳过;
- 解析失败 → 30 秒后自动重试一次,仍失败会发一条「开播推送解析失败」的站内通知;
- 一条推送可同时命中多个监控项。
七、排错对照表
| 现象 / 提示 | 原因 | 处理 |
|---|---|---|
| 未匹配到监控项:平台=小红书,主播=xxx | 通知里的昵称和监控项名字差太多 | 把监控项主播名改成和通知一致 |
| 未识别平台:xxx | 包名 / appLabel 未命中 | 确认包名为小红书,或补 appLabel: 小红书 |
| 缺少 appLabel 或主播标识 | 平台和主播名都没有 | 转发器里保留包名和正文 |
| Body 不是 JSON | 推送的不是 JSON | 转发器里设置 application/json |
| 解析失败:…,30秒后重试 | 网络或 Cookie 问题 | 检查网络,补充小红书 Cookie(a1、web_session) |
| 已开播(下载中),跳过 | 已在录制 | 正常 |
| 列表一直没有新记录 | 手机电脑不同内网 / 转发器权限没给 / 端口被占 | 逐项检查;确认防火墙放行 18081 |
| 主播开播了但没通知 | 非星标关注 | 去小红书设为星标关注,或每次手动预约 |
| 换 Wi-Fi 后失效 | 内网 IP 变了 | 重新复制 Webhook 地址 |
八、常见问答
Q:一定要用蝌蚪通知转发器吗?
A:官方教程推荐它。从原理上说,任何能把安卓通知转成 HTTP POST 发到 http://<内网IP>:18081/live 的工具都可以,一号录播只负责接收。
Q:需要电脑一直开着吗?
A:需要。通知是实时的,电脑关机或睡眠期间收不到,也不会补录。
Q:还要不要开监控轮询?
A:官方步骤说首次添加不需要开监控,靠通知触发即可。想更稳可以再打开自动录制作为兜底。
Q:小红书解析需要 Cookie 吗?
A:需要(涉及 a1、web_session)。软件内置小红书 Cookie 槽池会自动轮询可用槽位,你也可以在 Cookie 管理里补充自己的 Cookie,提高稳定性。
Q:自动录制时长有下限吗?
A:有,小红书最少 5 分钟,填小于 5 会被自动纠正为 5(快手同样)。
九、相关入口
- 官方教程原文:https://bestlive.cc/blog/2102241242286489602
- 软件内入口:帮助菜单 → 小红书监控教程
- 下载一号录播:蝌蚪直播录制助手
请遵守平台规则与当地法律法规,仅录制你有权保存的内容。