產品說明

Komga 是一款專為漫畫（Comics）、日漫（Manga）、圖畫小說（Graphic Novels）與電子書設計的媒體伺服器。如果您熟悉 Plex 或 Emby 這些影片管理工具，那麼 Komga 就是「漫畫界的 Plex」。

許多動漫愛好者硬碟中存有大量的 .cbz, .cbr, .epub 或 .pdf 檔案，Komga 能自動掃描這些檔案，抓取內嵌的詮釋資料（Metadata），並將它們整理成精美的虛擬書櫃。它內建了響應速度極快的 Web 閱讀器，支援適合日漫的「由右至左」閱讀模式。

最重要的是，Komga 支援 OPDS (Open Publication Distribution System) 協定。這意味著您不僅可以用瀏覽器看漫畫，還能將您的私人漫畫庫串流到手機平板上的第三方閱讀器（如 Android 上的 Tachiyomi/Mihon、iOS 上的 Paperback 或 Panels），達成「PC 端管理、行動端閱讀」的完美體驗。

核心特色：

廣泛格式支援：原生支援 CBZ, CBR, PDF, EPUB 格式，甚至支援直接讀取 RAR/ZIP 壓縮檔內的圖片。
強大的 Web 閱讀器：無需安裝 App，瀏覽器即可流暢閱讀，支援單頁/雙頁模式、日漫翻頁方向調整與縮放設定。
OPDS 支援：作為標準的 OPDS 1.2 伺服器，可無縫對接各類支援此協定的閱讀軟體。
多使用者管理：可建立多個帳號，並設定每個帳號可存取的書庫權限與閱讀進度同步。
中繼資料管理：自動讀取 ComicInfo.xml，支援手動編輯書籍資訊，讓您的收藏庫井然有序。

常用指令與快捷鍵

Komga 的核心操作主要透過 Web 介面與第三方 App，但在伺服器部署與 Web 閱讀時有一些關鍵指令與快捷鍵。

Docker 部署指令

這是最推薦的安裝方式，方便且易於維護。

# 啟動 Komga 容器
# 需將 /path/to/comics 替換為您實際的漫畫存放路徑
docker run -d --name komga 
  -p 25600:25600 
  -v $(pwd)/config:/config 
  -v /path/to/comics:/data 
  --user 1000:1000 
  gotson/komga

(啟動後，瀏覽器訪問 http://localhost:25600 即可設定)

Web 閱讀器快捷鍵 (鍵盤操作)

在電腦上使用瀏覽器閱讀時，熟練使用快捷鍵可大幅提升沈浸感：

快捷鍵	功能說明
← / →	上一頁 / 下一頁 (依據閱讀方向設定)
F	切換全螢幕模式 (Fullscreen)
M	顯示 / 隱藏選單列 (Menu)
L	切換為「由左至右」閱讀模式 (Left-to-Right)
R	切換為「由右至左」閱讀模式 (Right-to-Left, 日漫專用)
V	切換為「垂直捲動」模式 (Vertical, 韓漫/條漫專用)
D	切換單頁 / 雙頁顯示 (Double page)
Esc	關閉閱讀器，返回書庫

Java 直接執行 (適用於 Windows/macOS)

若不熟悉 Docker，且已安裝 Java 17+ 環境，可直接下載 jar 檔執行：

java -jar komga.jar

操作介面

介面亮點：
Komga 的介面採用 Material Design 風格，簡潔且適應性強。

首頁儀表板：顯示「最近加入」、「閱讀中」與「最近讀完」的書籍，方便快速接續進度。
書庫瀏覽：以封面牆（Grid View）展示系列作品，支援依標題、作者、加入時間排序。
系列詳情頁：點擊系列後，會列出該系列下的所有集數（卷），並顯示簡介、標籤（Tags）與作者資訊。
閱讀器：介面極度乾淨，預設隱藏所有按鈕，僅展示漫畫內容，點擊中央才會呼叫出控制列。