Jellyfin 安装启动失败排查与解决记录

在 Ubuntu 22.04 LTS 上安装 Jellyfin 时,可能会遇到服务无法正常启动的问题。以下记录一次完整的排查和修复过程,供后续参考。 问题现象 通过官方脚本或 APT 安装 Jellyfin 后,执行 systemctl status jellyfin.service 得到以下报错: 关键提示是 status=200/CHDIR,表示 systemd 在切换工作目录时失败,常见原因是目录不存在或无权限。 排查步骤 验证结果 日志显示 Jellyfin 已正确绑定到内网地址: 在浏览器中访问: 即可进入初始化向导。 总结与经验 通过以上步骤,Jellyfin 服务成功启动,系统恢复正常使用。

Jellyfin 完整迁移指南:媒体文件、数据与配置

在服务器迁移或系统重装时,如何让 Jellyfin 保持原有的媒体库、封面、用户和观看记录?只需完成 媒体文件迁移 + 配置与数据库迁移 + 重新安装软件包 三个步骤,即可实现无缝恢复。 1. 准备工作 迁移前,需要确保新旧系统之间能够互相访问(通常通过 SSH),并拥有管理员权限。推荐使用 rsync 工具进行文件同步,既能保持权限和时间戳,也能断点续传。 2. 迁移媒体文件 首先迁移存放影片、剧集的媒体目录。例如: 这样,源服务器中的 Media Library 目录会完整复制到新服务器的 /home/user/ 下。注意路径不要在末尾添加 /,以确保目录结构保持一致。 3. 迁移配置与数据库 Jellyfin 的核心数据主要分布在两个目录: 迁移命令示例: 这样就能将所有元数据、封面、用户记录和插件一并带走。 4. 安装 Jellyfin 在新系统上安装与旧系统版本一致的 Jellyfin,避免数据库不兼容问题。以 Debian/Ubuntu 为例: 5. 权限检查与服务启动 迁移完成后,需要确保目录权限正确: 然后启动 Jellyfin 服务: 6. 验证迁移结果 打开浏览器访问 http://<新服务器IP>:8096,确认以下内容: 如果一切正常,就说明迁移成功。 总结 …

Jellyfin 使用 443 标准端口解决 Trailer 与预览片段播放问题

在部署 Jellyfin 媒体服务器时,许多人会遇到 Trailer(预告片)或缩略图预览无法播放的问题。尤其当服务端口未使用标准的 443 端口,即使已经启用了 HTTPS,仍然会在浏览器中被阻止。通过切换到标准 443 端口,这些问题可以被彻底解决,以下总结了原因与解决思路。 现象 在 Jellyfin 界面中,电影详情页会提供一个 Trailer(预告片)按钮,该功能通常会调用外部平台(如 YouTube 或 TMDb)的视频链接,通过内嵌播放器在页面中播放。当端口不是 443 时,即使启用了 HTTPS,浏览器也会提示“不允许播放”或直接阻止 Trailer 视频的加载。 此外,视频预览片段(如快进时显示的缩略图)也可能无法加载,表现为黑屏、卡顿或直接无法生成预览。 根本原因 非标准端口引发的浏览器安全策略限制 切换到 443 端口的优势 配置建议 总结 Trailer 与视频预览无法播放的问题,根本原因在于非标准 HTTPS 端口导致的浏览器安全限制。切换到标准 443 端口后,浏览器会将其视为安全内容,从而允许外部嵌入视频的正常播放,Jellyfin 相关功能也将完全恢复正常体验。 参考