系统设置

路径：系统 → 系统设置。

这里配置下载器、媒体服务器、通知渠道和网络访问参数。每完成一项就测试一次，确认连接或消息实际可用，再继续配置使用它的任务。

第一次安装建议先读首次设置：其中的“代理服务器”是 Mediora 访问 TMDB 等外部服务使用的网络代理；它和“播放服务 → 媒体代理”不是同一个功能。

服务设置

这里可添加下载器以及 Emby、Jellyfin 等媒体服务器。保存服务时会先测试连接，通过后才保存；已有服务也可以重新测试。

字段	怎么填写	影响
服务类型	选择你实际安装的下载器、Emby 或 Jellyfin。	决定连接方式。
服务地址	填写 Mediora 所在机器能够访问到的完整地址，例如 http://192.168.1.2:8096。	地址不可达时无法测试，也不能被后续功能使用。
WebUI API Key	下载器页面提供时填写；没有则按下载器实际要求处理。	用于读取下载状态或监听下载结果。
用户名、密码	下载器要求账号登录时填写。	仅用于连接该下载器。
API 密钥	Emby 或 Jellyfin 必填，使用媒体服务器后台创建的 API Key。	媒体代理需要通过它读取媒体服务器信息。

服务地址从 Mediora 容器内访问，不是从你的浏览器访问。另一个容器的 localhost 不能直接使用；请填可达的服务名或内网地址。修改媒体服务器地址或密钥后，回到影音优化重新检测助手并保存处理范围；不要把媒体代理端口回填成它自己的上游地址。

下载器连接成功不代表下载文件已经能读取。下载器与 Mediora 需使用一致的容器内保存路径，具体挂载示例见首次设置。

通知管理

路径：系统 → 系统设置 → 通知管理。

通知管理支持企业微信、Telegram 和 PushPlus。每个渠道都可以单独保存、启用和测试；先完成一个渠道的测试，再把它用于工作流或下载助手。

通用操作：

1. 在通知管理中找到要使用的渠道，点击配置按钮。
2. 按下面对应渠道的说明填写字段。
3. 将“启用”设为“是”，点击“保存”。
4. 重新打开配置，点击“测试”，确认手机、群组或频道实际收到测试消息。

不要把下面的 Token、Secret 或加密密钥发到聊天记录、截图和公开文档中。

渠道	需要填写的字段	作用
企业微信	企业 ID、应用 AgentId、应用 Secret、Token、EncodingAESKey；代理地址可选。	前五项来自企业微信自建应用和接收消息设置；用于发送通知和接收回调。
Telegram	Bot Token、Chat ID；代理 API 地址可选。	Bot Token 用于机器人身份，Chat ID 决定消息发到哪个用户、群组或频道。
PushPlus	用户 Token；群组编码可选。	未填群组编码时发送给个人，填写后发到对应群组。
启用	保存后选择“是”。	停用后保留配置，但不会发送消息，也不能用于下载助手交互入口。

企业微信

企业微信可以接收 Mediora 的任务通知；启用后，也可以作为下载助手的私聊入口。

1. 登录企业微信管理后台，在“我的企业 → 企业信息”中复制“企业 ID”。

2. 打开“应用管理 → 自建 → 创建应用”，创建一个专门给 Mediora 使用的应用。记下应用详情中的“AgentId”和“Secret”，并把需要接收消息的成员加入应用可见范围。

3. 先将 Mediora 通过反向代理开放为企业微信能够访问的公网 HTTPS 地址，具体设置见公网访问与安全。然后在该应用的“接收消息服务器配置”中填写 URL，格式为：

   https://你的公网域名:端口号/api/message?token=你的MedioraAPI令牌

   域名和端口号使用反向代理对外提供服务的公网地址，不能填 NAS 的内网地址或容器内部端口。使用 HTTPS 默认端口 443 时可以省略 :443。例如：

   https://media.example.com:443/api/message?token=your_mediora_api_token

   将 token= 后的占位内容替换为“系统 → 系统设置 → 常规设置”中复制的 API 令牌，不是企业微信生成的 Token。

   在企业微信接收消息设置中生成或填写 Token、EncodingAESKey，先暂不提交 URL 验证，将它们原样复制到 Mediora 的同名字段。

4. 回到 Mediora 的通知配置中填写：

   Mediora 字段	从哪里获取
   企业 ID	企业微信“我的企业 → 企业信息”中的企业 ID。
   应用 AgentId	该自建应用的 AgentId。
   应用 Secret	该自建应用详情中的 Secret。
   Token	与企业微信接收消息设置完全相同，用于验签，不需要拼进 URL。
   EncodingAESKey	企业微信接收消息设置中的 EncodingAESKey。
   代理地址	只有企业微信接口需要通过代理访问时才填写；普通部署留空。

5. 先在 Mediora 保存并启用企业微信配置，再到企业微信后台提交 URL 验证。Mediora 需要用已启用配置中的 Token 和 EncodingAESKey 验签，未保存或未启用时会提示配置不存在。验证完成后再发送测试消息。

这里的企业微信 Token 是回调验签用的值，与 URL 中填写的 Mediora API 令牌不同；两者建议使用不同的随机值。回调 URL 携带 token 时，Mediora 会同时核对该 API 令牌；令牌重置后应同步更新回调 URL。企业微信回调仍须使用企业微信 Token 和 EncodingAESKey 验签、解密，不能只凭有效 API 令牌通过。公网域名必须能从企业微信访问，反向代理不能拦截 /api/message 或改写、丢失查询参数。

Telegram

Telegram 的普通通知是 Mediora 发给指定用户、群组或频道的消息；如果要从 Telegram 私聊发送下载链接，还需要再绑定下载助手交互入口。

1. 在 Telegram 中打开 @BotFather，发送 /newbot，按提示创建机器人并复制 Bot Token。

2. 打开刚创建的机器人，先发送一条消息。使用 Chat ID 查询机器人或 Telegram Bot API 找到接收消息的 Chat ID：个人通常是一串正数，群组通常是一串负数。

3. 在 Mediora 中填写：

   Mediora 字段	怎么填写
   Bot Token	@BotFather 返回的完整 Token。
   Chat ID	接收通知的个人、群组或频道 Chat ID。
   代理 API 地址	通常留空，默认使用 https://api.telegram.org；只有使用兼容 Telegram Bot API 的代理时才填写代理地址。

4. 将“启用”设为“是”，保存后点击“测试”。确认机器人已经被允许向目标群组或频道发消息；向频道发送消息时，通常还需要先把机器人加入频道并授予发消息权限。

如果要使用下载助手的 Telegram 私聊交互：先在“存储管理 → 下载助手 → 使用设置 → 交互入口”绑定这个已启用的 Telegram 配置。保存后 Mediora 会自动向 Telegram 注册 Webhook，页面会显示生成的回调地址。该地址不是上面的企业微信地址，而是包含交互入口 ID 和随机密钥的专用地址；必须为公网 HTTPS，端口只能使用 80、88、443 或 8443。

PushPlus

PushPlus 只负责把 Mediora 的通知推送到微信等接收端，不接收 Mediora 的回调，所以不需要填写回调地址，也不需要配置公网域名。

1. 登录PushPlus，在个人中心复制“用户 Token”。
2. 在 Mediora 的 PushPlus 配置中填写“用户 Token”。
3. 如果要把消息发送到 PushPlus 群组，再填写“群组编码（Topic）”；只发给自己的微信时留空。
4. 将“启用”设为“是”，保存并点击“测试”。

PushPlus 测试成功但工作流没有消息时，检查工作流中的“通知”步骤是否已启用，并确认该渠道仍处于启用状态。

常规设置

字段	什么时候填写	影响
访问域名	需要固定访问地址时填写完整地址，例如 https://media.example.com 或局域网的 http://192.168.1.20:3000；不能只写域名。	用于生成链接、企业微信回调和 Telegram 下载助手 Webhook；Telegram 入站交互需要公网 HTTPS 地址。PushPlus 仅发送通知，不需要回调地址。
API 令牌	普通外部通知调用消息接收入口时使用，可复制或重置。	普通外部通知使用 Authorization: Bearer 请求头，不放进 URL；重置后旧令牌立即失效。企业微信回调 URL 的填写方式见上文。它与企业微信 Token、智能体凭证不同，普通网页不需填写。
代理服务器	Mediora 访问外部服务需要走网络代理时填写。	会用于访问如 TMDB 等外部服务；可用“测试连接”检查。
页签激活刷新	通常保持开启。	浏览器从后台切回页面时自动刷新当前页面的主要数据；关闭后需要手动刷新。

通知投递记录与重试

通知页的投递记录用于查看下载助手和工作流等已接入事件的各渠道结果，不是所有历史消息的完整收件箱。失败时先修复渠道配置，再从原记录重试；如果对方已收件但成功回执未能保存，重试仍可能重复发送。

发送测试消息成功只证明出站通知可达，不证明企业微信 / Telegram 的入站私聊回调已经可用。入站交互还需在下载助手绑定入口，并完成公网地址和渠道侧设置。

凭据	用在哪儿
Mediora API 令牌	普通外部消息接收请求的 Bearer 请求头。
企业微信 Token / EncodingAESKey	企业微信签名校验与消息解密。
Telegram Bot Token	Telegram 机器人连接和 Webhook 注册。
Agent 手动凭证 / 浏览器授权	智能体 MCP 接入。

保存提示配置已被其他页面修改时，先重新读取并核对差异再保存；不要凭旧页面反复覆盖。更换服务地址后，原密码或密钥的掩码不能作为新服务的完整凭据，按页面要求重新填写。

主题与网络测试

打开页面的快捷菜单，可选择“切换主题”或“网络测试”。主题选择后立即预览，保存后应用到此 Mediora 实例，刷新或重启后仍会保留；取消则恢复已保存的颜色。

网络测试检查 Mediora 所在设备到当前实际使用服务的连接，可选择“按当前配置”或“全部直连”，并单独重试异常项。显示的耗时是收到响应所需时间，连通正常仍需结合各服务的认证和业务测试判断。

系统日志

路径：系统 → 系统日志。出现问题时先记下发生时间，再筛选相应时间和模块，查看错误详情。具体筛选、实时跟随和分享前检查见系统日志。

示例：同一台 NAS 上连接媒体服务器

假设 NAS 地址为 192.168.1.20，Emby 的实际访问端口为 8096，Mediora 的媒体代理实例端口为 8090：

• 这里的“服务地址”填 http://192.168.1.20:8096，只填协议、地址和端口，不附加 /web、登录链接或 API 密钥。
• 播放客户端连接媒体代理时，使用 http://192.168.1.20:8090；不要把这个地址反填为上游服务器。
• 两者分别运行在 Docker 容器里时，127.0.0.1 指当前容器自己。只有服务确实在同一网络环境中运行时才使用回环地址；同一 Docker 网络里的服务名，也要先确认能从 Mediora 访问。

下载器也要分两步验证：保存连接后能看到状态，再提交一个小下载，确认下载器报告的路径能在 Mediora 文件列表里读取。只测通接口，不能证明媒体路径已映射正确。

示例：只需要完成通知时

只选一个你正在使用的通知渠道就够了。例如用 PushPlus 接收任务完成提醒：保存并启用渠道 → 发送测试消息并确认收到 → 在需要的工作流里配置通知步骤 → 用一个小任务确认真实通知。

需要在 Telegram 或企业微信里私聊发送下载链接时，再单独配置下载助手的交互入口。通知发送成功与私聊回调接通是两件事，不必为了单纯接收完成提醒就开放私聊回调。

Telegram 的“代理 API 地址”要求兼容 Telegram Bot API 的服务地址，和常规设置中的 HTTP 网络代理地址用途不同。Bot Token、Chat ID 和 Mediora API 令牌也不能互换，填写时按本页对应字段逐项核对。

网络异常时，可以先用“网络测试”的“按当前配置”和“全部直连”作对照，再回到出错服务测试认证和具体业务。一次直连测试成功不会修改已保存的代理设置。