# 漫阅+ 连接 OPDS：为什么能看到目录，却不能直接逐页阅读

语言：zh-CN
原文：[漫阅+ 连接 OPDS：为什么能看到目录，却不能直接逐页阅读](<https://allluckly.cn/guides/manyue-opds-pse-library/>)
中文：[中文 HTML](<https://allluckly.cn/guides/manyue-opds-pse-library/>)
English: [English HTML](<https://allluckly.cn/en/guides/manyue-opds-pse-library/>)
发布于: 2026-10-22T00:00:00+08:00
内容更新于: 2026-10-22T00:00:00+08:00
署名：Bison

分清 OPDS 目录、整包获取链接和 OPDS-PSE 页面流，正确填写目录地址，并选择可验证的阅读或本地导入路径。

OPDS 目录可以告诉阅读器“这里有哪些书”，但目录可见不等于书里的每一页都能直接请求。漫阅+ 公开说明明确区分普通 OPDS 和 OPDS-PSE：支持逐页扩展的内容可以按页读取，只有整包获取链接的普通条目不支持在这个入口直接逐页阅读。理解这一点，能避免把协议能力不足误判为密码错误。

## 准备的是目录地址，不是网站首页

向服务提供者索取 OPDS 目录 URL，并确认需要哪种账号认证。示例 `https://catalog.example.com/opds-comics/` 只是占位地址；实际路径取决于服务器配置，不能套用为所有服务的固定路径。不要从浏览器随便复制一个搜索页、书籍详情页或下载按钮后的临时链接当作目录。

确认自己有权访问目录内容，先选择一个小范围分类作为起点。目录可能很大，也可能有多层导航；第一次只需找到一两本已知样本，不必把所有分类一次检查完。连接前还应核对漫阅当前服务器书库权益，账号认证、应用权益和协议能力属于三个独立条件。

## 在服务器书库中添加 OPDS

添加连接时选择 OPDS 类型，填写目录地址以及服务要求的用户名和密码。不要把密码嵌入 URL，避免链接被复制到剪贴板、截图或公开记录中。提交后查看是否能够列出目录，再进入明确的分类或书籍条目。

如果目录解析失败，先检查地址返回的究竟是 OPDS 内容还是普通 HTML 登录页。这里不要求你手工编辑服务器返回数据；应由服务管理者确认正确地址和访问配置。反复改变书架名称不会修复错误目录类型，改成其他服务类型也不一定有意义，除非你确实在使用对应服务器。

## 看懂整包链接和页面流的区别

普通获取链接通常指向一整个文件，页面流则需要服务器告诉客户端怎样请求指定页。OPDS-PSE 的目的就是增加这类逐页信息，使客户端无需先取得整份文档才能开始读取。[OPDS-PSE 项目说明](<https://anansi-project.github.io/docs/opds-pse/intro>)对此有简明定义。

因此，一条记录包含标题、作者、封面和整包下载地址，也仍然可能不具有逐页阅读能力。目录和封面显示正常时，认证也许已经成功；如果打开后提示缺少支持的页面流，应优先核对服务器是否实际提供 OPDS-PSE，而不是在已成功的登录步骤中不断重试。

## 按能力选择下一步

对于提供兼容页面流的样本，打开后检查首、中、末页，确认并非只有封面可以显示。服务器支持某个扩展不代表所有文件和所有条目都已经生成完整页面信息，应逐个核对问题作品。如果只在个别条目失败，记录具体书名与分类位置，让管理者检查该条目返回的能力。

对于只有整包链接的内容，不把漫阅 OPDS 入口描述为已经支持直接阅读。可以请管理者启用适合的逐页能力；如果服务本身就是 Komga 或 Kavita，也可以使用它们的专用连接方式。另一条明确路径是在服务允许的方式下取得自己的漫画文件，再用本地导入入口处理，这与“当前 OPDS 条目直接可读”是不同结果。

## 实例：比较同一目录中的两本样本

假设一本自制漫画在目录中提供页面流，另一本文档只有文件获取链接。先分别查看两个条目：第一本能够按页打开，记录几个实际页面；第二本即使能显示封面，也可能提示缺少页面流。把这两种结果分别写下，而不是把整个服务统一标成“可读”或“不可用”。

如果第二本通过服务允许的下载方式取得 PDF，你可以把它导入本地书库并离线阅读。此时成功的是本地 PDF 路线，不能据此宣传普通 OPDS 的逐页能力已经修复。保留路径差异，有助于日后再遇到同类条目时直接选择合适方案。

把检查结果写成三列小清单：条目名称、能否列出、能否逐页打开。对于取得整包后本地导入的书，再单独记录文件保存位置。这样下一次目录更新时，只需重查原先有问题的条目，也能清楚告诉服务管理者缺少的是目录信息还是页面流，而不是重新描述整套连接过程。

## 完成检查与更新边界

检查包括正确目录能重新打开、目标分类可达、样本能力已区分、可读条目的实际页面正常。目录更新、书籍移除或地址改变后，旧记录可能不再对应原对象；先刷新并核对服务端，再判断是否需要重建连接。不要仅凭同样的标题就假定新的条目拥有相同页码和书签位置。

### 只要服务器写着支持 OPDS，就一定能直接阅读吗？

不能。还需要它为相应条目提供漫阅能够使用的页面流。支持目录发现与支持逐页读取是两件事，公开格式清单也不能替代服务器端的具体输出。

### 能看到封面，为什么还说连接没有完全验证？

封面和正文可能来自不同请求，且能力不同。完整验证应包含打开实际页面、检查多个位置，以及需要离线时的文件检查。封面只证明其中一个环节完成，不应作为整条阅读路径成功的唯一证据。

## 接下来读什么

- [使用 Komga 专用连接](<https://allluckly.cn/guides/manyue-komga-library/>)。
- [使用 Kavita 专用连接](<https://allluckly.cn/guides/manyue-kavita-library/>)。
- [取得文件后从本地导入](<https://allluckly.cn/guides/manyue-getting-started/>)。

## 资料来源与版本

资料核对：2026 年 10 月 22 日，漫阅+ 2.0.2，iPhone / iPad。依据[中国区 App Store 公开说明](<https://apps.apple.com/cn/app/id6753895889>)、[Apple 版本查询](<https://itunes.apple.com/lookup?id=6753895889&country=cn>)与对应功能入口整理。界面名称可能随版本调整，功能权限以 App 当前购买页面为准。