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

April 4, 2026

之前分享的「道理鱼音乐」方案，很多朋友反馈在音源获取上遇到了困难。今天，就为大家介绍一个能轻松解决这个痛点的项目——SQMusic，让你一键下载并管理高品质音乐。

SQMusic 项目核心功能解析

这个项目的完整名称是 59799517/simple_sq_music_plus，你可以在 GitHub 上直接搜索找到它。

简单来说，SQMusic 是一款专为 NAS 环境打造的音乐下载工具，当然，你也可以把它当作一个强大的本地音乐下载器来用。它支持多种主流音频格式，包括 FLAC、APE、MP3 等（具体取决于你选择的码率）。最方便的是，它下载的音乐文件会自动整理成清晰规范的目录结构，能够完美适配 Emby、Jellyfin 以及未来的 Subsonic 等主流媒体服务器。

此外，它还能自动识别并填充歌曲的元数据标签（如专辑、歌手、年份），并同步下载歌词，真正实现了“下载即入库”，为你省去了大量手动整理的繁琐工作。

小提示：工具默认支持为 Emby 和 Jellyfin 添加第三方音乐服务标识，具体配置方法可查阅项目官方文档。

它生成的文件结构一目了然，非常适合媒体库管理：

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

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

下面我们以威联通（QNAP）NAS 为例，使用 Docker Compose 来一步步完成部署。这种方式清晰、易于管理。

以下是完整的 docker-compose.yml 配置内容。你只需要将其中的文件存储路径替换成自己 NAS 上的实际目录，其他部分基本可以直接使用。

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" # 冒号前的 8222 是外部访问端口，可按需修改
    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