视频列表监控教程

视频列表监控可以帮你「盯住」某个作者、频道或播放列表。一旦有新视频，监控端（鹰眼）会通知下载器，下载器自动解析并加入下载队列。适合想自动追更、不想反复手动复制链接的朋友。

一、它能做什么

• 持续关注指定视频列表（如某作者主页、播放列表等）。
• 发现新增视频后，自动推送到下载器。
• 可选择开启自动下载，新视频自动进入下载队列。
• 可在下载器里查看每次回调收到的视频记录和解析结果。

简单理解：鹰眼 负责「发现新视频」，下载器负责「接收通知并下载」。

二、开始前请准备

1. 已安装并登录下载器。下载地址：https://www.eagleeye123.com/
2. 已有可用的 鹰眼 监控服务（负责定时检查视频列表）。
3. 下载器需要保持运行，监控回调才能收到。
4. 若 鹰眼 和下载器不在同一台电脑，请保证两台电脑能互相访问（同一局域网更常见）。

三、在下载器中开启回调服务

1. 打开下载器，点击顶部菜单 设置 → 视频列表监控。
2. 勾选 启用 HTTP 回调服务。
3. 建议先用默认配置即可：
   • 监听地址：127.0.0.1（本机）
   • 监听端口：18889
   • 回调路径：/api/monitor/video-list/callback
4. 勾选 有新视频时自动下载新增视频（想自动下载就勾选；只想接收通知、手动处理可不勾）。
5. 点击 保存。
6. 看界面上的 服务状态：应显示「运行中」。如果是「未运行」，请重新打开该设置页确认已勾选启用并已保存。

页面中间有一行 回调地址（灰色不可编辑），例如：

http://127.0.0.1:18889/api/monitor/video-list/callback

点击 复制链接，后面填到 鹰眼 时会用到。

四、监听地址怎么填（重要）

• 鹰眼 和下载器在同一台电脑：监听地址填 127.0.0.1，回调地址直接用界面上显示的即可。
• 鹰眼 在另一台电脑 / 服务器：
  1. 监听地址不要填 127.0.0.1，请改成下载器所在电脑的局域网 IP，例如 192.168.1.20。
  2. 如何查看本机 IP：Windows 可在命令提示符输入 ipconfig，找到「IPv4 地址」。
  3. 保存后，回调地址会变成类似：http://192.168.1.20:18889/api/monitor/video-list/callback。
  4. 请在下载器电脑防火墙中放行该端口（默认 18889），否则对面访问不通。

五、（可选）设置安全密钥

如果不想别人随便往你的下载器推送任务，可以设置鉴权。两边必须完全一致：

• X-Callback-Secret 密钥：下载器里填一个密钥；鹰眼 回调请求头里也要带同名同值的 X-Callback-Secret。
• Authorization 请求头：同理，两边填写相同内容（例如 Bearer xxxxx）。

平时自己本机用，可以先不填；跨机器、长期使用时建议填上。

六、在 鹰眼 中配置监控任务

1. 在 鹰眼 新建或编辑「视频列表监控」任务。
2. 在任务的回调配置（callbackConfig）里：
   • url：粘贴下载器里复制的回调地址。
   • 若设置了密钥/鉴权：在 headers 中补上对应的 X-Callback-Secret、Authorization。
3. 按 鹰眼 的说明填好要监控的列表地址、检查频率等，保存并启动任务。

之后当列表出现新视频时，鹰眼 会向下载器发送通知；下载器开启自动下载后，会筛选新增条目并解析下载。

七、查看收到了哪些视频

1. 打开 设置 → 视频列表监控。
2. 点击 查看回调视频列表。
3. 这里可以看到标题、链接、作者、时间、是否新增、解析情况等。
4. 双击某一行，或选中后点「复制链接」，可复制该视频地址。
5. 解析情况常见含义：
   • 已接收：已收到通知
   • 解析中：正在解析
   • 解析成功：已解析并进入后续下载流程
   • 解析失败：解析出错（可看具体提示，或手动复制链接再解析）
   • 已跳过：例如本次无更新、无播放链接、未开启自动下载等

八、日常使用注意

• 监控期间请保持下载器开启；关闭后收不到回调。
• 电脑休眠、断网、改 IP、改端口后，请重新确认「服务状态」和回调地址是否仍正确。
• 改了监听地址/端口后，记得重新复制回调地址，并同步更新 鹰眼 任务配置。
• 自动下载依赖下载器本身的登录状态、Cookie、清晰度等常规设置；若某平台需要登录 Cookie，请先在「Cookie 管理」中配好。
• 同一条回调不会重复处理；若觉得列表太长，可在历史窗口中清空记录（不影响已下载任务）。

九、常见问题

1. 服务状态一直是「未运行」？

请确认已勾选「启用 HTTP 回调服务」并点击保存。若端口被占用，可换一个端口（如 18890），保存后再看状态，同时更新 鹰眼 中的回调地址。

2. 鹰眼 显示回调失败 / 连不上？

请检查：下载器是否在运行、服务状态是否为运行中、回调地址是否填对、跨机器时 IP 和防火墙是否正确。浏览器可在监控端所在电脑访问该回调地址做连通性排查（正常 POST 才能成功，浏览器直接打开可能不是 200，但至少能判断网络是否通）。

3. 收到了视频，但没有自动下载？

请确认已勾选「有新视频时自动下载新增视频」。到「查看回调视频列表」看解析情况：若显示「未开启自动下载」或「本次无更新」，说明本次没有按新增视频去下载。

4. 提示未授权 / unauthorized？

多半是密钥不一致。请对比下载器与 鹰眼 中的 X-Callback-Secret、Authorization 是否完全一致（多空格、少字符都会失败）。两边都不填也可以。

5. 解析失败怎么办？

先在历史列表里复制该视频链接，回到下载器主界面手动解析试一次。若手动也不行，通常是该平台限制、需要 Cookie，或网络/代理问题，按对应平台的常规下载方式处理即可。

十、最短上手流程（对照）

1. 下载器：设置 → 视频列表监控 → 启用服务 → 开启自动下载 → 保存 → 确认「运行中」。
2. 复制「回调地址」。
3. 鹰眼：监控任务的回调 url 填入该地址（可选填密钥）。
4. 启动监控任务，等待有新视频。
5. 在下载器「查看回调视频列表」确认是否收到，并在下载列表中查看是否开始下载。

若仍不清楚，可通过官网联系我们；会员可提供使用指导，方便时也可远程协助。