Skip to content

模式选择:WebDAV 与网盘模式

在添加储存库时,您会看到“WebDAV 模式”和“网盘模式(不检查时长)”。这两种模式在底层原理上是不同的,请根据您的实际存储环境选择。

1. 标准 WebDAV 模式

  • 适用场景:您的有声书存放在支持原生 WebDAV 协议的 NAS(群晖、威联通等)、Nextcloud、或者坚果云等自建/原生服务中。
  • 工作机制:Leelaa Reader 在扫描与播放时,会尝试读取文件的音频头部信息(如 ID3 标签、封面、时长),以获取最精确的媒体数据。
  • 配置参数
    • 服务器地址 (URL):如 http://nas.local:5005/webdav(系统会自动补齐 http:// 协议头)。
    • 用户名:您的 WebDAV 账号。
    • 密码:您的 WebDAV 密码或应用独立密码。

2. 网盘模式 (Netdisk)

  • 适用场景:您的有声书存放在阿里云盘、百度网盘、夸克等公有云盘,并且已经通过第三方工具或文件共享服务转出为 WebDAV 协议。
  • 防风控机制(重要): 由于大多数第三方网盘对频繁的文件读取(特别是读取音频时长或频繁拉取文件头部)有极其严格的风控策略(可能导致账号被限速、封禁或频繁断连),网盘模式针对此场景进行了深度优化:
    • 跳过敏感探测:系统在扫描时不再主动请求读取音频头部与时长,仅通过文件名与目录结构获取基本元数据。
    • M4B 章节清单:如果目录内有轻量 metadata.json,可以用其中明确的分卷绑定来生成 M4B 章节。多分卷时,清单需提供每章对应的 file/path,或顶层 files[] 中每个分卷的 pathduration/duration_ms。只有全书时间轴时,系统不会按文件大小猜测章节归属。
    • 按需加载:只有在您点击播放或下载时,才会真正向网盘发起数据请求。
  • 配置建议如果您使用的是阿里云盘等公有云盘转出的 WebDAV,强烈建议您勾选“网盘模式”!

可视化连接与路径选择

与本地挂载一样,Leelaa Reader 支持 WebDAV/网盘模式的可视化路径选择

  1. 填写完地址、账号密码后,点击“验证连接”。
  2. 如果验证成功,系统会弹出远程文件浏览器,列出服务器上的目录。
  3. 您可以像在本地电脑上一样,一层层点进去,选中存放有声书的根目录(例如 /有声书/评书),然后点击保存。

注意事项

  • 避免挂载根目录:为了提高扫描速度,建议您挂载具体的有声书子目录,而不要直接挂载网盘的根目录(如 /)。
  • 稳定性推荐:为了获得最佳体验,优先使用系统或 NAS 自带 WebDAV,以及 Nextcloud、坚果云、123 网盘等原生 WebDAV 服务。第三方桥接工具适合作为过渡方案,稳定性通常不如原生 WebDAV。