FlowMedia Wiki

常见问题 ​

本页按部署、路径、权限、网盘、任务、反代、授权几个方向整理常见问题。

部署相关 ​

容器反复重启怎么办？ ​

先查看日志：

bash
docker compose logs -f flowmedia

常见原因：

现象可能原因处理
授权失败LICENSE_KEY 未填、填错或已封禁检查授权码，一机一容器一码
数据目录不可写/config 没有权限检查宿主机目录权限或临时使用 PUID=0 PGID=0
端口被占用6688 / 6689 / 6699 已被其他服务占用修改宿主机端口映射，如 16688:6688
镜像异常镜像拉取不完整或缓存损坏重新 docker compose pull flowmedia

6688、6689、6699 分别是什么？ ​

端口用途是否必须
6688FlowMedia Web UI 和 API必须
6689Emby 302 反代使用 Emby 直连播放时必须
6699Navidrome 302 反代使用 Navidrome 直连播放时必须

如果你只使用管理页面，至少要映射 6688。如果要使用 302 播放，请同时映射 6689 / 6699。

默认账号密码是什么？ ​

以 docker-compose.yml 中的环境变量为准：

yaml
DEFAULT_USERNAME=admin
DEFAULT_PASSWORD=你设置的密码

首次登录后建议进入「设置 → 用户管理」修改密码。

.vitepress/dist 或构建产物需要提交吗？ ​

Wiki 项目的 .vitepress/dist/ 是构建产物，已在 .gitignore 中。正常编辑文档时只需要关注 Markdown 和主题源码。

目录与权限 ​

FlowMedia 看不到 /CloudNAS 里的文件怎么办？ ​

按顺序检查：

  1. 宿主机上 /volume1/CloudNAS 是否能看到 CloudDrive2 挂载内容。
  2. FlowMedia compose 是否包含 /volume1/CloudNAS:/CloudNAS:rslave。
  3. 进入容器后是否能看到 /CloudNAS。
  4. 飞牛系统如挂载不刷新，可尝试把 rslave 改为 rshared。
  5. CloudDrive2 容器是否有 /dev/fuse、privileged: true 和正确挂载目录。

/media、/music、/CloudNAS 有什么区别？ ​

路径作用
/CloudNAS云盘挂载目录，归档和同步的源文件通常在这里
/media视频 STRM / 软链接输出目录，给 Emby / Jellyfin / Plex 索引
/music音乐软链接输出目录，给 Navidrome 索引

不要把 Emby 媒体库直接指向 /CloudNAS/待整理。推荐先归档，再同步到 /media。

Permission denied 怎么办？ ​

  1. 查看宿主机目录所有者：
bash
ls -la /volume1/media
ls -la /volume1/music
ls -la /volume1/docker/flowmedia/config
  1. 如果不熟悉 Linux 权限，先用：
yaml
PUID=0
PGID=0

  1. 如果要降权运行，把 PUID / PGID 设置为宿主机目录所有者的 UID / GID。

  2. 修改后重启：

bash
docker compose up -d

代理与外部服务 ​

TMDB 无法访问怎么办？ ​

国内环境访问 TMDB 通常需要代理：

yaml
environment:
  - HTTP_PROXY=http://你的代理IP:端口
  - HTTPS_PROXY=http://你的代理IP:端口

同时检查：

  1. FlowMedia「设置 → TMDB」已填写 API Key。
  2. 代理地址是容器能访问的地址，不要填 127.0.0.1，除非代理就在同一个容器内。
  3. 代理端口已放通。

Telegram 同步失败怎么办？ ​

常见原因：

原因处理
频道不是公开频道只添加公开频道
代理不可用配置 HTTP / SOCKS 代理
Cron 太频繁降低同步频率
频道用户名填错使用 @channelname 或 channelname

网盘与 CloudDrive2 ​

云盘测试连接失败怎么办？ ​

网盘排查
115网盘重新扫码登录，增大最小请求间隔
123云盘检查账号密码，确认网页登录正常
阿里云盘重新扫码或刷新 Token

如果近期频繁运行任务，建议先暂停任务，等待一段时间后再测试。

Webhook 测试成功但任务不触发怎么办？ ​

检查三件事：

  1. CloudDrive2 Webhook URL 是否使用 6688，不是 6689 / 6699。
  2. FlowMedia 任务的监控模式是否勾选 Webhook。
  3. 文件变化路径是否位于任务的监控目录下。

示例：

项目路径
Webhook 变化路径/CloudNAS/115/待整理/电影/A.mkv
归档任务监控目录/CloudNAS/115/待整理/电影

这类路径可以触发。如果监控目录填成 /CloudNAS/115/影视库，则不会触发。

转存成功但没有自动归档怎么办？ ​

通常是转存目标不在归档监控目录下。

推荐：

参数示例
CloudDrive2 转存目标/CloudNAS/115/待整理/电影
归档任务监控目录/CloudNAS/115/待整理/电影
归档任务目标目录/CloudNAS/115/影视库/电影

归档与同步 ​

归档任务参数怎么选？ ​

日常推荐：

参数推荐
监控目录/CloudNAS/.../待整理
目标目录/CloudNAS/.../影视库 或 /CloudNAS/.../音乐库
监控模式Webhook 或定时
处理方式云盘挂载目录优先 CD2移动 / CD2复制
跳过失败开启
跳过重复开启
强制归档仅重建媒体库时开启

链接同步任务参数怎么选？ ​

视频推荐：

参数推荐
源目录归档目标目录，如 /CloudNAS/115/影视库/电影
目标目录Emby 媒体库目录，如 /media/电影
同步模式STRM
触发方式推荐由归档任务联动

音乐推荐：

参数推荐
源目录音乐归档目标目录
目标目录Navidrome 音乐库，如 /music
同步模式软链接
触发方式推荐由音乐归档任务联动

归档和同步能同时开启监控吗？ ​

同一个链接同步任务不要同时：

  1. 开启 Webhook / 定时监控。
  2. 又作为某个归档任务的联动同步目标。

二者互斥。推荐做法是：

归档任务开启 Webhook / 定时
链接同步任务关闭监控
归档任务完成后联动触发链接同步

Cron 表达式怎么写？ ​

表达式含义
*/30 * * * *每 30 分钟
0 */2 * * *每 2 小时
0 3 * * *每天凌晨 3 点
0 8,20 * * *每天 8 点和 20 点

大库建议降低频率，避免频繁扫描。

反代播放 ​

Emby 反代播放失败怎么办？ ​

  1. 确认客户端地址是 http://<host>:6689，不是 Emby 原生 8096。
  2. 确认 6689 已映射且防火墙放通。
  3. 确认 STRM 是新版格式，必要时执行「强制同步」。
  4. 确认云盘账号在线。
  5. 如果客户端需要转码，请直接连接 Emby 原生地址。
  1. 确认客户端地址是 http://<host>:6699。
  2. 确认 6699 已映射。
  3. 确认音乐同步目标目录与 Navidrome /music 是同一个宿主机目录。
  4. 确认云盘账号在线。

群晖 6690 端口冲突怎么办？ ​

Navidrome 反代使用 6699，不是 6690。请确认 compose 中映射：

yaml
ports:
  - "6699:6699"

授权相关 ​

如何获取授权码？ ​

访问 捐赠页面，扫码支付 ¥99，并在付款备注中填写邮箱地址。授权码会发送至备注邮箱。

同一授权码能在多台机器使用吗？ ​

不能。一机一容器一码。同一授权码在多台机器或多个容器中同时使用，可能触发封禁。

授权包含什么？ ​

授权用于 FlowMedia 工具本身，不包含任何媒体资源、网盘账号、第三方会员、TMDB API Key 或部署代工服务。

合规说明 ​

FlowMedia 不提供任何资源。用户需要自行确保媒体文件、网盘内容、第三方账号和播放环境的合法性。

更多帮助 ​

© 2026 FlowMedia