收起左侧

MusicFree——让听歌这件事变得简单一点

67
回复
2462
查看
[ 复制链接 ]
2026-5-18 19:56:18 显示全部楼层 阅读模式

MusicFree

MusicFree——让听歌这件事变得简单一点

项目地址:https://ansgoo.github.io/music-free-site/

曾几何时,想听无损音乐往往要分别搭建多套服务:

MusicFree 希望用 All in One 的方式,让听歌这件事变得简单一点

music.webp

扩展性

提供音乐全生命周期的管理能力:

  • 在线搜索下载入库,便捷获取曲目
  • 去重 到多格式 播放,完整的曲库维护
  • 封面歌词 的刮削,补全歌曲信息
  • 支持各平台 歌单同步(链接导入与定时同步)
  • 支持艺术家、专辑的 匹配与刮削,自动补全头像与简介

上述扩展能力均通过 插件 实现,可按需订阅注册表、安装不同插件组合。

场景 文档
音乐搜索 / 去重 / 刮削 音乐管理
专辑浏览与专辑级刮削 专辑
艺术家与批量头像 艺术家
歌单导入与同步 歌单
插件安装与编排 插件 · 注册表 · 插件合集

兼容性

支持完整的 OpenSubsonic 与部分 Navidrome 风格 REST API。常见客户端例如:

  • 音流
  • Supersonic
  • Feishin、Symfonium、DSub 等 Subsonic / OpenSubsonic 兼容应用

接口说明见 OpenSubsonic APINavidrome API

安装

Docker Compose 示例(请按实际环境修改端口与卷路径):

services:
  music-free:
    image: ansgoo/music-free:latest
    container_name: music-free
    restart: unless-stopped
    ports:
      - "4533:4533"
    volumes:
      - /vol1/docker/music-free:/app/data
      - /vol1/music:/app/music
收藏
送赞 3
分享
2026-5-18 20:04:06 楼主 显示全部楼层

我是MusicFree的作者,欢迎大家试用这个项目,大家有好的想法或者建议欢迎提issue,记得订阅第三方插件啊,

社区第三方注册表地址:https://cdn.jsdelivr.net/npm/musicfree-plugin@latest/artifact/registry.json

默认用户名/密码:admin/admin

1

查看全部评分

0

主题

2

回帖

0

牛值

系统先锋体验团🛩️

2026-5-19 15:50:58 显示全部楼层

感谢大佬分享,我先去试用下,这个项目和原来的app版的、musicfree是一脉相承吗

多提意见,和APP musicfree 没有任何关系  详情 回复
2026-5-19 18:11

23

主题

254

回帖

0

牛值

小有名气

2026-5-19 16:03:16 显示全部楼层

这么强悍吗?搜索下载?封面,歌词。。。。musci神器啊

不止于此,基于指纹的音乐文件去重、各个平台的歌单同步,最重要的是他是插件化的,理论上可以支持任意平台,插件和本项目无关,如果你会编程可以使用任意编程语言给他编写插件,更多的功能还在开发中  详情 回复
2026-5-19 18:10

2

主题

50

回帖

0

牛值

初出茅庐

2026-5-19 17:04:28 显示全部楼层

关注一下,

但我感觉和之前的app版的musicfree(https://github.com/maotoumao/MusicFree)是重名但无关的项目?

我都开发完了,才发现有个同名的APP,但是我们之间确实没有任何关系  详情 回复
2026-5-19 18:08
2026-5-19 18:08:47 楼主 显示全部楼层
sicifus 发表于 2026-5-19 17:04
关注一下,
但我感觉和之前的app版的musicfree(https://github.com/maotoumao/MusicFree)是重名但无关的 ...

我都开发完了,才发现有个同名的APP,但是我们之间确实没有任何关系
2026-5-19 18:10:51 楼主 显示全部楼层
mimiwuqi 发表于 2026-5-19 16:03
这么强悍吗?搜索下载?封面,歌词。。。。musci神器啊

不止于此,基于指纹的音乐文件去重、各个平台的歌单同步,最重要的是他是插件化的,理论上可以支持任意平台,插件和本项目无关,如果你会编程可以使用任意编程语言给他编写插件,更多的功能还在开发中
2026-5-19 18:11:45 楼主 显示全部楼层
流风回雪zc 发表于 2026-5-19 15:50
感谢大佬分享,我先去试用下,这个项目和原来的app版的、musicfree是一脉相承吗
...

多提意见,和APP musicfree 没有任何关系
Navidrome 支持网络电台,你这个有考虑加入吗  详情 回复
2026-5-19 22:55

1

主题

2

回帖

0

牛值

江湖小虾

2026-5-19 22:55:11 显示全部楼层
我是成海文 发表于 2026-5-19 18:11
多提意见,和APP musicfree 没有任何关系

Navidrome 支持网络电台,你这个有考虑加入吗
电台分为两种,一种是订阅某个媒体流资源直接播放,一种是通过某种规则实现将本地文件生成一个歌单,第一种在国外用户比较流行,第二种就是我们常用的歌单功能吧,这是我的理解,可能理解不对,后期会继续完善歌单,  详情 回复
2026-5-20 07:29

0

主题

23

回帖

0

牛值

江湖小虾

2026-5-19 23:29:36 显示全部楼层

谢谢大佬分享!

安装试用,效果很不错。但导入**云或qq音乐歌单,歌单里面的大多数歌曲不能播放(可能是非会员吧);再有就是,只有管理员进入后台管理才能从互联网搜索音乐,是否普通成员也开通此权限?

产品设计认为管理员有对音乐资源有绝对的权利,普通用户只能使用,如果允许普通用户下载,普通用户下载的歌曲会被其他用户感知,但是普通用户下载的歌曲的品质、风格、内容无法保证 后面会增加一个许愿功能,普通用  详情 回复
2026-5-20 07:26
应该和会员无关,QQ音乐网站非vip歌曲能播放,但导入歌单里面的很多非VIP歌曲也不能播放。  详情 回复
2026-5-19 23:41

0

主题

23

回帖

0

牛值

江湖小虾

2026-5-19 23:41:02 显示全部楼层
赵♥★ 发表于 2026-5-19 23:29
谢谢大佬分享!
安装试用,效果很不错。但导入**云或qq音乐歌单,歌单里面的大多数歌曲不能播放(可能是非 ...

应该和会员无关,QQ音乐网站非vip歌曲能播放,但导入歌单里面的很多非VIP歌曲也不能播放。
歌单部分不能播放和是否是会员没有关系,能否播放取决于你本地是否存在歌单音乐,歌单同步只是同步歌单,不会同步音乐文件  详情 回复
2026-5-20 07:21
2026-5-20 07:21:40 楼主 显示全部楼层
赵♥★ 发表于 2026-5-19 23:41
应该和会员无关,QQ音乐网站非vip歌曲能播放,但导入歌单里面的很多非VIP歌曲也不能播放。 ...

歌单部分不能播放和是否是会员没有关系,能否播放取决于你本地是否存在歌单音乐,歌单同步只是同步歌单,不会同步音乐文件
那只能一个一个的通过音乐搜索后下载云导入歌单里面的歌曲,才能在歌单里面播放导入的歌单歌曲,还是比较麻烦。能不能通过歌单进行音乐搜索,并批量下载呢  详情 回复
2026-5-20 09:23
2026-5-20 07:26:35 楼主 显示全部楼层
赵♥★ 发表于 2026-5-19 23:29
谢谢大佬分享!
安装试用,效果很不错。但导入**云或qq音乐歌单,歌单里面的大多数歌曲不能播放(可能是非 ...

产品设计认为管理员有对音乐资源有绝对的权利,普通用户只能使用,如果允许普通用户下载,普通用户下载的歌曲会被其他用户感知,但是普通用户下载的歌曲的品质、风格、内容无法保证

后面会增加一个许愿功能,普通用户可以将自己的歌单中不存在的歌曲进行许愿,管理员在后台通过愿望实现的功能帮忙实现,打通了普通用户和下载之间的交互
2026-5-20 07:29:36 楼主 显示全部楼层
李桂成 发表于 2026-5-19 22:55
Navidrome 支持网络电台,你这个有考虑加入吗

电台分为两种,一种是订阅某个媒体流资源直接播放,一种是通过某种规则实现将本地文件生成一个歌单,第一种在国外用户比较流行,第二种就是我们常用的歌单功能吧,这是我的理解,可能理解不对,后期会继续完善歌单,会抓取个个平台的流行排行榜

23

主题

254

回帖

0

牛值

小有名气

2026-5-20 07:42:05 显示全部楼层

用户名,密码是啥?我没找到,在你的github上也没找到。。。。

23

主题

254

回帖

0

牛值

小有名气

2026-5-20 07:45:24 显示全部楼层

不用了,找到了admin,admin

0

主题

23

回帖

0

牛值

江湖小虾

2026-5-20 09:23:29 显示全部楼层
我是成海文 发表于 2026-5-20 07:21
歌单部分不能播放和是否是会员没有关系,能否播放取决于你本地是否存在歌单音乐,歌单同步只是同步歌单, ...

那只能一个一个的通过音乐搜索后下载云导入歌单里面的歌曲,才能在歌单里面播放导入的歌单歌曲,还是比较麻烦。能不能通过歌单进行音乐搜索,并批量下载呢
歌单是普通用户的,音乐资源是所有用户的,交互上随便怎么搞,流程上一定要管理员审核  详情 回复
2026-5-20 09:35
2026-5-20 09:31:59 楼主 显示全部楼层
我是作者,欢迎大家试用,大家部署好之后记得注册第三方插件啊!社区第三方注册表地址:https://cdn.jsdelivr.net/npm/mus ... ifact/registry.json
产品很好,但是有些问题麻烦问一下怎么解决 1、怎么显示完整的歌词呢 2、新建歌单,怎么把播放的歌曲加入歌单呢 3、怎么让客户端音流链接到您这个软件呢  详情 回复
2026-6-6 19:08
2026-5-20 09:33:27 楼主 显示全部楼层

我是作者,欢迎大家试用,多提意见,部署完了一定要记得注册社区第三方插件啊!

社区第三方注册表地址:https://cdn.jsdelivr.net/npm/musicfree-plugin@latest/artifact/registry.json

默认账号密码:admin/admin

2026-5-20 09:33:43 楼主 显示全部楼层
我是作者,欢迎大家试用,多提意见,部署完了一定要记得注册社区第三方插件啊! 社区第三方注册表地址:[url]https://cdn.jsdelivr.net/npm/musicfree-plugin@latest/artifact/registry.json[/url] 默认账号密码:admin/admin
2026-5-20 09:35:18 楼主 显示全部楼层
赵♥★ 发表于 2026-5-20 09:23
那只能一个一个的通过音乐搜索后下载云导入歌单里面的歌曲,才能在歌单里面播放导入的歌单歌曲,还是比较 ...

歌单是普通用户的,音乐资源是所有用户的,交互上随便怎么搞,流程上一定要管理员审核
管理员一键同步歌单,并下载歌单歌曲  详情 回复
2026-5-21 22:06

23

主题

254

回帖

0

牛值

小有名气

2026-5-20 15:46:56 显示全部楼层

搜索下载这个功能是不是针对本地曲目的,不是下载其他地方的歌曲?

可以下载本地目录,但是大家说的是另一个功能,从远程平台下载,例如QQ、**、咪咕之类的,目前这个能力是通过社区提供第三方插件实现的底层是GoMuiscDL,支持从各种平台下载音乐,需要先订阅第三方注册表  详情 回复
2026-5-20 16:51
2026-5-20 16:51:59 楼主 显示全部楼层
mimiwuqi 发表于 2026-5-20 15:46
搜索下载这个功能是不是针对本地曲目的,不是下载其他地方的歌曲?

可以下载本地目录,但是大家说的是另一个功能,从远程平台下载,例如QQ、**、咪咕之类的,目前这个能力是通过社区提供第三方插件实现的底层是GoMuiscDL,支持从各种平台下载音乐,需要先订阅第三方注册表

0

主题

9

回帖

0

牛值

江湖小虾

2026-5-21 19:22:38 显示全部楼层

配置完访问端口,没有页面显示

糟糕,当前内网地址暂时无法访问

是不是https访问的,飞牛默认点击端口号打开的页面是https:/xx.xx.xx.xx:端口号,改成http即可  详情 回复
2026-5-21 19:27
2026-5-21 19:27:46 楼主 显示全部楼层
营口广汽丰田金 发表于 2026-5-21 19:22
配置完访问端口,没有页面显示
糟糕,当前内网地址暂时无法访问

是不是https访问的,飞牛默认点击端口号打开的页面是https:/xx.xx.xx.xx:端口号,改成http即可

0

主题

9

回帖

0

牛值

江湖小虾

2026-5-21 19:53:49 显示全部楼层

http://192.168.31.250:4534/

image.png

image.png

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

x

0

主题

9

回帖

0

牛值

江湖小虾

2026-5-21 20:06:58 显示全部楼层

安装了好几个镜像版本都是一样的问题,也不知道怎么弄了

你的docker-compose贴一下,我使用的是V1.1.5版本的,没任何问题,V1.1.5是昨晚打出的包  详情 回复
2026-5-21 21:10
2026-5-21 21:10:15 楼主 显示全部楼层
营口广汽丰田金 发表于 2026-5-21 20:06
安装了好几个镜像版本都是一样的问题,也不知道怎么弄了

你的docker-compose贴一下,我使用的是V1.1.5版本的,没任何问题,V1.1.5是昨晚打出的包



  1. services:
  2.   music-free:
  3.     image: ansgoo/music-free:V1.1.5
  4.     container_name: music-free
  5.     restart: unless-stopped
  6.     ports:
  7.       - "18888:4533"
  8.     volumes:
  9.       - /vol1/1000/docker/muisc-free:/app/data
  10.       - /vol1/1000/音乐:/app/music
复制代码
这样就好用了  详情 回复
2026-5-21 21:23

0

主题

9

回帖

0

牛值

江湖小虾

2026-5-21 21:20:59 显示全部楼层

services:
music-free:
image: ansgoo/music-free :latest
container_name: music-free
restart: unless-stopped
ports:

  • "18888:4533"
    volumes:
  • /vol1/1000/docker/muisc-free:/app/data
  • /vol1/1000/music:/app/music
不能默认选择你输入的版本好就好了  详情 回复
2026-5-21 21:30

0

主题

9

回帖

0

牛值

江湖小虾

2026-5-21 21:23:03 显示全部楼层
我是成海文 发表于 2026-5-21 21:10
你的docker-compose贴一下,我使用的是V1.1.5版本的,没任何问题,V1.1.5是昨晚打出的包

这样就好用了

0

主题

9

回帖

0

牛值

江湖小虾

2026-5-21 21:29:34 显示全部楼层

谢谢 作者大大,这个满足了我所有的需求,完美了,我愿称之为最强音乐。

歌单,下载怎么弄啊,能不能一键下载  详情 回复
2026-5-21 21:40

0

主题

9

回帖

0

牛值

江湖小虾

2026-5-21 21:30:06 显示全部楼层
营口广汽丰田金 发表于 2026-5-21 21:20
services:
music-free:
image: ansgoo/music-free :latest

不能默认选择你输入的版本好就好了

0

主题

9

回帖

0

牛值

江湖小虾

2026-5-21 21:40:30 显示全部楼层
营口广汽丰田金 发表于 2026-5-21 21:29
谢谢 作者大大,这个满足了我所有的需求,完美了,我愿称之为最强音乐。
...

歌单,下载怎么弄啊,能不能一键下载
没做,后期做大概思路是普通用户在歌单详情页会有个“一键许愿”,管理员在后台收到愿望清单可以“实现愿望”,然后会一键下载,当然实现愿望也可以通过管理员自己通过其他方式下载音乐去实现  详情 回复
2026-5-21 22:20

0

主题

9

回帖

0

牛值

江湖小虾

2026-5-21 22:06:10 显示全部楼层
我是成海文 发表于 2026-5-20 09:35
歌单是普通用户的,音乐资源是所有用户的,交互上随便怎么搞,流程上一定要管理员审核 ...

管理员一键同步歌单,并下载歌单歌曲
2026-5-21 22:20:34 楼主 显示全部楼层
营口广汽丰田金 发表于 2026-5-21 21:40
歌单,下载怎么弄啊,能不能一键下载

没做,后期做大概思路是普通用户在歌单详情页会有个“一键许愿”,管理员在后台收到愿望清单可以“实现愿望”,然后会一键下载,当然实现愿望也可以通过管理员自己通过其他方式下载音乐去实现
我觉得如果需要我得**云会员也可以,我可以方便同步过来  详情 回复
2026-5-22 08:33

2

主题

21

回帖

0

牛值

江湖小虾

2026-5-22 08:33:06 显示全部楼层
我是成海文 发表于 2026-5-21 22:20
没做,后期做大概思路是普通用户在歌单详情页会有个“一键许愿”,管理员在后台收到愿望清单可以“实现愿 ...

我觉得如果需要我得**云会员也可以,我可以方便同步过来

9

主题

20

回帖

0

牛值

江湖小虾

2026-5-22 10:35:51 显示全部楼层

image.png

刮削失败,几个插件都试过了

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

x
你订阅下社区三方插件,社区三方插件的注册表地址,看评论区的评论,然后在插件商店中安装QQ 和wangyi云的插件,最后在插件方案中配置一下刮削的插件  详情 回复
2026-5-22 10:44
2026-5-22 10:44:28 楼主 显示全部楼层
[quote][size=2][url=forum.php?mod=redirect&goto=findpost&pid=294992&ptid=64012][color=#999999]funny 发表于 2026-5-22 10:35[/color][/url][/size] 刮削失败,几个插件都试过了[/quote]

你订阅下社区三方插件,社区三方插件的注册表地址,看评论区的评论,然后在插件商店中安装QQ 和wangyi云的插件,最后在插件方案中配置一下刮削的插件
ScreenShot_2026-05-22_104158_373.png

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

x

9

主题

20

回帖

0

牛值

江湖小虾

2026-5-22 11:14:27 显示全部楼层

歌词能刮,但封面刮不出来

是所有的都刮削不出来,还是部分刮削不出来?能否欧刮削出来取决于你的歌曲和插件,有些音乐在部分平台是没有的,当然刮削不到,当然还有网络问题  详情 回复
2026-5-22 11:42
2026-5-22 11:42:25 楼主 显示全部楼层
funny 发表于 2026-5-22 11:14
歌词能刮,但封面刮不出来

是所有的都刮削不出来,还是部分刮削不出来?能否刮削出来取决于你的歌曲和插件,有些音乐在部分平台是没有的,当然刮削不到,当然还有网络问题,甚至还有你音乐本身的元数据标签是不是不准确,建议使用单个歌曲刮削测试

1

主题

5

回帖

0

牛值

江湖小虾

2026-5-22 17:26:03 显示全部楼层

image.png

音乐清洗,设置好规则,点击批量清洗历史数据,就会任务取消。莫非我的设置有问题?

image.png

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

x
这个问题已经修复了,但是我最近没流量了,dockerhub推不上去镜像了,最晚6月1日会有一个大的发布,会更新这个问题,并且你这个规则我会加入内置规则中,你可以提个issue跟踪,这个问题暂时不处理  详情 回复
2026-5-22 17:35
2026-5-22 17:35:46 楼主 显示全部楼层
upcszm 发表于 2026-5-22 17:26
音乐清洗,设置好规则,点击批量清洗历史数据,就会任务取消。莫非我的设置有问题?

...

这个问题已经修复了,但是我最近没流量了,dockerhub推不上去镜像了,最晚6月1日会有一个大的发布,会更新这个问题,并且你这个规则我会加入内置规则中,你可以提个issue跟踪,这个问题暂时不处理

0

主题

20

回帖

0

牛值

江湖小虾

2026-5-23 12:24:37 显示全部楼层
缺点没有本地模式无法通过目录访问   还得挂载
我意思就是目前这个只能挂DAV获取文件 目前没有本地直接读目录  详情 回复
2026-5-23 13:16
其实没有理解你的意思,Docker 对宿主机的目录访问都是有要求的,只有你显式声明了才能访问宿主机的目录,后期会出各个平台的客户端安装包,支持运行时指定媒体源文件目录  详情 回复
2026-5-23 13:03
2026-5-23 13:03:55 楼主 显示全部楼层
LeconFowin 发表于 2026-5-23 12:24
缺点没有本地模式无法通过目录访问   还得挂载

其实没有理解你的意思,Docker 对宿主机的目录访问都是有要求的,只有你显式声明了才能访问宿主机的目录,后期会出各个平台的客户端安装包,支持运行时指定媒体源文件目录

0

主题

20

回帖

0

牛值

江湖小虾

2026-5-23 13:16:00 显示全部楼层
LeconFowin 发表于 2026-5-23 12:24
缺点没有本地模式无法通过目录访问   还得挂载

我意思就是目前这个只能挂DAV获取文件  目前没有本地直接读目录
把地址映射过去就行了,默认就有本地的,  详情 回复
2026-5-23 20:30
本地目录通过docker路径映射啊,你看看部署的docker-compose  详情 回复
2026-5-23 13:22
2026-5-23 13:22:04 楼主 显示全部楼层
LeconFowin 发表于 2026-5-23 13:16
我意思就是目前这个只能挂DAV获取文件  目前没有本地直接读目录

本地目录通过docker路径映射啊,你看看部署的docker-compose

0

主题

20

回帖

0

牛值

江湖小虾

2026-5-23 14:01:20 显示全部楼层
搜歌下载下一首MusicFree后台就自动关闭了 不知啥原因 是触发扫描引发的吗  这样只能下一首 在去运行程序
具体描述一下过程吗?不是很懂  详情 回复
2026-5-23 15:24
2026-5-23 15:24:31 楼主 显示全部楼层
LeconFowin 发表于 2026-5-23 14:01
搜歌下载下一首MusicFree后台就自动关闭了 不知啥原因 是触发扫描引发的吗  这样只能下一首 在去运行程序 ...

具体描述一下过程吗?不是很懂
具体就是 我搜歌下载 下完一首 软件自动关闭 无法连续下第二首 需要重启软件在下第二首 周而复始 是不是下完就触发后台扫描 然后程序出错自动关闭  详情 回复
2026-5-23 15:49

0

主题

20

回帖

0

牛值

江湖小虾

2026-5-23 15:49:52 显示全部楼层
我是成海文 发表于 2026-5-23 15:24
具体描述一下过程吗?不是很懂

具体就是 我搜歌下载 下完一首 软件自动关闭 无法连续下第二首 需要重启软件在下第二首 周而复始 是不是下完就触发后台扫描 然后程序出错自动关闭
我这边没有这个异常,方便的话,可以提供一下docker日志不  详情 回复
2026-5-23 18:54
2026-5-23 18:54:08 楼主 显示全部楼层
LeconFowin 发表于 2026-5-23 15:49
具体就是 我搜歌下载 下完一首 软件自动关闭 无法连续下第二首 需要重启软件在下第二首 周而复始 是不是 ...

我这边没有这个异常,方便的话,可以提供一下docker日志不
026-05-23 15:53:01.427 ERROR failed to sync builtin tag cleaning rules path=/app/config/tag_cleaning_builtin_rules.json err=read builtin rules file: open /app/config/tag_cleaning_builtin_rules.json: n  详情 回复
2026-5-23 19:09
12下一页
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则