woahbase/alpine-mpd

alpine-mpd

镜像概述

alpine-mpd是基于多架构Alpine Linux的Docker镜像，集成S6进程管理系统、Music Player Daemon (MPD) 和yMPD Web界面。该镜像旨在提供轻量级、跨硬件平台的音乐播放解决方案，适用于个人或小型环境的音乐服务部署。

核心功能与特性

• 多架构支持：提供x86_64、aarch64、armv7l、armhf、i386、ppc64le、riscv64、s390x等架构版本，适配从PC到嵌入式设备的多种硬件环境。
• 轻量级基础：基于Alpine Linux构建，镜像体积小，系统资源占用低，适合资源受限环境。
• S6进程管理：采用S6进程管理框架，确保MPD及相关服务稳定运行、可靠重启和进程监控。
• MPD核心组件：集成Music Player Daemon，支持多种音频格式播放，提供音乐库管理、播放列表、音频输出控制等核心功能。
• yMPD Web界面：内置yMPD轻量级Web管理界面，通过浏览器即可实现音乐播放控制、曲目切换、音量调节等操作。

使用场景与适用范围

• 个人音乐服务器：搭建本地音乐库，通过网络访问和管理个人音乐收藏。
• 家庭媒体中心：作为家庭多媒体系统的音乐播放模块，与其他媒体服务协同工作。
• 嵌入式设备部署：在树莓派、ARM开发板等嵌入式设备上运行，提供本地化音乐播放功能。
• 开发测试环境：快速构建MPD服务原型，用于音乐播放相关应用的开发与测试。

使用方法与配置说明

基本运行命令

通过以下命令启动容器，映射必要端口并挂载音乐目录：

bash
docker run -d \
  --name alpine-mpd \
  -p 6600:6600 \  # MPD服务端口
  -p 8080:8080 \  # yMPD Web界面端口
  -v /本地音乐目录:/music \  # 挂载本地音乐文件
  -v /本地配置目录:/etc/mpd \  # 挂载MPD配置文件(可选)
  -v mpd_data:/var/lib/mpd \  # 持久化MPD数据(播放列表、缓存等)
  woahbase/alpine-mpd

Docker Compose配置示例

yaml
version: '3'
services:
  alpine-mpd:
    image: woahbase/alpine-mpd
    container_name: alpine-mpd
    ports:
      - "6600:6600"  # MPD服务端口
      - "8080:8080"  # Web界面端口
    volumes:
      - /home/user/music:/music  # 本地音乐库目录
      - ./mpd-config:/etc/mpd    # 自定义配置目录
      - mpd_data:/var/lib/mpd    # 数据持久化卷
    restart: unless-stopped

volumes:
  mpd_data:  # 自动创建命名卷存储MPD数据

关键配置说明

端口映射

目录挂载

MPD配置自定义

如需修改MPD默认配置，可在本地创建mpd.conf文件并挂载到/etc/mpd/mpd.conf。常用配置项：

conf
music_directory "/music"          # 音乐文件目录(默认已配置)
playlist_directory "/var/lib/mpd/playlists"  # 播放列表目录
db_file "/var/lib/mpd/tag_cache"  # 音乐库标签缓存
bind_to_address "0.0.0.0"         # 允许所有网络访问
port "6600"                       # MPD服务端口
audio_output {                    # 音频输出配置示例
  type "alsa"
  name "Local Audio"
}

Web界面访问与使用

容器启动后，通过浏览器访问 http://<主机IP>:8080 打开yMPD Web界面，可实现：

• 按艺术家、专辑、曲目分类浏览音乐库
• 控制播放状态(播放/暂停、上一曲/下一曲)
• 调整音量与播放模式(随机、循环等)
• 管理播放列表(创建、编辑、加载)

维护与支持

该镜像由WOAHBase维护，相关资源参考：

• 官方文档：WOAHBase alpine-mpd文档
• 镜像仓库：https://hub.docker.com/r/woahbase/alpine-mpd
• 源代码：https://github.com/woahbase/alpine-mpd