为什么Ubuntu装Jellyfin失败

在 Ubuntu 上安装 Jellyfin 失败的原因有很多种，下面我按常见原因 → 对应解决办法给你梳理一下，你可以对照看看是哪一类。

一、软件源 / 网络问题（最常见）

1. 没添加 Jellyfin 官方源

很多人直接：

sudo apt install jellyfin

但 Ubuntu 官方仓库没有 jellyfin，会提示：

E: Unable to locate package jellyfin

✅ 正确做法：

sudo apt install curl gnupg
curl -fsSL https://repo.jellyfin.org/ubuntu/jellyfin_team.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/jellyfin.gpg

echo "deb [signed-by=/usr/share/keyrings/jellyfin.gpg] https://repo.jellyfin.org/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list

sudo apt update
sudo apt install jellyfin

2. Ubuntu 版本太新或太旧

Jellyfin 只支持 特定 Ubuntu 版本（如 20.04 / 22.04 / 24.04）

检查：

lsb_release -a

如果显示 noble 但你用的是老教程，可能源不匹配。

3. 网络无法访问 Jellyfin 源（国内常见问题）

• 被墙
• 速度极慢导致 timeout

✅ 解决：

• 换网络（代理 / 科学上网）
• 或用国内镜像（如清华、中科大，不一定同步）

二、依赖问题

4. 依赖包没装全

常见错误：

The following packages have unmet dependencies

解决：

sudo apt -f install
sudo apt update
sudo apt upgrade

5. 系统里有冲突的包

比如：

• 装过 Emby
• 装过旧版 Jellyfin

清理：

sudo apt remove jellyfin emby-server
sudo apt autoremove

三、权限 / 服务问题

6. 服务起不来但“装上了”

检查：

systemctl status jellyfin

常见问题：

• /var/lib/jellyfin 权限不对
• 磁盘满

修复：

sudo chown -R jellyfin:jellyfin /var/lib/jellyfin

四、其他方式安装失败

7. 用 Docker 但端口 / 权限错

如果你是用 Docker：

docker run -d \
  -p 8096:8096 \
  -v /path/config:/config \
  -v /path/media:/media \
  jellyfin/jellyfin

失败常因：

• 没开 8096
• 路径不存在

五、你可以这样帮我精准判断

如果你愿意，把失败信息原样贴出来（终端报错），我可以：

• 直接告诉你哪一步错
• 给你一条命令修好

例如：

• E: Unable to locate package jellyfin
• 404 Not Found
• Failed to start jellyfin.service

你现在是哪种情况？