5 分钟接上在线书库：Readest OPDS 目录使用指南

【免费下载链接】readestReadest is a modern, feature-rich ebook reader designed for avid readers offering seamless cross-platform access, powerful tools, and an intuitive interface to elevate your reading experience.项目地址: https://gitcode.com/gh_mirrors/re/readest

你有一批书散落在不同的来源：公版书想从 Project Gutenberg 拿，个人书存在 Calibre 里，订阅的书又挂在别人的目录服务器上。Readest 是一款跨平台电子书阅读器，它的OPDS 目录功能让你把这些在线书源统一接进同一个图书馆：按分类浏览、搜索、下载，阅读进度和标注照常在多台设备间同步。

功能速览

• OPDS 协议：支持 Atom 与 OPDS 2.0 JSON 两种 feed 格式，目录搜索走 OpenSearch 协议
• 内置目录：预置 Project Gutenberg、Standard Ebooks、ManyBooks、Unglue.it 四个常用目录，可一键添加
• 多格式下载：目录提供 EPUB、PDF 等多种格式时，按钮会给出格式下拉菜单供你选择
• 自动下载：订阅指定 feed 后，目录更新即自动下载新书入库，失败条目按退避策略重试
• 来源去重：按目录 ID 加下载来源 URL 记录映射，同一本书不会重复入库

常用内置目录一览：

⏱️ 快速上手：4 步配置你的第一个 OPDS 目录

1. 打开 Readest 主界面，点击底部"图书馆"进入书库
2. 点击顶栏搜索框右侧的加号图标，展开"导入书籍"下拉菜单
3. 选择菜单里的"在线图书馆"项（未启用在线目录的版本显示为"OPDS 目录"），在打开的面板中找到"Popular Catalogs"区域，点击 Project Gutenberg 卡片上的"Browse"按钮，直接浏览，不需要保存
4. 点击任意书籍卡片进入详情页，点击"Download"按钮开始下载
5. 下载完成后 toast 提示"Download completed"，图书馆里出现这本书，即可直接打开阅读

📖 深入使用

浏览与搜索

进入目录后，页面以条目卡片和分组导航的形式呈现，点条目进详情，点导航卡片进子分类。详情页会额外拉取书籍的完整条目，补齐简介、出版方和语言信息。目录支持搜索时，顶部会出现搜索栏，输入书名或作者回车即可，每页默认返回 20 条结果，搜索无结果会给出提示并停留在搜索页。

下载与入库

详情页的"Download"按钮会列出全部可用获取方式，例如"Download EPUB"或"Download PDF"，有多格式时以下拉菜单呈现。目录如果支持 Borrow 借阅或 Buy 购买链接，按钮也会按对应名称显示。下载完成后，Readest 用目录提供的元数据和封面替换文件内嵌记录，书直接出现在图书馆；已下载过的条目再进入详情页，按钮变为"打开并阅读"。开启云端同步后，新下载的书会自动排队上传到其他设备。

在线收听有声书

目录里带音频流的条目不占下载位，详情页会出现"Play"按钮，点开直接在播放器里听，进度按书记录在案。

接入自己的 Calibre 内容服务器

在自己的 Calibre 书库上启用"Connect to Share → 启动内容服务器"，把生成的http://[IP]:8080/opds地址填进 Readest 即可。服务器开启认证时，在添加目录表单填写用户名和密码；服务器使用自签名证书时，开启"Allow Self-Signed Certificate"开关。

🛠️ 进阶玩法

自定义请求头。你的目录被 Cloudflare 保护，或需要 API Key 时，在添加目录表单的"Custom Headers"框中按每行一个Header-Name: value的格式填写：

CF-Access-Client-Id: your-client-id CF-Access-Client-Secret: your-client-secret

自建目录端点。Calibre 的命令行方式示例：

calibre-server --enable-lending --lending-url http://[IP]:8080

自签名证书开关只对桌面端（Tauri）客户端生效；Web 版访问目录会经过 Readest 服务器代理，表单会让你确认这一点。目录列表支持拖拽排序，删除目录不会删除已下载的书。

⚠️ 避坑指南

• 现象：添加目录时报"Failed to load OPDS feed: 404/500"原因：URL 指向了 HTML 首页而非 OPDS 端点办法：确认地址以/opds或.opds结尾，先用浏览器打开，能看到 XML 或 JSON 才算端点正确

• 现象：Web 版提示"Adding LAN addresses is not supported"原因：Web 版不支持局域网地址办法：用桌面版或手机版直连本机 Calibre

• 现象：桌面端浏览正常，下载时报 TLS 证书错误原因：原生下载器不走系统证书库办法：在目录编辑中开启"Allow Self-Signed Certificate"

• 现象：误开了自动下载原因：开关开启后有 5 秒保护窗口，到点才触发同步办法：窗口内再点一次即取消；已触发的可在卡片上查看"Last synced"与失败条数，点失败数进入重试列表

• 现象：同一本书被重复导入原因：手动导入的书没有来源映射办法：通过目录下载或自动下载获取，Readest 按目录加来源 URL 去重

• 现象：目录账号没有同步到另一台设备原因：凭证同步默认关闭办法：在"设置 → 同步"中开启凭证同步，再填写账号密码

收尾

Readest 的 OPDS 目录把在线书源变成图书馆的一部分：浏览、下载、收听、自动订阅一次配齐。更多细节见 OPDS 服务实现 与 图书馆模块。

【免费下载链接】readestReadest is a modern, feature-rich ebook reader designed for avid readers offering seamless cross-platform access, powerful tools, and an intuitive interface to elevate your reading experience.项目地址: https://gitcode.com/gh_mirrors/re/readest