Success
快速結論： 要在 iPhone 或 iPad 上設定 OPDS 伺服器，先安裝一款支援 OPDS 的閱讀器 App，打開它的「書庫」或「書目」區，新增一個書目，貼上伺服器完整的 OPDS 網址（例如 Calibre Content Server 是 http://192.168.1.10:8080/opds，而不是光禿禿的 IP 位址），給它一個名字，只有在伺服器要求時才填帳號與密碼。存檔之後，App 就會列出那台伺服器上的每一本書，可以下載並離線閱讀。最常見的錯誤，就是漏掉 /opds 路徑或連接埠號碼。
OPDS 聽起來像是要有架站背景才敢碰的東西，但只要你知道兩件會絆倒所有人的事，它其實大約兩分鐘就能搞定：伺服器期待的確切路徑，以及各家伺服器處理登入的方式。這份教學會從頭到尾走一遍新增第一個書目、App 裡的精確步驟、每一種常見伺服器的網址規則、一小份我寫這篇時親手驗證過的公開書目，以及當什麼都沒出現時真正管用的排查清單。
一點說明：我是 Petr Jahoda，justRead 是我做的。這裡描述的每一條 OPDS 連線我都親手設定過，用的是真的伺服器和真的 iPhone，而不是照著規格改寫。下面的陷阱都是我自己踩過的。
這份教學在 2026 年 7 月全面改寫並擴充，每一個公開書目網址都在發布當天重新測試過，才不會把你送到一個死掉的 feed。
OPDS 究竟是什麼
OPDS，全名 Open Publication Distribution System，是一個讓閱讀 App 瀏覽並從伺服器下載書籍的簡單標準。最清楚的比喻是：OPDS 就是書的 RSS。 RSS 閱讀器指向一個 feed 位址，就能看到那個來源的每一篇新文章。OPDS 閱讀器指向一個書目網址，就能看到那台伺服器提供的每一本書，含封面、作者、簡介與下載連結。你點一本書，它就下載到你的裝置上，然後你可以離線讀。
因為它是開放標準，而不是某一家公司的 App，所以同一個閱讀器可以用同一套機制連上差異極大的來源：像 Project Gutenberg 這樣的公共領域圖書館、一台家用媒體伺服器，以及你自己的 Calibre 收藏，全都講同一種語言。沒有任何東西被綁在某個商店或帳號上。
你會遇到兩個版本：
- OPDS 1.2 是今天幾乎所有東西都在講的版本。它建立在 Atom 這個 XML feed 格式之上，所以一份書目本質上就是一份列出書籍與子分類的 XML 文件。2026 年有人給你一個 OPDS 網址時，它幾乎一定是 1.2。
- OPDS 2.0 是同一個想法比較新、以 JSON 為基礎的改寫版。對開發者來說更乾淨，也開始出現（例如 Komga 兩種都提供），但採用度還在早期。你不需要做選擇。好的閱讀器會替你協商版本，而實務上你用到的會是 1.2。
開始之前你需要什麼
連上任何 OPDS 書目只需要兩項資訊，而且常常只需要第一項：
- 書目網址。 這是 OPDS 端點，通常以
/opds或類似的路徑結尾。公開書目的話，該專案會在自己的網站上公布。你自己的伺服器的話，就是伺服器位址加上那套軟體使用的 OPDS 路徑（這正是大多數設定失敗的地方，下面有完整一節在講）。 - 帳號與密碼，只有在伺服器要求時才需要。 公開書目通常是開放的。私人伺服器，例如你自己的 Calibre 或 Komga，可能會要求登入。若是如此，你輸入一次，App 就會記住。
整份清單就這樣。不需要第三方帳號，中間不需要同步服務，也不需要用線手動搬檔案。
步驟 1：安裝一款 OPDS 閱讀器
iOS 與 iPadOS 本身不會瀏覽 OPDS 書目，所以你需要一款支援這個標準的閱讀器 App。justRead 是一款內建 OPDS 的 iPhone 與 iPad EPUB 及 PDF 閱讀器：它內建了 Project Gutenberg 與 Internet Archive 這兩個書目，讓你新增自己的伺服器，並支援伺服器端搜尋、分頁與依分類瀏覽，所以即使是龐大的書目也還是好用。不論你選哪一款 App，你要找的功能就是在它的書庫或設定裡的 OPDS 或「書目」區塊。如果你想先看完整功能再決定，OPDS 閱讀器總覽說明了這款 App 支援什麼。
有一個誠實的限制值得先講：justRead 讀 EPUB 與 PDF 檔案。只提供其他格式的 OPDS 書目仍然可以瀏覽，但你只能下載 EPUB 與 PDF 版本。
步驟 2：一步步新增你的第一個書目
想最快看到 OPDS 運作起來，就用一個免費的公開書目，而在 justRead 裡最快的那個，甚至完全不用打字。
免打字路線（內建）。 justRead 內建了 Project Gutenberg 與 Internet Archive。打開書庫、打開書目區，它們已經在那裡了。點一下 Project Gutenberg，你立刻就在瀏覽超過七萬本公共領域書籍，沒有網址要貼。這是通往「下載到一本書」最短的路徑。先用它一次，確認整個流程沒問題，再去新增自訂的東西。
手動路線（任何書目）。 用網址新增書目時，大多數閱讀器的流程都一樣，在 justRead 裡具體是：
- 打開 書庫。
- 選擇 新增 OPDS 書目（新增伺服器或書目的選項）。
- 把書目網址 貼 進位址欄。是貼上，不要重打，這樣你就不可能在路徑或連接埠上打錯字。
- 給它一個之後你認得出來的 名字，例如「家裡的 Calibre」或「Gutenberg」。
- 如果伺服器需要登入，輸入 帳號與密碼。不需要的話就留空。
- 存檔。
書目現在會出現在你的清單裡。點它就能 瀏覽。比較大的書目會展開成你可以往下鑽的分類，所以你可以 依分類瀏覽（依主題、作者、最熱門、最近新增等等），而不必捲一份巨大的清單。用伺服器端搜尋直接向伺服器查詢書名或作者，而不必先把全部下載下來，而分頁則讓長長的搜尋結果以好消化的區塊載入。點任何一本書就能下載；它會進到你的書庫，之後就是你的，可以離線讀。
那六個步驟就是全部的技術含量。這份教學其餘的部分，都是為了把其中一個值弄對：步驟 3 裡的網址。
/opds 路徑陷阱，深入說明
如果你只帶走一件事，就帶走這個：OPDS 網址幾乎從來不會只是伺服器的位址。 光禿禿的 IP 或主機名指向的是伺服器給人看的網頁，而不是給機器讀的 OPDS feed。把閱讀器指向 http://192.168.1.10:8080，你會得到錯誤或一個空書目；指向 http://192.168.1.10:8080/opds，你的藏書就出現了。造成傷害的是兩個細節，路徑與連接埠，而每一種伺服器的處理方式都不同。
- Calibre Content Server 預設在連接埠
8080的/opds上提供服務：http://<ip>:8080/opds。漏掉:8080，連線還沒開始就死了。漏掉/opds，你會連到網頁閱讀器而不是 feed。 - Komga 的 OPDS 1.2 feed 在更深的路徑上：
http://<host>:25600/opds/v1.2/catalog。預設連接埠是 25600，而書目在好幾層裡面，不在光禿禿的/opds。 - Kavita 又是另一套做法：它不用帳號密碼，而是 把 API 金鑰直接寫進網址裡：
http://<host>:5000/api/opds/<你的api金鑰>。沒有另外要打的密碼，因為網址裡的金鑰就是憑證。從 Kavita 的設定裡把整個組好的網址複製過來，登入欄位留空。
規律是：把連接埠弄對、把路徑弄對，然後確認憑證是住在網址裡還是登入欄位裡。連線失敗時，十次有九次就是這三者之一。
步驟 3：連上 Calibre Content Server
最受歡迎的私人書目就是你自己的 Calibre 藏書。Calibre 這套免費的桌面電子書管理程式，只要按幾下就能把你的整個收藏透過 OPDS 發布出來：
- 在你的電腦上打開 Calibre，點工具列的 連接／分享。
- 選 啟動 Content Server。
- 找出你電腦的區域網路 IP 位址（類似
192.168.1.10）。OPDS 端點就是http://192.168.1.10:8080/opds，其中8080是 Calibre 的預設連接埠。
在你的 iPhone 或 iPad 上，用上面的六個步驟把那個網址新增成一個 OPDS 書目。有兩點讓 justRead 在這裡特別輕鬆：它能 在同一個 Wi-Fi 上自動探索到 Calibre Content Server，所以你可能根本不用去找、也不用打那個 IP；而且它支援 HTTP Digest 驗證，也就是你開啟 Calibre 的「需要帳號與密碼」選項時所使用的登入機制。
關於 Content Server 有幾個值得知道的現實：Calibre 必須在電腦上保持開啟並執行，書目才會有作用；除非你設定了遠端存取，否則兩台裝置必須在同一個網路上；而如果電腦的 IP 位址變了（家用路由器會自己這麼做），書目網址也會跟著變。在路由器裡保留一個固定 IP，或改用電腦的 .local 主機名，可以避免「昨天還好好的，今天就壞了」的問題。
這條 OPDS 路線是單純在 iOS 上讀你 Calibre 藏書最快的方式。如果你想把伺服器那一側做得完整，包括打開連接埠、加上登入、從家門外也連得到、處理多個藏書庫，Calibre Content Server 教學專門講那件事。而如果你希望閱讀進度與評分能同步回你的電腦，而不只是單向瀏覽，Calibre 藏書同步會在上面再加一層雙向同步。
自架伺服器的網址規則
如果你跑著家用伺服器，同樣的六步驟流程一樣適用，只是換成各專案自己的 OPDS 端點。以下是你要把主機與連接埠代入的規則：
| 伺服器 | 適合 | OPDS 端點規則 |
|---|---|---|
| Calibre Content Server | 你現有的桌面 Calibre 藏書 | http://<ip>:8080/opds |
| calibre-web | 有網頁介面的 Calibre 藏書，不用一直開著桌面程式 | http://<host>:8083/opds |
| Komga | 漫畫與日式漫畫，也支援 EPUB | http://<host>:25600/opds/v1.2/catalog |
| Kavita | 漫畫、日式漫畫與電子書 | http://<host>:5000/api/opds/<你的api金鑰> |
| COPS | 架在 Calibre 資料庫上的輕量 PHP 書目 | http://<host>/cops/feed.php |
關於這張表的說明：上面列出的連接埠是各專案常見的預設值，但每一個都可以在安裝時更改，所以連線失敗時請到伺服器自己的設定裡確認。calibre-web 的預設常常是 8083，但完全取決於你怎麼部署（反向代理可能會讓連接埠消失，只剩一個純主機名）。COPS 的入口在不同版本間變動過，所以如果 feed.php 解析不出來，請去你的 COPS 管理頁面找確切的 OPDS 連結，不要用猜的。Komga 也在 /opds/v2 提供 OPDS 2.0 feed，但上面那個 1.2 的書目路徑是相容性較好的起點。
justRead 支援自訂 OPDS 伺服器，包括 Calibre OPDS、calibre-web、Kavita、Komga 與 COPS，並提供逐伺服器的篩選與分頁，讓大型書目維持在好操作的狀態。
公開 OPDS 書目的入門清單
你不需要自己的伺服器也能用 OPDS。以下是我在這份教學發布當天重新測試過的公開書目。我只列出真的回傳了活的 OPDS feed 的網址，而且對那個有門檻的明講出來，而不是把你送到一個會安靜失敗的連結。
- Project Gutenberg（已驗證可用，免登入）：
https://www.gutenberg.org/ebooks.opds/。超過七萬本公共領域書籍，完全開放，下載也合法。這是第一個該加的黃金標準書目。在 justRead 裡它是內建的，所以你甚至不用貼這個網址；列在這裡是給其他 App 與備查用的。 - Unglue.it（已驗證可用，免登入）：
https://unglue.it/api/opds/。一份收錄創用 CC 授權以及被「贖回」成免費電子書的書目。比 Gutenberg 小、也更雜食，但完全開放。 - Standard Ebooks（是真的 feed，但有門檻）：這個專案製作排版精美的公共領域電子書，而且它確實在
https://standardebooks.org/feeds/opds發布 OPDS feed。在這次改寫時，完整的 feed 並未對大眾開放：它保留給 Patrons Circle 成員（小額捐款）、電子書貢獻者與贊助者，而且會暫時封鎖任何進行抓取的 IP。如果你支持這個專案，贊助者的驗證方式是輸入帳號的電子郵件、密碼欄留空。如果沒有，就把 Standard Ebooks 當成一個「從網站瀏覽並下載」的來源，而不是一個可以直接插上去的 OPDS 網址。
我刻意讓這份清單保持簡短，而且只放我能確認的書目。幾個出現在較舊清單上的書目已經死掉或封鎖自動存取，所以我沒有收錄。想要更廣、且持續查證過的整理，包括該避開的死 feed，請看2026 年最佳免費 OPDS 書目。那篇負責「要指向哪裡」，這篇負責「要怎麼指」。
HTTP、HTTPS、憑證與登入
家用的本機伺服器通常跑在你自家網路上的純 HTTP 上，這沒問題，因為流量從來沒有離開你家。你在 Wi-Fi 上連 Calibre Content Server 時，會打 http://（而不是 https://），這是正常的。
但當你想從家門外連上書目時，HTTPS 就重要了，而 iOS 在這件事上很嚴格：
- iOS 會拒絕不受信任的憑證。 如果你的伺服器用的是 自簽憑證，iOS 會直接拒絕連線，而不是在閱讀器裡跳出一個「仍要繼續」的按鈕。可靠的解法是用真的憑證：把伺服器放在一個網域名稱後面，並簽發一張免費憑證（例如用 Let's Encrypt），通常透過反向代理來做。這樣 iOS 就會像信任一般網站那樣信任它。手動在 iOS 設定裡安裝並信任自簽憑證是做得到，但很繁瑣，長遠來看正規憑證省事得多。
- Basic 與 Digest 驗證。 OPDS 伺服器用兩種 HTTP 登入機制之一來保護自己。Basic 驗證會在每次請求時送出你的帳號與密碼（走 HTTPS 是安全的，走純 HTTP 則會外洩），而 Digest 驗證是一種挑戰／回應機制，從不送出原始密碼。Calibre 的 Content Server 用的是 Digest，而 justRead 支援它。不論哪一種伺服器，都要用你在伺服器端設定的那組帳號密碼，一模一樣；差一個字元對 App 來說讀起來是「拒絕存取」而不是「密碼錯誤」，這也是為什麼登入打錯字會偽裝成連線失敗。
什麼都沒出現？完整排查清單
當書目載入不了時，照這個順序往下檢查。每一項都是我真的踩過的原因：
- 路徑錯了。 你用了光禿禿的位址，而不是完整的 OPDS 路徑。補上
/opds（Calibre）、/opds/v1.2/catalog（Komga），或你的伺服器文件裡寫的那一個。這是第一名的原因。 - 少了連接埠。 你漏掉了
:8080（Calibre）、:25600（Komga）、:5000（Kavita）或:8083（calibre-web）。沒有連接埠，請求哪裡也去不了。 - 在同一個網路上嗎？ 家用伺服器的話，手機與伺服器必須在同一個 Wi-Fi 上。手機很愛掉回行動網路；如果你在 5G 上而伺服器是一個只在區網內的
192.168.x.x位址，那就單純連不到。確認 Wi-Fi 有開，而且加入了正確的網路。 - 從外面連區網 IP。
192.168.x.x或10.x.x.x的位址只在你家裡有用，在咖啡廳永遠解析不出來。要遠端連上它，需要一條回家的 VPN，或是一個正式的網域加反向代理。 - 防火牆擋住連接埠。 Calibre 最常見的失敗：伺服器在跑、網址也對，但電腦的防火牆安靜地擋掉了 8080 的連入連線。在跑伺服器的那台機器上，把該連接埠（或 Calibre 這個程式）放行。
- 伺服器其實沒在跑。 Calibre 必須保持開啟且 Content Server 已啟動；自架的容器必須是起來的。如果 Calibre 關了或容器停了，書目就消失了。在同一個網路上，用桌面瀏覽器載入同一個網址：如果瀏覽器也連不到，那問題出在伺服器，不在 App。
- 驗證打錯字。 帳號或密碼錯了，讀起來會像連線失敗。仔細重新輸入憑證，注意第一個字母被自動大寫，以及貼上時尾端多出來的空白。
- HTTPS 憑證被拒絕。 使用自簽憑證的遠端伺服器會被 iOS 拒絕。照上面說的改用受信任的憑證。
- 位址變了。 昨天可以今天不行，是因為路由器發給電腦一個新的 IP。保留一個固定 IP，或改用
.local主機名。
最快的單一診斷是第 6 點的瀏覽器測試：在同一個網路上，用 Safari 或桌面瀏覽器打開那個確切的 OPDS 網址。如果你看到一堆原始 XML，代表伺服器與網址都沒問題，問題出在 App 或它的憑證。如果瀏覽器也失敗，那問題就是伺服器、連接埠或網路，而你剛剛把搜尋範圍砍了一半。
OPDS 在你的閱讀環境裡的位置
OPDS 把 iPhone 或 iPad 變成任何你指得到的藏書的前端，不論公開或私人，都不必手動搬檔案。書目設好之後，加一本新書只要兩下。大多數人最後都會有一個小小的組合：一個內建的公開書目拿來讀經典，加上自己的 Calibre 或自架伺服器來放真正收集的東西。
- 對 iOS 上的電子書整體還很陌生？先從如何在 iPhone 和 iPad 上讀 EPUB開始。
- 想看看一款 OPDS 閱讀器能做到什麼的完整樣貌？請看 OPDS 閱讀器總覽。
- 在決定要加哪些公開書目？用2026 年最佳免費 OPDS 書目。
- 自己在跑 Calibre？Calibre Content Server 教學講伺服器那一端，而 Calibre 同步加上進度與評分的雙向同步。
justRead 有 14 天免費試用，所以你可以先設好第一個書目、確認整個流程可行，再決定要不要買。到 App Store 下載 justRead，今天就加上你的第一個 OPDS 書目。
常見問題
什麼是 OPDS 書目？
OPDS 書目是一個讓閱讀 App 從伺服器瀏覽並下載書籍的 feed，很像 RSS 閱讀器訂閱新聞 feed。你把 App 指向書目網址，它就會列出伺服器提供的每一本書，含封面與簡介，可以下載並離線閱讀。
Calibre Content Server 正確的 OPDS 網址是什麼？
是你電腦的區網 IP，加上 Calibre 的連接埠，再加上 /opds 路徑：http://192.168.1.10:8080/opds。會把它弄壞的兩個錯誤是：只用光禿禿的 IP 而沒有 /opds，以及忘記 :8080 這個連接埠。
我一定要有 Calibre 才能在 iPhone 上用 OPDS 嗎？
不用。你可以在完全沒有自己伺服器的情況下連上 Project Gutenberg 之類的公開書目，而且在 justRead 裡，Gutenberg 與 Internet Archive 是內建的，什麼都不用打。Calibre 的 Content Server 只是眾多受歡迎的 OPDS 來源之一，如果你本來就把藏書放在電腦的 Calibre 裡，它就很有用。
為什麼我的 OPDS 伺服器在 iOS 上連不上？
常見原因依序是：路徑錯了（少了 /opds）、少了連接埠號碼、手機與伺服器不在同一個網路、防火牆擋住連接埠、登入打錯字，或是 iOS 拒絕信任的自簽 HTTPS 憑證。在同一個網路上用桌面瀏覽器載入那個確切網址，就能判斷問題是出在伺服器還是 App。
Kavita 為什麼不問我帳號密碼？
Kavita 把 API 金鑰直接放在 OPDS 網址裡（http://<host>:5000/api/opds/<你的api金鑰>），所以金鑰就是憑證。從 Kavita 的設定把完整網址複製過來，貼成書目位址，帳號與密碼欄留空。
OPDS 1.2 和 OPDS 2.0 有什麼差別？
OPDS 1.2 是比較舊、建立在 Atom 上的 XML 版本，而且是今天幾乎每一台伺服器與每一款閱讀器都在講的。OPDS 2.0 是比較新、以 JSON 為基礎的版本，對開發者比較乾淨，也開始出現（Komga 兩種都提供），但採用度還在早期。好的閱讀器會處理伺服器給的任一種，所以你很少需要選。
OPDS 在 iPhone 上能走 HTTPS 與自簽憑證嗎？
搭配受信任的憑證時可以走 HTTPS。iOS 會直接拒絕自簽或其他不受信任的憑證，所以遠端存取請把伺服器放在真正的網域與免費憑證（例如 Let's Encrypt）後面，而不要用自簽的。至於在你自己 Wi-Fi 上的伺服器，純 HTTP 沒問題。
我能從家門外連到家裡的 OPDS 伺服器嗎？
用 192.168.x.x 這種區網位址不行，它只在你家裡解析得出來。要遠端連上，可以用 VPN 連回家，或是透過網域名稱加上帶有受信任憑證的反向代理把伺服器公開出去。
OPDS 在手機上能處理多少本書？
非常大的藏書都沒問題，因為 OPDS 是以瀏覽為先：App 只有在你點下去時才下載那本書，而不是整份書目。justRead 使用伺服器端搜尋與分頁，所以一份幾萬本的書目會分塊載入並保持流暢，而且你可以依分類瀏覽，不必把全部捲過一遍。
justRead 透過 OPDS 支援哪些伺服器？
justRead 可以連上標準的 OPDS 伺服器，包括 Calibre 的 Content Server、calibre-web、Komga、Kavita 與 COPS，並提供逐伺服器篩選、伺服器端搜尋、分頁與依分類瀏覽。它也會在同一個 Wi-Fi 上自動找到 Calibre Content Server，並支援 Calibre 的 HTTP Digest 登入。
在 justRead 裡我能透過 OPDS 下載什麼？
EPUB 與 PDF 檔案，以及 CBZ 與 CBR 漫畫。你可以瀏覽同時列出其他格式的書目，但 justRead 會下載並開啟的是 EPUB、PDF 與漫畫版本。
設定好之後要指向哪裡：這個月仍然真的送得出書的免費 OPDS 書目，或者如果架伺服器比你想像的麻煩，更簡單的免費 EPUB 取得管道。Komga 與 Kavita 這兩台大家最常用這種方式連上的伺服器，主要是漫畫伺服器，所以在你加入它們之前，CBZ 或 CBR 下載之後會發生什麼事也值得先知道。
← Back to Guides