Skip to content

1. 扫描与并发控制 ​

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

扫描并发数 ​

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

任务超时时间 ​

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

识别有声书所需的最少媒体文件数 ​

  • 作用:目录里至少要有多少个媒体文件,才会被识别成一本书。
  • 默认值:5,范围 1~100。
  • 说明:只影响重启后新启动的扫描;不会自动删除或重新分类已经入库的书籍。单文件 M4B 仍按专门规则识别,不受此阈值限制。

2. 网络与服务端口 ​

当前服务端口由启动环境决定,高级设置只显示正在监听的端口,不能从页面改写容器或反向代理的端口映射。

  • 本地开发默认显示 3000。
  • 标准 Docker默认显示 8686。
  • 保存其他高级设置时,不会附带修改端口。
  • 如果需要改对外端口,请修改部署环境中的 PORT、容器端口映射或反向代理,然后重启服务。

3. 转码与读取上限 ​

FFmpeg 转码 ​

  • 使用开关开启或关闭,不必输入 0 或 1。
  • 默认开启;保存后需重启服务才生效。

单章节最大读取量 ​

  • 页面以 MB 显示,范围 1~100 MB,默认 25 MB。
  • 保存时仍按字节写入,兼容旧配置;未改动的历史值不会被顺便改写。

4. 其他底层配置 ​

临时文件清理策略 ​

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

数据库模式(WAL) ​

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

恢复默认只影响可以编辑的项;只读的运行端口会保持当前值。需要重启的配置继续在服务启动时生效。