OPDS 书源连不上？本地网络权限与 calibre 认证模式修复

书源类故障九成出在两条：系统本地网络权限、calibre 认证模式。逐条对号。

症状一：iOS 或 macOS 连不上家里局域网书源

家里路由器上的书源（私有地址、.local 主机名、自建 calibre 服务器）在 iPhone 或 Mac 上死活连不上，浏览器却能打开——基本就是系统的本地网络权限拦的。

修复：iOS、iPadOS 或 macOS 15+ 进系统设置的隐私与安全性 → 本地网络，把 Readest 打开。列表里找不到 Readest 时，先在应用里打开一次任意书源让系统记录请求，再回来授权。公网书源（如 Standard Ebooks）不经本地网络，不需要这项权限。

症状二：带密码的 calibre 服务器报 400

报错形如「加载订阅源失败：400 Bad Request」，关掉 calibre 的登录验证又能连——把 calibre 的认证模式改为 basic 即可。

修复：calibre 偏好设置 → 通过网络分享 → 高级，把认证模式设为 basic，重启内容服务器；命令行启动的加对应认证模式参数后重启。然后 Readest 里用原地址原凭据重连。

官方同时提醒：basic 认证的密码传输是可逆编码的，建议只在可信局域网或套了 https 的服务器上用。书源添加的完整流程见OPDS 书源订阅。

症状三：凭据填了但换设备要重填

书源地址同步到所有设备，用户名密码属于加密凭据，只随「凭据」类目走：开启类目、设置同步密码短语、其他设备输入同一短语后自动带过去，见按类目管理同步。

症状四：自动下载没生效

每个书源卡片的自动下载是独立开关，且首次开启需要确认；卡片上有最近同步时间与失败计数，失败集中时先手动打开该目录看是否需要重新登录。

还是不行

官方排障文档之外的渠道：社区论坛与仓库问题区检索同款报错，多数已有解；发帖时附上应用版本、系统版本与完整报错文本，回复率最高。