跳到主要内容

功能总览

Mediora 的核心作用，是把“文件放在哪里”“媒体如何整理”“资料如何补全”“如何交给 Emby 或 Jellyfin 播放”串成一条可重复执行的流程。你不需要一次配置全部功能，按自己的使用目标选择即可。

整理、刮削、STRM 的共同操作说明集中在任务运行与结果核对。

先理解一条完整链路​

存储管理
  ↓
媒体整理 ──→ 媒体刮削 ──→ 生成 STRM ──→ Emby / Jellyfin 播放
  │              │              │
  └──────────────┴──────────────┴──→ 工作流自动串联

同步管理：在两个位置之间复制或同步文件
下载助手：把链接下载到已配置的存储
媒体代理：为远端 STRM 提供实际播放入口
影音优化：提前准备远程媒体的播放信息

各模块的职责不同：

功能主要作用是否会改真实文件
云盘管理添加本地、115 或 OpenList，浏览、传输文件和调整适用的目录读取策略。会。新建、上传、复制、移动、重命名和删除会作用于实际存储。
媒体整理把来源目录中的影片和剧集复制、移动或硬链接到目标媒体库，并按规则命名。会。复制、移动、覆盖都会产生真实文件变化。
媒体刮削从 TMDB 获取片名、海报、简介和资料文件，写回媒体目录。会。主要写入资料文件和图片，不负责移动影片。
生成 STRM为远端媒体生成很小的播放入口文件，让媒体服务器看到远端影片。会。会在输出目录创建或更新 .strm 文件。
同步管理从来源复制到目标，支持增量、预演、定时和删除保护。会。启用同步删除时还可能删除目标多余文件。
下载助手批量添加下载链接，把下载结果保存到指定网盘目录。会。下载器或网盘会创建实际文件。
工作流按顺序调用已保存的整理、刮削、STRM、缓存和通知步骤。取决于引用的步骤。工作流本身不回滚已完成的文件操作。
媒体代理让 Emby 或 Jellyfin 通过 Mediora 播放远端 STRM。通常不会；分流规则中的同类型转存可能会向目标存储写入临时文件。
影音优化提前准备影片的播放信息，并在条件满足时同步给媒体服务器。可能会写入优化结果备份；不会删除原影片。
控制台汇总任务、计划和媒体代理状态，帮助定位下一步。不会。控制台是查看入口。

按目标选择功能​

你想完成的事情推荐顺序
把下载好的电影放入媒体库添加存储 → 媒体整理 → 媒体刮削
让 115 或 OpenList 中的影片出现在 Emby / Jellyfin添加远端存储 → 生成 STRM → 配置媒体代理 → 刷新媒体库
让新下载的文件自动入库添加存储和下载器 → 建立手动整理/刮削任务 → 工作流添加“下载完成”或“目录监控”条件
把一个目录备份到另一个目录添加来源和目标存储 → 同步管理 → 先预演，再执行或定时
一次处理多种媒体操作先分别保存手动整理、刮削或 STRM 任务 → 工作流按顺序引用
让远程影片少一些首次播放等待先保证 STRM 和媒体代理可播放 → 配置影音优化 → 选择媒体库并预览范围

推荐的配置顺序​

  1. 如果服务器访问外网受限，先在“设置 → 系统设置 → 常规设置”配置并测试外网代理；网络正常时留空。
  2. 在“设置 → 自动化设置 → TMDB”填写令牌并测试连接，再检查命名规则和二级分类。
  3. 在 Docker 中挂载要使用的目录，并在“存储管理 → 云盘管理”中确认页面能看到正确文件。
  4. 添加需要使用的 115 或 OpenList，并点击测试或打开文件列表确认连接正常。
  5. 用少量文件建立一个手动任务。整理先选“复制 + 仅缺失”，刮削先选“仅缺失”。
  6. 实际运行并检查目标目录、文件名、海报和资料文件，确认结果后再改为移动、覆盖或自动运行。
  7. 需要远端播放时，再生成 STRM、添加媒体服务器并配置媒体代理；不要把 mediora:// 文件直接交给普通播放器。
  8. 需要自动串联时，先用工作流的“手动执行”条件测试，再增加定时、下载完成或目录监控条件。
  9. 扩大处理范围前，先完成备份，并保留来源数据或可恢复副本。

想按这个顺序一步步完成配置，直接阅读首次设置。

三个容易混淆的概念​

任务、运行记录和文件不是一回事​

保存任务只是保存一套规则，不代表已经处理文件。点击运行后才会产生一次运行记录；删除任务也不会删除已经生成的影片、资料或 STRM 文件。

STRM、媒体代理和影音优化各自解决不同问题​

  • STRM：把远端影片以小文件的形式放进媒体服务器媒体库。
  • 媒体代理：在播放时根据 STRM 和当前存储找到实际内容并提供播放请求。
  • 影音优化：提前准备影片的播放信息，并尝试让媒体服务器采用准备好的结果。

影音优化不是媒体代理的替代品。远端 STRM 仍需先能通过媒体代理正常播放；优化助手暂时不可用时，结果可以先保存在 Mediora，待助手恢复后再同步。

“预演”只查看计划，不等于执行​

同步预演用于确认将新增、更新、跳过或删除哪些文件，不会改动文件。媒体整理、刮削和 STRM 的任务预览主要用于确认处理范围；真正的文件变化仍发生在点击运行、执行或确认之后。

第一次使用的最小实验​

建议准备一个测试目录，只放 1–3 个文件，按下面顺序验证：

  1. 在文件列表中确认来源和目标目录没有选反。
  2. 运行一次媒体整理，确认复制结果和命名。
  3. 运行一次媒体刮削，确认资料文件和海报写入位置。
  4. 如果使用远端存储，再生成一个 STRM 并通过媒体服务器播放。
  5. 查看任务历史，确认失败、跳过和成功的含义。

验证完成后再增加文件数量。移动、覆盖、同步删除和网盘转存都属于高风险操作，先不要在唯一的生产副本上试用。