Xiaomusic完整安装指南：从Docker到pip多种部署方式详解

想要让小爱同学为你播放音乐吗？Xiaomusic是一个开源项目，专门用于让小爱同学播放音乐，音乐使用yt-dlp下载，支持多种部署方式。本指南将详细介绍Xiaomusic的完整安装过程，涵盖Docker容器化部署、pip包管理安装等多种方法，帮助你快速上手这个实用的音乐播放工具。

🚀 Xiaomusic项目简介

Xiaomusic是一个基于Python开发的智能音乐播放系统，它能够将你的小爱同学变成功能强大的音乐播放器。通过yt-dlp工具，你可以轻松下载各种平台的音乐资源，享受高质量的音乐体验。

📦 前置准备工作

在开始安装之前，请确保你的系统满足以下要求：

• 操作系统：支持Windows、Linux、macOS
• Python版本：Python 3.7及以上
• 网络环境：稳定的网络连接
• 小爱设备：可连接的小爱音箱设备

🐳 Docker容器化部署

方法一：使用官方Docker镜像

Docker是最简单的部署方式，无需配置复杂的Python环境：

docker pull xiaomusic:latest
docker run -p 5000:5000 xiaomusic

方法二：构建自定义Docker镜像

如果你想自定义配置或使用最新代码：

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic
cd xiaomusic
docker build -t xiaomusic-custom .
docker run -p 5000:5000 xiaomusic-custom

Docker Compose部署

对于生产环境，推荐使用Docker Compose：

version: '3'
services:
  xiaomusic:
    build: .
    ports:
      - "5000:5000"
    volumes:
      - ./config.json:/app/config.json

🐍 Python pip安装方式

方法一：从源码安装

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic
cd xiaomusic
pip install -r requirements.txt

方法二：直接安装

pip install xiaomusic

⚙️ 配置与初始化

基础配置

复制配置文件模板：

cp config-example.json config.json

编辑配置文件，设置你的小爱设备参数和音乐下载路径。

插件配置

Xiaomusic支持丰富的插件系统，你可以在plugins/目录下找到各种功能插件，如HTTP请求、音量控制等。

🎵 使用指南

Web界面访问

部署完成后，通过浏览器访问 http://localhost:5000 即可进入控制面板。

功能特点

• 智能音乐下载：使用yt-dlp自动下载高质量音乐
• 多设备支持：可连接多个小爱音箱设备
• 播放控制：支持播放、暂停、上一首、下一首等操作
• 播放列表管理：轻松创建和管理个人播放列表

🔧 常见问题解决

端口冲突问题

如果5000端口被占用，可以修改映射端口：

docker run -p 8080:5000 xiaomusic

网络连接问题

确保小爱音箱与部署Xiaomusic的设备在同一局域网内。

📚 进阶配置

自定义音乐源

在配置文件中可以添加自定义音乐源，扩展音乐资源。

定时任务配置

通过crontab.py可以设置自动更新音乐库等定时任务。

💡 使用技巧

1. 快速搜索：使用控制面板的搜索功能快速找到想听的歌曲
2. 播放模式：支持随机播放、单曲循环等多种播放模式
3. 设备切换：轻松在不同的小爱设备间切换播放

🎉 总结

通过本指南，你已经掌握了Xiaomusic的多种部署方式。无论是使用Docker的便捷部署，还是通过pip的灵活安装，都能让你快速享受到小爱同学带来的音乐盛宴。

记住，Xiaomusic的核心优势在于其简单易用的界面和强大的音乐下载能力，让你的智能音箱焕发新的活力！