书屿连接 OPDS：浏览目录、搜索并获取电子书

OPDS 提供的是适合阅读器使用的电子书目录。它可以按作者、分类或其他导航展示作品，并给出获取文件的链接。在书屿中使用 OPDS，重点是找到真正的目录地址，再确认目标书提供的格式与你的阅读需求一致。

找到服务提供的 OPDS 地址

准备一个你有权访问的 OPDS 书库，地址应由服务提供方或自己的服务器设置给出。网页首页、管理后台和 OPDS 入口往往不是同一个 URL。不要因为浏览器能打开某个网站，就假定把首页地址填进阅读器一定能工作；页面可能返回 HTML，而不是目录数据。

如果需要账号访问，准备对应的用户名与密码。先确认服务端已经收录一本可下载的小型 EPUB，方便验证。书屿的 OPDS 浏览、下载与远程阅读属于藏书家 Pro 范围，内容本身仍由你的书库提供，应用不会随连接自动提供额外电子书资源。

从「设置」进入「OPDS 书库」或当前版本对应的 OPDS 书源管理入口，选择添加。填写容易辨认的名称与完整目录地址，保留服务要求的路径和末尾斜杠；有认证字段时分别填入凭据，不要把密码拼进 URL。保存后打开书源，观察是否显示目录或作品条目。

如果第一屏是按作者、最近添加、分类等组织的目录，先进入一个你熟悉的小分类。OPDS 中的目录条目与书籍条目不同，点开目录通常会继续进入下一层，不是立即下载。不要因为连续点了几次都还在列表，就误以为阅读按钮失效；先看当前条目的类型。

如果书源提供搜索入口，先输入完整书名的一部分，再查看结果中的作者和格式。不同 OPDS 服务的搜索能力不同，不能保证支持全文、任意组合条件或全站模糊匹配。没有搜索入口时，可以通过目录导航逐级找到练习书，这仍是正常的目录使用方式。

结果较多时，先用作者或分类缩小范围，再核对版次。封面相同不代表获取链接相同，某本书可能同时提供 EPUB、PDF 和管理用途的其他格式。打开操作菜单前先决定自己需要重排阅读还是固定页面，能够减少下载后才发现格式不合适的返工。

在目标书条目中选择对应的下载操作，例如「下载到书架 EPUB」或当前界面的同类入口。若出现多个格式，优先选你已经在本地成功阅读过的一种。等待文件获取和导入完成，回本地书架打开，核对章节、正文与书名。

有些条目会提供流式阅读或先缓存再阅读的选项，应按当前可用入口使用。第一次建议完整下载一本，这样更容易检验离线结果。能够在线翻开前几页，并不代表全书已经缓存；出门前需要断网打开后面章节，确认实际准备范围。

目录能够显示，不代表每一个获取链接都有效。服务器可能返回登录页、过期链接、权限错误或已经移动的文件。遇到“服务器返回的不是该格式文件”之类提示时，先检查服务端获取链接和权限，而不是把下载结果强行改名成 EPUB。

同样，某个条目只提供商店购买页或详情网页，也不等于它提供了电子书文件。应使用自己有权获取且服务确实提供的内容。书屿公开版中 MOBI、AZW、AZW3、CBR、DJVU 的管理支持，不应理解为每一种都能直接读；选择 EPUB、PDF 或其他明确可读格式更适合首次验证。

先确认目录地址正确，再确认账号能看见目标条目，然后检查目标格式链接，最后核对本地正文。这个顺序可以把“连不上书源”“搜不到书”“下载失败”“文件读不了”拆成四个不同问题。不要四个环节同时更改，否则很难知道哪一步真正解决了故障。

如果目录很大，可先连接服务允许的子目录，或通过导航缩小范围。加载完整目录需要时间，刷新过程中不要把暂时没有出现的条目当成已被删除。也不要依据一次网络中断就清空本地书架；已下载的书和远程目录状态应分别保留并检查。

为什么浏览器里能看书库，App 却说目录无效？ 浏览器可能打开的是面向人的网页，或依赖已有登录 Cookie。阅读器需要服务实际提供的 OPDS 地址与相应认证。回到服务设置核对入口，不能用网页外观判断协议是否匹配。

OPDS 是否等于漫画逐页阅读？ 不是。OPDS 是目录机制，具体获取方式由服务与客户端共同决定。书屿这里用于电子书目录和文件获取；不要把其他漫画 App 的 OPDS-PSE 页面流规则直接套过来，也不要推断所有 OPDS 条目都可流式阅读。

已经收藏的远程书能永远离线打开吗？ 远程条目、封面缓存和完整本地文件不同。需要离线时完成下载并实际打开检查；目录存在、搜索成功或加入列表，都不能代替文件验证。

如果目录来自自己的 Calibre，可以看Content Server 连接；若只想从 NAS 文件夹取书，参考WebDAV 书库。下载完成后的文字定位，可继续全文搜索教程。

资料核对于 2026 年 10 月 23 日。公开版本为书屿 1.1.3，最低要求 iOS / iPadOS 15.6。本文按公开功能说明与相应功能入口整理，界面名称可能随版本调整。参考App Store 官方说明与Apple 版本信息。