Linux系统如何运行Jellyfin - 问答

一、准备工作
在Linux系统上运行Jellyfin前，需确认以下要求：

系统要求：至少2GB内存（推荐4GB及以上），支持x86_64或ARM架构；
依赖要求：安装.NET Core运行时（Linux/macOS需手动安装，Windows系统自带）；
权限要求：确保媒体文件目录对Jellyfin进程可读（默认用户为jellyfin）。

二、主流安装方式

1. 原生包管理器安装（推荐新手）

以Ubuntu/Debian为例，步骤如下：

添加官方仓库：

sudo apt update
sudo apt install apt-transport-https ca-certificates curl gnupg software-properties-common
mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg
echo "deb [signed-by=/etc/apt/keyrings/jellyfin.gpg] https://repo.jellyfin.org/debian $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list

安装Jellyfin：

sudo apt update
sudo apt install jellyfin -y

启动服务：

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

其他发行版（如CentOS、Fedora、Arch Linux）可参考官方文档调整仓库地址和包名。

2. Docker容器部署（推荐开发者/自托管）

使用Docker可快速部署且隔离环境，步骤如下：

安装Docker：

sudo apt update
sudo apt install docker.io -y
sudo systemctl start docker
sudo systemctl enable docker

拉取镜像并运行：

docker pull jellyfin/jellyfin:latest
docker run -d \
  --name jellyfin \
  -p 8096:8096 \          # Web界面端口
  -p 8920:8920 \          # 可选：Live TV端口
  -v /path/to/media:/media \  # 挂载媒体目录（替换为实际路径）
  -v /path/to/config:/config \  # 挂载配置目录（用于备份）
  -v /path/to/cache:/cache \    # 挂载缓存目录
  --device /dev/dri:/dev/dri \  # 可选：Intel GPU转码支持（需宿主机开启）
  jellyfin/jellyfin

验证运行：

docker ps  # 查看容器状态（若显示"Up"则表示运行中）

Docker Compose可简化多容器管理，推荐使用官方Compose文件。

三、核心配置步骤

1. 访问Web界面

安装完成后，在浏览器输入http://<服务器IP>:8096（如http://192.168.1.100:8096），跟随向导完成初始配置：

创建管理员账户：设置用户名、密码（建议使用强密码）；
选择语言与时区：根据使用习惯调整；
添加媒体库：点击"Libraries"→"Add Library"，选择媒体类型（视频/音频/图片），指定媒体目录路径（如/media/movies）。

2. 关键配置优化

文件权限设置：
若媒体文件无法扫描，需修改目录权限（以/data/media为例）：

sudo chown -R jellyfin:jellyfin /data/media  # 直接授权（简单）
# 或创建媒体用户组（推荐）
sudo groupadd media
sudo usermod -aG media jellyfin
sudo usermod -aG media your_username  # 替换为上传文件的用户
sudo chmod -R 775 /data/media

刷新媒体库：添加新文件后，需手动刷新（Web界面→对应媒体库→右上角"Scan Library"）。

3. 硬件加速（提升转码性能）

Jellyfin支持Intel QuickSync、NVIDIA NVENC、AMD VAAPI等硬件加速，以Docker为例：

NVIDIA加速：需安装NVIDIA Container Toolkit，运行容器时添加--runtime=nvidia参数；
Intel核显加速：挂载/dev/dri设备，Web界面→"Admin"→"Playback"→"Hardware Acceleration"→选择"VAAPI"，并设置对应解码器（如H.264、HEVC）。

四、常见问题解决

无法访问Web界面：检查防火墙是否允许8096端口（sudo ufw allow 8096），或确认Jellyfin服务是否运行（sudo systemctl status jellyfin）；
媒体库扫描失败：确认媒体目录权限正确，或尝试重启Jellyfin服务（sudo systemctl restart jellyfin）；
Docker容器无法启动：检查挂载路径是否存在，或查看容器日志（docker logs jellyfin）定位错误。

0 赞

0 踩