greencashew/audioserve

AudioServe 多架构 Docker 镜像

镜像概述

支持的架构

• amd64
• armv8 (ARM64)

核心功能与特性

AudioServe 是一个简单的个人音频文件服务器，主要用于有声书，也支持任何具有良好目录结构的音频文件。其设计专注于简洁性和极简主义：

• 服务器采用 Rust 编写，性能高效
• 集成默认 Web 客户端（HTML5 + JavaScript），适用于现代浏览器（最新版 Firefox 或 Chrome）
• 提供 https://github.com/izderadicka/audioserve-android 及自定义客户端 API
• 支持多音频集合管理、搜索缓存、TLS 加密等功能

使用场景与适用范围

• 个人有声书库管理与流式播放
• 家庭网络内音频文件共享
• 需跨设备（电脑、手机）访问音频内容的场景
• 对服务器资源占用有要求的轻量级部署需求

使用方法与配置说明

Docker 快速启动

简单示例

bash
docker run -d --name audioserve -p 3000:3000 -v /本地音频目录:/audiobooks greencashew/audioserve --no-authentication /audiobooks

启动后访问 http://localhost:3000 即可浏览音频集合。此为最小化配置，仅用于测试，生产环境需添加认证等参数。

详细配置示例

bash
docker run -d --name audioserve -p 3000:3000 \
    -v /本地音频集合1:/collection1 \
    -v /本地音频集合2:/collection2 \
    -v /本地数据目录:/home/audioserve/.audioserve \
    -e AUDIOSERVE_SHARED_SECRET=你的密码 \
    greencashew/audioserve \
    --ssl-key /audioserve/ssl/audioserve.p12 --ssl-key-password 密钥密码 \
    --search-cache \
    /collection1 /collection2

配置说明：

• -v /本地音频集合1:/collection1：挂载多个音频集合目录
• -v /本地数据目录:/home/audioserve/.audioserve：持久化存储服务器运行数据（密钥、缓存等）
• -e AUDIOSERVE_SHARED_SECRET=你的密码：设置客户端认证共享密钥
• --ssl-key/--ssl-key-password：启用 TLS 加密（镜像内置测试用自签名证书，生产环境需替换为自有证书）
• --search-cache：启用目录结构缓存以加速搜索，并监控目录变化

Docker Compose 配置

yaml
version: '3.3'
services:
    audioserve:
        container_name: audioserve
        ports:
            - '3000:3000'
        environment:
            - AUDIOSERVE_SHARED_SECRET=你的密码
        volumes:
            - '/mnt/audiobooks/:/audiobooks'
        image: greencashew/audioserve
        restart: always
        command: --search-cache /audiobooks

参数说明

命令行参数

bash
audioserve [FLAGS] [OPTIONS] [BASE_DIR]...

标志（FLAGS）

• --allow-symlinks：允许跟随集合目录中的符号链接
• --cors：启用 CORS - 允许任何来源的请求
• -d, --debug：启用调试日志（详细日志可通过 RUST_LOG 环境变量配置）
• --disable-folder-download：禁用整个文件夹下载的 API 端点
• -h, --help：显示帮助信息
• --no-authentication：无需认证 - 主要用于测试
• --print-config：打印当前配置（含所有选项），用于生成配置文件
• --search-cache：缓存集合目录结构以加速搜索，并监控目录变化
• --thread-pool-large：使用更大的线程池（通常不需要）
• -V, --version：显示版本信息

选项（OPTIONS）

• --chapters-duration <分钟数>：长文件按章节展示时，每章时长（默认 30 分钟）[环境变量：AUDIOSERVE_CHAPTERS_FROM_DURATION]
• --chapters-from-duration <分钟数>：将大于指定时长的音频文件拆分为章节（仅逻辑拆分，默认 0 即禁用）[环境变量：AUDIOSERVE_CHAPTERS_FROM_DURATION]
• -c, --client-dir <路径>：客户端文件目录（index.html 和 bundle.js）[环境变量：AUDIOSERVE_CLIENT_DIR]
• -g, --config <路径>：YAML 格式的配置文件 [环境变量：AUDIOSERVE_CONFIG]
• --data-dir <路径>：audioserve 数据目录（缓存、状态等，默认 $HOME/.audioserve）[环境变量：AUDIOSERVE_DATA_DIR]
• -l, --listen <地址:端口>：服务器监听地址和端口（默认 0.0.0.0:3000）[环境变量：AUDIOSERVE_LISTEN]
• --positions-file <路径>：保存上次收听位置的文件 [环境变量：AUDIOSERVE_POSITIONS_FILE]
• --secret-file <路径>：服务器密钥文件（不存在则自动生成，默认 $HOME/.audioserve.secret）[环境变量：AUDIOSERVE_SECRET_FILE]
• -s, --shared-secret <密钥>：客户端认证共享密钥 [环境变量：AUDIOSERVE_SHARED_SECRET]
• --shared-secret-file <路径>：包含共享密钥的文件（比命令行参数更安全）[环境变量：AUDIOSERVE_SHARED_SECRET_FILE]
• --ssl-key <路径>：TLS/SSL 私钥和证书（PKCS#12 格式，提供则启用 HTTPS）[环境变量：AUDIOSERVE_SSL_KEY]
• --ssl-key-password <密码>：TLS/SSL 私钥密码 [环境变量：AUDIOSERVE_SSL_KEY_PASSWORD]
• --thread-pool-keep-alive-secs <秒数>：线程池空闲线程存活时间（默认永久）[环境变量：AUDIOSERVE_THREAD_POOL_KEEP_ALIVE]
• --token-validity-days <天数>：认证令牌有效期（默认 365 天，最小 10 天）[环境变量：AUDIOSERVE_TOKEN_VALIDITY_DAYS]
• -x, --transcoding-max-parallel-processes <数量>：最大并发转码进程数（默认 2 * CPU 核心数）[环境变量：AUDIOSERVE_MAX_PARALLEL_PROCESSES]
• --transcoding-max-runtime <小时数>：转码进程最大运行时间（默认 24 小时）[环境变量：AUDIOSERVE_TRANSCODING_MAX_RUNTIME]

参数（ARGS）

• <BASE_DIR>...：音频集合根目录（可指定多个）[环境变量：AUDIOSERVE_BASE_DIRS]

作者

项目由 https://github.com/izderadicka 创建

来源

• https://github.com/greencashew/audioserve/blob/master/.github/workflows/publish-on-docker.yml
• https://github.com/greencashew/audioserve
• https://github.com/izderadicka/audioserve