trevorj/mopidy-extras

镜像概述

本镜像基于Ubuntu官方镜像构建，是容器化的Mopidy音乐服务器，支持MPD客户端和HTTP客户端访问，包含所有官方插件及流行扩展，可轻松添加新插件，且以app用户身份运行以提升安全性。

核心功能

后端扩展

• 标准：DLNA(dLeyna)
• Spotify（需Premium账户）
• Google Play Music（支持2步验证的应用专用密码）
• SoundCloud（需认证令牌）

• ---

• AudioAddict（高级账户可提升音质）

前端扩展

• 标准：MPD、HTTP
• Scrobbler（音乐记录）
• API Explorer（接口调试）
• Local-Images（本地封面显示）
• Material-Webclient、Mopify等多款网页客户端
• Webhooks、Notifier等功能扩展

使用场景

1. 本地音乐文件的索引与播放
2. 流媒体平台（Spotify、***等）的音乐播放
3. 通过控制台客户端（如ncmpcpp）管理音乐
4. 通过网页客户端（如Material-Webclient）可视化操作

配置说明

PulseAudio网络设置（音频输出）

1. 安装PulseAudio Preferences：sudo apt-get install paprefs
2. 打开paprefs → "Network Server"标签 → 勾选"Enable network access to local sound devices"（可选"Don't require authentication"避免cookie挂载）
3. 重启PulseAudio：sudo service pulseaudio restart或pulseaudio -k && pulseaudio --start

部署示例

Docker Run命令

sh
docker run --rm trevorj/mopidy-extras host run \
      -o spotify/username='你的Spotify账户' -o spotify/password='你的密码' \
      -o gmusic/username='你的Google账户' -o gmusic/password='应用专用密码' \
      -o soundcloud/auth_token='你的SoundCloud令牌' \
      | bash

Docker Compose示例

sh
docker-compose run --service-ports mopidy \
      -o spotify/username='你的Spotify账户' -o spotify/password='你的密码' \
      -o gmusic/username='你的Google账户' -o gmusic/password='应用专用密码' \
      -o soundcloud/auth_token='你的SoundCloud令牌'

关键配置项

• 端口：6600（MPD服务）、6680（HTTP服务）
• 环境变量：PULSE_SERVER（PulseAudio服务器地址）、PULSE_COOKIE_DATA（PulseAudio cookie的十六进制编码）
• 卷映射：/app/Music（本地音乐目录）、/app/.local/share/mopidy（元数据存储目录）

本地文件播放示例

1. 赋予本地音乐目录权限：chgrp -R 29 /path/to/music && chmod -R g+r /path/to/music
2. 索引本地文件：docker run --rm trevorj/mopidy-extras host run mopidy local scan | bash
3. 启动服务器后访问：http://你的主机IP:6680

MPD客户端示例（ncmpcpp）

启动服务器后运行：docker run --rm -it wernight/ncmpcpp ncmpcpp --host 你的主机IP

反馈

若有问题或需要添加扩展，请在GitHub仓库提交issue：https://github.com/wernight/docker-mopidy/issues