虽然有点复杂，但是体验一级棒！

我一直渴望拥有一款简单且低成本的媒体服务器，可以全天候运行，树莓派上的Jellyfin恰好完美契合了这一需求。虽然设置过程有点复杂，但一旦运行起来，使用体验会非常好。如果你也对此感兴趣，接下来我将一步步引导你完成整个设置流程！

Jellyfin可以通过添加HTTPS支持，配置Jellyfin软件源，然后使用APT软件包管理器进行安装。后续还能通过Web界面配置Jellyfin媒体服务器。

本教程将详细介绍在树莓派上安装Jellyfin的过程、设置说明以及配置技巧。在开始本教程之前，先为大家简要介绍一下Jellyfin。

什么是Jellyfin？

Jellyfin是一款强大的媒体服务器软件，它允许用户创建个性化的流媒体平台，让他们可以通过本地网络在多个设备上畅享喜爱的内容。

Jellyfin的独特之处在于，它没有付费版本或订阅模式。与Plex和Emby等选项相比，它是节省开支的绝佳替代方案。

让我们将树莓派设置为Jellyfin媒体服务器吧。在开始实际教程之前，我们先来看看本教程所需的硬件和软件要求。

硬件和软件要求

以下是遵循本教程所需准备的物品：

树莓派：推荐使用树莓派4，因为媒体服务器需要相当强大的CPU和更多内存。

SD卡：为树莓派刷入最新版本的树莓派操作系统。需要至少8GB的SD卡。

外置硬盘：可以是SSD固态硬盘、HDD机械硬盘或具有大容量的U盘。它将用于存储所有媒体文件。

除此之外，还需要一个本地网络（基于Wi-Fi或以太网），确保能通过不同设备远程访问Jellyfin。

需要注意的是，你需要一台全新安装了最新版本树莓派操作系统的树莓派。这里有一篇很棒的文章可以帮助你完成这一步骤：《在树莓派上安装树莓派操作系统（图解指南）》。

现在我们已经明确了所需条件，让我们开始教程吧。

Jellyfin的安装与设置

以下是在树莓派上安装Jellyfin的详细步骤：

为安装Jellyfin准备树莓派。

在树莓派上安装Jellyfin。

首次访问并初步设置Jellyfin的Web界面。

现在，让我们深入探讨每个步骤。

为安装Jellyfin准备树莓派

在本节中，我们将通过以下操作为树莓派安装Jellyfin做准备：

为apt软件包添加Jellyfin软件源。

挂载外置存储设备。

现在，让我们详细讨论每个选项。

添加Jellyfin软件源

在本节中，我们将讨论如何添加Jellyfin软件源，以便在树莓派上安装Jellyfin软件包。我们需要在终端中执行一些命令来完成此操作。

第一步是将树莓派上的内置软件包更新到最新版本。为此，我们只需在树莓派的终端中执行以下命令，并重启树莓派使更改生效。

sudo apt updatesudo apt upgrade

自动在启动时挂载外置硬盘

接下来，是为了让Jellyfin可以访问你本地存储的固定位置的媒体文件，如电影和电视节目。如果你现在还没有任何媒体文件，可以跳过此步骤，后续需要时再回来设置。

如果你和我一样，将所有媒体文件存储在单独的驱动器上，如外置USB驱动器或网络附加存储（NAS）上。在这种情况下，你需要在系统上创建一个静态挂载位置，以便让Jellyfin可以将该位置用作主要媒体目录。

本教程钟，我们将为外置设备设置一个静态挂载路径“/mnt/jellyfin”。

只需根据你的外置存储设备，按照以下教程之一进行操作：

《如何在树莓派上挂载USB驱动器》

https://raspberrytips.com/mount-usb-drive-raspberry-pi

《如何轻松映射网络驱动器》

https://raspberrytips.com/map-network-drive-on-ubuntu/

这样就完成了让树莓派准备好安装Jellyfin所需的设置。现在，我们可以继续实际的Jellyfin安装过程了。

Jellyfin的安装

做好所有前期准备后，接下来开始安装Jellyfin。本节将展示如何使用单个命令安装Jellyfin。

推荐方法：使用官方Jellyfin安装脚本

在新的终端窗口中执行以下命令：

curl https://repo.jellyfin.org/install-debuntu.sh | sudo bash

此命令将安装特定于我们树莓派硬件和软件架构的Jellyfin版本。由于Jellyfin是一个相当庞大的软件包（约100兆字节），因此完成此过程需要一些时间。

如果一切设置正确，你应该能够毫无问题地安装Jellyfin。服务应该启动并处于活动状态：

至此，你已成功在树莓派上安装了Jellyfin。你可以跳转到“首次访问和初步设置”部分。我将向你展示如何首次访问Jellyfin的Web界面并完成首次设置。

替代方法：手动安装

如果因特殊原因，官方Jellyfin脚本仍然无法为你工作，也可以选择手动安装所有内容。Jellyfin在其官方文档中提供了相关说明。

https://jellyfin.org/docs/general/installation/advanced/manual#official-linux-repository-manual

修复/tmp安装错误

注意：你在安装过程中是否遇到了类似这样的错误？

“/tmp空间不足：找到944968KB，需要2097152KB。请增加tmpfs大小或释放空间后重试。”

如果是这样，本节将为你提供解决方案。

以下是如何在树莓派操作系统上修复Jellyfin的/tmp安装错误：

打开fstab文件：

sudo nano /etc/fstab

添加以下行以将/tmp文件夹增加到4GB：

tmpfs /tmp tmpfs defaults,noatime,mode=1777,size=4G 0 0

保存并退出（按CTRL+X）。

重启你的系统。

当系统再次启动时，你应该会看到临时目录变大了：

df -h

现在再次运行Jellyfin安装脚本。

错误应该已经消失，一切应该按预期工作。

Jellyfin的首次访问和初步设置

Jellyfin安装完成后将默认运行。

安装结束时，你应该会收到如何访问Web界面的说明。

要完成初步设置，请从与树莓派连接到同一网络的设备上打开以下URL：

http://<Raspberry Pi's IP Address>:8096

你可以查看相关教程以了解如何查找树莓派的当前IP地址。

https://raspberrytips.com/find-current-ip-raspberry-pi/

打开界面后，按照以下步骤完成初始配置：

在Jellyfin欢迎页面上，你可以点击“设置指南”按钮以获取有关设置过程的更多信息。

现在，我们将一起完成设置过程。点击“下一步”按钮将带你进入用户设置页面。在这里，你将设置一个新的用户配置文件，该配置文件将对媒体服务器拥有完全控制权。这相当于创建一个管理员用户。

我建议设置一个基本密码以增加安全性。填写完所有必填字段后，点击“下一步”。然后，它将提示你选择一个媒体库，这将是存储所有媒体文件的主要目录。

在为树莓派安装Jellyfin进行设置时，我们已经为外置存储设备设置了静态挂载路径。这将是我们的媒体库。只需点击“添加媒体库”按钮，并选择所需的内容类型和显示名称。

接下来，我们将配置此库以指向我们的Jellyfin目录。为此，请点击“文件夹”旁边的+按钮，然后从可用目录列表中选择“/mnt/jellyfin”目录，并点击“确定”。

保持“添加媒体库”的其他选项为默认值，并点击“确定”按钮。现在，你应该在库目录中看到新添加的库。点击“下一步”按钮继续设置过程。

Jellyfin会从各种在线资源库中维护我们本地库中所有媒体内容的元数据，以提供丰富的用户体验。因此，它会要求我们设置显示此元数据的首选语言。设置好并点击“下一步”。

接下来，我们将设置远程访问（从同一网络上的不同设备访问Web界面的能力）。默认情况下，允许远程连接（当然，因为我们正在远程设置Jellyfin！）。保持配置不变，并点击“下一步”。

这样就完成了初始设置！你现在可以使用Jellyfin畅享你喜爱的媒体内容了！

你现在应该能够通过相同的URL在登录后访问Jellyfin的Web界面。在下一节中，我们将介绍一些可能的配置，以充分利用我们的媒体服务器。

本节到此结束。在下一节中，我们将讨论一些额外的配置选项，以帮助你充分利用Jellyfin。

注意：如果添加到库文件夹中的新文件没有显示出来，你可以在主菜单中强制进行扫描（管理 > 仪表板）。

同时确保Jellyfin用户具有访问这些文件的权限。

Jellyfin高级配置选项

本节将讨论用户可用的额外配置选项，以充分利用他们的个人媒体服务器。我们将讨论三个主要配置：

启用硬件加速以获得最佳性能。

增强Jellyfin的安全性（启用HTTPS）。

了解Jellyfin中的用户管理。

现在，让我们详细讨论每个选项。

在Jellyfin中启用硬件加速

我们可以在Jellyfin中启用硬件加速，以便媒体服务器使用树莓派的GPU，从而提供更优质的观看体验。要启用此选项，需要进行一些额外的设置。我们将在本节中介绍整个过程。

第一步是告诉树莓派允许Jellyfin应用程序使用GPU。为此，我们需要将其添加到video用户组中。我们可以通过在树莓派的终端中执行以下命令来完成此操作：

sudo usermod -aG video jellyfin

接下来，我们需要为GPU分配更多内存，因为默认分配的76MB通常不足以应对视频解码等更繁重的工作负载。为此，我们需要对启动配置文件进行如下更改：

sudo nano /boot/firmware/config.txt

在文件末尾添加以下行并保存文件：

gpu_mem=320

要设置的内存量取决于你使用的树莓派型号。对于树莓派4，我保持为320MB，因为它具有更强大的GPU；而对于原始的树莓派3，我保持为160MB。

最后，为了使更改生效，重启你的树莓派。完成后，你可以使用以下命令验证分配的GPU内存：

vcgencmd get_mem gpu

现在，树莓派的GPU设置已完成，我们可以在Jellyfin中启用硬件加速了。为此，只需转到Web界面，点击屏幕左上角的菜单图标，然后从菜单中选择“仪表板”选项。

接下来，从左侧菜单中选择“播放”部分，在“转码”下，将“硬件加速”值设置为“Video4Linux2（V4L2）”，这是树莓派唯一支持的模式。

你已成功在Jellyfin中启用了硬件加速！

增强Jellyfin的安全性（启用HTTPS）

安全性对于媒体服务器来说尤为重要，特别是如果你计划通过互联网访问它。如果未加以保护，它可能会容易受到网络攻击。

幸运的是，Jellyfin提供了启用HTTPS流量的选项。为此，你将需要一个SSL证书，该证书将用于验证所有传入的远程连接。此过程有点复杂，需要一些基本的网络知识和bash命令知识。

Jellyfin有一个专用页面，将引导你完成整个过程。

https://jellyfin.org/docs/general/networking/letsencrypt/

它展示了如何通过Let's Encrypt创建SSL证书，然后你可以轻松地通过Jellyfin用户界面添加此证书以启用HTTPS。

Jellyfin中的用户管理

Jellyfin允许管理员为媒体服务器上的不同用户设置细粒度的访问权限。这为你提供了诸如限制孩子观看某些内容或为特定用户设置私人视频等功能。

Jellyfin文档中有一篇详细文章解释了Jellyfin中的用户管理是如何工作的。

https://jellyfin.org/docs/general/server/users/adding-managing-users

Jellyfin的Web界面中有一个专用的“用户”部分，可以轻松管理这些设置。

本教程到此结束。现在，你将能够：

在树莓派上安装和设置Jellyfin媒体服务器。

了解Jellyfin可用的高级配置选项。

知道如何解决使用Jellyfin时遇到的最常见问题。