你是否曾经梦想过拥有一个完全属于自己的私人 Netflix？一个不依赖任何云端服务、不受订阅费用限制、且完全掌控你数字隐私的家庭影院系统？在 Ubuntu 22.04 LTS 上搭建 Jellyfin 媒体服务器，就是实现这一梦想的最佳途径。
虽然乍一看，在 Linux 系统上配置媒体服务器似乎有些令人生畏，尤其是对于刚接触命令行的朋友来说，但请不用担心。只要我们遵循正确的步骤，这一切其实比想象中要简单得多。在这篇文章中，我们将像老朋友一样，一步步探讨如何在 Ubuntu 22.04 LTS 上安装和配置 Jellyfin，让你轻松地整理、管理并向家中的任何设备流式传输你的高清影片。
通过阅读这篇教程，你将学到如何从零开始配置系统环境、处理依赖关系、设置安全的软件仓库，以及如何优化服务以获得最佳的播放体验。
目录
为什么选择 Jellyfin？
在我们开始动手敲代码之前，先让我们聊聊为什么 Jellyfin 值得我们花时间去搭建。Jellyfin 不仅仅是一个播放器，它是一个完整的“自由”生态系统。它是 Emby 和 Plex 等商业软件的开源替代品，但它坚持了一个核心理念：自由。
Jellyfin 的核心优势
我们可以通过以下几点来理解它的独特之处：
- 真正的免费与开源：Jellyfin 完全免费，没有“付费会员”功能墙，也不会追踪你的观看习惯。它的源代码托管在 GitHub 上，任何人都可以审查、修改和贡献。这意味着我们可以始终确保数据的安全性和私密性，没有任何“后门”或隐藏的数据传输。
- 强大的跨平台能力：无论你是 Windows 粉丝、Mac 用户、Linux 极客，还是喜欢用 Docker 部署一切，Jellyfin 都能完美运行。这使得它成为家庭服务器的理想选择。
- 随时随地访问：Jellyfin 提供了适用于 Android、iOS 和 Windows Phone 的移动应用程序。这意味着我们可以随时随地从世界任何地方向手机或平板电脑流式传输媒体，只要你的网络带宽允许，你的媒体库就跟着你走。
- 丰富的插件生态：就像浏览器一样，Jellyfin 支持各种插件。例如，你可以安装插件来添加对新媒体格式的支持、接入字幕库、甚至抓取额外的元数据来美化你的海报墙。
核心组件：FFmpeg 的重要性
在深入安装步骤之前，我们必须提到一个幕后英雄——FFmpeg。Jellyfin 媒体服务器高度依赖 FFmpeg 依赖项。为什么它如此重要？因为 FFmpeg 提供了核心的多媒体处理能力，使得 Jellyfin 能够处理各种媒体格式（如 MKV, MP4, AVI），为不同性能的设备进行实时转码（Transcoding），利用硬件加速来提升转码效率，并支持各种高级插件特性。没有 FFmpeg，Jellyfin 就只是一具空壳。
—
步骤 1：准备环境与安装依赖项
万事开头难，但只要我们准备好环境，后续就会一帆风顺。首先，我们需要确保 Ubuntu 系统拥有必要的工具来下载和安装软件。
安装基础工具包
为了从互联网安全地下载软件包并验证其签名，我们需要使用 INLINECODEf7441df8 命令向系统安装 INLINECODEb98e8281（用于下载数据）、INLINECODE5a14efea（用于加密签名验证）以及 INLINECODE48e9d625（用于管理仓库）。
打开你的终端，输入以下命令：
# 更新现有的软件包列表
sudo apt update
# 安装必要的依赖工具：curl, gnupg 和软件源管理工具
# -y 参数表示自动确认安装，无需手动输入 Yes
sudo apt install curl gnupg software-properties-common -y
代码解读：
-
sudo：以超级管理员权限运行命令。 -
curl：这是一个强大的命令行下载工具，我们将用它来获取 Jellyfin 的密钥。 -
gnupg：GNU Privacy Guard，用于处理 GPG 签名，确保我们下载的软件包是由官方发布的，未被篡改。
启用 Universe 软件仓库
在 Ubuntu 上，FFmpeg 依赖项位于 Universe 软件仓库 中。这是一个社区维护的巨大软件库。为了确保我们能安装到 FFmpeg 及其相关编解码器，我们需要启用这个仓库。
# 添加 universe 仓库并自动确认
# -y 参数同样用于自动化确认过程
sudo add-apt-repository universe -y
执行完这一步后，你的系统就已经准备好接收 Jellyfin 及其所有依赖了。
—
步骤 2：添加 Jellyfin 的 GPG 密钥
在从第三方仓库安装软件时，安全性是至关重要的。为了确保我们下载的 Jellyfin 软件包是真实、未损坏且由官方签发的，我们需要添加官方的 GPG 密钥。
创建密钥存储目录
现代 Linux 系统倾向于将非第三方密钥存储在特定的目录中以保持系统整洁。让我们先创建这个目录：
# 创建目录 /etc/apt/keyrings，如果已存在则忽略（-p 参数）
# 这是存储第三方 APT 仓库密钥的标准位置
sudo mkdir -p /etc/apt/keyrings
下载并验证密钥
现在，我们将使用 INLINECODE8b88b896 命令将 Jellyfin 团队的 GPG 签名密钥下载到这个新创建的目录中。请注意，这里使用了一个管道操作符 INLINECODE5e188c61，将 INLINECODE42546de7 的输出直接传递给 INLINECODE0e3a8060 进行处理。
# 下载 Jellyfin 官方 GPG 密钥
# -fsSL: f(失败时不显示错误), s(静默模式), S(显示错误), L(跟随重定向)
# gpg --dearmor: 将 ASCII 格式的密钥转换为二进制格式以便 APT 使用
curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg
为什么这样做？ 这一步相当于添加了一个“身份证明”。以后当我们从 Jellyfin 仓库下载软件时，系统都会拿出这个“身份证明”来比对，确保软件包的来源绝对可靠。
—
步骤 3：添加 Jellyfin 软件仓库
有了密钥还不够，我们还需要告诉系统去哪里下载 Jellyfin 的软件文件。这一步通过配置 APT 源列表来完成。
自动化配置仓库（推荐）
为了确保配置的准确性（特别是针对不同的 Ubuntu 版本和系统架构），Jellyfin 官方推荐使用一组命令来动态生成仓库配置文件。这种方法比手动编写更不容易出错。
让我们来看看这组命令的工作原理：
# 1. 获取操作系统的 ID (例如: ubuntu)
export VERSION_OS="$( awk -F‘=‘ ‘/^ID=/{ print $NF }‘ /etc/os-release )"
# 2. 获取操作系统的代号 (例如: jammy 对于 22.04)
export VERSION_CODENAME="$( awk -F‘=‘ ‘/^VERSION_CODENAME=/{ print $NF }‘ /etc/os-release )"
# 3. 获取系统架构 (例如: amd64)
export DPKG_ARCHITECTURE="$( dpkg --print-architecture )"
# 4. 使用 cat 和 heredoc (EOF) 将配置写入文件
# 这里我们使用变量 ${VERSION_OS} 等来自动填充配置内容
cat <<EOF | sudo tee /etc/apt/sources.list.d/jellyfin.sources
Types: deb
URIs: https://repo.jellyfin.org/$(echo ${VERSION_OS})
Suites: ${VERSION_CODENAME}
Components: main
Architectures: ${DPKG_ARCHITECTURE}
Signed-By: /etc/apt/keyrings/jellyfin.gpg
EOF
深入解析代码：
- INLINECODE6b350065: 这些命令设置了临时的环境变量。通过读取 INLINECODEfb4fd218 文件，我们能准确得知当前运行的是 Ubuntu 的哪个版本。这是极其重要的，因为如果你在 22.04 上安装了为 18.04 编写的包，可能会导致依赖冲突。
- INLINECODEa9046093: 这是一个非常实用的 Shell 技巧。它允许我们将多行文本（直到 INLINECODE42e4f6ec 标记）直接写入到需要 root 权限的文件中。
tee命令负责写入，同时我们可以看到输出内容。
完成这一步后，你的系统就已经认识 Jellyfin 的官方下载地址了。
—
步骤 4：更新系统软件包索引
在我们刚刚添加了新的仓库地址后，必须让系统更新一下它的“地图”。如果不更新，系统将不知道新仓库里有 Jellyfin 可供下载。
# 更新软件包列表并升级已安装的软件包
# 使用 && 连接两个命令，确保 update 成功后才执行 upgrade
sudo apt update && sudo apt upgrade -y
实用见解：保持系统更新不仅是好习惯，更是安全的关键。INLINECODEd5e528db 会刷新所有仓库的包列表，而 INLINECODE209a2c05 则会将系统中过时的软件（比如刚刚添加依赖项时可能涉及到的库）升级到最新版本。
—
步骤 5：在 Ubuntu 22.04 LTS 上安装 Jellyfin
终于到了最激动人心的时刻！现在我们可以一键安装 Jellyfin 了。
# 安装 jellyfin 软件包
# -y 参数用于自动确认安装提示
sudo apt install jellyfin -y
在安装过程中，你可能会看到一些关于配置文件的提示，或者关于 INLINECODE3ff44ec3 被自动安装作为依赖的提示。这是完全正常的。Jellyfin 会自动创建一个名为 INLINECODEb12c7d95 的系统用户和用户组来运行服务，这在安全上是一个最佳实践（不要使用 root 用户运行服务）。
常见安装问题排查
如果在安装过程中遇到“无法定位软件包”的错误，请回过头检查步骤 3 中生成的 /etc/apt/sources.list.d/jellyfin.sources 文件内容是否正确，或者步骤 2 中的 GPG 密钥路径是否正确。最常见的原因是仓库 URL 拼写错误。
—
步骤 6：启用服务并启动 Jellyfin 服务器
安装完成后，Jellyfin 服务通常不会立即运行。我们需要手动启动它，并将其设置为“开机自启”。
Systemd 服务管理详解
在现代 Linux 系统中，INLINECODEeb4be874 是负责管理后台服务的守护进程。我们将使用 INLINECODEafd1925a 命令与之交互。
-
systemctl enable: 这就像是设置汽车的“自动启动”。它会在系统引导时自动启动 Jellyfin 服务，确保即使服务器意外重启，你的媒体服务器也能自动恢复上线。 -
systemctl start: 这是“现在立刻启动”的命令。它不依赖于重启，立即将服务拉起。
让我们执行以下命令：
# 启动 Jellyfin 服务
sudo systemctl start jellyfin.service
# 设置 Jellyfin 为开机自启
sudo systemctl enable jellyfin.service
验证服务状态
作为专业开发者，我们不仅要启动服务，还要确认它确实在运行。我们可以使用 status 命令来查看详细日志。
# 查看 jellyfin 服务的运行状态
# 如果看到绿色的 "active (running)"，说明一切正常
systemctl status jellyfin.service
如果服务未能启动，你可以在这个界面看到详细的错误日志（Journal），通常会提示端口被占用或配置文件错误。
—
步骤 7：配置防火墙设置 (UFW)
既然服务器已经运行起来了，我们必须确保外部流量能够顺利访问它。Ubuntu 默认自带了一个名为 UFW (Uncomplicated Firewall) 的防火墙工具，但它默认会阻止所有传入连接。
开放 Jellyfin 默认端口
Jellyfin 默认使用 8096 端口进行 Web UI 访问和 HTTP 流媒体传输。我们需要使用 ufw allow 命令来放行这个端口。
# 允许通过 8096 端口访问 Jellyfin
sudo ufw allow 8096/tcp
# (可选) 如果你也想启用 HTTPS 访问，通常需要开放 8920，但这取决于后续配置
# sudo ufw allow 8920/tcp
# 检查防火墙状态，确认规则已生效
sudo ufw status
安全建议
如果你的服务器直接暴露在公网上，仅仅开放端口是不够的。你应该考虑在 Jellyfin 后台的“网络”设置中启用 HTTPS 支持，或者使用 Nginx 作为反向代理并配置 SSL 证书（如 Let‘s Encrypt）。这能确保你的密码和媒体流量不被中间人窃取。
—
步骤 8：首次配置与向导
现在，一切就绪！打开你喜欢的浏览器（Chrome, Firefox, Edge 等），在地址栏输入：
http://YOUR_SERVER_IP:8096
（将 INLINECODE3b70755b 替换为你 Ubuntu 服务器的局域网 IP 地址，例如 INLINECODEd06aab6d）。
你将看到欢迎界面。以下是一个快速的配置清单：
- 选择语言：支持简体中文。
- 创建管理员账户：请务必设置一个强密码。
- 添加媒体库：指引 Jellyfin 扫描你的电影和电视节目文件夹（建议提前挂载好大容量硬盘）。
- 元数据设置：选择中文作为首选元数据语言，这样海报和简介会更符合你的阅读习惯。
总结与后续步骤
恭喜你！你刚刚在 Ubuntu 22.04 上成功搭建了一个属于自己的流媒体帝国。通过这篇文章，我们不仅完成了安装，还深入理解了 Linux 软件仓库的运作机制、GPG 签名验证的重要性以及 Systemd 服务管理的基础。
作为一个私人服务器管理员，你的旅程才刚刚开始。接下来，你可以尝试探索 Jellyfin 丰富的插件系统，或者研究如何启用硬件加速（如 Intel QuickSync 或 NVIDIA NVENC），这将极大地提升你在转码 4K 视频时的性能表现。
无论你是想整理家庭录像，还是建立庞大的电影库，Jellyfin 都是你最忠实的伙伴。现在，去享受你的专属影院吧！