SqMusic无损音乐下载工具完整部署指南：在NAS上搭建私人音乐库

SqMusic是一款开源的音乐资源下载与管理工具，专为音乐爱好者设计。与普通下载工具不同，它支持多种音频格式，包括MP3、FLAC、APE等无损格式，让您能够享受更高质量的音乐体验。通过Docker容器化部署，可以在NAS设备上快速搭建私有的音乐下载平台。

项目采用微服务架构，包含三个核心组件：

主应用服务：处理音乐搜索和下载逻辑
Web前端：提供用户友好的操作界面
MySQL数据库：存储用户配置和下载记录

这种设计确保了系统的稳定性和可扩展性，适合长期使用。

系统部署详解

环境准备

设备要求：威联通NAS或其他支持Docker的NAS设备
存储空间：建议至少10GB可用空间用于存储音乐文件
网络环境：稳定的互联网连接，用于访问音乐平台API

Docker Compose配置

以下是完整的部署配置文件，保存为docker-compose.yml：

version: '3.8'
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=sqmusicv3password
    volumes:
      - /share/Container/sqmusic/file:/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:
      - "8096:80"
    networks:
      - sq-app-network
    depends_on:
      - sqmusic_main
    restart: always

  mysql:
    image: docker.1ms.run/mysql:5.7
    container_name: sqmusic_mysql
    environment:
      MYSQL_ROOT_PASSWORD: sqmusicv3password
      MYSQL_DATABASE: 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