ubuntu上jellyfin怎么配置

一、准备工作 在Ubuntu上配置Jellyfin前，需完成系统更新及必要依赖安装，确保后续步骤顺利执行：

sudo apt update && sudo apt upgrade -y  # 更新系统包
sudo apt install apt-transport-https ca-certificates gnupg curl -y  # 安装依赖工具

二、添加Jellyfin官方仓库 为避免第三方源的安全风险，建议通过Jellyfin官方APT仓库安装：

1. 创建密钥环目录并导入GPG密钥（用于验证软件包完整性）：

   mkdir -p /etc/apt/keyrings
   curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg
   

2. 添加Jellyfin仓库（根据Ubuntu版本调整）：

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

三、安装Jellyfin 通过APT包管理器安装Jellyfin（自动解决依赖关系）：

sudo apt update  # 刷新包列表
sudo apt install jellyfin -y  # 安装Jellyfin

四、启动与管理Jellyfin服务 确保Jellyfin服务正常运行并设置开机自启：

sudo systemctl start jellyfin  # 启动服务
sudo systemctl enable jellyfin  # 开机自启
sudo systemctl status jellyfin  # 检查服务状态（显示"active (running)"即为正常）

五、访问与基础配置

1. 访问Web界面：在浏览器中输入http://<服务器IP>:8096（如http://192.168.1.100:8096），首次访问需创建管理员账户（设置用户名、密码及邮箱）。
2. 添加媒体库：登录后点击左侧导航栏“Libraries”→“+”→选择媒体类型（视频/音频/图片）→指定媒体文件所在目录（如/home/user/Movies）→点击“Scan Library”自动扫描并添加媒体。

六、高级配置（可选）

1. 配置远程访问：
   • 允许端口通过防火墙（若启用UFW）：

     sudo ufw allow 8096/tcp  # 允许Jellyfin默认端口
     sudo ufw enable  # 启用防火墙
     

   • 设置端口转发（非局域网环境）：在路由器后台将外部端口（如8096）转发至服务器内部IP的8096端口。
2. 设置SSL证书（启用HTTPS）：
   • 安装Certbot及Apache模块：

     sudo apt install certbot python3-certbot-apache -y
     sudo a2enmod proxy proxy_http ssl proxy_wstunnel remoteip http2 headers  # 启用必要模块
     sudo systemctl restart apache2
     

   • 获取SSL证书（替换your_domain.com为你的域名）：

     sudo certbot certonly --agree-tos --email your_email@example.com --no-eff-email --webroot -w /var/www/html -d your_domain.com
     

   • 配置Apache反向代理（编辑虚拟主机文件）：

     sudo nano /etc/apache2/sites-available/jellyfin.conf
     

     添加以下内容（替换域名及证书路径）：

     <VirtualHost *:80>
         ServerName your_domain.com
         Redirect permanent / https://your_domain.com/
     </VirtualHost>
     <VirtualHost *:443>
         ServerName your_domain.com
         DocumentRoot /var/www/html/jellyfin/public_html
         ProxyPreserveHost On
         ProxyPass "/.well-known/" "!"
         ProxyPass "/" "http://localhost:8096/"
         ProxyPassReverse "/" "http://localhost:8096/"
         RequestHeader set X-Forwarded-Proto "https"
         RequestHeader set X-Forwarded-Port "443"
     </VirtualHost>
     

     保存后重启Apache：

     sudo systemctl restart apache2
     

3. 启用硬件加速（提升播放性能，以NVIDIA显卡为例）：
   • 安装NVIDIA驱动及Container Toolkit：

     sudo ubuntu-drivers autoinstall  # 自动安装适合的NVIDIA驱动
     sudo systemctl reboot  # 重启服务器
     distribution=$(. /etc/os-release;echo $ID$VERSION_ID) && curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg && curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sed 's#deb http#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] http#' | sudo tee /etc/apt/sources.list.d/nvidia-docker.list && sudo apt update && sudo apt install -y nvidia-container-toolkit && sudo systemctl restart docker
     

   • 重启Jellyfin容器（若使用Docker安装）：

     sudo docker restart jellyfin
     

七、常见问题排查

• 无法访问Web界面：检查防火墙是否允许8096端口、Jellyfin服务是否运行（sudo systemctl status jellyfin）。
• 媒体库未扫描：确认媒体目录权限（Jellyfin用户需有读取权限）、网络连接是否正常。
• 硬件加速无效：确认显卡驱动是否正确安装、Jellyfin配置中是否启用了硬件加速（Web界面→“Playback”→“Hardware Acceleration”）。