TG 与 TMDB 订阅
FlowMedia 支持 Telegram 公开频道资源订阅和 TMDB 热门/搜索订阅。二者可以联动，实现“发现资源 → 转存到云盘 → 触发归档 → 进入媒体库”的自动化流程。
使用前提
| 前提 | 说明 |
|---|---|
| 已配置网盘账号 | 用于分享链接转存 |
| 已配置 CloudDrive2 转存目标 | TG / TMDB 订阅会把资源转存到这些目录 |
| 已配置归档任务 | 转存后由归档任务整理入库 |
| 已配置 TMDB API Key | 用于影视搜索、热门推荐、订阅匹配 |
| 国内环境已配置代理 | Telegram / TMDB 通常需要代理 |
TG 频道订阅
TG 频道订阅用于抓取公开频道的新帖，解析标题、简介、封面和网盘分享链接。
频道参数
| 参数 | 含义 | 示例 | 注意事项 |
|---|---|---|---|
| 频道名称 | Telegram 公开频道用户名 | @channelname 或 channelname | 只支持公开频道，私密频道无法抓取 |
| 显示名称 | 在 FlowMedia 页面中展示的名称 | 电影频道 | 方便区分多个频道 |
| 同步开关 | 是否参与自动同步 | 开启 | 暂停某个频道时关闭 |
| 同步频率 Cron | 定时抓取频道的表达式 | */30 * * * * | 频率过高可能触发访问限制 |
| 代理 | 访问 Telegram 时使用的代理 | http://192.168.1.10:7890 | 国内环境通常需要 |
Cron 示例
| 表达式 | 含义 | 建议 |
|---|---|---|
*/30 * * * * | 每 30 分钟同步一次 | 活跃频道 |
0 */2 * * * | 每 2 小时同步一次 | 普通频道 |
0 8,20 * * * | 每天 8 点和 20 点同步 | 低频频道 |
0 3 * * * | 每天凌晨 3 点同步 | 大量频道统一低峰同步 |
TG 消息字段
| 字段 | 含义 | 用户操作 |
|---|---|---|
| 标题 | 从频道帖子中提取的资源标题 | 可用于判断是否要转存 |
| 简介 | 帖子正文摘要 | 查看资源说明 |
| 封面 | 帖子或 TMDB / 豆瓣匹配到的图片 | 仅用于展示 |
| 云盘类型 | 帖子中识别到的分享来源 | 选择对应云盘转存 |
| 识别结果 | TMDB / 豆瓣匹配出的影视信息 | 不准确时可手动处理 |
| 转存状态 | 是否已经转存 | 未转存 / 已转存 / 失败 |
手动转存参数
| 参数 | 含义 | 如何选择 |
|---|---|---|
| 目标云盘 | 要把分享链接保存到哪个云盘 | 与分享链接类型一致，或选择支持转存的目标云盘 |
| 转存目录 | 保存到 CloudDrive2 中哪个目录 | 建议选择归档任务监控目录，如 /CloudNAS/115/待整理/电影 |
| 自定义标题 | 手动修正资源标题 | 标题识别错误时填写 |
| 媒体类型 | 电影 / 电视剧 | 影响后续归档规则 |
转存目录最好落在归档任务的监控目录下。这样转存成功后，归档任务可以自动处理新增文件。
TMDB 订阅
TMDB 订阅用于提前标记想要的影视资源。TG 同步抓到匹配资源后，FlowMedia 可以自动转存。
基础参数
| 参数 | 含义 | 填写建议 |
|---|---|---|
| TMDB API Key | TMDB 接口访问密钥 | 在 TMDB 官网申请后填入设置页 |
| HTTP 代理 | 访问 TMDB 的代理 | 国内环境通常必填 |
| 图片域名 | TMDB 图片加载地址 | 默认即可；访问慢时可按设置页提示修改 |
| 目标云盘 | 命中订阅后转存到哪个云盘 | 选择已登录且测试成功的云盘 |
| 目标目录 | 命中订阅后保存到哪个目录 | 建议选择归档监控目录 |
TMDB 筛选参数
| 筛选项 | 含义 | 示例 | 说明 |
|---|---|---|---|
| 类型 | 电影或电视剧 | 电影 | 决定查询 TMDB movie 还是 tv |
| 排序 | 结果排序方式 | 热度 / 评分 / 上映日期 | 按评分排序时建议同时设置最低投票数 |
| 风格 | 影片类型 | 动作 / 喜剧 / 科幻 | 可缩小范围 |
| 语言 | 原始语言 | 中文 / 英文 / 日文 | 用于筛选原始语言 |
| 地区 | 发行地区 | 中国大陆 / 美国 / 日本 | 对地区发行数据有依赖 |
| 年份 | 上映或播出年份 | 2026 | 找特定年份资源时使用 |
| 最低评分 | 过滤低评分内容 | 7.0 | 评分资源太少时可能无结果 |
| TMDB ID | 精确查询影视 ID | 550 | 搜索框输入纯数字时可用于精确匹配 |
订阅状态
| 状态 | 含义 | 用户需要做什么 |
|---|---|---|
| 待转存 | 已订阅，等待 TG 同步命中资源 | 保持 TG 同步开启 |
| 已转存 | 已找到匹配资源并转存成功 | 等待归档任务处理 |
| 失败 | 找到资源但转存失败 | 检查云盘账号、分享链接、转存目录 |
| 已取消 | 用户取消订阅 | 不再自动转存 |
自动转存流程
- TG 定时同步抓取频道新帖。
- FlowMedia 提取标题并匹配 TMDB / 豆瓣信息。
- 系统检查是否存在“待转存”的 TMDB 订阅。
- 命中后调用对应云盘能力转存到目标目录。
- 转存成功后触发归档监控。
- 归档完成后可联动链接同步，进入媒体服务器。
转存目标参数
TG 与 TMDB 共用 CloudDrive2 转存目标。
| 参数 | 含义 | 示例 |
|---|---|---|
| 云盘类型 | 115 / 123 / 阿里 | 115 |
| CloudDrive2 路径 | 转存后保存的目录 | /CloudNAS/115/待整理/电影 |
| 归档任务关系 | 该路径是否被归档任务监控 | 应落在归档任务监控目录内 |
推荐配置
| 场景 | 推荐 |
|---|---|
| 频道更新很频繁 | TG Cron 设置为 */30 * * * * 或更低频 |
| 云盘容易风控 | 降低 TG 同步频率，并增大云盘最小请求间隔 |
| 想自动入库 | 转存目录选择归档监控目录 |
| 想减少误转存 | 先使用手动转存，确认频道质量后再用 TMDB 自动订阅 |
| 标题识别不准 | 优先补 TMDB API Key 和代理，必要时手动改标题 |
常见问题
| 问题 | 原因 | 处理 |
|---|---|---|
| TG 同步失败 | Telegram 无法访问或频道不是公开频道 | 配置代理，确认频道公开 |
| TMDB 搜索无结果 | API Key 错误、代理不可用、标题不规范 | 测试 TMDB 设置，尝试 TMDB ID 精确搜索 |
| 订阅一直待转存 | TG 频道未抓到匹配资源 | 等待频道更新或手动转存 |
| 转存成功但未归档 | 转存目录不在归档监控目录内 | 修改 CloudDrive2 转存目标 |
| 自动转存失败 | 云盘账号失效、链接失效或目标目录无权限 | 重新登录云盘，检查分享链接和目录 |