飞牛 NAS (fnOS) 部署指南

Leelaa Reader 已上架飞牛应用商店，您可以实现一键部署与自动更新。

1. 商店安装（推荐）

最简单的方式，适合绝大多数用户。

步骤说明

1. 打开应用商店：登录飞牛 NAS 后台，点击桌面上的「应用商店」。
2. 搜索应用：在搜索栏输入 leelaa 或 有声书，找到 有声书 应用。
3. 点击安装：点击应用卡片下方的「安装」按钮。
4. 配置参数：
   • 应用端口：设置有声书服务的访问端口（默认 8686）。
   • 用户数据状态：
     • 已有用户：如果您的数据库中已经创建过账号，请选择此项。
     • 没有用户：首次安装或重装且需要创建管理员账号，请选择此项。
   • 初始管理员账号：仅在“没有用户”时生效，默认为 admin。
   • 初始管理员密码：仅在“没有用户”时生效。如果不填写，系统将自动生成随机密码，并在启动后写入数据目录下的 password.txt。
   • 数据库存放路径：可选。留空则自动使用系统分配的应用共享目录；若需手动指定，请输入绝对路径（如 /vol1/1000/docker/leelaa）。
5. 启动应用：安装完成后，在桌面点击图标即可打开。

2. Docker Compose 部署（进阶）

如果您更喜欢通过 Docker Compose 手动管理，可以使用以下配置。

Docker 镜像支持 linux/amd64（x86_64）与 linux/arm64（ARM64/aarch64）。飞牛设备通常会自动拉取匹配架构；如果启动后日志出现 exec format error，请在 docker-compose.yml 的服务下添加 platform: linux/amd64 或 platform: linux/arm64。

目录结构建议

建议在 NAS 的 Docker 共享文件夹下创建如下结构：

/vol1/1000/docker/leelaa/
├── docker-compose.yml
└── data/               # 自动生成的数据库文件存放处

docker-compose.yml 示例

services:
  leelaa-reader:
    image: leedaisen/leelaa-reader-server:latest
    container_name: leelaa-reader
    ports:
      - "8686:8686"
    volumes:
      - ./data:/data  # 重要：持久化数据目录
    environment:
      - DEFAULT_ADMIN_USERNAME=admin
      - DEFAULT_ADMIN_PASSWORD=请设置强密码
      - TZ=Asia/Shanghai
    restart: unless-stopped

DEFAULT_ADMIN_PASSWORD 可不传；不传时首启会自动生成随机密码，并写入 /data/password.txt。

如需强制指定架构，在 image 下一行加入：

    platform: linux/amd64 # x86_64 设备使用；ARM64/aarch64 设备改为 linux/arm64

挂载路径说明

容器内路径	说明	建议挂载方式
/data	核心数据目录 (SQLite 数据库、封面缓存)	必须挂载 到本地持久化目录

数据持久化方案

Leelaa Reader 使用 SQLite 数据库存储所有元数据和进度信息。所有数据文件都位于容器内的 /data 目录下。

• 备份：只需备份宿主机的 ./data 目录即可完整备份整个应用状态。
• 迁移：将 ./data 目录复制到新机器，并挂载到相同位置即可无缝迁移。