Leelaa Reader：自托管有声书管理与播放（飞牛 fnOS 适配 / 支持 WebDAV）
Leelaa Reader 是一套自托管的有声书管理与播放系统：把你的有声书放在 NAS/网盘（WebDAV）里，不需要上传到第三方平台，就能在手机/电脑,播放、续播，并在多设备间同步进度。
特色亮点
- WebDAV 原生支持：支持群晖、飞牛、AList、小雅等 WebDAV 源
- 自动扫描与刮削：递归扫描目录，识别书籍结构，抓取封面/作者/简介等元数据
- 播放进度同步：进度、收藏等写入 SQLite，换设备也能无缝续播
- 多用户：多账号共享同一服务，每个用户独立进度与收藏
- 现代化播放器：倍速、睡眠定时、片头/片尾跳转等
- 响应式 + PWA：手机端可“添加到桌面”，体验接近原生 App
- 部署简单：支持 fnOS 应用商店一键安装，也可 Docker 独立部署
在飞牛 fnOS 安装（推荐：应用商店）
- 登录 fnOS 后台，进入 应用商店
- 搜索
leelaa 或 有声书，找到 Leelaa Reader / 有声书
- 点击安装，并配置：
- 端口映射：默认
3000（例如外部仍用 3000:3000）
- 存储映射：把容器内
/data 映射到 NAS 本地目录（用于保存 SQLite 数据库与配置）
- 安装完成后，从桌面打开，访问：
http://飞牛IP:3000
Docker 部署（非 fnOS / 或更喜欢自定义的同学）
Docker Run
docker run -d \
--name leelaa-reader \
-p 3000:3000 \
-v /path/to/data:/data \
-e TZ=Asia/Shanghai \
--restart unless-stopped \
leedaisen/leelaa-reader-api:latest
Docker Compose
version: "3"
services:
leelaa-reader:
image: leedaisen/leelaa-reader-api:latest
container_name: leelaa-reader
ports:
- "3000:3000"
volumes:
- ./data:/data
environment:
- TZ=Asia/Shanghai
restart: unless-stopped
说明：
- 只需要持久化
/data，不要把有声书目录挂载进容器（本项目通过 WebDAV 读取）
首次使用（3 分钟）
- 获取默认管理员账号密码
- 首次启动会自动创建管理员
- 账号密码会输出在日志里
- Docker：
docker logs leelaa-reader
- fnOS：进入应用详情 → 查看日志
- 浏览器访问：
http://飞牛IP:3000 登录
- 进入 /activate 页面获取机器码（Server ID）
- 14 天全功能试用；需要永久授权可联系作者微信：
Yay_ls
- 进入「储存库管理」添加 WebDAV
- 点击「开始刮削/扫描」，等待完成即可开始听书
远程访问建议（强烈推荐）
如果你要外网访问 + PWA（添加到桌面），建议配置反代并启用 HTTPS：
- Lucky / Nginx Proxy Manager / Nginx 都可以
- 反代目标一般是：
http://127.0.0.1:3000
常见问题（FAQ 精简版）
- 扫描不到书：确认目录结构（建议“一书一文件夹”）、WebDAV 可连通、文件格式受支持（mp3/m4a/wav/flac 等）
- 扫描慢：控制递归深度、减少首扫目录范围、分批刮削
- 数据丢失：检查是否把容器
/data 做了持久化映射（强制要求）
更新日志 / 反馈
- 欢迎在帖子里反馈你遇到的问题（截图 + 日志更容易定位）
- 也欢迎提需求：播放器体验、刮削规则、fnOS 适配等都会持续优化
