安装前准备
Mediora 使用 Docker 运行。安装前先备齐必备项目，再根据需要使用的功能补充可选项目。
必备项目
| 准备内容 | 说明 |
|---|---|
| Docker 运行环境 | 安装在电脑、服务器或 NAS 上，用于启动和运行 Mediora |
| Mediora 数据目录 | 长期保存登录状态、设置和任务记录 |
| 媒体目录 | 存放或读取本地影片、剧集和 STRM 文件；下载目录及其他媒体库按需挂载 |
| Emby 或 Jellyfin 访问地址、API 密钥 | 二选一，用于管理媒体库和播放影片；安装后按首次设置接入 Mediora |
| TMDB 访问配置 | 用于媒体整理和媒体刮削，识别电影、剧集并获取片名、海报等资料 |
| 安装机器的局域网地址 | 让家里的电脑、电视或手机访问 Mediora 页面 |
数据目录和媒体目录都应放在长期保留的位置。不要把它们放进会被自动清理的临时目录。
可选项目
以下项目按使用需求准备，无需全部配置。
| 准备内容 | 说明 |
|---|---|
| 115 网盘账号 | 使用 115 媒体或下载助手时按需准备，具体接入方式见云盘管理 |
| OpenList 访问地址、登录令牌 | 通过 OpenList 接入存储时使用 |
| STRM 输出目录 | 使用 STRM 播放时，需要让 Emby 或 Jellyfin 读取此目录 |
| 通知渠道账号与配置 | 启用消息通知时，按页面提示准备对应渠道的账号和连接配置 |
| 外网访问 代理地址与端口 | 仅在 TMDB、网盘等服务访问受限时配置外网代理；浏览器能访问不代表容器也可以，应在 Mediora 页面完成连接测试 |
运行平台限制
当前发布流程提供 linux/amd64（x86_64）与 linux/arm64（ARM64）镜像，Docker 按安装机器架构选择对应变体。使用历史版本或自行构建的镜像时，应另行核对实际架构。
数据目录应放在支持正常文件锁和 SQLite 写入的可靠磁盘上，不要放进网盘网络文件夹。为数据库快照、升级副本、下载暂存和日志保留空间；来源媒体在远端并不意味着本机不需要可用空间。
推荐的目录安排
以下路径都只是示例，请按自己的磁盘、共享文件夹和权限调整。 本节用 /mnt/volume1/docker/mediora 保存 Mediora 的配置、数据及下载文件，用 /mnt/volume1/medias 表示媒体库；无需为了照抄示例而搬动已有媒体。
表格左侧是宿主机（电脑、服务器或 NAS）的实际目录，右侧是挂载后 Mediora 能看到的容器内路径。在 Mediora 页面选择目录时，使用右侧路径。
使用 Compose 时，可将配置文件保存为 /mnt/volume1/docker/mediora/compose.yaml；命令和手动界面方式无需创建这个文件。下面三种场景可以按需组合，数据目录只需挂载一次。
场景一：媒体库和其他本地目录
已有本地媒体库，同时需要读取其他本地目录时，可以这样安排：
| 宿主机目录（示例） | 容器内路径 | 用途 |
|---|---|---|
/mnt/volume1/medias | /medias | 已有媒体库，或整理、刮削后的保存位置 |
/mnt/volume1/docker/mediora/imports | /imports | 其他待处理文件，例如准备整理入库的影片 |
在“云盘管理”添加本地存储时，选择 /medias 或 /imports。已有目录可直接挂载，无需先复制到 Mediora 的数据目录。只供读取的目录可以只读挂载；需要移动、刮削或写入的目录应允许对应操作。
场景二：使用网盘中的媒体
通过网盘账号或 OpenList 接入媒体时，网盘中的来源目录由存储连接访问，不需要先下载到本地或额外创建一个“网盘目录”。
| 宿主机目录（示例） | 容器内路径 | 用途 |
|---|---|---|
/mnt/volume1/medias | /medias | 按需保存本地 STRM 或其他输出 |
安装后在云盘管理添加对应存储，再选择网盘内的媒体目录。需要将 STRM 输出到本地时，可使用 /medias/strm，并让 Emby 或 Jellyfin 能读取同一份输出；不需要本地输出时，可以不挂载 /medias。
场景三：使用本地下载目录
使用 qBittorrent 或 Transmission 下载，再交给 Mediora 处理时，将下载目录和媒体库分开：
| 宿主机目录（示例） | 容器内路径 | 用途 |
|---|---|---|
/mnt/volume1/docker/mediora/downloads | /downloads | 本地下载器保存文件的位置 |
/mnt/volume1/medias | /medias | 下载完成后整理、刮削的目标媒体库 |
Mediora 和下载器必须看到相同的下载路径。 下载器也运行在容器中时，将同一个 /mnt/volume1/docker/mediora/downloads 同样挂载为 /downloads。例如下载器报告文件保存在 /downloads/complete，Mediora 也应能从这个路径读取。
安装后先将 /downloads 添加为本地存储，再按下载助手配置下载目录；需要下载后自动处理时，再配置工作流。
准备好后，继续阅读安装 Mediora。