Skip to content

1. 扫描与并发控制

对于海量有声书库,扫描速度和系统负载之间的平衡至关重要。

扫描并发数

  • 作用:控制系统同时处理多少个扫描任务(文件夹或文件)。
  • 调优建议
    • 低功耗设备(如老旧 NAS 或软路由):建议将并发数设置为 12,以防止内存溢出(OOM)或 CPU 满载导致系统卡顿。
    • 高性能服务器(如多核 CPU + SSD):可以适当提高并发数(如 4 或更高),以大幅缩短海量书库的初始扫描时间。

任务超时时间

  • 作用:控制单个扫描或刮削任务的最长允许执行时间。
  • 调优建议:如果您的网络环境不稳定(例如挂载了海外网盘或网络较差的 WebDAV),建议适当延长超时时间(例如 300 秒或更长),避免因网络波动导致大文件扫描失败。

2. 网络与服务端口

您可以自定义系统对外的服务端口,以适应复杂的网络部署环境。

自定义服务端口

  • 作用:修改系统默认监听的 HTTP 端口(默认为 8098)。
  • 适用场景
    • 当您的服务器上已经运行了其他占用 8098 端口的服务时。
    • 当您需要通过反向代理(如 Nginx、Lucky)配置多个内部服务时。
  • 注意事项:修改端口后,请确保您在 Docker 的 docker-compose.yml 中也同步更新了端口映射规则,并重启容器。

3. 其他底层配置

临时文件清理策略

  • 作用:系统在刮削封面、解析音频标签时会产生临时文件。您可以配置系统闲置时自动清理这些文件的频率。
  • 调优建议:对于存储空间有限的设备,建议开启“闲置时自动清理”,以避免临时文件占用过多空间。

数据库模式(WAL)

  • 作用:控制 SQLite 数据库的写入模式。开启 WAL 模式可以显著提升高并发下的读写性能。
  • 调优建议:默认已开启,对于极少数不支持 WAL 模式的文件系统,您可以在此关闭。