如何在Debian上配置Jellyfin

在Debian上配置Jellyfin媒体服务器的完整步骤

一、前置准备

确保Debian系统已更新至最新版本，并安装基础依赖包：

sudo apt update && sudo apt upgrade -y
sudo apt install apt-transport-https ca-certificates curl gnupg2 software-properties-common -y

二、添加Jellyfin官方存储库

1. 导入GPG密钥（验证软件包完整性）：

   curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/jellyfin_team-archive-keyring.gpg
   

2. 添加存储库（根据Debian版本调整$(lsb_release -cs)，如Debian 11为bullseye、12为bookworm）：

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

3. 更新包列表：

   sudo apt update
   

三、安装Jellyfin

通过APT安装Jellyfin（自动解决依赖关系）：

sudo apt install jellyfin -y

四、启动Jellyfin服务

1. 启动服务并设置开机自启：

   sudo systemctl enable jellyfin  # 开机自动启动
   sudo systemctl start jellyfin   # 立即启动服务
   

2. 检查服务状态（确认运行正常）：

   sudo systemctl status jellyfin
   

   若输出中包含active (running)，则表示服务已成功启动。

五、访问Web界面完成初始配置

1. 打开浏览器，输入http://<服务器IP>:8096（如http://192.168.1.100:8096），进入Jellyfin欢迎页面。
2. 跟随向导配置：
   • 选择语言：根据偏好选择界面语言（如中文）。
   • 创建管理员账户：设置用户名、密码（用于登录管理后台）。
   • 添加媒体库：
     点击“添加媒体库”，选择媒体类型（电影、电视节目、音乐等），输入显示名称（如“家庭电影”），点击“+”号选择媒体文件存储路径（如/home/user/Movies），完成添加。
   • 设置远程访问：确保“允许远程连接”已开启，并启用“自动端口映射”（若服务器在路由器后，需在路由器中转发8096端口至服务器IP）。
3. 完成配置：点击“完成”，进入Jellyfin仪表板，即可查看和管理媒体库。

六、可选：高级配置

1. 修改默认端口（如将8096改为8080）：
   编辑Jellyfin配置文件：

   sudo nano /etc/jellyfin/system.xml
   

   找到<Port>8096</Port>，修改为<Port>8080</Port>，保存后重启服务：

   sudo systemctl restart jellyfin
   

   访问时需使用新端口（如http://<服务器IP>:8080）。

2. 启用硬件加速（提升转码性能，需显卡支持）：
   编辑转码配置文件：

   sudo nano /etc/jellyfin/transcoding.xml
   

   在<Transcoding>标签内添加硬件加速参数（以Intel核显为例）：

   <VideoCodec>h264_vaapi</VideoCodec>
   <AudioCodec>aac</AudioCodec>
   <ExtraArgs>["-vaapi_device", "/dev/dri/renderD128", "-vf", "format=nv12,hwupload"]</ExtraArgs>
   

   保存后重启服务生效。

3. 添加共享文件夹（如NFS/Samba挂载的媒体目录）：
   确保共享文件夹已挂载至服务器（如/mnt/nfs_movies），然后在Web界面“媒体库”中点击“添加媒体库”，选择对应路径即可。

常见问题排查

• 无法访问Web界面：检查服务器防火墙是否放行8096端口（sudo ufw allow 8096/tcp），或路由器是否转发端口。
• 媒体库未扫描：在Web界面“媒体库”中点击“扫描”，强制刷新媒体文件列表。
• 依赖错误：若安装时提示依赖缺失，运行sudo apt -f install自动修复。

通过以上步骤，即可在Debian系统上完成Jellyfin的配置与使用，搭建个人媒体服务器。