快速开始

Leelaa Reader 是一个自托管的有声书平台。你只需要把自己的有声书音频文件放在 NAS/网盘（支持 WebDAV）里，就可以在手机/电脑上随时在线播放、续播与同步进度。

🚀 部署方式

1. 飞牛 NAS (fnOS) 应用商店安装 (推荐)

如果你使用的是飞牛 NAS，可以通过应用商店实现一键部署与自动更新。

1. 打开应用商店：登录飞牛 NAS 后台，进入「应用商店」。
2. 搜索应用：在搜索栏输入leelaa找到 有声书。
3. 点击安装：找到应用后点击「安装」。
4. 配置参数：
   • 网络：设置外部访问端口（默认为 3000）。
   • 存储：将容器内的 /data 目录映射到 NAS 的本地文件夹，用于持久化存储数据库。
5. 启动应用：安装完成后，在桌面点击图标即可打开。

---

2. Docker 部署

适用于所有支持 Docker 的环境（Linux、群晖、威联通、Windows/Mac 等）。

使用 Docker Run 启动

docker run -d \
  --name leelaa-reader \
  -p 3000:3000 \
  -v /path/to/data:/data \
  -e TZ=Asia/Shanghai \
  --restart unless-stopped \
  admin8756/leelaa-reader:latest

使用 Docker Compose (推荐)

创建 docker-compose.yml 文件：

version: '3'
services:
  leelaa-reader:
    image: admin8756/leelaa-reader:latest
    container_name: leelaa-reader
    ports:
      - "3000:3000"
    volumes:
      - ./data:/data
    environment:
      - TZ=Asia/Shanghai
    restart: unless-stopped

运行 docker-compose up -d 即可启动。

---

🚩 首次初始化 (3 分钟)

1. 获取账号密码：
   • 系统首次启动时，会自动创建一个默认管理员账号。
   • 账号信息会直接打印在 Docker 日志中。
   • 使用命令查看日志：docker logs leelaa-reader。
2. 登录：访问 http://服务器IP:3000，使用日志中的账号密码登录。
3. 获取机器码 (Server ID)：访问 /activate 页面查看你的设备唯一 ID。
4. 购买与激活：联系作者微信（Yay_ls）发送机器码，购买并获取激活码后在激活页输入（支持 14 天全功能试用）。
5. 添加储存库：进入「储存库管理」页面添加你的 WebDAV 配置。
6. 开始刮削：点击「开始刮削」，系统会自动识别音频文件并抓取元数据，等待刮削任务完成即可开始听书。

---

🔒 远程访问与 SSL 配置 (推荐)

为了能够在外网安全访问，并启用 PWA (添加到桌面) 功能，强烈建议配置反向代理并启用 SSL (HTTPS)。

1. 申请 SSL 证书

• 自动申请 (推荐)：使用 Lucky 或 Nginx Proxy Manager 等工具，可以一键申请 Let's Encrypt 免费证书并自动续期。
• 手动申请：在阿里云、腾讯云等云服务商后台申请免费的半年/一年期 DV 证书，下载后上传至服务器。

2. 反向代理配置

方法 A：使用 Lucky (NAS 用户推荐)

Lucky 是一款非常适合 NAS 用户的反向代理工具，界面直观，支持自动证书申请。

1. 添加规则：进入 Lucky 的「反向代理」模块，添加 Web 服务规则。
2. 配置后端：
   • 监听端口：设置你希望在公网访问的端口（如 443 或 8443）。
   • 目标地址：http://127.0.0.1:3000 (如果 Lucky 与 Leelaa Reader 在同一台机器)。
3. 开启 SSL：在安全配置中勾选「启用 HTTPS」，并选择你申请的证书。

方法 B：使用 Nginx

在你的 Nginx 配置文件中添加以下内容：

server {
    listen 443 ssl;
    server_name your.domain.com;

    ssl_certificate /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # 支持 WebSocket (SSE 需要)
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

---

📱 移动端最佳体验 (PWA)

为了获得原生 App 般的流畅体验（沉浸式全屏、更稳定的后台播放、系统媒体控制），强烈建议将 Leelaa Reader 作为 PWA (Progressive Web App) 添加到手机桌面。

🍎 iOS (iPhone / iPad)

1. 使用 Safari 浏览器 打开 Leelaa Reader 网址。
2. 点击浏览器底部的 “分享” 按钮（向上箭头的方块）。
3. 在弹出的菜单中向下滚动，找到并点击 “添加到主屏幕”。
4. 点击右上角的 “添加”。

🤖 Android

1. 使用 Chrome 浏览器 或系统自带浏览器打开网址。
2. 点击右上角的 “三个点” 菜单图标。
3. 找到 “安装应用” 或 “添加到主屏幕”。
4. 根据提示点击 “安装”。

你会喜欢的点

• 不用折腾文件上传，直接对接 NAS/WebDAV 的现有目录。
• 播放器支持倍速、睡眠定时、跳过片头片尾，适合长时间听书。
• 书籍元数据自动抓取：支持喜马拉雅在线刮削，也可从本地文件/音频标签提取。
• 播放进度跨设备自动同步。