🔵 Plex

📋 简介

Plex是一个流行的媒体服务器软件，可以组织、管理和播放个人媒体收藏。它提供了精美的用户界面和强大的功能，支持在各种设备上流畅播放媒体内容。

⚙️ 配置说明

🔧 配置字段

• 📡 服务器地址：Plex服务器的访问地址，通常为 http://IP:32400 或 https://域名 格式
• 🔑 API密钥（X-Plex-Token）：访问Plex API所需的令牌
• 📂 媒体播放地址 / 外网地址：用于远程访问的播放地址
• 🚪 代理端口：用于strm302播放的代理端口（可选）
• 🔔 代理通知：开启后发送媒体代理相关通知（可选）
• 🔀 媒体路径映射：用于将媒体服务器中的路径转换为实际网盘或挂载路径（可选）
• ☁️ 网盘挂载路径：用于声明网盘挂载前缀，帮助代理正确识别并解析直链（可选）

🌐 获取API密钥

1. 登录Plex管理界面
2. 点击右上角的用户头像
3. 选择"设置"
4. 在页面URL中找到X-Plex-Token=参数，复制其后的令牌值
5. 或者通过Plex Web界面按F12打开开发者工具，在网络选项卡中查找包含令牌的请求

📋 配置步骤

1. 在媒体服务器页面点击"新增媒体服务器"
2. 选择"Plex"作为服务器类型
3. 填写服务器名称（自定义）
4. 输入服务器地址（Plex服务器的IP和32400端口）
5. 输入API密钥（X-Plex-Token）
6. 点击"测试"按钮验证配置
7. 测试成功后点击"保存"

🚀 媒体代理（STRM 必读）

• 网盘直链场景下，Plex 的 .strm 播放需要启用媒体代理处理直链分发
• 若未配置媒体代理，通常无法完成 302 跳转播放
• 详细配置请查看：[媒体代理能力详解]

🆕 新增代理字段说明

🔔 代理通知

开启后，Plex 的媒体代理在处理播放请求时会发送相关通知，便于观察代理是否命中、是否使用直链或是否发生降级回退。

• 适合调试代理或排查播放问题时开启
• 仍需在消息通知渠道中勾选 媒体代理 推送类型
• 稳定运行后可按需关闭

🔀 媒体路径映射

用于把 Plex 实际返回的媒体路径统一映射到代理可以识别的目录结构，特别适合 Docker、网盘挂载和多环境路径不一致的场景。

• 每行填写一条规则
• 格式为 原路径前缀:目标路径前缀
• 例如：/data/media:/115/media
• 命中后会先做路径替换，再参与白名单匹配和直链解析

适用场景：

• Plex 扫描目录与实际文件路径不一致
• 容器路径、宿主机路径、网盘挂载路径存在差异
• 需要把 Plex 的媒体路径统一收敛到网盘目录

☁️ 网盘挂载路径

用于声明哪些路径属于网盘挂载目录，让 Plex 播放请求在命中这些路径时可以更顺利地走媒体代理直链流程。

• 每行填写一个路径前缀
• 例如：/115/media
• 命中后代理会按去掉该前缀后的相对路径继续解析
• 对非 .strm 资源也能生效

适用场景：

• Plex 媒体库直接建立在挂载目录之上
• 希望 Plex 的本地路径也能被代理识别成可直链的网盘资源

⚠️ 注意事项

• 确保Plex服务器在网络中可访问
• 默认Plex端口为32400，请确保此端口未被防火墙阻止
• API密钥需要具有足够的权限以访问媒体库信息
• 如果使用Plex Pass订阅，可以获得更多高级功能
• 需要确保防火墙设置允许相关端口通信
• 对于远程访问，建议配置HTTPS以提高安全性
• 某些功能可能需要Plex Pass订阅才能使用