在 Ubuntu 上部署 Jellyfin 的跨平台同步方案
一、目标与总体思路
- 跨平台共享：在 Ubuntu 上运行 Jellyfin，通过官方客户端在 Windows/macOS/Android/iOS/TV 等设备上访问同一媒体库，实现多设备观看与权限隔离。
- 跨平台同步：重点在移动端的离线观看（将剧集/电影缓存到本地），以及多设备间的播放进度、收藏等用户数据在服务器侧统一保存与同步。Jellyfin 提供多用户与播放进度同步能力，移动端支持离线缓存观看。
二、Ubuntu 服务器部署与基础配置
- 安装方式（二选一）
- 脚本一键安装（推荐）
- 执行：
curl -s https://repo.jellyfin.org/install-debuntu.sh | sudo bash
- 启动：
sudo systemctl start jellyfin
- Docker 部署（环境隔离）
- 数据卷：
docker volume create jellyfin-config jellyfin-cache jellyfin-media
- 运行示例：
docker run -d --name jellyfin --user 1000:1000 --net=host -v jellyfin-config:/config -v jellyfin-cache:/cache -v jellyfin-media:/media --restart=unless-stopped jellyfin/jellyfin
- 首次访问与基础设置
- 浏览器打开：
http://<服务器IP>:8096，完成向导（语言、管理员、媒体库路径等）。
- 媒体库路径建议使用绝对路径并挂载到容器内（Docker 场景映射到 /media）。
- 文件权限与库扫描
- 权限：确保运行 Jellyfin 的系统用户对媒体目录可读（如将目录组设为 media 并把 jellyfin 加入该组，或
chown -R jellyfin:jellyfin /your/media）。
- 扫描：新增内容后，在 Web UI 对应媒体库执行 Scan Library/Refresh Metadata。
三、跨平台访问与远程连接
- 局域网直连：各设备在同一网络下通过
http://<服务器IP>:8096 访问。
- 远程访问与 HTTPS（两种常见做法）
- 路由器端口转发：将 8096/8920 转发到服务器；在 Jellyfin 管理界面启用远程访问，并配置 HTTPS/Let’s Encrypt 证书。
- 反向代理（Nginx/Apache）或内网穿透：用 Nginx 终止 TLS 并反向代理到 8096；在复杂网络环境可用 Tailscale 等实现安全的内网穿透访问。
四、实现跨平台同步的关键配置
- 服务器端
- 创建家庭成员账户，设置各自的内容访问权限与家长控制。
- 在用户权限中开启与“同步/离线观看”相关的功能（不同版本名称可能略有差异，常见为允许媒体同步/离线）。
- 建议启用 HTTPS，避免移动网络下同步失败或证书校验问题。
- 客户端（以 Android 为例）
- 安装官方 Jellyfin App，登录服务器账户。
- 在目标媒体详情页点击“同步”，选择质量（如 自适应/720p/1080p）、存储位置与范围（单集/整季/全部），开始同步。
- 在“我的媒体 → 已同步”查看、播放与删除离线内容；在同步设置中可配置仅 Wi‑Fi、仅 充电 时同步，避免移动数据与存储占用。
- 同步效果与适用场景
- 进度、收藏等用户数据在服务器侧统一保存，换设备登录同一账户即可继承。
- 离线观看适合通勤/旅行等弱网或无网场景，移动端支持后台与断点续传。
五、常见问题与优化建议
- 新文件未显示：在媒体库执行 Scan Library；若已入库但元数据异常，执行 Refresh Metadata。
- 权限问题导致“看不到媒体”：确认媒体目录对 jellyfin 用户可读（组权限或所有权设置）。
- 远程访问不稳定：优先使用 Nginx + Let’s Encrypt 或 Tailscale，减少公网暴露与端口映射带来的问题。
- 同步慢或失败：在 5GHz Wi‑Fi 下同步、预留足够存储空间、避免多设备并发同步；必要时降低同步质量。
- 转码与硬件加速：在“控制台 → 播放”启用 Intel Quick Sync/NVIDIA NVENC 等硬件加速，提升移动端兼容与同步效率。