如何在 Linux 上設定 Jellyfin 媒體伺服器

若要在 Linux 系統上設定Jellyfin 媒體伺服器，請安裝伺服器軟體包，開啟其 Web 安裝精靈，建立管理員帳戶，然後新增您的媒體資料夾。本指南使用 Jellyfin 目前經過校驗和驗證的 Debian、Ubuntu 及其受支援衍生發行版的安裝程式。其他 Linux 發行版應遵循 Jellyfin 的容器或社群軟體包指南。

在開始之前，請掛載您的媒體儲存裝置並記下其 Linux 路徑，例如 `/usr/local/bin` /srv/media/Movies。該軟體包以名為 `<service-account-name>` 的獨立服務帳戶執行 Jellyfin jellyfin，該帳戶需要存取父目錄和讀取檔案的權限。其他發行版或手動設定軟體倉庫，請參閱官方 Linux 安裝指南。

安裝並配置 Jellyfin

1. 下載並驗證安裝程序

在 Debian 或 Ubuntu 伺服器上，開啟終端機或透過 SSH 連線。安裝下載和校驗和工具，然後取得腳本及其校驗和檔案：

sudo apt update
sudo apt install curl coreutils
mkdir -p ~/jellyfin-setup && cd ~/jellyfin-setup
curl -fsSLO https://repo.jellyfin.org/install-debuntu.sh
curl -fsSLO https://repo.jellyfin.org/install-debuntu.sh.sha256sum
sha256sum -c install-debuntu.sh.sha256sum

僅當結果為真時才繼續install-debuntu.sh: OK。由於安裝程式以管理員權限執行，您可以先使用以下命令檢查它less install-debuntu.sh。 Jellyfin 的指南列出了支援的衍生版本和手動安裝選項。

2. 執行安裝程式並檢查服務

執行已驗證的腳本，然後確認 Jellyfin 已啟動：

sudo bash install-debuntu.sh
sudo systemctl status jellyfin

如果它已停止，請在啟動時啟用它並使用sudo systemctl enable --now jellyfin.

3. 開啟安裝精靈

從同一網路上的裝置存取 ` http://<server-ip>:8096<server_name>`，將佔位符替換為 Linux 伺服器的 LAN 位址。http://localhost:8096在伺服器本身上使用 `<server_name>` 指令。 `<port>`8096/TCP是預設的 HTTP 連接埠。如果頁面無法載入，請檢查服務並允許受信任的 LAN 裝置透過防火牆存取該連接埠。

4. 選擇語言並建立管理員

選擇設定介面語言，然後輸入管理員使用者名稱和強密碼（密碼必須唯一）。此帳戶控制伺服器設定和使用者；如有需要，可在精靈完成後新增其他帳戶。

5. 新增媒體庫

選擇「新增媒體庫」，選擇類型（例如「電影」、「劇集」或「音樂」），輸入顯示名稱，並新增完整的資料夾路徑。不同的媒體庫有助於 Jellyfin 識別內容。例如，可以使用類似這樣的資料夾/srv/media/Movies/Arrival (2016)/Arrival (2016).mkv。請參閱媒體庫指南和電影命名指南。

如果資料夾遺失或掃描結果為空，請以服務帳戶身分測試存取權限sudo -u jellyfin ls /srv/media/Movies：僅授予其透過媒體群組或限定範圍的 ACL 的讀取和目錄遍歷權限。避免進行廣泛的遞歸操作chmod 777或更改整個磁碟的所有權。官方常見問題也指出，權限和檔案組織是導致媒體遺失的常見原因。

6. 設定元資料語言和區域

選擇 Jellyfin 用於標題、描述和其他已獲取元資料的首選語言和地區。這與設定介面語言是分開的，以後可以針對每個圖書館單獨更改。結果取決於服務提供者的可用性和網路連線。

7. 檢查遠端存取設定

對於僅限本地存取的伺服器，請關閉遠端存取。如果您打算在家外觀看，請啟用「允許遠端存取此伺服器」並單獨設定安全連接，例如 VPN 或 HTTPS 反向代理。嚮導設定不提供加密功能，也無法完成路由器設定。除非您特別需要 UPnP，否則請關閉「啟用自動連接埠對映」；Jellyfin 建議除非必要，否則停用此功能。

請勿將純 HTTP 連接埠8096直接轉送至公共網際網路。 Jellyfin 的預設 HTTPS 連接埠為 12344，8920/TCP在設定 HTTPS 之前未使用。啟用外部存取前，請遵循官方網路指南。

8. 完成並測試播放

完成精靈，登錄，然後讓 Jellyfin 掃描所選資料夾。如果 Jellyfin 無法找到伺服器，請從區域網路內的另一台裝置進行測試，並手動輸入伺服器位址和連接埠。相容的應用程式清單請參閱官方客戶端頁面。

修復常見的安裝問題

• 網頁無法存取：請檢查sudo systemctl status jellyfin伺服器 IP、連接埠8096和區域網路防火牆規則。最新日誌：sudo journalctl -u jellyfin -n 50 --no-pager。
• 空庫：請確認儲存已掛載且jellyfin帳戶可以讀取該資料夾。請使用正確的庫類型和支援的命名方式。
• 用戶端無法發現伺服器：請手動輸入區域網路位址:8096。本地發現使用UDP協議7359，但直接輸入位址並不依賴發現過程。

本機播放功能正常後，可以將新增使用者或設定遠端存取作為單獨的網路任務。