🎵 媒体服务

媒体服务功能用于管理和配置各种媒体服务器，构建个人媒体库，实现媒体内容的集中存储、管理和播放。

⚡ 快速开始

建议按以下顺序完成配置：

1. 先进入 媒体服务器 添加并测试服务器连接
2. 再按你的服务器类型查看对应教程（Emby / Jellyfin / Plex / UGoS / FNOS / 极影视）
3. Emby / Jellyfin / Plex 建议配置 Webhook 消息推送，并到对应媒体服务后台填写地址
4. 若使用网盘 .strm 播放，务必配置 媒体代理
5. 在 媒体服务器 完成至少一次媒体库同步
6. 需要排查缺集 / 未匹配 / 可升级 / 缺字幕时，进入 媒体健康中心
7. 需要自动或手动补字幕时，进入 字幕中心，并参考 字幕来源配置教程
8. 也可在 文件管理 对单文件检查字幕、对目录发起字幕巡检
9. 需要看观看数据时，进入 观影报告

🧭 功能导航

核心页面

• 📚 我的媒体库：查看电影、电视剧等媒体数据总览
• 🩺 媒体健康中心：发现缺集、未匹配、可升级、缺字幕等媒体库问题
• 🎬 字幕中心：管理字幕来源、媒体库策略与异步补齐任务
• 🧩 字幕来源配置教程：OpenSubtitles / Assrt / SubDL / 网页源凭据与 Cookie 说明
• 📊 观影报告：观看时长趋势、热门内容、用户活跃、设备与来源分布
• 🖥️ 媒体服务器：管理服务器新增、编辑、同步、定时任务、Webhook 地址与消息推送
• 🚀 媒体代理：配置播放分发策略、直链探测和回退机制
• 🪝 Webhook：媒体服务器后台回调配置与开放消息接口

服务器配置教程

• 🎬 Emby
• 🐙 Jellyfin
• 🎥 Plex
• 🟢 绿影视
• 🟠 飞牛影视
• 🔵 极影视

🔑 核心概念

• 媒体服务器：用于存储、管理和播放媒体内容的软件服务（如 Emby、Plex、Jellyfin）
• 媒体库：按电影、电视剧等类型组织媒体内容的逻辑结构
• 元数据：标题、简介、演员、海报、评分等描述信息
• 刮削：从 TheMovieDB、TheTVDB 等来源自动获取元数据和图片
• 直链播放：客户端直接访问资源地址进行播放，对网络质量要求较高

🔄 工作流程

媒体服务的基本工作流程如下：

1. 配置服务器：选择并配置合适的媒体服务器软件
2. 设置媒体库：指定媒体文件的存储目录，配置媒体库设置
3. 自动刮削：系统自动识别媒体文件并获取元数据
4. 库刷新：文件整理完成后通知媒体服务器刷新库
5. 内容播放：通过各种客户端设备访问和播放媒体内容

⚙️ 支持的媒体服务器

系统支持以下主流媒体服务器：

类型	说明	教程
Emby	功能丰富、生态成熟，设备兼容性好	查看
Jellyfin	免费开源、社区活跃	查看
Plex	体验完善、生态丰富	查看
绿影视 (UGoS)	面向中文场景的国产媒体服务	查看
飞牛影视 (FNOS)	飞牛系统中的媒体服务，账号密码接入	查看
极影视 (极空间)	极空间设备上的媒体服务	查看

📝 注意事项

• 选择服务器时优先考虑设备兼容性、远程访问场景与维护成本
• 确保媒体服务器可访问媒体文件目录，且 API 权限配置正确
• Emby、Jellyfin、Plex 建议开启 Webhook：既可做消息推送，也可为观影报告提供实时数据
• Emby、Jellyfin、Plex 在网盘 .strm 场景建议先配置媒体代理（查看媒体代理配置说明），否则通常无法完成 302 跳转播放
• 定期更新服务器版本，并关注版本兼容与变更说明
• 合理设置刮削与路径映射，减少识别错误