用 simple_sq_music_plus 搭建属于你的私有音乐库-Gstory's Blog

在数字音乐时代，我们越来越依赖流媒体平台。但你是否也曾担心某天喜欢的歌曲突然下架？或者希望拥有一个完全由自己掌控、可离线播放、还能与家庭影音系统（如 Emby 或 Jellyfin）无缝集成的本地音乐库？
今天，就来介绍一款开源利器 —— simple_sq_music_plus，它不仅能帮你从主流平台高质量下载音乐（支持 FLAC、APE、MP3 等格式），还能自动按 “歌手/专辑/歌曲” 的规范目录结构组织文件，并嵌入完整的元数据（ID3 标签）和歌词，完美兼容 Emby、Jellyfin 等媒体服务器！

🎵 什么是 simple_sq_music_plus？

simple_sq_music_plus 是一个基于 Web 的音乐下载与管理工具，专为构建私有音乐库而设计。其核心特性包括：
✅ 支持多格式音频下载（FLAC、APE、MP3，根据源码率智能选择）
✅ 自动按歌手/专辑/序号-歌曲名.扩展名结构组织文件
✅ 内嵌完整 ID3 标签（艺术家、专辑、封面、年份等）
✅ 自动下载并嵌入歌词（LRC 格式）
✅ 完全兼容 Emby / Jellyfin 的媒体识别规范
✅ 提供 Web 管理界面，支持歌单、专辑、歌手批量同步
✅ 基于 Docker 部署，开箱即用
💡 默认账号密码均为 admin，首次登录后请务必修改！

📁 目录结构示例（Emby/Jellyfin 友好）

/Music
└── 周杰伦
    └── 范特西
        ├── 01- 爱在西元前.flac
        ├── 02- 爸我回来了.flac
        └── 03- 简单爱.flac

这种结构正是 Emby 官方推荐的音乐命名规范，确保媒体服务器能正确识别专辑、艺术家并生成精美的封面墙。

🐳 快速部署：使用 Docker Compose（推荐）

项目已容器化，部署极其简单。只需三步：

1. 创建 docker-compose.yml

version: '3.8'

services:
  sqmusic_mysql:
    image: mysql:5.7
    container_name: sqmusic_mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: sqmusicv3password
      MYSQL_DATABASE: sqmusicv3
    volumes:
      - ./mysql_data:/var/lib/mysql
    networks:
      - sq-app-network

  sqmusic_main:
    image: registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus:v3.0.8
    container_name: sqmusic_main
    restart: always
    environment:
      DB_IP: sqmusic_mysql
      DB_PORT: 3306
      DB_NAME: sqmusicv3
      DB_USERNAME: root
      DB_PASSWORD: sqmusicv3password
    volumes:
      - ./music:/music  # 你的音乐将保存在此目录
    depends_on:
      - sqmusic_mysql
    networks:
      - sq-app-network

  sqmusic_web:
    image: registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus_web:v3.0.5
    container_name: sqmusic_web
    restart: always
    ports:
      - "8996:80"
    networks:
      - sq-app-network

networks:
  sq-app-network:
    driver: bridge

2. 启动服务

docker-compose up -d

3. 访问 Web 界面

打开浏览器，访问：http://你的服务器IP:8996
使用默认账号 admin / admin 登录，开始配置你的音乐下载任务！

4.自定义网络

如果要使用自定义网络、已有的数据库，则修改为以下

services:
  sqmusic_main:
    image: registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus:v3.0.26
    container_name: sqmusic_main
    environment:
      DB_IP: mysql地址
      DB_PORT: 3306
      DB_NAME: sqmusicv3
      DB_USERNAME: root # mysql账号
      DB_PASSWORD: sqmusicv3password # mysql密码
    volumes:
      - ./music:/music  # 你的音乐将保存在此目录
    network_mode: bridge
    ports:
      - 8099:8099
    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:
      - 8996:80
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
    network_mode: bridge
    restart: always
    depends_on:
      - sqmusic_main

sqmusic_web挂载出nginx文件，修改后端端的地址

...
    # 定义后端服务器
    upstream sqmusic_main {
        server 你的sqmusic_main容器地址:8099 weight=10 max_fails=3 fail_timeout=60s;
        keepalive 32;
    }
...

🔄 自动升级脚本

项目提供 check_update.sh 脚本（位于 script/ 目录），可定期检查新版本并提醒更新，保持功能最新。

✅ 总结
simple_sq_music_plus 不仅仅是一个音乐下载器，它是一个完整的私有音乐生态系统构建工具。无论你是 NAS 用户（如群晖）、家庭影院爱好者，还是希望摆脱流媒体束缚的音乐发烧友，它都能帮你打造一个：

高音质
结构规范
元数据完整
可长期保存
的个人音乐宝库。
🌟 开源地址：https://github.com/59799517/simple_sq_music_plus
📦 镜像仓库：阿里云容器镜像服务（已提供）
现在就部署起来，把音乐真正“拿回自己手中”吧！

目录CONTENT

用 simple_sq_music_plus 搭建属于你的私有音乐库