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”）。