书屿连接 Calibre 内容服务器：把电脑书库带到 iPad

如果你平时用 Calibre 管理电子书，可以通过它的内容服务器把书库提供给书屿。这样手机端能浏览书籍资料，再按需下载。这里的“同步书库”首先是取得目录与元数据，不能直接等同于把电脑上的所有文件搬进 iPad。

先让内容服务器确实可访问

在运行 Calibre 的电脑上按其功能开启内容服务器，确认实际监听地址和端口，并使用你配置的账号。电脑需要保持服务运行，不能因为 Calibre 窗口曾经打开过，就认为它在关机或休眠后仍可访问。第一次建议让电脑和 iPad 位于同一可信网络。

准备一本文字为主的 EPUB，确认它在 Calibre 书库中能正常打开。先用另一台设备访问内容服务器页面，确认账号有权查看这本书。书屿端的 Calibre 私有书库功能需要藏书家 Pro；服务器是否运行、账号权限和 App 权益需要分别检查。

在书屿选择 Content Server 方式

进入「设置」→「Calibre 书库」，点添加。在书库来源类型中选择 Content Server，填写书库名称、服务器地址和需要的用户名、密码。示例地址可能形如 http://192.168.1.20:8080，端口必须以你实际设置为准，不要把电脑本机使用的 localhost 填给另一台设备。

若服务部署在反向代理子路径下，应保留正确前缀。地址应指向该 Calibre 内容服务，而不是 NAS 管理后台或其他网页。凭据填写专用栏位，避免嵌入链接。保存后若提示是否另存为 OPDS 书源，可以根据自己是否需要轻量目录入口选择；这不是必须建立两套重复书库的要求。

同步元数据，再浏览具体书籍

在已配置书库上使用「立即同步」或相应同步入口，等待结果。查看提示中的书籍数量和最近同步时间，再打开「浏览书库」。这一步主要确认服务能够提供书名、作者、格式和其他目录资料；看到几百本封面，不代表几百本正文已经下载。

选中刚才的练习书，核对作者与可用格式。若本机已经有同一记录，目录刷新可能更新相关资料；尚未入库的书需要按实际界面选择同步记录或下载。不要把元数据刷新当作替换本地阅读文件，更不要在确认内容前删除原有书籍记录。

下载合适格式并进行阅读检查

在书籍操作中选择可读格式下载，首次优先 EPUB 或 PDF。若出现导入预览，确认重复或合并建议是否符合实际版本关系。完成后返回本地书架，打开正文、跳到一个靠后章节，再退出重开。文件能在服务器端打开，只说明源文件正常，手机端仍需验证下载结果。

接着临时关闭网络，检查已经下载的这一本。没有下载的条目仍需要服务器，不能把缓存目录当成离线全集。若你计划一次带走五本书，逐本确认下载完成，并至少抽查开头和后半部分；目录同步数量不是离线文件数量。

给电脑书库和手机记录划清边界

Calibre 是你的书籍管理来源，书屿还保存自己的阅读进度、笔记和标签。内容服务器的浏览与下载负责取得书籍，阅读资料的同步另有入口，操作时先看清处理的是哪一类内容。即使某个版本显示更高级的双向操作，也应先阅读该入口的范围与确认提示，不要默认手机上的全部修改都会安全地回写电脑。

对正在使用的主书库，先保持电脑端的既有备份方式。一次只验证一本书的资料更新，更容易发现字段差异。若同一本作品有两个译本或修订版，应保留明确的版本标识，不要仅因名称相似就在导入预览中合并。

常见连接问题的检查顺序

无法连接时，先确认电脑没有休眠、内容服务器仍在运行，再检查地址、端口和网络。认证失败时查看内容服务器账户配置，而不是使用电脑系统登录密码反复尝试。目录可读但下载失败时，检查具体书籍格式、访问权限和服务返回内容。

如果更换了服务器地址，先编辑或明确区分连接名称，避免书库列表出现多个难以辨认的副本。反向代理返回 HTML 登录页时，App 可能无法按预期读取目录或文件；应由服务配置提供兼容的访问方式，不能靠把网页后缀改成电子书后缀解决。

常见问题

电脑关机后为什么看得见封面却不能读新书？ 封面和目录可能已缓存在本机，未下载的文件仍依赖内容服务器在线。已经完成本地下载的书应单独做离线验证，不要根据封面判断服务器状态。

Content Server 和 metadata.db 方式选哪个？ 已有稳定内容服务器时，可以用本篇方式；如果 NAS 保存的是完整 Calibre 书库目录，也可考虑数据库方式。它们需要的地址和路径不同，不能把数据库文件路径填入服务器 URL 栏。

同步会把所有电子书传到开发者服务器吗？ 书屿的公开定位是访问你自己的私人书库。本篇流程连接的是你配置的 Calibre 服务；目录和阅读数据的保存范围仍应按相应功能说明理解，不要把私人连接误认为公共云书库。

资料与版本

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