NAS私享无损音乐库：Docker一键部署SQMusic全攻略

April 4, 2026

此前分享的「道理鱼音乐」方案，曾收到不少朋友反馈，对音源获取感到棘手。本期将为你介绍一个能够轻松解决此问题的项目。

SQMusic项目核心功能解析

项目的完整名称为59799517/simple_sq_music_plus，你可以在GitHub上进行搜索。

这是一款专为NAS设计的音乐下载工具，当然，你也可以将其作为普通的音乐下载器使用。它支持多种音频格式，包括flac、ape、mp3等（具体取决于所选码率）。下载后的歌曲目录结构经过专门优化，能够完美适配Emby与Subsonic（后续开放）等媒体服务器。同时，工具还支持自动识别文件标签信息并下载歌词，堪称一站式解决方案。音乐下载完成后，几乎无需任何额外处理即可直接导入你的媒体库。

该工具默认支持为Emby和Jellyfin添加第三方音乐服务标识，具体配置方法请参考其官方文档。

其生成的文件树结构清晰明了：

\音乐下载根目录
    \歌手名称
        \专辑名称
            1- 歌曲1.flac
            2- 歌曲2.flac

详细部署指南：以威联通NAS为例

我们将以威联通NAS为平台，通过Docker Compose的方式完成部署。

以下为完整的部署代码。内容较长，除了需要将后端服务中的文件路径修改为你自己的实际路径外，其余部分基本可以照搬使用：

services:
  # 后端服务
  sqmusic_main:
    image: registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus:v3.0.28
    container_name: sqmusic_main
    environment:
      - DB_IP=mysql
      - DB_PORT=3306
      - DB_NAME=sqmusicv3  # 需与下方数据库配置保持一致
      - DB_USERNAME=root
      - DB_PASSWORD=sqmusicv3 # 需与下方数据库配置保持一致，可自行修改
    volumes:
      - /share/media/music:/music # 请修改为你的音乐存储目录
    depends_on:
      mysql:
        condition: service_healthy
    networks:
      - sq-app-network
    expose:
      - "8099"
    restart: always

  # 前端Web服务
  sqmusic_web:
    image: registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus_web:v3.0.15
    container_name: sqmusic_web
    ports:
      - "8222:80" # 冒号前的端口号可自行定义
    networks:
      - sq-app-network
    depends_on:
      - sqmusic_main
    restart: always

  # 数据库服务
  mysql:
    image: mysql:5.7
    container_name: sqmusic_mysql
    environment:
      - MYSQL_DATABASE=sqmusicv3 # 需与后端服务配置一致
      - MYSQL_ROOT_PASSWORD=sqmusicv3 # 需与后端服务配置一致，可自行修改
    volumes:
      - /share/Container/sqmusic/mysql_data:/var/lib/mysql # 可更换为其他路径
    networks:
      - sq-app-network
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: always

networks:
  sq-app-network:
    driver: bridge