Skip to content

快速开始

Leelaa Reader 是一个自托管的有声书平台。首次使用只需要完成三件事:

  1. 部署服务端;
  2. 登录并添加有声书储存库;
  3. 选择客户端连接服务。

这个页面只保留最短开始路径。完整命令、安装包和平台差异分别放在对应的二级页面中,避免与下载安装重复。

1. 选择服务端部署方式

如果暂时不确定选择哪一种,请先查看部署方式概览

两种方式最终都会启动同一个服务:

text
http://服务器IP:8686

Docker 镜像支持 linux/amd64linux/arm64。如果日志出现 exec format error,需要检查设备与镜像架构是否一致。

2. 完成首次初始化

部署完成后,在浏览器中打开服务地址:

text
http://服务器IP:8686

按下面的顺序完成初始化:

  1. 登录管理员账号
    • 首次数据库没有用户时,管理员用户名默认为 admin
    • 如果没有手动配置密码,系统会生成随机密码,并写入数据目录下的 password.txt
  2. 完成激活
    • 登录后根据页面提示进入激活页;
    • 复制当前设备的 Client ID;
    • 输入激活码并提交。
  3. 添加储存库
    • 本地模式:服务端可直接读取的本地目录或 Docker 挂载路径;
    • WebDAV 模式:NAS、Nextcloud、坚果云等 WebDAV 服务;
    • 网盘模式:通过第三方工具转换出的网盘 WebDAV;
    • RSS 播客订阅:添加播客 RSS 地址。
  4. 扫描书库
    • 启动扫描任务;
    • 等待书籍与章节出现在首页;
    • 打开任意书籍确认章节可以播放。

数据持久化

Docker 部署必须持久化挂载 /data。飞牛安装则需要确保应用对数据库目录具有读写权限。

3. 选择客户端

选择你正在使用的设备。每篇教程都包含下载安装、服务地址填写和登录连接步骤。

4. 远程访问与 HTTPS

远程访问时建议使用反向代理和 HTTPS,不要直接将未加密的服务端口暴露到公网。

常见方案包括:

  • Lucky;
  • Nginx Proxy Manager;
  • Nginx;
  • NAS 自带反向代理。

反向代理的目标通常为:

text
http://127.0.0.1:8686

完成后,客户端填写配置好的 HTTPS 域名即可。更具体的部署与网络问题可以查看常见问题

下一步

  • 查看下载安装,获取 Android、iOS、车机和 FPK 安装入口;
  • 查看功能介绍,了解书库、播放与用户管理;
  • 查看开放平台,使用已接入应用或开发第三方客户端;
  • 查看周边生态,配置 NFC 3D 钥匙扣与 Apple 快捷指令。