FlowMedia Wiki

网盘接入 ​

FlowMedia 支持 115网盘、123云盘、阿里云盘，并推荐通过 CloudDrive2 把网盘挂载成容器内可访问的本地路径。

网盘接入分两部分：

  1. 在 FlowMedia 中登录云盘账号，用于转存、取直链、列目录。
  2. 在 CloudDrive2 中挂载云盘目录，用于归档刮削和链接同步扫描文件。

支持的网盘 ​

网盘登录方式FlowMedia 主要用途适合场景
115网盘扫码登录列目录、取直链、离线下载、分享转存、302 播放影视资源较多、需要直连播放
123云盘账号密码 / Token列目录、取直链、离线下载、分享转存、302 播放文件管理清晰、分享转存频繁
阿里云盘扫码登录 / Token 刷新列目录、取直链、分享转存、302 播放已有阿里云盘媒体库

接入顺序 ​

建议按以下顺序配置：

  1. 在 CloudDrive2 中登录网盘账号，并挂载到宿主机目录，如 /volume1/CloudNAS。
  2. 在 Docker Compose 中把宿主机挂载目录映射给 FlowMedia，如 /volume1/CloudNAS:/CloudNAS:rslave。
  3. 在 FlowMedia「网盘」页面登录同一个网盘账号。
  4. 在 FlowMedia「CloudDrive2 设置」中配置 CloudDrive2 地址和转存目标。
  5. 在 FlowMedia 中创建归档、同步、TG/TMDB 订阅任务时选择 /CloudNAS/... 路径。

网盘账号参数 ​

115网盘 ​

参数说明填写建议
登录方式通过二维码扫码登录使用常用浏览器已登录的 115 账号扫码
Cookie / 登录态系统保存扫码后的登录凭证失效后重新扫码登录
最小请求间隔两次云盘 API 请求之间的等待时间推荐 5s ~ 9s，越大越不容易触发风控
测试连接检查账号是否可用登录后必须点击测试，确认能列目录
容量信息显示云盘已用 / 总容量仅用于仪表盘展示，不影响任务执行

123云盘 ​

参数说明填写建议
账号123云盘登录账号填手机号或账号名
密码123云盘登录密码如果账号开启额外验证，需先确认网页登录正常
Token / JWT登录后生成的接口凭证通常由系统保存，失效后重新登录
最小请求间隔两次云盘 API 请求之间的等待时间推荐 5s ~ 9s
测试连接检查账号是否可用登录后必须测试

阿里云盘 ​

参数说明填写建议
登录方式扫码登录或刷新 Token推荐扫码登录
Refresh Token用于刷新访问凭证失效后重新扫码
Drive ID阿里云盘空间标识通常由系统自动获取
最小请求间隔两次云盘 API 请求之间的等待时间推荐 5s ~ 9s
测试连接检查账号是否可用登录后必须测试

如果仪表盘显示云盘风险状态为警告或风险，请先暂停高频任务，增大请求间隔，再重新测试连接。

CloudDrive2 配套 ​

CloudDrive2 负责把网盘挂载成目录。FlowMedia 负责扫描这些目录并执行归档、同步、转存后的触发。

推荐路径结构：

宿主机 /volume1/CloudNAS
  └── CloudDrive2 挂载 115 / 123 / 阿里云盘
        └── FlowMedia 容器内看到 /CloudNAS

Docker 卷参数 ​

yaml
volumes:
  - /volume1/CloudNAS:/CloudNAS:rslave
参数含义常见问题
/volume1/CloudNAS宿主机真实目录，CloudDrive2 挂载到这里必须确认宿主机上能看到网盘文件
/CloudNASFlowMedia 容器内路径创建任务时选择这个路径，而不是宿主机路径
rslave挂载传播模式，让容器能感知宿主机后续挂载变化群晖 / Ubuntu 常用
rshared更强的双向挂载传播飞牛系统如 rslave 不刷新，可改用 rshared

CloudDrive2 设置参数 ​

参数说明填写建议
CloudDrive2 地址CloudDrive2 Web 服务地址如 http://宿主机IP:19798，按实际端口填写
用户名 / 密码CloudDrive2 登录账号用于 FlowMedia 调用 CloudDrive2 目录和转存能力
挂载根目录FlowMedia 容器内看到的云盘根路径通常为 /CloudNAS
115 转存目标115 分享链接默认保存到哪个 CloudDrive2 路径如 /CloudNAS/115/待整理
123 转存目标123 分享链接默认保存到哪个 CloudDrive2 路径如 /CloudNAS/123/待整理
阿里转存目标阿里分享链接默认保存到哪个 CloudDrive2 路径如 /CloudNAS/aliyun/待整理

TG 转存、TMDB 自动转存、企业微信链接转存共用这份转存目标。目标路径应落在归档任务的监控目录内，转存后才能自动入库。

CloudDrive2 Webhook ​

Webhook 用于让 CloudDrive2 在文件变化时通知 FlowMedia。开启后，新增文件可以自动触发归档或同步任务。

在 CloudDrive2 网页设置中找到「设置 → Webhooks → 添加 Webhook」，填入类似配置：

toml
[global_params]
base_url = "http://192.168.1.250:6688"
enabled = true

[global_params.default_headers]
content-type = "application/json"

[file_system_watcher]
url = "{base_url}/api/monitor/webhook/cd2?token=请替换为FlowMedia页面显示的token"
method = "POST"
enabled = true
body = '''
{
    "event_name": "{event_name}",
    "event_category": "{event_category}",
    "data": [
        {
            "action": "{action}",
            "is_dir": "{is_dir}",
            "source_file": "{source_file}",
            "destination_file": "{destination_file}"
        }
    ]
}
'''

[file_system_watcher.headers]

[mount_point_watcher]
url = "{base_url}/api/monitor/webhook/cd2?token=请替换为FlowMedia页面显示的token"
method = "POST"
enabled = false
body = '''
{
    "event_name": "{event_name}",
    "event_category": "{event_category}",
    "data": [
        {
            "action": "{action}",
            "mount_point": "{mount_point}",
            "status": "{status}",
            "reason": "{reason}"
        }
    ]
}
'''

[mount_point_watcher.headers]

Webhook 参数说明 ​

参数说明如何填写
base_urlFlowMedia 主服务地址改成 http://FlowMedia主机IP:6688，不要填 6689 或 6699
enabled是否启用全局 Webhook保持 true
content-type请求体格式保持 application/json
file_system_watcher.url文件变化通知地址从 FlowMedia「监控 / CloudDrive2 Webhook」页面复制，token 必须一致
method请求方法保持 POST
file_system_watcher.enabled是否监听文件新增、移动、删除需要自动触发归档/同步时设为 true
event_nameCloudDrive2 事件名称保持占位符，不要手动改成固定文字
event_category事件类别保持占位符
action文件动作，如创建、移动、删除保持占位符
is_dir是否目录保持占位符
source_file变化前路径或新增路径保持占位符
destination_file移动后的目标路径保持占位符
mount_point_watcher.enabled是否监听挂载点状态变化一般保持 false，排查挂载掉线时可开启
mount_point挂载点路径保持占位符
status挂载状态保持占位符
reason状态变化原因保持占位符

路径选择示例 ​

场景推荐路径
TG / TMDB 转存目标/CloudNAS/115/待整理
视频归档监控目录/CloudNAS/115/待整理
视频归档目标目录/CloudNAS/115/影视库
视频链接同步源目录/CloudNAS/115/影视库
视频链接同步目标目录/media/影视库
音乐归档目标目录/CloudNAS/115/音乐库
音乐链接同步目标目录/music

常见错误 ​

现象原因处理
FlowMedia 选目录看不到网盘文件/CloudNAS 没有正确映射或挂载传播模式不对检查 compose 卷，必要时 rslave 改 rshared
Webhook 测试成功但任务不触发任务没有开启 Webhook 监控，或路径不在任务监控目录下检查任务监控模式和监控目录
转存后不自动归档转存目标不在归档任务监控目录内把转存目标设置到归档监控目录下
云盘频繁风控请求间隔过小或任务过于密集把最小请求间隔调到 5s ~ 9s，减少并发任务
302 播放失败网盘账号登录态失效或 STRM 不是新格式重新登录云盘并强制同步

下一步 ​

© 2026 FlowMedia