常用设置
安装完成后，可以按自己的使用习惯调整下面这些设置。第一次使用请先按首次设置完成连接和测试，再回来看这一页。
这一页只列日常最常改的几项，并说明改完怎么验证。完整字段和边界条件在对应的功能页里。
网络访问与页面刷新
入口：系统 → 系统设置 → 常规设置。
| 设置与用途 | 怎么填写或选择 |
|---|---|
| 代理服务器：用于访问 TMDB 等外部服务。 | 网络受限时填写 Mediora 能访问的完整代理地址，例如 http://192.168.1.20:7890；可以直接访问时留空。 |
| 访问域名：用于通知跳转、外部回调和智能体接入。 | 填写 Mediora 的完整访问地址，例如 https://media.example.com；普通局域网使用可以留空。 |
| 页签激活刷新：切回浏览器页面时更新列表和状态。 | 按需开启；关闭时可手动刷新页面。 |
修改代理后，先点击“测试”，成功后再“保存”。
一个家庭局域网的填写示例
假设 NAS 地址是 192.168.1.10，已有外网代理位于另一台设备 192.168.1.20:7890：
| 要填写的位置 | 示例 | 用途 |
|---|---|---|
| 浏览器地址栏 | http://192.168.1.10:3000 | 打开 Mediora 页面 |
| 常规设置的“代理服务器” | http://192.168.1.20:7890 | 仅在需要时帮助 Mediora 访问外网 |
| 媒体服务器的“服务地址” | http://192.168.1.10:8096 | 连接实际运行的 Emby / Jellyfin，端口按其部署填写 |
| 播放客户端的服务器地址 | http://192.168.1.10:8090 | 仅在代理实例填写并映射了 8090 时，通过该实例播放 |
这些地址是例子，不能互相替代。代理服务运行在别的容器或宿主机时，localhost 指的仍是 Mediora 容器自身，应填写它实际能访问的地址。
优先在页面配置“代理服务器”，保存后打开常规设置中的“网络测试”，先用“按当前配置”验证，再按需用“全部直连”对照。不要只设置 HTTP_PROXY / HTTPS_PROXY 就认为所有 Mediora 请求都已走代理；不同功能可能采用各自的连接方式，仍以页面配置和实际测试为准。
TMDB 资料与语言
入口：系统 → 自动化设置 → TMDB 设置。
- API 读访问令牌：填写 TMDB 提供的读访问令牌，注意区分普通 API 密钥。
- API 服务地址：通常保留默认值；使用自己的服务地址时再修改。
- 元数据语言：选择希望获取的片名、简介等资料语言。
- 过滤成人内容：按使用需要开启，作用于 TMDB 搜索结果。
修改后先测试连接，再保存。更换语言不会自动改写已经保存的 NFO 和图片；需要更新已有媒体时，到媒体刮削选择少量文件重新测试。
整理后的命名与分类
入口：系统 → 自动化设置。
| 想调整的内容 | 打开哪个页面 | 调整时注意 |
|---|---|---|
| 电影和剧集的目录名、文件名 | 重命名规则 | 先看输入框下方的实时预览，确认片名、年份、季集号和分隔符符合预期后再保存。 |
| 按语种、地区等条件分目录 | 二级分类策略 | 规则从上到下匹配；整理任务需要选择“自动匹配”才会按规则选分类。 |
| 不规则文件名的辅助识别 | AI 辅助识别 | 按需启用并测试服务；普通命名能识别时可以保持关闭。 |
命名规则用于开启“按规则重命名”的整理任务。修改规则不会自动重命名或移动已有文件；先用一个小目录确认结果，再扩大处理范围。
正在被任务指定使用的分类，先调整任务中的选择，再删除或改名。完整字段和示例见自动化设置。
下载器与媒体服务器
入口：系统 → 系统设置 → 服务设置。
| 服务 | 需要填写的内容 | 保存后检查什么 |
|---|---|---|
| qBittorrent / Transmission | 实际服务地址，以及该下载器要求的用户名、密码或 API Key。 | 连接状态正常，并能看到下载器信息。 |
| Emby / Jellyfin | 实际媒体服务器地址，以及服务器后台创建的 API 密钥。 | 连接状态正常，再到需要使用它的媒体代理或影音优化中选择该服务器。 |
服务地址要能从 Mediora 访问，不能只在自己的浏览器里能打开。保存时会先测试连接，失败时按页面提示检查地址和认证信息。
下载器连接成功后，还需要在下载助手或工作流中设置后续处理。媒体服务器连接成功后，按自己的播放方式继续配置媒体代理或影音优化。
具体字段见系统设置。
任务消息通知
入口：系统 → 系统设置 → 通知管理。
- 选择企业微信、Telegram 或 PushPlus，填写对应渠道的信息。
- 启用渠道并保存，再发送测试消息，确认接收端实际收到。
- 需要工作流完成后通知时，在工作流中添加并启用“通知”步骤。
企业微信和 Telegram 还可以绑定为下载助手的私聊入口；PushPlus 只发送通知。能收到测试消息后，需要私聊下载时再到下载助手绑定入口。
渠道的申请、字段和回调设置见通知管理。
日志、历史与备份保留
入口：系统 → 数据维护 → 执行策略。
| 设置 | 作用 | 怎么选择 |
|---|---|---|
| 每日维护时间、月度维护日期与时间 | 安排记录归档和数据库整理。 | 选择较少运行任务的时段。 |
| 运行日志保留（天） | 保留过程信息，方便排查问题。 | 经常需要查旧日志时适当延长。 |
| 任务历史保留（天） | 保留文件处理结果，方便回查去向。 | 按需要回查的时间范围设置。 |
| 每日、每周、每月备份保留（份） | 控制自动完整安装备份的保留数量。 | 结合磁盘空间保留多份备份。 |
改好后点击“保存策略”。历史归档和自动备份仍会占用磁盘空间，可在“概览”和“备份恢复”查看；当前新备份为包含配套身份和密钥的完整安装包，但不含媒体文件；旧 .db 快照范围不同，恢复方法见备份与恢复。
各类记录的范围和保留方式见数据维护。
修改后怎样确认效果
连接测试成功后，还要点击“保存”；保存设置后，再运行对应功能确认结果。例如修改命名规则后测试一次整理，修改通知后发送测试消息。
改动不会自动重做已经完成的任务，正在执行的任务和历史重试也可能继续使用当时保存的规则。需要处理旧文件时，重新确认来源、目标和覆盖方式后再执行。
如果提示设置已被其他页面修改，先记下当前输入，再重新加载最新设置并核对，避免用旧页面覆盖新内容。