音乐项目部署教程：飞牛（fnOS）Docker 搭建 + 接入 Jellyfin 实现统一管理
今天再分享一个音乐类项目，支持在线搜索、播放与下载，并且可以与 Jellyfin 整合，实现统一媒体管理。
本文记录在 飞牛（fnOS）环境下通过 Docker Compose 部署的完整流程，以及如何将下载的音乐接入 Jellyfin。
一、视频教程地址
本文对应的视频包含完整部署与演示过程：
👉 视频播放地址：
如果你更习惯看视频，可以直接观看；如果想按步骤部署，可以继续阅读。
二、部署环境说明
系统：飞牛（fnOS）
部署方式：Docker Compose
其他 NAS 系统同样可参考
三、创建项目目录
首先在系统中创建一个用于存放数据的目录，例如：
/music
用于存放：
音乐下载文件
封面
歌词
四、使用 Docker Compose 部署
1️⃣ 新建 Compose 项目
打开 Docker
进入 Compose
新增项目
填写项目名称
选择刚才创建的目录
粘贴 compose 文件
version: '3.8'
services:
mysql:
image: mysql:5.7
container_name: sqmusic_mysql
command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
environment:
MYSQL_ROOT_PASSWORD: sqmusicv3password
MYSQL_DATABASE: sqmusicv3
volumes:
- ./mysql_data:/var/lib/mysql
ports:
- "3306:3306"
networks:
- sq-app-network
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-uroot", "-psqmusicv3password"]
interval: 5s
timeout: 5s
retries: 20
restart: always
sqmusic_main:
image: registry.cn-hangzhou.aliyuncs.com/sqdockler/simple_sq_music_plus:v3.0.31
container_name: sqmusic_main
environment:
- DB_IP=mysql
- DB_PORT=3306
- DB_NAME=sqmusicv3
- DB_USERNAME=root
- DB_PASSWORD=sqmusicv3password
volumes:
- ./music:/music
depends_on:
mysql:
condition: service_healthy
networks:
- sq-app-network
ports:
- "8099: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
networks:
sq-app-network:
driver: bridge2️⃣ 需要修改的地方
主要有两个：
✅ 修改音乐存放路径
将容器内的路径映射到你自己的音乐目录，例如：
volumes:
- /你的音乐路径:/music
确保路径是你实际使用的目录。
✅ 检查端口是否占用
默认端口是：
8096
⚠️ 需要注意：
8096 通常是 Jellyfin 默认端口。
如果已占用，可以修改为：
8097
或其他未占用端口。
3️⃣ 开始构建
确认修改完成后：
点击确定
开始构建容器
构建时间取决于网络情况。
五、部署完成后的使用体验
访问：
http://你的IP:端口
默认账号密码：
admin
admin
登录后可以看到界面功能包括：
音乐搜索
在线播放
下载
歌单解析
整体界面简洁，操作直观。
六、下载功能说明
测试搜索一首歌曲：
搜索速度较快
支持直接播放
默认带有封面与歌词
可选择不同码率下载
下载完成后：
文件保存到刚才映射的目录
自动创建分类目录
包含封面图片
包含歌词文件
支持整张专辑下载，并默认选择最高音质。
七、与 Jellyfin 整合
如果你希望统一在 Jellyfin 中管理音乐，可以按照以下步骤操作。
方法一（推荐）
如果在部署时已经将音乐目录映射为你原有的音乐库目录，那么：
👉 不需要额外操作
Jellyfin 重新扫描媒体库即可识别。
方法二（后期添加路径）
如果部署时未使用原有音乐目录：
停止 Jellyfin 容器
进入容器详情
添加路径映射
将音乐下载目录映射到 Jellyfin
保存后重启 Jellyfin。
在 Jellyfin 中添加媒体库
进入 Jellyfin 控制台
新建或编辑媒体库
添加刚才的音乐目录
保存并扫描
完成后即可在 Jellyfin 中播放下载的音乐。
八、设置建议
在项目设置中可以调整：
同时下载数量
登录密码
如果没有特殊需求，基本保持默认即可。
九、整体体验总结
这个音乐项目的优点：
部署简单
搜索速度快
支持高音质下载
自动整理封面与歌词
可与 Jellyfin 无缝整合
适合：
使用 NAS 的用户
希望自建音乐库的人
想统一在 Jellyfin 管理媒体的用户
十、相关资源
总结
如果你本身已经在使用 Jellyfin 或 NAS，这个音乐项目可以作为一个补充下载工具，帮助快速扩充音乐库。
有问题欢迎在评论区留言或加入群组交流。
感谢你的阅读，我们下期再见。
评论区