🧊 Jellyfin

📋 简介

Jellyfin是一个免费、开源的媒体服务器软件，可以管理和播放存储在各种设备上的多媒体内容。它是Emby的一个开源分支，提供了类似的功能但完全免费且社区驱动。

⚙️ 配置说明

🔧 配置字段

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

🌐 获取API密钥

1. 登录Jellyfin管理界面
2. 进入"控制台"->"API密钥"页面
3. 点击"添加新密钥"按钮
4. 输入应用名称（如"Media Saber"）
5. 复制生成的API密钥

📋 配置步骤

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

🚀 媒体代理（STRM 必读）

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

🔌 关于"代理端口"的补充说明

"代理端口"配置是为有 strm302 播放需求 的用户准备的。

strm302 应用场景简述：
当媒体库为网盘资源（即通过 strm 文件构建的媒体库）时，在远程播放（例如在公司播放家中媒体库）时，strm302 可以直接建立网盘播放通道，而无需占用家庭服务器的上行带宽。

📝 若无相关需求，此项可忽略。

配置说明：

• 填入一个未被占用的端口号
• 该端口需在部署 ms 时进行端口映射（非常重要）
• 访jellyfin就需要访问配置的302端口，如截图配置了代理端口8097，访问jellyfin地址为 http://127.0.0.1:8097

🆕 新增代理字段说明

🔔 代理通知

开启后，媒体代理在处理 Jellyfin 播放请求时可以发送相关通知，便于确认代理是否命中以及是否发生回退。

• 适合需要观察代理链路的用户开启
• 仍需在消息通知渠道中勾选 媒体代理 推送类型
• 若只想安静使用播放代理，可保持关闭

🔀 媒体路径映射

用于把 Jellyfin 中记录的媒体路径转换成代理真正用于解析的路径，适合路径不一致的部署环境。

• 每行填写一条规则
• 格式为 原路径前缀:目标路径前缀
• 例如：/mnt/media:/115/media
• 命中后会先替换路径，再进入挂载路径匹配和直链解析流程

适用场景：

• 容器内扫描路径与宿主机实际路径不同
• 本地路径实际对应网盘挂载目录
• 多套目录结构需要统一映射

☁️ 网盘挂载路径

用于标记哪些路径属于网盘挂载目录，方便媒体代理把这类文件按网盘资源来处理。

• 每行填写一个路径前缀
• 例如：/115/media
• 命中后代理会按去掉该前缀后的相对路径继续做直链解析
• 对非 .strm 的网盘文件同样有效

适用场景：

• Jellyfin 扫描目录本身就是 rclone、cd2 等挂载目录
• 希望代理优先识别挂载路径并直接走直链链路

---

⚠️ 注意事项

• 确保Jellyfin服务器在网络中可访问
• API密钥需要具有足够的权限以访问媒体库信息
• 默认Jellyfin端口为8096，请确保此端口未被防火墙阻止
• 需要确保防火墙设置允许相关端口通信
• 对于远程访问，建议配置HTTPS以提高安全性
• Jellyfin作为开源软件，更新频率较高，建议关注更新日志