sweisgerber/mopidy

Mopidy (Docker镜像)

基于https://github.com/linuxserver/docker-baseimage-alpine%E3%80%81https://github.com/mopidy%E4%BB%A5%E5%8F%8Ahttps://github.com/jaedb/Iris%E6%9E%84%E5%BB%BA%E3%80%82%E9%95%9C%E5%83%8F%E5%90%8C%E6%97%B6%E5%8F%91%E5%B8%83%E4%BA%8Ehttps://hub.docker.com/r/sweisgerber/mopidy%E3%80%82

建议与snapcast配合使用，示例参考：https://github.com/sweisgerber/mopiroom%E3%80%82

镜像概述与主要用途

该镜像提供Mopidy音频服务器功能，集成Iris Web客户端，支持音频文件播放、网络音频源接入及音频流管理。通过FIFO输出音频至snapcast，实现网络内多设备音频流传输与播放，适用于构建家庭或小型网络音频系统。

核心功能与特性

• Iris Mopidy Client：内置Iris Web客户端，可作为snapclient流播放器并管理snapserver
• FIFO音频流输出：支持通过FIFO（命名管道）将音频从Mopidy传输至snapcast
• s6-overlay进程管理：采用基础镜像提供的s6-overlay实现可靠的进程管理
• 轻量级设计：基于Alpine Linux，体积小，资源占用低

使用场景与适用范围

• 家庭网络音频系统：集中管理本地音乐文件和网络音频源，流式传输至多个房间的snapclient设备
• 小型办公或商业场所：实现背景音乐播放与管理
• 需要扩展音频源的场景：支持安装多种Mopidy扩展（如Beets、YTMusic、TuneIn等），扩展音频来源

使用方法与配置说明

推荐使用docker-compose

复杂配置下推荐使用docker-compose，以下为示例配置：

yaml
version: "3"
services:
  mopidy:
    image: docker.io/sweisgerber/mopidy:alpine
    hostname: mopidy
    environment:
      - PUID=1000 # Mopidy服务运行的用户ID，需有权限访问音乐文件
      - PGID=1000 # Mopidy服务运行的组ID，需有权限访问音乐文件
      - TZ=Europe/Berlin # 时区设置
      # 安装扩展相关环境变量（参考：https://github.com/linuxserver/docker-mods/tree/universal-package-install）
      - DOCKER_MODS=linuxserver/mods:universal-package-install # 启用通用包安装模块
      - INSTALL_PIP_PACKAGES=Mopidy-Beets|Mopidy-dLeyna|Mopidy-InternetArchive|Mopidy-TuneIn|Mopidy-YTMusic # 通过pip安装的Mopidy扩展（竖线分隔）
      # - INSTALL_PACKAGES=mopidy-podcast # 可选，通过系统包管理器安装的扩展
    restart: "unless-stopped" # 除非手动停止，否则自动重启
    ports:
      - 6600:6600 # MPD远程控制端口
      - 6680:6680 # HTML API及Web界面端口（用于访问Mopidy和Iris）
    # devices:
    # - /dev/snd:/dev/snd # 可选，如需输出到主机音频设备需启用
    volumes:
      - $MOPIROOM_FOLDER/config/:/config/ # 配置文件目录
      # 数据目录，包含Mopidy配置的FIFO位置（参考：https://github.com/sweisgerber/docker-mopidy/blob/main/root/defaults/mopidy.conf）
      # FIFO用于snapcast流式传输，工作流程：Mopidy→文件系统FIFO→SnapServer→局域网流→SnapClient
      # mopidy.conf中音频输出配置示例：
      # [audio]
      # output = (...) location=/data/audio/snapcast_fifo
      - $MOPIROOM_FOLDER/data/:/data/ 
      - $MOPIROOM_FOLDER/:/music/:ro # 本地音乐文件目录（只读，可选，需播放主机音频文件时启用）
# 建议配合snapcast使用，snapcast配置参考：https://github.com/sweisgerber/docker-snapcast/blob/main/docker-compose.example.yml

关键配置说明

环境变量

• PUID/PGID：指定运行Mopidy服务的用户和组ID，确保对挂载的音乐文件有访问权限
• TZ：设置时区，影响日志时间等
• DOCKER_MODS：启用universal-package-install模块以安装扩展
• INSTALL_PIP_PACKAGES：通过pip安装的Mopidy扩展，多个扩展用|分隔
• INSTALL_PACKAGES：可选，通过系统包管理器安装的扩展

端口映射

• 6600：MPD远程控制端口，用于音频播放器控制
• 6680：Web界面和API端口，用于访问Iris客户端和Mopidy API

卷挂载

• /config/：存储Mopidy配置文件，包括扩展设置、音频输出配置等
• /data/：存储运行时数据，核心是FIFO文件，用于音频流传输至snapcast
• /music/：本地音乐文件目录（只读），可选，需播放主机本地音频时挂载

扩展安装

通过INSTALL_PIP_PACKAGES或INSTALL_PACKAGES环境变量可安装额外Mopidy扩展，扩展列表可参考Mopidy官方扩展库。

与snapcast配合使用

该镜像设计用于与snapcast配合，实现多设备音频同步播放。snapcast服务端（SnapServer）读取Mopidy输出的FIFO音频流，通过局域网传输至snapcast客户端（SnapClient），实现多房间音频同步。