audioserve Docker镜像文档

镜像概述

本Docker镜像包含最新发布版本的audioserve音频流式传输服务器，旨在提供便捷的音频文件流式传输服务。audioserve是一款轻量级工具，可将本地或网络存储的音频文件通过HTTP流式传输到客户端，并支持Web界面访问与播放控制。

核心功能与特性

• 最新版本集成：内置audioserve的最新稳定发布版本，确保包含最新功能与安全更新
• 多格式支持：兼容MP3、FLAC、WAV、OGG等主流音频格式
• 实时转码：根据客户端需求动态转码音频文件，适配不同网络环境与设备性能
• Web界面：提供直观的Web管理界面，支持音频文件浏览、播放控制及播放列表管理
• 安全认证：支持基于密钥的访问控制，防止未授权访问
• 轻量级设计：低资源占用，适合在嵌入式设备（如树莓派）及服务器环境部署

使用场景与适用范围

• 个人音频库管理：将本地音频文件通过服务器流式传输至手机、平板等多设备访问
• 家庭媒体中心：构建家庭内部音频流服务，实现多设备共享音频资源
• 小型团队共享：用于团队内部音频资料（如语音记录、播客）的便捷共享与访问
• 低功耗设备部署：适用于树莓派等嵌入式设备，作为轻量级音频服务节点

使用方法与配置说明

基本部署命令

bash
docker run -d \
  --name audioserve \
  -p 8000:8000 \
  -v /path/to/your/audio/files:/audio \
  izderadicka/audioserve \
  --audio-dir /audio

参数说明：

• -p 8000:8000：端口映射，将容器内8000端口映射至主机8000端口
• -v /path/to/your/audio/files:/audio：挂载主机音频目录至容器内/audio路径
• --audio-dir /audio：指定audioserve的音频文件根目录（需与挂载路径一致）

带认证的安全部署

通过--auth-key参数或AUTH_KEY环境变量设置访问密钥：

bash
docker run -d \
  --name audioserve \
  -p 8000:8000 \
  -v /path/to/your/audio/files:/audio \
  -e AUTH_KEY=your_secure_access_key \
  izderadicka/audioserve \
  --audio-dir /audio --auth-key your_secure_access_key

访问Web界面时需输入密钥进行验证。

自定义配置示例

指定端口与转码设置：

bash
docker run -d \
  --name audioserve \
  -p 8888:8888 \
  -v /path/to/your/audio/files:/audio \
  izderadicka/audioserve \
  --audio-dir /audio --port 8888 --transcode "mp3:128k" --log-level debug

配置参数说明

Web界面访问

服务启动后，通过浏览器访问 http://<主机IP>:<端口>（如 http://localhost:8000）即可打开Web界面，浏览音频文件并进行播放控制。