Ubuntu 下 Jellyfin 播放器与播放体验设置指南
一 访问入口与基础配置
- 安装完成后，使用浏览器访问 http://服务器IP:8096 进入向导，创建管理员账户、添加媒体库路径（如 /mnt/media），完成后即可在网页端直接播放。若需远程访问，建议通过反向代理或内网穿透；服务器本机播放同样使用 :8096 地址。为提升安全性与可达性，可配置 Apache/Nginx + HTTPS 与防火墙放行 8096/tcp。
二 网页端播放器关键设置
- 字幕
- 在播放页面点击“字幕”图标选择内嵌字幕轨道；外挂字幕（如 SRT/SSA/ASS）需与视频同名并放在同目录，或在媒体库的高级选项中为对应条目刷新元数据后识别。
- 音轨与声道
- 在“播放”→“音轨/音频设备”选择所需音轨；如设备支持，可切换 5.1/7.1 声道输出（取决于客户端与系统音频设备）。
- 播放器与硬件加速
- 在“播放”→“转码”中按需开启硬件加速：
- VAAPI：适用于 Intel 核显。先确认设备节点：ls -l /dev/dri 应见 renderD128；将 Jellyfin 服务用户加入 render 组（sudo usermod -aG render jellyfin），重启服务后在“VA API Device”填入 /dev/dri/renderD128。
- Quick Sync（QSV）：同为 Intel 平台的高级路径，需合适驱动与核显支持，在转码页面选择 QSV 并测试播放。
- NVIDIA NVENC：安装 NVIDIA 驱动 与容器工具链（如使用 Docker），在转码页面选择 NVENC 测试。
- 若播放卡顿或音画不同步，优先检查是否触发了转码（网页左下角有提示），并调整码率/分辨率或改用 Direct Play。
- 外网访问与 HTTPS
- 推荐用 Apache/Nginx 反向代理 配置 HTTPS（Certbot 自动申请证书），对外暴露 443 端口，内部代理到 8096，更安全且便于穿透。
三 Ubuntu 桌面客户端与 MPV 播放器集成
- 桌面客户端
- 从 Jellyfin 官网下载 Linux（.deb） 客户端，安装后登录服务器即可播放。客户端提供更完整的播放控制与系统媒体键支持。
- 第三方播放器 MPV（推荐给高级用户）
- 安装 MPV：sudo apt install mpv
- 在 Jellyfin Web“播放”→“播放器”选择 MPV，可获得更强的硬解兼容与渲染能力（如 VAAPI）。如遇沙箱/权限问题，确保桌面会话下运行且用户属于 video/render 组。
四 外观与多用户设置
- 外观与自定义
- 在“控制台”→外观（Look and Feel）可切换 主题；如需更深度自定义，可在“自定义 CSS/JS”中注入样式与脚本（修改前请备份，变更后重启服务生效）。
- 多用户与权限
- 在“控制台”→用户 添加家庭成员账户，分别为其分配媒体库访问、播放、下载等权限；可设置 家长控制 与播放策略，实现家庭多用户隔离与配额管理。
五 常见问题排查
- 媒体库不显示或新片不识别
- 检查媒体目录权限（Jellyfin 运行用户需可读），必要时将目录所属组设为 jellyfin 或建立共享组并加入 jellyfin；新文件未自动识别时，在对应媒体库执行 Scan Library/Refresh Metadata。
- 硬件加速失败或转码异常
- 确认 /dev/dri 设备存在且权限正确（render 组），ffmpeg 路径与版本匹配；在转码页面选择正确的 VAAPI/QSV/NVENC 并查看日志定位问题。
- 远程访问失败
- 核对 防火墙/云安全组 已放行 8096/tcp 或反向代理的 443/tcp；若使用域名，确保 DNS 与 证书 正常。
