Jellyfin
Jellyfin 是一套开源的多媒体管理应用套件，专为组织、管理和分享数字媒体文件而设计。通过该插件，AMMDS 可与 Jellyfin 媒体服务器建立深度集成，实现元数据同步、演员头像补全等高级功能。
插件配置
基本配置
| 参数 | 说明 | 默认值 |
|---|---|---|
| 启用状态 | 控制是否启用 Jellyfin 插件 | 关闭 |
| 服务地址 | Jellyfin 服务器的网络端点 | http://127.0.0.1:8096 |
| API 密钥 | Jellyfin 服务器的认证令牌 | - |
| 用户名 | (可选) Jellyfin 服务器的登录用户名 | - |
| 密码 | (可选) Jellyfin 服务器的登录密码 | - |
| 绑定用户 | 选择要绑定的 Jellyfin 用户账号 | - |
| 自动补全 | 控制是否为媒体库中演员缺失头像自动补全 | 关闭 |
配置说明
- 服务地址：请使用服务器的实际网络地址，避免使用
localhost或127.0.0.1，否则可能导致容器化部署时连接失败 - API 密钥：可在 Jellyfin 管理界面的「系统」→「高级」→「API 密钥」中生成
- 绑定用户：需先填写正确的服务地址和 API 密钥并保存后，才能在下拉列表中选择用户
- 自动补全：开启后，系统将自动为媒体库中演员缺失的头像进行补全，前提是 AMMDS 中已添加对应演员的头像
连接验证
- 网络连通性：确保 AMMDS 服务器能够访问 Jellyfin 服务地址
- 认证信息：API 密钥需具有足够的权限执行所需操作
- 服务状态：确保 Jellyfin 服务器处于运行状态且可正常响应 API 请求
功能特性
- 元数据同步：支持与 Jellyfin 媒体库的元数据双向同步
- 用户绑定：可绑定特定 Jellyfin 用户，实现个性化配置
- 头像自动补全：智能识别并补全演员缺失的头像信息
- 状态监控：实时监控 Jellyfin 服务器的运行状态
注意事项
服务地址配置
请勿使用 localhost 或 127.0.0.1 作为服务地址，特别是在容器化部署环境中，否则可能导致连接失败。
自动补全前提
启用自动补全功能前，请确保 AMMDS 中已添加对应演员的头像数据，否则补全功能可能无法正常工作。
API 密钥权限
建议为 AMMDS 创建专用的 API 密钥，并赋予适当的权限范围，以确保系统安全性。