Docker 安装

适用于 Linux x86_64 / aarch64 的 Docker。使用管理员密码登录，在挂载目录内选择输入与输出；飞牛原生目录弹窗和 NAS 账号登录使用 FPK 安装。

导入镜像

先在下载中心核对 Docker 交付状态。取得匹配 NAS 架构的镜像归档及 .sha256 文件后，在归档目录核对并导入：

sha256sum -c leelaa-audio-split-*.tar.sha256
docker load -i <音轨工厂镜像归档.tar>

当前提供本地候选归档，尚未发布公共镜像。导入后镜像名为 leelaa-audio-split:local。源码构建入口为仓库根的 pnpm build:docker，构建要求见项目 README。

选择目录和端口

将下面内容保存为安装目录中的 compose.yaml：

yaml

name: leelaa-audio-split
services:
  audio-split:
    image: leelaa-audio-split:local
    pull_policy: never
    init: true
    restart: unless-stopped
    read_only: true
    cap_drop: [ALL]
    security_opt: [no-new-privileges:true]
    stop_grace_period: 30s
    ports:
      - "${AUDIO_PORT:-8692}:8692"
    volumes:
      - data:/data
      - cache:/cache
      - type: bind
        source: ${AUDIO_INPUT_DIR:?请设置 AUDIO_INPUT_DIR 为源音频目录}
        target: /input
        read_only: true
        bind:
          create_host_path: false
      - type: bind
        source: ${AUDIO_OUTPUT_DIR:?请设置 AUDIO_OUTPUT_DIR 为输出目录}
        target: /output
        bind:
          create_host_path: false
      - type: bind
        source: /etc/machine-id
        target: /run/host/machine-id
        read_only: true
        bind:
          create_host_path: false
    tmpfs:
      - /tmp:rw,noexec,nosuid,size=64m
volumes:
  data:
  cache:

输入与输出目录必须已存在。应用以 UID/GID 10001:10001 运行，需有输入读取权限和输出写入权限。在同一终端设置路径并启动：

export AUDIO_INPUT_DIR=/your/nas/audiobooks
export AUDIO_OUTPUT_DIR=/your/nas/split-output
export AUDIO_PORT=8692
docker compose --project-directory . -f compose.yaml up -d

打开 http://NAS地址:8692/。AUDIO_PORT 只调整宿主端口，容器内部仍为 8692。目录在应用中显示为 input 和 output，源目录只读，结果写入新任务文件夹。路径或权限有误时，先修正再启动；只给选定目录授权。

首次登录

初始账号为 admin，随机密码自动生成在持久卷。设备管理员在自己的终端查看：

docker compose -f compose.yaml exec audio-split cat /data/bootstrap-admin.txt

登录后更换初始密码，明文文件随即删除。随后在授权中心处理软件授权，再开始切割。容器日志不输出初始密码。

更新与备份

导入新归档后，在相同安装目录，保留 Compose 项目名及目录设置，执行：

docker compose -f compose.yaml up -d --force-recreate

data 卷保存管理员、许可安装身份、平台连接和任务记录，备份前停止应用并备份整个卷。cache 卷只保存可再生的音频分析与试听暂存。输入和输出文件独立保存在宿主目录。

docker compose down 保留数据卷；docker compose down -v 会删除管理员、许可记录和历史，执行前先备份。移除容器不删除宿主的输入与输出文件。

设备身份与恢复

Compose 只读挂载 Linux 宿主 /etc/machine-id。同机重建时保留此挂载和 data 卷，可延续安装身份；标识缺失或无效时拒绝启动，不回退到临时容器 ID。不要复制其他设备的标识文件。

数据全清后的本机恢复和设备更换使用授权恢复与迁移；公开设备标识本身不能取得授权。Docker 与 FPK 是独立安装，正式 Auth、设备迁移和实际 NAS 权限仍需对应环境验收。

Docker 安装 ​

导入镜像 ​

选择目录和端口 ​

首次登录 ​