Jellyfin 是採用 GPL-2.0 授權的開源媒體系統，於 2018 年 12 月建立儲存庫，GitHub 累積 57,843 顆星、5,594 次複製與 377 位關注者。該專案在 2026 年 9 月 8 日推出 12.0 穩定版，隨後於 9 月 15 日發布 12.1、10 月 5 日發布 12.2，是自 10.11 系列以來規模最大的一次結構調整。本次改版並未以新增功能為訴求，而是集中處理資料模型、播放清單關聯化與舊客戶端相容性，並明言升級後無法在不還原完整備份的情況下回復舊版。
Jellyfin 是 GPL-2.0 授權的開源媒體伺服器，源自 Emby 3.5.2 並以 .NET 實作，提供無付費牆的媒體管理與串流服務，GitHub 星標逾 5.7 萬。
該專案的定位在官方說明中相當明確：它是 Emby 與 Plex 之外的自由軟體選項，由專用伺服器向各式終端應用程式提供媒體，並強調沒有加值授權、沒有隱藏條款。這條路線決定了它的技術選擇，也解釋了為何大版本改動往往集中在資料層而非介面層。
Jellyfin 的架構與生態系統如何運作？
Jellyfin 採伺服器與客戶端分離架構，伺服器負責媒體掃描、資料庫與轉碼，客戶端涵蓋網頁、行動與電視平台，並以官方外掛儲存庫擴充功能。
儲存庫本身僅包含伺服器後端，前端介面、各平台應用程式與品牌資源分屬組織下的其他專案。伺服器以 C# 與 .NET 撰寫，負責函式庫掃描、中繼資料擷取、轉碼排程與 API 提供，客戶端則透過同一組介面取用內容。這種分工讓同一套後端能同時支援網頁、行動裝置與電視盒。
擴充機制以外掛為核心。官方提供穩定版外掛儲存庫，開發者可透過相同介面擴充中繼資料來源、直播電視節目表與搜尋行為。12.0 進一步把搜尋提供者設計為可替換元件，允許外掛改寫搜尋結果的產生方式，讓生態系統的介入層級從資料補充延伸到行為層。伺服器的部署形態以容器為主，Docker 映像下載量已達 4.29 億次，另有 Debian、Ubuntu 與 Windows 等原生套件。
Jellyfin 12.0 有哪些重大變更？
12.0 移除 /emby 與 /mediabrowser 舊路由、關閉舊式驗證、廢除 EasyPassword，改用每個函式庫設定字幕，屬破壞性變更，舊客戶端恐無法連線。
版本說明明確列出多項行為變更。沿襲自 Emby 時代的 /emby/* 與 /mediabrowser/* 路由前綴已完全移除，依賴這些路徑的第三方客戶端將停止運作；舊式驗證預設關閉，且既有安裝也會透過遷移一併停用；POST /Users/{userId}/EasyPassword 與 GET /Items/{itemId}/CriticReviews 等過時介面同步刪除。
設定層面亦有調整。全域字幕設定被移除，改為每個函式庫各自配置；.ogg 不再被視為影片格式而歸類為音訊，.aifc 改列音訊、.aiff 不再視為圖片；符號連結僅在播放時解析。使用者名稱的大小寫現在可以更改，但帳號改以正規化欄位儲存並加上唯一索引，若既有安裝存在僅大小寫不同的名稱，必須在升級前先行修正。
Jellyfin 12.0 的資料庫與效能有什麼改進？
播放清單與收藏改用 LinkedChildren 關聯表，OwnerId 與 PrimaryVersionId 成為 GUID 外鍵，並加入多項調校遷移，使續播與查詢加快。
資料層是本次改版的核心。舊版把播放清單與收藏的子項目序列化後儲存，12.0 改為關聯式的 LinkedChildren 資料表，OwnerId 與 PrimaryVersionId 成為真正的外鍵，ExtraIds 欄位則被移除。這項調整讓收藏與清單的查詢擺脫序列化解析，同時簡化了資料一致性維護。
配套的還有大量調校遷移，涵蓋項目計數、名稱、型別與清理名稱、最新項目、圖片資訊與主要版本編號等欄位。首次啟動時會執行清理程序：合併重複的音樂演出者與人物、移除孤立的額外項目與外部資料、修復錯誤的擁有者關聯，並重算排序用的清理名稱。額外的效能改善包括：資料庫重負載任務不再與函式庫掃描同時執行、項目刪除改為批次處理以避開 SQL 變數上限、jellyfin.db 可存放於自訂路徑。
Jellyfin 在維運與部署上有哪些新能力？
新增 --mode 啟動參數，可選 MediaServer、MigrateSystem 或 SeedSystem，讓資料庫遷移能在不啟動伺服器時執行，適合容器化部署。
對自架使用者而言，這次最實用的改動是啟動模式。新的 --mode 參數允許只執行遷移或資料庫種入而不啟動完整服務，讓升級流程可以拆成獨立步驟，對 Kubernetes 之類的編排環境特別有利，也讓大型函式庫的遷移能在受控時段進行。
其他維運面的調整包括：啟動介面重新設計並顯示版本與活動資訊、已停用的外掛不再於重啟後被自動啟用、完整系統備份遇到損壞的關鍵影格資料列時改為略過而非整份失敗。直播電視方面，伺服器不再回傳客戶端無法連線的本地串流網址，XMLTV 節目表匯入改用由實際取用欄位計算的 ETag，重複更新時明顯降低成本。
Jellyfin 的社群規模與採用情況如何？
儲存庫累積 57,843 顆星、5,594 次複製、377 位關注者與約 370 位貢獻者，提交次數逾三萬次，發布 117 個版本，Docker 映像下載量達 4.29 億次。
- 57,843GitHub 星標
- 5,594複製次數
- 377關注人數
- 30,123提交次數
- 117發布版本
- C#主要語言
數據顯示專案星標 57,843、複製 5,594 次、關注 377 人、提交逾三萬次、發布 117 個版本，貢獻者約 370 位，另有 706 個未結議題。
提交量與版本的堆疊反映長期維護的節奏。逾三萬次提交分布在約 370 位貢獻者之間，平均每人貢獻超過八十次，顯示核心維護群相對穩定；117 個版本對應自 2018 年底以來的開發歷程，也說明專案維持規律的發布週期。706 個未結議題則屬於大型自架專案的常態，多數集中在特定硬體轉碼與中繼資料來源的相容性問題。
使用規模可由容器資料側面觀察。Docker 映像累積 4.29 億次下載，Docker Hub 上的專案頁面另有 1,596 顆星標。這個數字包含自動化部署與 CI 環境的重複拉取，不宜直接等同使用者數，但足以說明它在自架社群中的普及程度。專案採用 GPL-2.0 授權，允許商業使用與修改，衍生作品需以相同條款釋出。
Jellyfin 12.2 修復了哪些問題？
12.2 包含 51 項修正，涵蓋以 hvc1 標記 Dolby Vision Profile 8、升級 ATL 解決 FLAC 播放卡住、修正 Windows 上 EPUB 中繼資料不載入。
作為 12.x 系列的最新穩定版，12.2 於 2026 年 10 月 5 日發布，內容以修補為主。轉碼與播放層面，Dolby Vision Profile 8 改用 hvc1 標記，升級 ATL 至 7.18.0 以解決格式異常的 FLAC 檔案造成播放卡住的問題，並修正降低位元深度時低位元率畫質劣化的情況。
資料與中繼資料層面則處理多項邊界情況：修正 Windows 上 EPUB 中繼資料與封面無法載入、防止片段清理器在重封裝 MKV 時誤刪播放位置之後的片段、讓評分只在子項目確實跟隨時才傳遞、以及避免幾乎未開始播放的集數被推進到下一集。這些修正雖屬細節，但多數直接影響日常播放體驗。
Jellyfin 使用上有哪些限制與注意事項？
12.0 升級涉及不可回滾的資料庫變更，必須先完整備份；非內建外掛應先移除，升級後須執行一次完整函式庫掃描，否則替代版本等資料可能遺失。
升級風險需要事前評估。官方說明指出，從 10.10.7 或 10.11.x 可直接升級至 12.0，不需經由中間版本，但更舊的版本應先升級至 10.10.7。由於本次包含無法回復的資料庫變更，官方強烈建議在升級前完整備份資料目錄，否則一旦需要回復只能依賴備份。
外掛相容性是另一個關鍵。任何非內建的外掛都應在遷移前移除，待其適配新的資料庫結構後再重新加入，並確認外掛儲存庫網址指向穩定版清單。此外，升級後必須執行一次完整函式庫掃描，以還原因資料型別問題而被移除的自動解析替代版本；首次掃描的耗時會明顯長於平時，部分影片也可能暫時顯示為新加入。
如何開始使用 Jellyfin？
使用者可由官方下載頁取得容器映像或原生套件，安裝後開啟網頁介面完成精靈設定、指定媒體資料夾，再依需求安裝外掛與終端應用程式。
入門流程分為三部分：部署伺服器、設定函式庫、安裝客戶端。伺服器可透過 Docker 映像或發行版套件安裝，啟動後以瀏覽器連線至網頁介面，依設定精靈建立管理員帳號並指定媒體資料夾。函式庫建立後，伺服器會掃描檔案並自動擷取中繼資料。
客戶端涵蓋行動裝置、電視與桌面平台，另有社群維護的第三方應用。若需要硬體轉碼，應在系統層確認顯示卡驅動與對應的轉碼後端，並在伺服器設定中啟用。對於希望降低升級風險的使用者，建議先在測試環境驗證 12.0 的掃描與外掛相容性，再套用至正式環境。
出處連結有哪些？
本文數據取自 Jellyfin 的 GitHub 儲存庫與官方發布說明，統計數字為 2026 年 10 月上旬查詢結果，功能變更依 12.0 版本說明整理。
完整的版本說明與安裝文件，可於下列來源查閱：
常見問題有哪些？
以下整理五個常見疑問，涵蓋授權、升級風險、外掛相容、社群規模與硬體轉碼，答案依官方版本說明與文件整理而成。
Jellyfin 需要付費嗎？
不需要。專案採 GPL-2.0 授權，所有功能皆可使用，沒有加值授權或付費解鎖項目；營運經費來自社群募資與捐贈。
Jellyfin 12.0 可以降回舊版嗎？
不行。12.0 包含無法直接回復的資料庫變更，若需回到舊版只能還原升級前的完整備份，官方因此建議升級前務必備份資料目錄。
升級後影片或替代版本消失了怎麼辦？
執行一次完整函式庫掃描即可。12.0 因資料型別調整會移除先前自動解析的替代版本，掃描後會重新建立，首次掃描耗時會明顯較長。
Jellyfin 與 Plex、Emby 有什麼差別？
Jellyfin 為完全開源且無付費層級的自由軟體方案，功能不設訂閱限制；Plex 與 Emby 則採專有授權並提供付費方案。Jellyfin 起源於 Emby 3.5.2 的開源分支。
Jellyfin 支援硬體加速轉碼嗎？
支援。伺服器可透過對應的轉碼後端使用 Intel、AMD 與 NVIDIA 硬體加速，實際可用性取決於作業系統、驅動與顯示卡型號，需在設定中啟用。
總結：Jellyfin 12.0 適合什麼樣的團隊？
Jellyfin 適合希望自控媒體資料、不接受付費牆與授權限制的自架使用者與小型團隊；若偏好開箱即用且願意付費，商業方案在客服與客戶端體驗上仍有優勢。
12.0 的意義在於它選擇以資料模型重構作為大版本的內容。播放清單關聯化、舊路由與舊驗證退場、遷移流程獨立化，這些改動都不會在功能列表上產生話題，卻決定了專案未來的維護成本與擴充彈性。對長期自架的社群而言，這是把技術債一次清償的版本。
選擇上仍取決於需求。願意投入時間維護伺服器、在意資料主權與授權條款的團隊，能在 Jellyfin 找到完整且無限制的方案；重視即時客服、行動端體驗與既有內容生態的使用者，商業平台仍有其價值。無論選擇哪一方，升級前完成備份與外掛盤點，都是自架環境不變的基本原則。