Ubuntu 下 Jellyfin 播放列表设置指南
一 环境准备与访问
- 本机或局域网访问地址：http://localhost:8096 或 http://<服务器IP>:8096。首次进入完成管理员创建、语言与媒体库添加。
- Ubuntu 常见部署方式与要点：
- 原生安装：使用官方仓库一键安装，启动服务后即可访问 Web UI。
- Docker 部署：映射 /media（媒体）、/config（配置），并设置 UID/GID 避免权限问题。
- 媒体库准备就绪后，播放列表功能才会在客户端可用（网页、移动端 App 等）。
二 创建与管理播放列表
- 入口与创建：在网页端进入左侧的播放列表，点击新建播放列表，设置名称；部分客户端支持选择媒体类型（视频/音频/混合）与可见性（私人/公开）。
- 添加内容：
- 在媒体详情页点击添加到并选择目标播放列表；
- 在媒体库多选后通过上下文菜单添加；
- 支持的客户端可拖拽条目到播放列表。
- 排序与维护：支持手动拖拽排序、按标题/添加日期/播放次数等自动排序、一键随机排序；可单个或批量移除条目，或清空列表。
三 共享与协作
- 可见性：将播放列表设为公开后，对所有用户可见；默认通常为私人。
- 细粒度权限：可为指定用户设置只读/编辑/管理等权限，实现多人协作维护同一播放列表（如家庭或团队共享）。
- 操作路径：进入播放列表的设置/共享，搜索并添加用户，分配权限后保存。
四 进阶与自动化
- 智能播放列表（音乐场景）：可按最近添加、最常播放、特定艺术家/流派、评分较高等条件自动整理音乐内容，适合持续更新的精选合集。
- API 与自动化：支持通过 REST API 创建与管理播放列表，便于批量导入、定时更新或与其他服务集成（示例请求见下文“快速命令”）。
五 常见问题与快速命令
- 看不到播放列表或无法添加内容：回到控制台 → 媒体库执行Scan Library/Refresh Metadata，确保媒体已被识别且条目信息完整。
- 权限导致媒体不可见（原生或 Docker）：确保运行 Jellyfin 的用户（如 jellyfin 或容器映射的 UID/GID）对媒体目录具备读取权限。
- Docker 快速命令示例：
- 启动容器（映射媒体与配置，设置 UID/GID 为当前用户，避免权限问题）
sudo docker run -d \
–name jellyfin \
–volume /path/to/your/media:/media \
–volume /path/to/jellyfin/config:/config \
-e UID=1000 -e GID=1000 \
-p 8096:8096 \
jellyfin/jellyfin
- API 快速示例（创建视频播放列表并添加条目）：
- 创建
curl -X POST http://<服务器IP>:8096/Playlists \
-H “Content-Type: application/json” \
-d ‘{ “Name”: “周末电影夜”, “MediaType”: “Video”, “ItemIdList”: [“item-id-1”,“item-id-2”] }’
- 添加更多条目
curl -X POST http://<服务器IP>:8096/Playlists//Items \
-H “Content-Type: application/json” \
-d ‘{ “ItemIds”: [“item-id-3”,“item-id-4”] }’
提示：将 <服务器IP>、库中的 item-id-* 替换为实际值；API 需使用有效的 用户令牌/认证（在用户资料中生成）。
