漫画胶囊
OPDS 漫画阅读指南

OPDS 漫画阅读器：让阅读器连上书库，而不是连上文件夹

前面两种连接方式——SMB 和 WebDAV——给你的都是一个目录树。OPDS 不一样，它给你的是一份服务端整理好的书目。这个差别决定了它能做什么、也决定了它为什么有时候会让你先下载。这篇把 OPDS 讲清楚。

前往 App Store阅读指南

适合已经在 NAS 上自建漫画服务端（如 Komga）、想用 iPhone 和 iPad 阅读的用户；漫画胶囊是阅读器，不提供在线漫画资源。

在 iPhone 与 iPad 上通过 OPDS 阅读漫画

OPDS 是什么

OPDS 全称 Open Publication Distribution System，是一套基于 Atom 的目录格式。 说人话：它是让阅读器「浏览一个书库」的标准协议。

它和前两种方式最大的区别在这里：

SMB / WebDAV OPDS
你看到的是 目录树和文件 服务端整理好的书目
分层结构 文件夹 / 子文件夹 系列 / 卷 / 封面
谁在组织内容 你的文件夹命名 服务端（如 Komga）
典型搭档 NAS 共享文件夹 Komga、Kavita、Calibre-Web

用 SMB 连 NAS，你看到的是 漫画/海贼王/海贼王 - vol001.cbz。用 OPDS 连 Komga，你看到的是「海贼王」这个系列，带封面、带卷号、带作者信息——因为 Komga 已经替你整理过了。

所以 OPDS 不是用来替代 SMB/WebDAV 的，它是用来配合服务端的。 没有服务端，OPDS 就无从谈起。

说句实在话：这个协议拿来当漫画服务器其实挺别扭的。它的资源组织方式不是目录结构，为了适配它，客户端到处都要单独判断。但它解决了一个真问题——让「服务端整理好的库」和「iOS 上的阅读器」能对接上，而且跟流式阅读结合起来是合理的。所以值得支持。

哪些服务提供 OPDS

OPDS 不是一个产品，是一套标准，好几种自托管服务端都提供：

  • Komga——最流行的漫画服务端，提供 OPDS v1 和 v2，社区里跟 iOS 客户端配合的资料也最多。
  • Kavita——多格式数字图书馆，支持漫画、小说、PDF，同样提供 OPDS。
  • Calibre-Web——电子书管理工具，也有 OPDS 接口，但它是为电子书设计的，漫画的封面识别和系列归类不如 Komga 专业。
  • LANraragi、Ubooquity——漫画库方向的自托管服务，也提供 OPDS。

要提醒一点：OPDS 是有版本差异的，v1 和 v2 不是一回事。 有些老版本的服务端或套件只支持 v1，功能会残缺。以飞牛官方商城里那个 Komga 为例，它太老了，连 OPDS v2 都不支持，装它基本等于白装——用 Docker 部署官方镜像。

漫画胶囊目前走的是 OPDS v2，配合 Komga 是验证得最充分的组合。 如果你用的是 Komga，可以直接看 Komga 漫画服务器 iOS 使用指南，那篇里有完整的部署步骤；下面讲的是协议这一侧的通用做法。

在阅读器里添加

以漫画胶囊连 Komga 为例：

  1. 打开 App，书架侧边栏 → 添加网络书架。
  2. 选 Komga，然后点添加 OPDS v2 服务器。
  3. 地址只要填 IP:端口，比如 http://192.168.1.100:25600。
  4. 账号密码就是登录 Komga 的那套。

这里有个细节值得说一下：OPDS 的完整地址其实包含服务端约定的路径，不同服务端还不一样。漫画胶囊的做法是只让你填 IP 和端口，剩下的地址它自动判断补全——因为客户端会先去问一下服务端是什么，确认是 Komga 之后再按 Komga 的规则拼出正确的地址。

所以你不需要去查「OPDS 的 URL 路径到底长什么样」，填 IP 和端口就够了。

添加成功后，整个书库会直接出现在书架里，跟浏览本地书架的体验一致。流式阅读、AI 高清这些功能都能用，进度也会自动同步。

为什么有的书要先下载

这是 OPDS 使用中最容易困惑的一点，值得单独讲。

原因在于：OPDS 传输的仍然是压缩包。 服务端给你的是一本 CBZ 或 CBR 文件，至于「能不能只取其中几页、剩下的边看边加载」，取决于两件事——服务端支不支持，以及客户端能不能做到。

OPDS 生态里为此有一个专门的扩展，叫翻页流式（Page Streaming）。支持它的服务端会额外提供「逐页访问」的入口，客户端就能一页一页地取，而不是整本拉下来。

于是就出现了三种情况：

  1. 服务端和客户端都支持流式——点开就能看，跟看本地文件一样。这是最好的情况。
  2. 服务端支持、客户端不支持——每次打开都要等整本下载完，几百 M 的单行本会等得很难受。
  3. 服务端自己就不提供——那不管客户端多强，都只能整本下载后再读，客户端会明确提示「该书仅支持下载阅读」。

所以遇到「要先下载」的时候，不一定是你的阅读器不行，很可能是服务端那一侧没有提供流式入口。可以先确认服务端版本是不是最新的，老版本功能残缺是常见原因。

顺带说一个格式上的连带影响：即使都在流式读取，不同格式的速度也不一样。 ZIP、CBZ 这类压缩包能按位置只取需要的部分，效率最高；PDF 是为打印设计的，渲染本身就重，同样的图片在 ZIP 里秒开、在 PDF 里可能要花好几倍时间；RAR 因为压缩算法闭源，解析效率也不如 ZIP，而且流式支持本来就弱一些。这跟 OPDS 无关，是格式本身的差异，但会直接影响你感觉到的打开速度。

常见问题

OPDS 和 WebDAV 有什么区别，我该用哪个？

看你的漫画是怎么组织的。如果就是一摞文件夹，用 WebDAV 或 SMB，链路短、配置简单、新增文件立刻可见。如果你在 NAS 上跑了 Komga、Kavita 这类服务端，用 OPDS，它能让你看到服务端整理好的系列和封面。两者可以同时挂在同一个书架里，不冲突。

为什么我的 OPDS 书库连上了却不显示封面？

先确认服务端是不是已经完成刮削——Komga 需要先扫描并匹配到元数据，封面才会生成。另外如果用的是老版本的套件（比如 NAS 商城里的 Komga），接口不完整也会导致封面取不到。换成官方 Docker 镜像再试。

OPDS 能搜索吗？

漫画胶囊目前不提供 OPDS 的搜索功能。 书架里的搜索只能搜到当前磁盘已经缓存过的书籍，这一点跟本地书架的搜索范围不一样，用的时候留意一下。

连不上 OPDS 服务端，先查什么？

  1. 端口对不对？Komga 默认是 25600。
  2. 服务端是不是最新版本？老版本可能不支持 OPDS v2。
  3. 账号密码对不对？是服务端里创建的那个账号。
  4. iPhone、iPad 和 NAS 是不是在同一个网络下？外网访问需要先配好组网或穿透。

本页适合找在线漫画的用户吗？

本页介绍的是阅读你自己已有的漫画文件。漫画胶囊不提供在线漫画内容，请使用你有权阅读的文件和服务。想部署服务端，看 Komga 漫画服务器 iOS 使用指南；想比较几个 NAS 系统，看NAS 系统怎么选。