快速上手
这一页只讲最短的一条路：从已装好的 Mediora 出发，让一部影片出现在 Emby 或 Jellyfin 里。完整配置项见首次设置。
一分钟理解 Mediora
存储（文件在哪）
↓
媒体整理（摆位置、改名字）──→ 媒体刮削（补海报、简介）
↓
Emby / Jellyfin 扫描并播放
本地影片可以让媒体服务器直接扫描整理后的目录。远端影片可先生成 STRM，再配置媒体代理播放；是否整理、重命名或刮削，按实际需要选择，生成 STRM 不会代替这些操作。
开始前确认
- 容器能打开页面：
http://安装机器的内网IP:3000。 data目录已经挂载到容器/app/data，并且长期保留。- 已有可访问的测试影片，清楚它位于本地目录还是远端存储。
- 已有 Emby 或 Jellyfin；使用下面的播放步骤前，先按首次设置添加媒体服务器连接。媒体服务器还要能扫描输出目录，连接测试不会自动添加媒体库。
其余设置（代理、通知、影音优化等）都可以以后再加。
先选对存储来源
存储来源决定后面所有事情顺不顺。不要一上来就用 115 直连。
| 你的情况 | 用哪种 | 为什么 |
|---|---|---|
| 有本地磁盘或 NAS 空间 | 本地存储 | 直接访问本机目录，仍需确认磁盘与目录权限。 |
| 绿联 NAS，影片在网盘里 | 绿联NAS网络文件夹挂载 | 通过 NAS 的网络文件夹访问来源，仍受网盘规则、NAS 挂载状态和权限影响。 |
| 多个网盘想统一管理 | CloudDrive2 | CD2 负责账号与挂载，Mediora 只连你的服务。 |
| 只有 115 可用 | 115，但只做临时补充 | 不推荐作为主力；可能遇到账号验证、限频或接口变化，后续不保证长期支持。 |
本地影片：五步入库
例如先按安装指南把待整理目录映射到 /imports、媒体库映射到 /medias，把测试副本放在 /imports/test。在云盘管理添加两条本地存储：“待整理”的业务根选 /imports，“媒体库”的业务根选 /medias。整理任务中，来源选“待整理”下的 /test，目标选“媒体库”下的 /；不要再把业务根拼进任务路径。Emby / Jellyfin 要读取同一份输出：即使它的容器里叫 /library，只要映射的是同一个宿主机目录即可；在媒体服务器里选择它自己能看到的路径。
| 步骤 | 在哪操作 | 关键设置 |
|---|---|---|
| 1. 添加来源和目标存储 | 存储管理 → 云盘管理 | 按上例分别添加“待整理”和“媒体库”，先确认测试文件可见、目标可写 |
| 2. 填 TMDB 令牌 | 系统 → 自动化设置 → TMDB | 填读访问令牌，先测试连接再保存 |
| 3. 建整理任务 | 媒体管理 → 媒体整理 | 复制 + 不覆盖已有文件 + 按规则重命名，先用 1–3 个文件 |
| 4. 建刮削任务 | 媒体管理 → 媒体刮削 | 仅缺失，目录选整理后的媒体库 |
| 5. 刷新媒体库 | Emby / Jellyfin | 手动“扫描媒体库”，确认海报和条目 |
远端影片：换成 STRM + 媒体代理
| 步骤 | 在哪操作 | 关键设置 |
|---|---|---|
| 1. 添加远端存储 | 存储管理 → 云盘管理 | 绿联NAS网络文件夹挂载、CD2 或 OpenList；115 只作临时补充 |
| 2. 生成 STRM | 媒体管理 → 生成 STRM | 输出到媒体服务器能扫描的目录，先只生成 1–3 个 |
| 3. 映射代理端口 | Docker 配置 | 按实例计划使用的端口映射，例如 8090:8090，然后重建容器；8090 仅为示例 |
| 4. 新建代理实例 | 播放服务 → 媒体代理 | 选媒体服务器、填端口，保存后“启用” |
| 5. 换客户端地址 | Emby / Jellyfin 客户端 | 连 Mediora 地址 + 代理端口，实际播放验证 |
三句话避免最常见的问题
- 手动任务保存后还要运行：定时或监控任务则要核对启用状态、触发条件和下一次运行时间。
- 本地目录使用容器路径：远端存储则从各自的目录选择器选择，不能把 NAS 路径填成网盘路径。
- 改 Docker 配置要重建容器：新增挂载和端口用
docker compose up -d，restart不生效。
接下来看哪里
| 你想做的事 | 推荐阅读 |
|---|---|
| 一步步完整配置 | 首次设置 |
| 搞清楚各个功能的关系 | 使用说明 |
| 调整网络、命名与通知等日常设置 | 常用设置 |
| 遇到问题 | 常见问题 |
| 分不清术语 | 常用概念 |
扩大到整库之前，先完成一次备份。