无损音乐库自建指南：SQMusic Docker部署与使用教程

April 4, 2026

在之前的分享中，我们介绍了音乐自建方案，但音源获取常常成为用户头疼的问题。今天，我们将为大家介绍一个名为SQMusic的项目，它能够轻松解决无损音乐下载和管理的难题。

项目简介与功能特性

该项目名为59799517/simple_sq_music_plus，可在GitHub上搜索获取。SQMusic是一款专为NAS设计的音乐下载工具，它不仅支持常见的音频格式如FLAC、APE、MP3（码率可调），还能自动整理下载的歌曲目录结构，兼容Emby和Subsonic等服务。此外，它提供文件标签识别和歌词下载功能，实现从下载到入库的一站式管理。默认支持Emby和Jellyfin等第三方音乐服务标识，具体配置请参考其官方文档。典型的文件树结构示例如下：

\Music下载根路径       \歌手名称              \专辑名称                      1- 歌曲1.flac                      2- 歌曲2.flac

Docker Compose部署指南

下面以威联通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  
  # 前端服务  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

部署时，请打开威联通的Container Station，创建新的应用程序。成功部署后，系统将运行三个容器。如果镜像拉取遇到问题，建议检查网络或联系项目维护者。