跳到主要内容

首次设置

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

不需要一次把所有功能都打开。每完成一个阶段，就用少量测试文件验证一次，再进入下一阶段。

先分清两个“代理”​

Mediora 里有两个名字相近、用途完全不同的设置：

名称入口作用什么时候配置
外网代理服务器设置 → 系统设置 → 常规设置让 Mediora 访问 TMDB 等外部服务时通过代理。如果服务器访问外网受限，第一步配置；网络正常时可以留空。
媒体代理播放服务 → 媒体代理让 Emby 或 Jellyfin 播放远端 STRM。只有准备使用 STRM 播放时，在存储、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 令牌用于外部服务调用消息接收入口，普通网页不需要填写；智能体接入需单独授权。

第 2 步：配置 TMDB​

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

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

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

第 3 步：先配置命名和分类，再添加存储任务​

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

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

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

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

打开“存储管理 → 云盘管理 → 存储类型”：

  1. 先添加一个最常用的本地目录，选择 Docker 已挂载的容器内路径，例如 /medias、/downloads 或 /library。
  2. 需要远端媒体时，再添加 115 或 OpenList。
  3. 远端存储点击“测试连接”；本地存储打开“文件列表”。
  4. 确认能看到正确的目录和文件后，再为常用目录设置默认目录或快捷方式。

页面中填写的是容器内路径，不是安装机器上的原始路径。没有看到目录时，先检查 Docker 挂载；目录能看但不能新建、改名或写入时，检查宿主机权限和只读挂载。

详细说明见云盘管理；看不到本地目录时，参照安装页的目录映射检查。

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

打开“设置 → 系统设置”：

需要自动处理下载时​

在“服务设置 → 下载器”添加 qBittorrent 或 Transmission，填写下载器完整地址和认证信息，保存时会先测试连接。下载器能连接，只代表 Mediora 能读取它；下载目录还必须在 Docker 中挂载，并能在云盘管理里选择。

如果 Mediora 与下载器分别运行在容器里，同一块宿主机目录要挂到相同的容器内路径。例如两边都使用 /data/downloads：

services:
  mediora:
    image: anoiv/mediora:latest
    volumes:
      - /宿主机/下载目录:/data/downloads
  qbittorrent:
    image: 你的-qbittorrent-镜像:版本
    volumes:
      - /宿主机/下载目录:/data/downloads

这段只说明共享挂载关系；安装 Mediora 时仍按安装指南填写完整服务配置。下载器的默认保存路径和 Mediora 本地存储根路径不相交时，保存下载目录会显示警告；首次完成后还会核对 Mediora 能否看到下载器报告的文件。

需要 Emby 或 Jellyfin 时​

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

  1. 选择服务器类型。
  2. 填写 Mediora 所在机器可以访问的完整地址，例如 http://192.168.1.2:8096。
  3. 填写媒体服务器后台创建的 API 密钥。
  4. 保存并确认连接测试成功。

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

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

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

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

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

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

确认结果后，再考虑把整理方式改为“移动”、把覆盖模式改为“全部覆盖”，或把任务改为定时、下载器监控或目录监控。

当前分支的手动和定时任务提供“就绪即处理”和“扫描完成后处理”。第一次想先确认完整来源时可选后者；选择前者后，后续扫描失败也会保留已完成的文件。具体含义见任务运行与结果核对。

整理负责放置和命名，刮削负责写入资料；两者可以分开运行，也可以在后面的工作流中串起来。

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

如果要把本地、115 或 OpenList 中的影片通过 STRM 交给 Emby/Jellyfin 播放：

  1. 在“媒体管理 → 生成 STRM”创建任务。
  2. 源存储选择真实影片所在的存储，输出目录选择媒体服务器能扫描到的目录。
  3. 先只生成 1–3 个 STRM，确认文件出现在输出目录。
  4. 在 Emby 或 Jellyfin 中刷新对应媒体库。
  5. 打开“播放服务 → 媒体代理”，新建实例，绑定第 5 步添加的媒体服务器并设置端口。
  6. Docker bridge 网络部署时，额外映射你在上一步自行填写的“代理端口”，建议宿主机端口和容器端口都使用这个值。例如只有你填写 8090 时，才使用 8090:8090；8090 仅为示例。应用配置并重新创建容器后，启用实例，再从媒体服务器打开影片测试。
  7. 在 Emby / Jellyfin 客户端使用 Mediora 地址和该代理端口登录，实际播放一部影片；直接连接原媒体服务器端口不会经过此代理实例。

基础播放能正常工作后，再考虑配置分流或降级规则。不要一开始就添加复杂规则，否则无法判断问题来自 STRM、来源存储、端口还是路由规则。

具体字段见生成 STRM和媒体代理。Compose、NAS 管理面板的端口映射与健康检查方法见bridge 网络设置。

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

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

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

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

“已优化”表示 Mediora 已准备结果；“服务器已使用”才表示媒体服务器已采用结果。助手暂时不可用时，结果可以先保存在 Mediora，不能把“已优化”直接理解成媒体服务器已经完成接管。

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

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

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

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

完成首次配置后的检查清单​

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

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