OPDS Source

使用 BookLore OPDS 书源

BookLore 可以把你的自建书库暴露为 OPDS 目录。离卷添加这个目录后，就能在手机上浏览、搜索和打开 EPUB 书籍。

准备条件

• BookLore 已部署并能在浏览器打开，例如 http://192.168.1.10:6060。
• BookLore 里已经创建书库，并完成 EPUB 扫描。
• 手机和 BookLore 服务器在同一网络，或 BookLore 已通过 HTTPS 域名暴露到外网。

1. 在 BookLore 开启 OPDS

1. 打开 BookLore 管理页面。
2. 进入 Settings > OPDS。
3. 开启 OPDS Server Enabled。
4. 复制 OPDS Catalog 地址，常见格式是 http://your-server:6060/api/v1/opds。

2. 创建 OPDS 专用用户

1. 仍在 Settings > OPDS 页面，找到 OPDS Users。
2. 点击 Add User。
3. 填写用户名、密码和默认排序方式。
4. 保存密码。BookLore 的 OPDS 密码创建后通常不能再次查看。

3. 在离卷添加书源

1. 打开离卷，进入 书架 > 添加书源 > OPDS。
2. 名称填写 BookLore 或你的书库名称。
3. 地址填写 BookLore 的 OPDS Catalog URL，例如 http://192.168.1.10:6060/api/v1/opds。
4. 认证方式选择账号密码，填入刚创建的 OPDS 用户。
5. 保存后进入书源，确认能看到书库、作者、系列或最近添加列表。

排查连接失败

• 先用手机浏览器打开 OPDS 地址，确认网络能访问。
• 确认 BookLore 的 OPDS 服务已开启，而不是只开启 Komga API。
• 确认使用的是 OPDS 用户，不是 BookLore 网页登录账号。
• 如果通过公网访问，优先使用 HTTPS，避免证书链不完整或反向代理路径错误。