跳到主要内容

首次设置

第一次使用建议按“网络访问 → 资料服务 → 存储 → 任务 → 播放 → 自动化”的顺序配置。这样每一步都有前置条件，出现问题时也容易判断是网络、连接、权限还是任务规则导致的。

不需要一次把所有功能都打开。每完成一个阶段，就用少量测试文件验证一次，再进入下一阶段。只想先跑通一条链路，可以看更短的快速上手。只管理文件时，先完成第 4 步即可；整理和刮削需要 TMDB，STRM 播放需要媒体服务器与媒体代理，暂时不用的功能可以跳过。

第 1 步：先配置外网访问​

如果你的 Mediora 所在机器不能直接访问 TMDB、通知服务或其他外部接口，打开“系统 → 系统设置 → 常规设置”：

  1. 在“代理服务器”填入容器能够访问的完整地址，例如 http://192.168.1.20:7890，替换成实际代理机器地址和端口。127.0.0.1 指 Mediora 容器自身，仅代理确实运行在同一网络环境时才适用。
  2. 点击“测试”，确认连接成功。
  3. 点击“保存”。

如果网络本来就能正常访问外部服务，代理服务器可以留空，不要为了“先配代理”随便填写一个地址。填写错误的代理会让 TMDB 测试、刮削和部分通知都失败。

同一页的“访问域名”只在需要外部回调或生成固定网页链接时填写，必须带上协议，例如 https://media.example.com；局域网地址也可以写成 http://192.168.1.20:3000。普通局域网使用不需要先配置。常规 API 令牌用于外部服务调用消息接收入口，普通网页不需要填写；智能体接入需单独授权。

外网代理是 Mediora 出站用的；给播放器用的“媒体代理”是另一回事，见常用概念。

第 2 步：配置 TMDB​

打开“系统 → 自动化设置 → TMDB”：

  1. 填写 TMDB 的 API 读访问令牌，不要把普通 API 密钥和读访问令牌混用。
  2. 语言先选择你希望资料显示的语言。
  3. “过滤成人内容”按家庭使用需要开启。
  4. 先点击“测试连接”，成功后再保存。

TMDB 是媒体刮削、手动搜索和部分自动识别的基础。测试失败时，先检查第 1 步的外网代理、令牌是否完整，以及服务器时间是否正确，不要直接反复创建刮削任务。字段细节见自动化设置。

第 3 步：确认命名和分类​

在“系统 → 自动化设置”继续检查两个基础规则：

  • 重命名规则：决定之后媒体整理生成的电影目录、剧集目录、季目录和文件名。页面中的花括号字段不要删除，先看实时预览。
  • 二级分类策略：供整理任务的“自动匹配”选项使用，规则按从上到下匹配。也可以在任务中选“不分类”或指定一个固定分类；保存后只影响之后的整理，不会自动移动旧文件。

第一次建议先保留默认规则。只要确认默认预览符合你的目录习惯，就可以继续添加存储；不要在还没有测试整理结果时一次性设计很复杂的 YAML 规则。

第 4 步：添加并验证存储​

开始前确认容器已经启动；Compose 安装可用 docker compose ps 查看状态。容器正在运行后，还要等初始化完成并实际打开页面。示例 image: anoiv/mediora:latest 使用浮动镜像标签，不会自行更新正在运行的容器；升级前仍需阅读更新日志并备份完整数据。

打开“存储管理 → 云盘管理 → 存储类型”，按实际来源选择一种即可：

  1. 使用本地目录时，添加本地存储，选择 Docker 已挂载的容器内路径，例如 /medias、/downloads 或 /library。
  2. 使用绿联NAS网络文件夹挂载时，先在绿联云客户端完成“连接网络文件夹”，再按挂载指南完成 /mnt/@remote 映射、rslave 传播和 UGREEN_REMOTE_ROOT 设置，最后添加相应存储。无需另存为本地存储。
  3. 通过 CD2 接入时，先按CD2 配置指南完成 CD2 侧的云盘挂载和令牌，再在 Mediora 填写服务地址与令牌。
  4. 通过 OpenList 接入时，添加 OpenList 并填写服务地址和令牌。
  5. 远端存储点击“测试连接”；本地存储打开“文件列表”。
  6. 确认能看到正确的目录和文件后，再为常用目录设置默认目录或快捷方式。

关于 115： 115 直连不推荐作为主力。它可能遇到账号验证、限频和接口变化，Mediora 会限制请求频率，也不保证后续长期支持。如果只需要临时补充，可以添加，但不要让整个媒体库依赖它。完整说明见云盘管理。

添加本地存储时填写容器内路径；远端来源应从该存储的目录选择器选择，不填写宿主机路径；路径与挂载的关系见安装前准备。没有看到目录时先检查 Docker 挂载，能看但不能写入时检查宿主机权限和只读挂载。字段说明见云盘管理。

第 5 步：按需要配置下载器、媒体服务器和通知​

打开“系统 → 系统设置 → 服务设置”和“通知管理”。

需要自动处理下载时​

在“服务设置 → 下载器”添加 qBittorrent 或 Transmission，填写下载器完整地址和认证信息，保存时会先测试连接。下载器能连接，只代表 Mediora 能读取它；下载目录还必须在 Docker 中挂载成与下载器相同的容器内路径，并能在云盘管理里选择。挂载写法见安装前准备。

下载器的默认保存路径和 Mediora 本地存储根路径不相交时，保存下载目录会显示警告；首次完成后还会核对 Mediora 能否看到下载器报告的文件。

需要 Emby 或 Jellyfin 时​

在“服务设置 → 媒体服务器”添加 Emby 或 Jellyfin：

  1. 选择服务器类型。
  2. 填写 Mediora 所在机器可以访问的完整地址，例如 http://192.168.1.2:8096。仅在媒体服务器确实与 Mediora 共用网络环境时才能使用 localhost；通常应填实际内网地址，也不要填媒体代理端口。
  3. 填写媒体服务器后台创建的 API 密钥。
  4. 保存并确认连接测试成功。

媒体服务器配置只负责让 Mediora 访问服务器；远端播放还要在第 7 步配置媒体代理。

需要任务通知或私聊入口时​

在“通知管理”配置企业微信、Telegram 或 PushPlus，保存后先发送测试消息。只有企业微信和 Telegram 可以进一步绑定为下载助手的私聊入口；PushPlus 只发送通知，不接收下载指令。

第 6 步：先用少量文件测试整理和刮削​

准备一个只包含 1–3 个文件的测试目录：

  1. 打开“媒体管理 → 媒体整理”，创建一个手动执行任务。
  2. 来源选择测试目录，目标选择媒体库目录。
  3. 第一次使用选择“复制”，覆盖规则选“不覆盖已有文件”，开启“按规则重命名”，并明确选择“不分类”或“自动匹配”。
  4. 保存任务后手动运行，检查目标目录和文件名。
  5. 打开“媒体管理 → 媒体刮削”，创建一个手动刮削任务。
  6. 运行后检查 NFO、海报和简介是否写到了预期目录。

确认结果后，再考虑把整理方式改为“移动”、把整理的覆盖规则改为“始终覆盖”，或把任务改为定时、目录监控。

整理、刮削和 STRM 统一采用“就绪即处理”，扫描后续失败也会保留已完成文件，第一次务必用小范围验证。具体含义见任务运行与结果核对。整理负责放置和命名，刮削负责写入资料；两者可以分开运行，也可以在工作流中串起来。

第 7 步：需要远端播放时，再配置 STRM 和媒体代理​

如果要把本地或远端网盘中的影片通过 STRM 交给 Emby/Jellyfin 播放：

  1. 在“媒体管理 → 生成 STRM”创建任务：源选真实影片所在的存储，输出选媒体服务器能扫描到的目录，先只生成 1–3 个。
  2. 在 Emby 或 Jellyfin 中刷新对应媒体库，确认能扫描到条目。
  3. 打开“播放服务 → 媒体代理”，新建实例，绑定第 5 步添加的媒体服务器并设置端口。
  4. 按媒体代理的端口映射说明，在 Docker 中映射这个端口并重建容器，然后“启用”实例。
  5. 在 Emby / Jellyfin 客户端使用 Mediora 地址和该代理端口登录，实际播放一部影片；直接连接原媒体服务器端口不会经过代理实例。

基础播放正常后，再考虑分流或降级规则。不要一开始就添加复杂规则，否则无法判断问题来自 STRM、来源存储、端口还是路由规则。字段见生成 STRM和媒体代理。

所有来源的新 STRM 均通过 Mediora 提供播放来源，无需选择播放方式或填写视频目录映射；本地来源需保持对应目录挂载可用。

第 8 步：需要更快准备远程影片时配置影音优化​

影音优化是可选的 Pro 功能，建立在媒体服务器和 STRM 播放链路已经可用的基础上：

  1. 打开“播放服务 → 影音优化 → 处理规则”，选择媒体服务器和要处理的媒体库。
  2. 点击“重新检测助手”，确认助手状态。
  3. 点击“预览处理范围”，确认数量无误。
  4. 先保持默认限流和“在 STRM 旁保存备份”，再保存规则；页面要求确认助手同步权限时，先核对范围。
  5. 先批量处理少量已有影片，观察“已优化”和“服务器已使用”是否分别推进。

“已优化”表示 Mediora 已准备结果；“服务器已使用”才表示媒体服务器已采用。助手暂时不可用时结果可先保存在 Mediora，详见影音优化。

第 9 步：最后再启用自动化​

所有基础功能都手动验证后，再选择自动化方式：

需求推荐方式
每天固定时间扫描在对应任务中选择定时执行，填写 Cron 并确认下次运行时间。
下载完成后自动入库先配置下载助手或下载器，再在工作流中添加“下载完成”条件。
本地目录出现新文件就处理使用目录监控；CloudDrive2 还可在配置变化观察后使用相应监控。其他网盘和绿联NAS网络文件夹挂载可使用定时扫描。
依次整理、刮削、生成 STRM、通知建立手动整理/刮削/STRM 任务，在工作流中按顺序引用，先用手动条件测试。

自动化启用前，再检查一次来源、目标、覆盖模式和删除策略。工作流或定时任务不会因为失败自动撤回已经完成的复制、移动、覆盖或资料写入。

完成后的检查清单​

  • 外网受限时，外网代理测试成功；网络正常时保持为空。
  • 需要识别或刮削时，TMDB 测试成功并已保存。
  • 需要整理时，命名规则预览符合预期。
  • 至少一个存储能打开正确目录，远端存储测试成功。
  • 需要使用的下载器、媒体服务器或通知渠道已测试成功。
  • 已用少量文件手动验证准备使用的功能。
  • 需要播放远端文件时，STRM、媒体库扫描和媒体代理都已单独验证。
  • 已完成一次 data 目录备份，再扩大处理范围。

容易搞错的地方​

容易搞错实际情况
第一次就配满所有功能每多一项都要多验证一项。先跑通“存储 → 整理 → 刮削”，其余按需再加。
把外网代理和媒体代理当成一个外网代理管出站访问，媒体代理管播放入口；端口和用途都不同。
没有外网限制也填了代理网络正常时保持为空，填了反而可能让 TMDB 测试失败。
保存设置后以为已经生效测试按钮只验证连接，功能是否运行取决于任务的调度方式和启用状态。
用小样本验证时选了整库目录验证阶段只选 1–3 个文件的目录。
一开始就用 115 直连当主力存储不推荐依赖 115 直连承载主力媒体库。先阅读接入限制并评估其他来源；更换接入方式也不能保证免于网盘限频或验证。
直接开定时任务再观察结果先手动跑一轮并逐条核对，再交给自动化。

如果目标是自动入库并播放，“能用了”的标准是一部测试影片经过整理和刮削后出现在媒体库里，并能实际播放。如果只管理文件，能正确浏览和验证所需读写即可，不必为了完成清单启用所有功能。

重要媒体建议先阅读备份与恢复。