扫描很慢？扫描性能优化指南

扫描速度主要取决于您的 存储介质 和 连接方式。Leelaa Reader 针对不同场景提供了不同的优化策略。

1. 不同存储模式的速度预期

本地存储 (Local Storage)

性能表现：速度最快，几乎无延迟。
预期速度：取决于您的 NAS 硬盘性能（如 NVMe SSD），读取速度最高可达 4GB/s。
适用场景：飞牛原生应用或 Docker 挂载本地硬盘。

内网 WebDAV (LAN WebDAV)

性能表现：非常快，受限于网络带宽。
预期速度：取决于您的网口规格。例如，千兆网口理论上限为 125MB/s，万兆网口则更快。
适用场景：通过 WebDAV 连接同一局域网内的其他 NAS 或服务器。

云端网盘 (Cloud Storage)

性能表现：受限于公网带宽、网盘 API 限制及风控策略。
优化建议：强烈建议在存储库设置中开启「网盘模式」。

2. 核心优化策略

🚀 开启「网盘模式」（针对云端 WebDAV）

如果您连接的是公有云盘，或通过第三方工具把网盘转出为 WebDAV，开启「网盘模式」可以带来以下好处：

大幅提升刮削速度：优化了文件头（Metadata）的读取逻辑，减少不必要的网络请求。
降低风控风险：通过减少高频次的 API 调用，有效避免触发网盘服务商的流量封锁或封号风险。

📂 优化目录结构

层级不宜过深：建议将根目录直接设在存放书籍的父级目录下，避免扫描大量无关的深层文件夹。
规范书籍存放：遵循「一文件夹即一本书」的原则，可以显著提高扫描器的识别效率。

🔍 调整扫描深度

在存储库设置中，可以根据实际需求调整 「扫描深度」。如果您书籍存放得很规整，降低深度可以减少扫描器在深层空目录中的无效徘徊。

3. 常见性能误区

“测试连接”快不代表扫描快：测试连接只检查目录列表，而扫描需要读取音频文件头（如时长、码率等信息）。
首次扫描 vs 增量扫描：首次全量扫描需要建立索引并触发刮削，耗时较长是正常的。后续增量扫描只会处理变动部分，速度会非常快。

如果您的扫描任务长时间卡住或进度异常缓慢，请查看 info.log 确认是否有网络请求超时的报错。