【首发】道理鱼音乐管理更新上线0.1.5稳定版本 20251108

汪仔饭

简介

分享一下开发的音乐程序，强不强大不知道，功能有些多，如果感觉不错，记得支持下，目前版本稳定，偶尔细节有个bug理解下，后面会修复，值得现体验下，当然有好的建议，我也会悉心接受，感谢的支持！

PS:希望交流是愉快的，为了营造更好的交流环境，请不要把所谓自己的性格和傲娇、情绪的言语，带到这里，影响大家心情。

道理鱼音乐管理平台

自建 NAS 音乐管理与播放系统，提供媒体扫描、元数据补全、**、收藏与队列管理、自动转码等能力，可通过 Docker 或本地环境快速部署。

项目概述

这是一个全栈音乐管理系统，包含后端API服务器和React前端应用。

项目地址

目前仅作为问题建议提交和pc端（完成后我会上传到这个位置）下载使用

https://gitee.com/wangzaifan/daoliyu-music.git

更新内容

0.1.5更新20251108

如出现后端重启，直接删除原docker compose项目和容器后，重新选择docker compose，重新构建

0.1.4更新20251020

后端

0.1.5更新20251108

更新补全有声书，音乐视频，仅供测试使用。

有声书，第三方没有可靠元数据，所以尽量使用本地目录，封面支持 cover.jpg图片文件。暂时都是体验使用。

0.1.4更新20251020

• 修改SQLite数据库（修复后端重启不支持并发读写的问题，导致后端频繁重启）为PostgreSQL数据库

前端

0.1.5更新20251108

• 修复ui超出问题

0.1.4更新20251020

• 取消艺术家、专辑、歌单、歌曲库的分页
• 增加增量音乐入库
• 修改艺术家、专辑、歌单、歌曲库的UI，
• 修改歌曲库快速加入播放列表
• 添加有声书和音乐视频菜单
• 增加网页端EQ（需要https协议）

注意：这次基本和全新部署差不多，最好清理旧的数据后再部署

项目结构

• backend/ - Node.js/Express API服务器（TypeScript）
• frontend/ - React前端应用（TypeScript + Vite）
• media/ - 媒体文件存储
• playlists/ - 播放列表数据

功能亮点

• 媒体扫描：支持多目录配置，自动解析 ID3 元数据、封面、歌词并写入数据库。
• 智能播放：Web 前端提供队列、收藏、下一首/上一首、音量与进度控制，支持令牌式音频流与 HLS。
• 账号系统：区分管理员与普通用户，支持注册开关、资料修改、密码变更与头像上传。
• 收藏体系：曲目、专辑收藏与歌单管理一应俱全，可直接加入播放器队列。
• 实时通知：内置 WebSocket 网关，后续可扩展扫描与播放的实时反馈。
• 转码缓存：集成 FFmpeg 实时转码，支持自动生成指定码率的缓存文件并在后台统计与清理。
• 插件与元数据：插件清单自动识别目录内 manifest，元数据提供方支持启用、优先级配置与第三方源扩展。

版本更新

• 增加对redis的支持
• 优化网格模式下的排版问题（太小的分辨率1080P以下懒得适配了）
• 增加对当前播放列表内歌曲一键添加歌单
• 增加一键匹配歌手简介
• 至于扩展方面增加了几个匹配机制，感觉可以根据后台自行调试选择。
• 优化界面逻辑
• 修复右侧播放列表因歌曲名称过长导致UI变形
• 增加播放列表显示效果
• 增加快捷收藏按键
• 增加歌曲、艺人、专辑的简单编辑

演示内容

目前已完成

• 目录入库
• 歌单按照目录名入库
• 标签读取和在线匹配机制（建议先使用 音乐标签 给音乐做匹配，大佬的工具，免费好用）
• 多用户机制
• 公开歌单其他用户可见
• 用户收藏机制
• 声音指纹技术（待验证）
• 一键匹配歌手信息

后续工作安排

• 个人喜好推荐算法
• PC端（即将完成）
• 安卓客户，只能最后做适配，毕竟独立开发个人能力有限。

以下是0.1.5版本的docker compose，增加最新版标签latest，后期更新会有提示。

由于之前一直是预览（已全部清除），这个版本开始基本是稳定下来了，可以长期使用。

首页

专辑列表

系统设置

默认歌单路径（子文件夹为单位，文件夹名为歌单名）

还有很多就不一一截图了，体验版本，个人时间精力有限，有些细节还没那么完美，至少够用了，后期的话，可能会对接或者开发pc端和安卓端。

开发初心是让自己用着舒服，看着顺眼的，功能基本满足。

应用尝鲜下载

Ps：打包有点仓促，实际还是属于docker compose,下载后 应用商店 - 手动安装 (下载取决于的网速，最好有镜像站加速或特殊网络加持)

之前内置的路径，现在都在 文件管理 - 应用文件 - daoliyu-music （这里取决于安装时选择哪个存储分区，安装时注意下，当然安装后，也可以手动编辑docker compose或后端镜像自行添加路径映射，只要映射到容器的 /data/xxx 多媒体库添加 /data/xxx 即可）懒省事就在默认的目录下找

如有问题及时反馈下，感谢这么久兄弟们的支持，下一版本，准备去掉音乐视频，感觉不够纯粹，所以后面准备拿掉，得承认视频还得是飞牛专业的来，留时间搞其他端，另外，尝试搞一台服务器搭建共用的元信息服务器，这个可能需要大家一起来做贡献。敬请期待下！

『来自123云盘用户的分享』道理鱼音乐应用版

链接：https://www.123865.com/s/8sh9-qhXsh?pwd=w5nF# 提取码：w5nF

感谢

最后感谢大家的支持，以及几位打赏的网友，感谢支持！

由于支持多用户登录和便于部署，供nas实用为主，严禁未经本人书面允许，从事商业行为。

问题解答

**问：**后端频繁重启，需要重新删除数据重新扫描的问题

答： 已更换数据库

**问：**版本更新了什么

答： 目前没精力去做详细解答（目前重心在pc端，基本完成，自查细节），后期正式版本发布后再去完善

**问：**为什么我要删除重建又要重新扫

**答：**十分抱歉，现在版本只属于功能相对稳定的版本，UI和数据还在修复完善阶段，只要没放出1.0版本，都属于测试阶段，发不出来也是让大家众测，有好的建议我会采纳，相对的，对于个人喜欢来让我改变道理鱼音乐的定位，我也不会去做的。

最后，感谢兄弟们（以及B站的兄弟们）的大力支持和建议提交，后期我会更用心的完善每个功能模块。

汪仔饭

如果有问题，请尽量一次性说明情况，例如权限问题，请贴出你的docker-compose，入库问题或其他问题，请尽量详述环境和目录情况、歌曲格式之类的，论坛社区不是在聊天，如果能一次帮大家解决问题，我会尽量一次解决，请相互理解下，感谢！

laolarou

niubility！感谢分享！

sucan

膜拜大佬！

玉尺书生

能不能在歌曲库里添加个全部播放或者一键所有歌曲添加到队列。

kuku8

这界面太熟悉啦

汪仔饭

玉尺书生 发表于 2025-9-24 16:54
能不能在歌曲库里添加个全部播放或者一键所有歌曲添加到队列。

现在还不是很成熟，只是把逻辑走通，也不是不增加，单拿我来说，光专辑就3万多首，还不算歌单，一个播放列表添加几万首，还是把喜欢的搞在歌单比较好，毕竟不是流媒体服务器，压力有些大，目前数据库格式，也扛不住，后期更换其他数据库和加入缓存高并发，缓解下压力问题应该不大，暂时只作为预览体验，bug肯定会有，精力有限，等后期会慢慢添加完善

玉尺书生

汪仔饭 发表于 2025-9-25 06:35
现在还不是很成熟，只是把逻辑走通，也不是不增加，单拿我来说，光专辑就3万多首，还不算歌单，一个播放 ...

你不在共建团群吗，共建团的人我没见过有点奇怪，哈哈哈哈哈。

汪仔饭

玉尺书生 发表于 2025-9-25 14:36
你不在共建团群吗，共建团的人我没见过有点奇怪，哈哈哈哈哈。

主理人把我漏了，要么是我没看到信息，我才知道的有个共建团的群，目前没在

eric1218

支持开发大佬

玉尺书生

汪仔饭 发表于 2025-9-25 15:25
主理人把我漏了，要么是我没看到信息，我才知道的有个共建团的群，目前没在 ...

你私信主理人啊，我跟他说了。

松花酿_bynsS

大佬 wav格式歌曲信息有乱码

hweir

感谢分享！

汪仔饭

松花酿_bynsS 发表于 2025-9-25 16:36
大佬  wav格式歌曲信息有乱码

建议你把音乐标签处理下再试试，步骤参考这个 打开MP3Tag或音乐标签：
添加你想要转换元信息的歌曲所在目录：
注意，此时这些MP3文件的元信息还是GBK编码，这时可以全选这些歌曲，点击工具栏中的Save按钮对所有元信息进行重新保存（不用对其元信息做任何更改），MP3Tag会自动将所有元信息就地重新以Unicode编码进行保存：

jiaye

看界面就不错，部署上试试。666

哄哄_otEN2

**，这界面看着挺不错，好不容易刮削出来几千首歌，我得找时间试试

huicopy

能不能自定义音效？

松花酿_bynsS

[quote][size=2][url=forum.php?mod=redirect&goto=findpost&pid=179202&ptid=38427][color=#999999]汪仔饭 发表于 2025-9-25 18:49[/color][/url][/size] 建议你把音乐标签处理下再试试，步骤参考这个 打开MP3Tag或音乐标签： 添加你想要转换元信息的歌曲所在 ...[/quote]

试了试 还是名字这里。

汪仔饭

以下是0.1.3版本的docker compose，增加最新版标签latest，后期更新会有提示。

由于之前一直是预览，这个版本开始基本是稳定下来了，可以长期使用。

版本更新

• 增加对redis的支持
• 优化网格模式下的排版问题（太小的分辨率1080P以下懒得适配了）
• 增加对当前播放列表内歌曲一键添加歌单
• 增加一键匹配歌手简介
• 至于扩展方面增加了几个匹配机制，感觉可以根据后台自行调试选择。
• 优化界面逻辑
• 修复右侧播放列表因歌曲名称过长导致UI变形
• 增加播放列表显示效果
• 增加快捷收藏按键
• 增加歌曲、艺人、专辑的简单编辑

汪仔饭

松花酿_bynsS 发表于 2025-9-26 16:58
试了试 还是名字这里。

你这个界面是mp3tag？那这个是什么https://www.mp3tag.de/en/，还不知道的话，可以问下ai ，wav格式是有这个问题，不过目前不打算**

面宽碗大

这种不能录到飞牛三方库进行更新吗

jiaye

汪仔饭 发表于 2025-9-26 18:08
以下是0.1.1版本的docker compose，
版本更新

是要重新部署么？不能直接更新镜像么？

jiaye

像这种

汪仔饭

jiaye 发表于 2025-9-27 00:36
像这种

现在还是主要是预览版本，bug还有，启用架构还在优化中，至于latest标签，之前没打，所以是不会显示最新版本的提示，现在已经打上新版标签，以后会提示，不过，框架在在优化中docker compose也会换，后面会单发帖，在使用不同类型数据库的配置。

玉尺书生

汪仔饭 发表于 2025-9-26 18:08
以下是0.1.3版本的docker compose，增加最新版标签latest，后期更新会有提示。
由于之前一直是预览，这个版 ...

你可以编辑帖子啊，左下角有编辑按钮。

汪仔饭

玉尺书生 发表于 2025-9-28 00:15
你可以编辑帖子啊，左下角有编辑按钮。

编辑完了又要审核，所以没编辑直接顶置了

ACER

妥妥的大佬啊,这个和NAS-MUSIC有些相似

汪仔饭

ACER 发表于 2025-9-29 01:00
妥妥的大佬啊,这个和NAS-MUSIC有些相似

你如果知道spotify是什么，应该就不会这么说了😄

ocean

权限始终给不了，调整了还是扫描不到

新新小朋友

建议新增功能，一键导入第三方歌单，然后根据本地音乐库，自动吧本地音乐库的音乐导入到歌单内。

有个第三方网站做的比较好，粘贴qq音乐歌单，就能导。Navidrome歌单同步工具

汪仔饭

ocean 发表于 2025-9-29 09:25
权限始终给不了，调整了还是扫描不到

麻烦问的时候贴出你的docker-compose

汪仔饭

新新小朋友 发表于 2025-9-29 09:30
建议新增功能，一键导入第三方歌单，然后根据本地音乐库，自动吧本地音乐库的音乐导入到歌单内。
有个第三 ...

好的，这个会考虑

ocean

汪仔饭 发表于 2025-9-29 09:50
麻烦问的时候贴出你的docker-compose

services:
  backend:
    image: msmkls/daoliyu-backend:latest
    container_name: daoliyu-backend
    restart: unless-stopped
    environment:
      DATABASE_PROVIDER: "sqlite"
      DATABASE_URL: "file:/app/data/dev.db"
      APP_PORT: 4000
      ADMIN_DISPLAY_NAME: "${ADMIN_DISPLAY_NAME}"
      ADMIN_EMAIL: "${ADMIN_EMAIL}"
      ADMIN_PASSWORD: "${ADMIN_PASSWORD}"
      LIBRARY_ROOT: "/data/media"
      PLAYLISTS_IMPORT_ROOT: "/data/playlists"
      REGISTRATION_OPEN: "true"
      PLUGINS_DIR: "/plugins"
      ACOUSTID_API_KEY: "${ACOUSTID_API_KEY}"
      LASTFM_API_KEY: "${LASTFM_API_KEY}"
      LASTFM_API_SECRET: "${LASTFM_API_SECRET}"
      SPOTIFY_TOKEN: "${SPOTIFY_TOKEN}"
      SPOTIFY_CLIENT_ID: "${SPOTIFY_CLIENT_ID}"
      SPOTIFY_CLIENT_SECRET: "${SPOTIFY_CLIENT_SECRET}"
      REDIS_URL: "redis://redis:6379/0"
      LOG_LEVEL: "debug"
      DEBUG: "true"
    volumes:
      # 下面冒号左侧是本地数据库文件夹，右侧是容器内路径，不要改动容器内路径
      - ./backend-data:/app/data
      # 下面冒号左侧是本地数据文件夹，右侧是容器内路径，不要改动容器内路径
      - ./backend-storage:/app/storage
      # 下面冒号左侧是本地音乐文件夹，右侧是容器内路径，不要改动容器内路径
      - ./vol1/1000/music:/data/media
      # 下面冒号左侧是本地播放列表文件夹，右侧是容器内路径，不要改动容器内路径
      - ./playlists:/data/playlists
      # 下面冒号左侧是本地插件文件夹，右侧是容器内路径，不要改动容器内路径（目前未启用不用动）
      - ./plugins:/plugins
    healthcheck:
      test: ["CMD", "wget", "-qO-", "http://localhost:4000/health"]
      interval: 30s
      timeout: 5s
      retries: 5
  frontend:
    image: msmkls/daoliyu-frontend:latest
    container_name: daoliyu-frontend
    restart: unless-stopped
    depends_on:
      - backend
    ports:
    #  5173是本地访问端口，可以自行修改，8080是容器内端口，不要改动
      - "5173:8080"
  redis:
    image: redis:7-alpine
    container_name: daoliyu-redis
    restart: unless-stopped
    command: ["redis-server", "--appendonly", "yes"]
    volumes:
      - redis_data:/data
volumes:
  redis_data:

汪仔饭

我也眼花了，没看到你使用的根目录，

# 下面冒号左侧是本地音乐文件夹，右侧是容器内路径，不要改动容器内路径
      - ./vol1/1000/music:/data/media

更换

# 下面冒号左侧是本地音乐文件夹，右侧是容器内路径，不要改动容器内路径
      - /vol1/1000/music:/data/media

把.去掉

ocean

汪仔饭 发表于 2025-9-29 10:12
我也眼花了，没看到你使用的根目录，
# 下面冒号左侧是本地音乐文件夹，右侧是容器内路径，不要改动容器内 ...

多谢多谢

王煜文

就能扫描1060首，我一共10000首，扫描不出来

虫子樱桃

可以上架到其他应用商店么

汪仔饭

[quote][size=2][url=forum.php?mod=redirect&goto=findpost&pid=180800&ptid=38427][color=#999999]王煜文 发表于 2025-9-29 13:36[/color][/url][/size] 就能扫描1060首，我一共10000首，扫描不出来[/quote]

我这3万多首歌都没什么问题，如果有问题请尽量一次性详细说明实际情况，不然只能猜测，谢谢

汪仔饭

虫子樱桃 发表于 2025-9-29 14:32
可以上架到其他应用商店么

哪个商店要上架，他们自己会来对接，暂时不接受第三方私自上架，个人开发仅供nas用户使用，当然飞牛除外(飞牛后期也有自己的😄)

huicopy

ocean 发表于 2025-9-29 11:00
多谢多谢

我也出现了这个问题，去掉点之后，可以扫描到文件了。

nythus

关注收藏了，等有安卓端了**我一下

jiaye

牛牛牛，扫描音乐比第一版快多了，能不能下次跟新不重扫了呢？

王煜文

卡在1000多，不在动了，清理缓存、重启、中午突破了8000多，还剩点，在扫描就不动了，另外进度条一会8000多，一会700多，重复回滚，有点小问题

王煜文

services:
backend:
image: msmkls/daoliyu-backend:latest
container_name: daoliyu-backend
restart: unless-stopped
environment:
DATABASE_PROVIDER: "sqlite"
DATABASE_URL: "file:/app/data/dev.db"
APP_PORT: 4000
ADMIN_DISPLAY_NAME: "${ADMIN_DISPLAY_NAME}"
ADMIN_EMAIL: "${ADMIN_EMAIL}"
ADMIN_PASSWORD: "${ADMIN_PASSWORD}"
LIBRARY_ROOT: "/data/media"
PLAYLISTS_IMPORT_ROOT: "/data/playlists"
REGISTRATION_OPEN: "true"
PLUGINS_DIR: "/plugins"
ACOUSTID_API_KEY: "${ACOUSTID_API_KEY}"
LASTFM_API_KEY: "${LASTFM_API_KEY}"
LASTFM_API_SECRET: "${LASTFM_API_SECRET}"
SPOTIFY_TOKEN: "${SPOTIFY_TOKEN}"
SPOTIFY_CLIENT_ID: "${SPOTIFY_CLIENT_ID}"
SPOTIFY_CLIENT_SECRET: "${SPOTIFY_CLIENT_SECRET}"
REDIS_URL: "redis://redis:6379/0"
LOG_LEVEL: "debug"
DEBUG: "true"
volumes:

下面冒号左侧是本地数据库文件夹，右侧是容器内路径，不要改动容器内路径

• /vol1/1000/docker/daoliyu-backend/backend-data:/app/data

下面冒号左侧是本地数据文件夹，右侧是容器内路径，不要改动容器内路径

• /vol1/1000/docker/daoliyu-backend/backend-storage:/app/storage

下面冒号左侧是本地音乐文件夹，右侧是容器内路径，不要改动容器内路径

• /vol1/1000/docker/daoliyu-backend/media:/data/media

下面冒号左侧是本地播放列表文件夹，右侧是容器内路径，不要改动容器内路径

• /vol1/1000/docker/daoliyu-backend/playlists:/data/playlists

下面冒号左侧是本地插件文件夹，右侧是容器内路径，不要改动容器内路径（目前未启用不用动）

• /vol1/1000/docker/daoliyu-backend/plugins:/plugins
  healthcheck:
  test: ["CMD", "wget", "-qO-", "http://localhost:4000/health"]
  interval: 30s
  timeout: 5s
  retries: 5
  frontend:
  image: msmkls/daoliyu-frontend:latest
  container_name: daoliyu-frontend
  restart: unless-stopped
  depends_on:
• backend
  ports:

5173是本地访问端口，可以自行修改，8080是容器内端口，不要改动

• "18082:8080"
  redis:
  image: redis:7-alpine
  container_name: daoliyu-redis
  restart: unless-stopped
  command: ["redis-server", "--appendonly", "yes"]
  volumes:
• redis_data:/data
  volumes:
  redis_data:

汪仔饭

jiaye 发表于 2025-9-29 20:47
牛牛牛，扫描音乐比第一版快多了，能不能下次跟新不重扫了呢？

之前都是是预览版本，有说明，这次从0.1.3开始的是稳定版本，上面有说明，以后除非你删库，不然会一直保持

汪仔饭

王煜文 发表于 2025-9-29 20:58
卡在1000多，不在动了，清理缓存、重启、中午突破了8000多，还剩点，在扫描就不动了，另外进度条一会8000多 ...

排除法吧。看到你贴出来的了，我三万多首入库正常，没有出现你这种情况，建议你睡觉之前搞一次，让他自己跑，后台进度先不用管，让他跑一晚上，浏览器缓存不用清理，后台只要是在扫描右上角🔔的地方状态就会在，不要同时开多个窗口扫描，等他自动停止，停止后，看入库的数量，另外，看下后端容器的日子提示的扫描，当然你也可以先看下后端容器有没有相关的提示。debug是开启的

huicopy

3.36万首歌曲，扫描了17个小时，扫描了59%，扫描太慢了。

左手饭特稀

请问大佬，这个支持API的么，就是支持Navidrome的软件支持这个么？

左手饭特稀

不用DOCKER好安装么？

ฅฅx

①希望可以用户名登陆
②希望可以双击播放，希望可以全部加入播放列表，希望可以批量选择播放（别人用不用不知道，但我经常用，最起码得有，不然很影响使用体验，播放还要一首一首点击播放）