jbonjean/volumio

Volumio Docker镜像（x86架构）

镜像概述

该Docker镜像基于Volumio项目构建，专为x86架构设备提供音乐播放功能。镜像源代码托管于https://github.com/jbonjean/docker-public-images，上游项目包括https://github.com/volumio/Volumio2-UI和https://github.com/volumio/Volumio2。

核心功能与特性

• x86架构支持：针对x86平台优化，可在PC、服务器等x86设备上运行
• 音乐播放功能：支持本地音乐文件播放，基于MPD（音乐播放器守护进程）
• 数据持久化：通过挂载数据卷保存配置信息和播放状态
• Web管理界面：通过3000端口提供Web访问界面，方便控制音乐播放
• 灵活音频输出：支持直接音频设备访问或Pulseaudio音频输出

使用场景

• 个人或家庭音乐中心，在x86设备上快速部署音乐播放系统
• 需要隔离环境运行Volumio的场景
• 轻量级音乐服务部署，避免在主机系统直接安装依赖

使用方法与配置说明

基本运行方式（直接音频设备输出）

bash
docker run --restart=always -d --name volumio \
    -e HOST=http://192.168.1.1:3000 \
    -p 3000:3000 \
    -v ${MUSIC_DIR}:/var/lib/mpd/music/:ro \
    -v ${VOLUMIO_DATA_DIR}:/data \
    --device /dev/snd \
    docker.xuanyuan.run/jbonjean/volumio

参数说明：

• -e HOST：Web界面访问地址
• -p：端口映射，将容器3000端口映射到主机3000端口
• -v ${MUSIC_DIR}:/var/lib/mpd/music/:ro：挂载本地音乐目录（只读），需将${MUSIC_DIR}替换为实际音乐文件目录
• -v ${VOLUMIO_DATA_DIR}:/data：挂载数据目录，用于持久化配置，需将${VOLUMIO_DATA_DIR}替换为实际数据目录
• --device /dev/snd：允许容器访问主机音频设备

Pulseaudio支持方式

bash
docker run --restart=always -d --name volumio \
    -e HOST=http://192.168.1.1:3000 \
    -p 3000:3000 \
    -v ${MUSIC_DIR}:/var/lib/mpd/music/:ro \
    -v ${VOLUMIO_DATA_DIR}:/data \
    -v $(readlink $HOME/.config/pulse/$(cat /etc/machine-id)-runtime):/pulse:ro \
    -e PULSE_SERVER=unix:/pulse/native \
    -e PULSE_COOKIE_DATA="$(cat $HOME/.config/pulse/cookie)" \
    -e HOST_USER=$(id -u):$(id -g) \
    -e AUDIO_OUTPUT=pulse \
    jbonjean/volumio

Pulseaudio路径调整

Pulseaudio socket位置可能因Linux发行版不同而变化，常见调整方案：

• 较新系统：-v /run/user/$(id -u)/pulse:/pulse:ro
• 根据实际系统Pulseaudio配置调整挂载路径

访问与使用

启动容器后，通过浏览器访问http://<主机IP>:3000即可打开Volumio Web管理界面，进行音乐库管理和播放控制。