Jellyfin：用Docker自架可調畫質 + 硬體解碼的影片音樂串流伺服器

想要打造多人共享的家庭影院，就使用Jellyfin來播放影片和音樂吧。

Jellyfin是一款自由開源的影音串流伺服器軟體，源自專有軟體「Emby」，設定上十分簡單直觀。

有了JellyFin，就能透過手機和電視盒無線播放電腦上的影片，出門在外也能連回家中播放影片，還能順便聽音樂。

本文Ivon將介紹如何使用Linux系統Docker架設JellyFin伺服器，並說明觀看方法。

1. Jellyfin特色功能
#

串流播放電腦的影片和音樂，不論是用網頁、手機APP、電視盒都行。支援多重帳號登入，多人畫面同步分享影片。
能以硬碟資料夾模式瀏覽媒體檔案
自動抓取影劇的封面和演員資訊，產生影片縮圖，允許手動編輯中繼資料。
播放影片就像看Youtube，自動依照網速調整畫質讓播放更順暢，支援投放到Chromecast、AirPlay。
還能充當雲端音樂播放器。

Jellyfin另提供多種插件，例如搭配BT下載管理器Sonarr、影音串流的Kodi、觀看統計JellyStats使用。

2. 用Docker架設Jellyfin
#

根據Jellyfin官方文件，推薦硬體規格為：Intel N100以上等級CPU、4GB以上RAM、100GB以上SSD。系統架構以x86為佳，Jellyfin對ARM架構的支援程度不一。

由於Jellyfin很吃影片轉檔效能，故CPU不能太差，若有GPU加速更好。

Ivon的系統規格：

系統：Ubuntu LTS
CPU：Intel i5-7400
GPU：Nvidia GTX1050Ti
RAM：8GB

在Linux電腦安裝Docker
欲啟用GPU硬體加速解碼，需要安裝顯示卡驅動與調整設定，這個後面再講，這邊先以CPU解碼為主。
參考Jellyfin官方文件，建立docker-compose.yml

mkdir ~/jellyfin

cd jellyfin

vim docker-compose.yml

填入以下內容，注意我寫的註解部份

version: '3'
services:
  jellyfin:
    # 拉取最新版Jellyfin映像檔，撰文當下版本是10.8.10
    image: jellyfin/jellyfin
    container_name: jellyfin
    # 以root使用者執行服務
    user: root:root
    network_mode: 'host'
    volumes:
    # 將設定檔和縮圖的存放至目前的目錄
      - "./config:/config"
      - "./cache:/cache"
    # 參考下面格式，將硬碟的目錄(冒號左邊)依序掛載至Jellyfin容器內部的目錄，以此類推
      - "/home/user/Movies:/Movies:ro"
      - "/home/user/Music:/Music:ro"
      - "/home/user/Comics:/Comics:ro"
    # 開機自動啟動容器
    restart: 'unless-stopped'
    environment:
    # 除非您有自己的域名，否則不需改這行
      - JELLYFIN_PublishedServerUrl=http://example.com
    extra_hosts:
      - "host.docker.internal:host-gateway"

啟動容器。此容器會在每次開機後自動啟動。

docker compose up -d

用瀏覽器開啟網址http://localhost:8096或者http://Linux電腦區域IP:8096，按照設定精靈的提示繼續。
設定帳號密碼，預設使用root
點選新增媒體庫，從/media目錄選擇掛載的影片目錄
設定要自動抓取的中繼資料，中繼資料就是影片的說明、演員、發行年份的資訊，可維持預設，之後能手動編輯。

Ivon建議：如果您的影片目錄不含電影、影集、動畫的影片，建議將媒體庫內容類別改為「Mixed Movies and Shows」或者「音樂錄影帶」，將影片以純資料夾模式處理。取消勾選所有「下載中繼資料」和「圖片獲取程序」選項，僅保留「Embedded Image Extractor」和「Screen Grabber」產生縮圖。不然Jellyfin會把每個子目錄當成「一季」影集處理，且會下載到奇怪的封面，影片檔名可能還會顯示錯誤。

設定中繼資料語言為正體中文。不過抓取到的資料Ivon自己感覺還是很大程度會含有簡體字。

3. Jellyfin使用技巧
#

3.1. 啟用GPU硬體解碼
#

影片串流的時候，你可以選擇「Driect Play」直接串流原始畫質檔案（需要瀏覽器硬體支援，像iOS Safari就不行）。

或者選擇特定畫質，讓Jellyfin在串流影片的時候進行即時轉碼，讓串流比較順暢。

為方便處理影片，Jellyfin官方開發了特製版的jellyfin-ffmpeg套件，此一套件已含在Jellyfin的官方Docker映像檔，無需另外安裝。

Jellyfin預設使用CPU解碼影片，若啟用GPU硬體解碼(Hardware Acceleration)可讓影片串流處理速度更快。Jellyfin支援Intel/AMD/Nvidia的加速技術，官方文件有詳細說明。

Nvidia GPU啟用NVENC硬體解碼 (點選展開)

首先要先安裝Nvidia驅動和Nvidia Container Toolkit
將使用者加入video群組

sudo usermod -aG video root
sudo usermod -aG video $USER

編輯docker-compose.yml，在最下面加入runtime

    runtime: nvidia
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]

更新Jellyfin容器的動態連結，重啟Docker服務

sudo docker exec -it jellyfin ldconfig

sudo systemctl restart docker

檢查容器是否能存取Nvidia顯示卡，應能印出顯示卡驅動資訊

sudo docker exec -it jellyfin nvidia-smi

進入Jellyfin首頁，點選左邊選單→ 「設定」→「控制台」 →「播放」，選擇使用Nvidia NVENC硬體加速，再往下捲動按儲存。

Intel CPU啟用QSV或VA-API硬體解碼 (點選展開)

只要Intel CPU有內顯，幾乎所有Intel GPU都支援VA-API硬體解碼。QSV則是要Haswell架構以後才支援。

儘管開發者說Intel解碼驅動和OpenCL執行時已含在Jellyfin的映像檔，不需要額外安裝驅動，但若驅動找不到，請還是參考官方文件了解要安裝哪些驅動套件。可能還得設定LIBVA_DRIVER_NAME的環境變數。

安裝OpenCL執行時套件

sudo apt install intel-opencl-icd

將使用者加入render群組

sudo usermod -aG render root
sudo usermod -aG render $USER

取得render群組的ID，每台電腦數字不一樣

sudo getent group render | cut -d: -f3

修改docker-compose，在最下面加入devices：

    devices:
      - /dev/dri/renderD128:/dev/dri/renderD128

重新啟動容器

sudo docker compose down

sudo docker compose up -d

檢查Jellyfin容器能否印出Intel解碼器版本

sudo docker exec -it jellyfin /usr/lib/jellyfin-ffmpeg/vainfo

檢查Jellyfin容器能否印出OpenCL執行時

sudo docker exec -it jellyfin /usr/lib/jellyfin-ffmpeg/ffmpeg -v verbose -init_hw_device vaapi=va -init_hw_device opencl@va

重新啟動容器

sudo docker compose down

sudo docker compose up -d

至Jellyfin首頁，點選左邊選單 → 「設定」→「控制台 →「播放」，選擇使用Intel QSV硬體加速，往下捲動按儲存。

要確認影片解碼有無運作，隨便開一部影片，然後用nvtop這類工具查看GPU使用率就知道了。

3.2. 啟用資料夾檢視
#

在「控制台」的媒體庫頁面，開啟在首頁左側選單顯示「資料夾」模式的功能。這樣就能按照電腦硬碟目錄架構去找檔案。

3.3. 自訂佈景主題
#

進入Jellyfin首頁，點選左邊選單開啟「設定」 → 「顯示」，變更佈景主題，滑掉最下面按下儲存。

您也可以自行下載CSS調整Jellyfin的外觀。

3.4. 新增其他Jellyfin使用者
#

進入Jellyfin首頁，點選左邊選單開啟「控制台」，在「使用者」頁面新增使用者。

在這裡能自由決定要開放哪些媒體庫給該位使用者觀看。

之後會有更詳細的權限控管，例如只能看特定媒體庫，禁止調整伺服器設定，啟用家長監護功能等。如果電腦撐不住同時太多人觀看，請調低「網際網路串流傳輸位元率限制」。

3.5. 多人同步觀看同一部影片
#

Jellyfin提供「SyncPlay」技術，讓不同使用者能同步觀看同一支影片。

第一個使用者在Jellyfin右上角點選「建立群組」
第二個使用者便可加入群組。

當第一個使用者播放影片的時候，第二個使用者的畫面也會跟著播放影片。點選右上角離開群組，退出同步播放。

4. 在手機和電視觀看Jellyfin媒體庫
#

如果您覺得網頁版效能不好，可以安裝官方Jellyfin客戶端，支援電腦與手機。

首先讓手機和電腦處於同一Wifi網路下。如果是不同網段可看下一節「外部網路存取」的作法。
Linux電腦輸入ip addr查看區域IP，通常是192.168開頭

enp2s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
    inet 192.168.1.103/24 brd 192.168.1.255 scope global dynamic noprefixroute enp2s0

下載Jellyfin官方客戶端。不過官方版Jellyfin似乎只是瀏覽器套殼而已，Ivon實際用下來效能不是很好，Ivon推薦找原生的版本，例如Android推薦Findroid；iOS則是Swiftfin。
開啟後輸入http://電腦區域IP:8096，登入帳號
停用電池優化就能鎖定螢幕後繼續播放。