📺 媒体服务 - 媒体服务器

---

⚡ 快速操作流程

建议按以下顺序完成媒体服务器配置：

1. 新增媒体服务器并填写基础信息
2. 点击“测试”确认连接可用
3. 保存后执行一次手动同步
4. 按需配置定时同步任务
5. 如涉及网盘 .strm 播放，配置媒体代理

---

📋 媒体服务器列表

媒体服务器列表页面展示了所有已添加的媒体服务器，支持多种媒体服务器类型，如 Emby、Jellyfin、Plex 等。

🎯 功能操作

• 🔄 刷新：点击刷新按钮可重新加载媒体服务器列表数据
• ➕ 新增媒体服务器：添加新的媒体服务器配置
• ⏰ 定时任务：设置媒体库自动同步的定时任务
• ✏️ 编辑：修改现有媒体服务器配置
• ❌ 删除：删除不需要的媒体服务器配置
• ▶️ 同步：手动同步媒体服务器的媒体库数据
• 👁️ 同步历史记录：查看媒体服务器的同步历史记录
• 🗑️ 删除同步历史记录：清除媒体服务器的同步历史记录

📊 状态显示

• 类型：显示媒体服务器的类型图标（Emby、Jellyfin、Plex等）
• 名称：自定义的媒体服务器名称
• 开启：显示媒体服务器是否启用
• 默认：显示是否为默认媒体服务器
• 同步信息：显示最近一次同步的统计信息（电影数、电视剧数、耗时等）
• 更新时间：显示配置的最后更新时间

---

📚 支持的媒体服务器类型

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

类型	说明	教程
Emby	功能强大，生态成熟	查看
Jellyfin	开源免费，社区活跃	查看
Plex	使用体验完善，插件生态丰富	查看
绿影视 (UGoS)	绿联私有云设备上的媒体服务器	查看
飞牛影视 (FNOS)	飞牛系统中的媒体服务器	查看
极影视 (极空间)	极空间私有云设备上的媒体服务器	查看

每种媒体服务器都需要相应的配置信息，如服务器地址和API密钥。 点击上面的查看配置教程可以获得每一种支持的媒体服务器的详细配置方式。

➕ 新增媒体服务器

以 Emby 为例，输入服务器地址、名称、Api Key，点击“保存”即可完成添加。

💡 建议在服务器地址中直接填入外网访问地址。
若填写的是内网地址（例如 http://ip:port），则必须在“媒体播放地址”中填入外网访问地址以保证远程可访问。

🎛️ 媒体服务器配置字段

• 📺 媒体服务器：选择媒体服务器类型（Emby/Jellyfin/Plex等）
• 📝 名称：自定义媒体服务器名称
• ✅ 是否开启：控制媒体服务器是否启用
• ⭐ 默认：设置为默认媒体服务器，用于判断媒体是否存在或缺失集数
• 其他字段：根据媒体服务器类型填写相应的字段

🧪 测试连接

在保存前可以点击“测试”按钮验证配置是否正确，测试通过后再保存配置。

---

🔄 同步媒体服务器

推荐按以下步骤操作：

1. 点击操作栏中的同步按钮（小飞机图标）
2. 选择需要同步的媒体服务器
3. 点击“同步”并等待任务完成
4. 在“我的媒体库”中检查同步结果

---

⏰ 定时同步任务

可以通过"定时任务"按钮设置媒体库的自动同步计划，系统将在指定时间自动同步所有启用的媒体服务器。

---

🚀 媒体代理新能力

媒体服务已支持统一媒体代理能力，用于处理 Emby、Jellyfin、Plex 的播放请求，并根据客户端能力、直链可用性和网络环境自动选择更合适的分发方式。

对于 Emby、Jellyfin、Plex 的网盘 .strm 播放场景，建议必须配置媒体代理以处理网盘直链；否则通常无法完成 302 跳转播放。

完整说明请查看：

• 👉 [媒体代理能力详解]

---

⚠️ 注意事项

• 确保媒体服务器地址可访问，API 密钥权限正确
• 建议设置一个默认媒体服务器用于媒体状态检查
• 建议定期同步媒体库，保持媒体数据准确
• 若启用了媒体代理，请同时确认代理端口、外网访问地址与直链可达性配置正确