rfabri/mopidy

Mopidy Docker镜像文档

概述

该Docker镜像为https://github.com/RoggerFabri/mopidy-icesnap%E9%A1%B9%E7%9B%AE%E7%9A%84%E7%BB%84%E6%88%90%E9%83%A8%E5%88%86%EF%BC%8C%E5%9F%BA%E4%BA%8EMopidy%E9%9F%B3%E4%B9%90%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84%E9%9F%B3%E4%B9%90%E6%B5%81%E5%AA%92%E4%BD%93%E6%9C%8D%E5%8A%A1%E5%AE%B9%E5%99%A8%E5%8C%96%E9%83%A8%E7%BD%B2%E6%96%B9%E6%A1%88%E3%80%82Mopidy%E4%BD%9C%E4%B8%BA%E5%BC%80%E6%BA%90%E9%9F%B3%E4%B9%90%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E7%A7%8D%E9%9F%B3%E4%B9%90%E6%BA%90%EF%BC%88%E6%9C%AC%E5%9C%B0%E6%96%87%E4%BB%B6%E3%80%81%E7%BD%91%E7%BB%9C%E6%9C%8D%E5%8A%A1%E7%AD%89%EF%BC%89%EF%BC%8C%E7%BB%93%E5%90%88icesnap%E5%8A%9F%E8%83%BD%E5%8F%AF%E5%AE%9E%E7%8E%B0%E9%9F%B3%E9%A2%91%E6%8D%95%E6%8D%89%E4%B8%8E%E6%B5%81%E5%AA%92%E4%BD%93%E4%BC%A0%E8%BE%93%E3%80%82

核心功能与特性

• Mopidy核心集成：支持本地音乐文件、网络音乐服务等多源音乐播放与管理
• icesnap功能：提供音频捕捉与流媒体传输能力，支持音频流定向输出
• 容器化部署：简化环境配置，提升跨平台部署与迁移效率
• 可扩展架构：兼容Mopidy插件生态，支持功能扩展

使用场景

• 个人/家庭音乐服务器：构建私有音乐库，实现多设备访问
• 小型网络音乐服务：为办公环境或社区提供音乐流媒体服务
• 开发测试环境：用于Mopidy插件开发或音乐服务功能验证

使用方法

基础部署

通过docker run命令快速启动容器：

bash
docker run -d \
  --name mopidy-icesnap \
  -p 6680:6680 \  # Mopidy Web界面端口
  -p 8000:8000 \  # icesnap流媒体输出端口
  -v /本地音乐目录:/music \  # 挂载本地音乐文件
  -v /本地配置目录:/config \  # 挂载配置文件目录
  roggerfabri/mopidy-icesnap

Docker Compose配置

创建docker-compose.yml实现配置持久化：

yaml
version: '3'
services:
  mopidy-icesnap:
    image: roggerfabri/mopidy-icesnap
    container_name: mopidy-icesnap
    ports:
      - "6680:6680"  # Web管理界面
      - "8000:8000"  # 流媒体传输端口
    volumes:
      - ./music:/music  # 本地音乐文件映射
      - ./config:/config  # 配置文件持久化
    restart: unless-stopped

启动服务：docker-compose up -d

配置说明

配置文件

在挂载的/config目录下创建mopidy.conf自定义配置：

ini
[core]
cache_dir = /config/cache
config_dir = /config
data_dir = /config/data

[http]
enabled = true
port = 6680
hostname = 0.0.0.0

[icesnap]
enabled = true
port = 8000
# 其他icesnap相关参数配置

环境变量

支持通过环境变量覆盖默认配置：

• MOPIDY_HTTP_PORT：Web界面端口（默认6680）
• ICESNAP_PORT：流媒体端口（默认8000）
• MUSIC_VOLUME：音乐目录挂载路径（默认/music）

注意事项

• 确保挂载目录具有读权限，避免音乐文件访问失败
• 首次启动自动生成默认配置，可通过修改mopidy.conf进行个性化设置
• 集成第三方音乐服务（如Spotify）需在配置文件中添加对应API凭证