1、XiaoMusic简介

XiaoMusic 是一个音乐服务应用，允许用户将音频文件导入到容器中进行管理，支持多种音频格式（如 MP3、WAV、FLAC 等），支持使用小爱音箱播放NAS中的音乐。

2、使用 Docker Compose 部署容器

在 UGOS Pro 系统上，推荐使用项目 Docker Compose 快速部署容器，适合需同时管理多个容器的场景，这种方法简化了容器的部署与管理工作。以下是使用 Docker Compose 部署 XiaoMusic 的详细步骤。

点击了解：什么是项目（Docker Compose）？

2.1 进入 Docker 项目界面

在 UGOS Pro 系统中，打开 Docker 应用，点击【项目】 > 【创建】，启动项目创建向导。

2.2 配置 Docker Compose 文件

在项目创建向导中，您需要上传 Docker Compose 配置文件。以下是 XiaoMusic 的示例配置：

services:
  xiaomusic:
    image: hanxi/xiaomusic
    container_name: xiaomusic
    restart: always
    volumes:
      - /volume5/music:/app/music
      - ./conf:/app/conf
    environment:
      - XIAOMUSIC_PORT=39981 #后台设置里的【访问端口】，修改后可以不用重启。
    ports:
      - 39981:39981

2.3 参数说明

image：指定要使用的 Docker 镜像及其版本，latest 表示拉取最新版本。

restart：定义容器重启策略，always当容器停止或崩溃时自动重启。

volumes：

./conf:/app/conf

./ 表示当前 Docker Compose 文件所在的目录，将宿主机的 ./conf 目录挂载到容器内的 /app/conf 目录，这个目录保存了所有的配置文件。

/volume5/music:/app/music

将NAS的音乐文件目录映射到容器的 /app/music，便于容器访问和管理音乐文件。这里请替换 /volume5/music 为 您在NAS上实际的音乐存储路径，例如 /volume1/Music。

相关阅读

【FAQ】如何在 Docker Compose 配置文件中正确表示 volumes 挂载路径？

environment：

XIAOMUSIC_PUBLIC_PORT：配置后台设置里的【外网访问端口】，修改后可以不用重启。

ports：将宿主机的 39981 端口映射到容器的 39981 端口，这是 xiaomusic 的 Web 服务访问端口。

3、部署项目

确认配置文件无误后，点击【立即部署】按钮，系统将自动拉取镜像并启动容器。部署完成后，您可以通过浏览器访问 http://<NAS_IP>:39981（例如：http://192.168.22.153:39981）来访问XiaoMusic 的 Web 登录界面。

3.1 镜像下载失败处理方法：

Docker 镜像加速器：建议配置加速器以提高下载速度，特别是在中国内地的网络环境下。参考《Docker配置镜像加速和镜像源》了解如何设置。

代理设置：在某些情况下，您可能需要配置 HTTP/HTTPS 代理来辅助下载，详见《Docker通过设置代理下载镜像》。

4、访问 XiaoMusic Web 界面

要访问 XiaoMusic 的 Web 界面并使用小爱音箱操控面板，请按照以下步骤操作：

1. 访问 Web 登录界面
   在浏览器中输入 http://<NAS_IP>:39981 以打开 XiaoMusic 的 Web 登录界面。
   请确保将 <NAS_IP> 替换为您的 NAS 设备的实际 IP 地址。

1. 选择操控面板主题
   在 Web 登录界面中，您可以选择不同的主题来定制小爱音箱操控面板。这里推荐使用 Pure 主题，它提供简洁和直观的操作界面。选择您喜欢的主题后，点击访问。

2. 查看功能介绍
   进入小爱音箱操控面板后，您将看到面板的功能介绍。这些介绍帮助您了解如何通过小爱音箱进行操作和控制。如果您选择了 Pure 主题，还可以在面板上查看详细的功能介绍，了解如何使用各种控制选项。

1. 启用小爱音箱功能
   为了启用小爱音箱操控功能，您需要在设置中勾选要使用的小爱音箱设备。保存设置后，您就可以开始通过小爱音箱来播放 XiaoMusic 的音乐。

1. 设置公网访问与安全防护
   如果您已配置 XiaoMusic 的公网访问功能，请务必在账号设置中开启 密码验证，并设置一个复杂的密码。这样可以有效避免因账号密码泄露导致的安全风险，确保您的账户安全。

2. 更多功能与支持
   如果您想了解更多关于 XiaoMusic 的功能或获取技术支持，您可以访问 XiaoMusic 的 GitHub 项目页面。在 GitHub 页面上，您可以查阅到项目的源代码、文档和开发者社区的讨论。

5、注意事项

请注意，本教程中的镜像由第三方开发和维护，教程仅供参考。绿联不承担因用户操作不当、第三方软件漏洞或镜像更新引发的风险，包括但不限于：

· 第三方镜像可能导致您在 UGOS Pro 系统中的文件意外修改或删除。

· 使用不安全的镜像可能导致数据上传至第三方服务器，存在隐私和数据泄露风险。

· 为确保系统稳定和数据安全，请谨慎选择可信来源的第三方镜像。

其他注意事项：

1. 容器的文件/文件夹路径仅供参考，您可以根据个人习惯创建。

2. 网页访问的容器端口和本地端口应保持一致。如有冲突，请改为未使用的端口。容器之间的本地端口不能相同，端口冲突会导致无法启动容器。

3. 容器的网页链接仅在 bridge 桥接模式下可访问。

4. 镜像仅提供搭建教程，具体使用方法和深度玩法请网上搜索参考。

5. 镜像由第三方开发，具体配置变动和 bug 修复请关注相关官方信息。

6. 建议将 Docker 配置目录存储在 SSD 硬盘中，以避免机械硬盘影响系统性能。