还在为音乐会员发愁用 MusicFree插件 三分钟搭起你的免费音乐聚合库【免费下载链接】MusicFreePluginsMusicFree播放插件项目地址: https://gitcode.com/gh_mirrors/mu/MusicFreePlugins你是否经历过这样的场景想听的歌散落在好几个平台这家要会员、那家要单独下载 App为了几首歌来回切换手机存储都快被塞满。如果有一个乐库总机能把 B 站、YouTube、猫耳FM、甚至你自己搭建的音乐服务器都接进来在同一个播放器里统一搜索、统一播放、统一管理是不是很爽MusicFree插件就是这套乐库总机。它是一组开源的音乐源适配插件配合 MusicFree 播放器使用可以让你绕开各平台的会员墙把分散的网络公开音乐资源聚合到一个界面里。而这份插件仓库正是帮你理解和使用这套机制的最佳入口。先搞懂一件事插件到底在做什么把 MusicFree 想象成一台电视插件就是一个个机顶盒电视本身不生产内容接上哪个盒子就能看哪家的节目。MusicFree 本身不存储任何歌曲它只负责搜索、播放和歌单管理真正去各个网站找歌、拿播放地址、抓歌词的活儿全部由插件完成。每个插件本质上是一段描述如何与某个平台对话的程序去哪儿搜索、搜索结果长什么样、音频链接怎么拼、歌词页面怎么解析。你把插件装进播放器播放器就知道该怎样去那个平台取资源。这个设计让 MusicFree 变得极其轻巧——加一个平台只需要新增一个插件完全不影响播放器本体。仓库里到底有什么五分钟看懂目录把插件仓库克隆到本地后你会看到这样一张插件全家福git clone https://gitcode.com/gh_mirrors/mu/MusicFreePlugins目录/文件作用plugins/全部插件源码每个平台一个文件夹types/TypeScript 类型定义含插件接口规范example/一个最简单的插件示例FreeSoundtest/插件的调试入口脚本scripts/打包与生成插件清单的自动化脚本plugins.json官方插件索引清单含名称、地址、版本其中plugins.json是最值得先看的一份文件它列出的就是播放器插件市场里能看到的所有条目。目前仓库收录了 Audiomack、歌词网、歌词千寻、Navidrome、suno、udio、猫耳FM、快手、音悦台、YouTube、bilibili、WebDAV 等插件覆盖了视频取流、歌词匹配、AI 音乐、自建服务器四大方向。三步快速上手把插件装进播放器整个过程不需要写一行代码跟着做就行。第一步拿到插件地址。打开仓库根目录的plugins.json里面每个条目的url字段就是该插件的安装地址。以 bilibili 插件为例找到它对应的url值并复制。第二步在播放器中导入。打开 MusicFree App进入插件管理页面选择从 URL 安装把刚才复制的地址粘贴进去确认后等待安装完成。也可以直接导入整个plugins.json清单一次装齐所有官方插件。第三步验证生效。回到首页搜索栏输入一首歌名下拉结果列表。如果能看到来自 bilibili、YouTube 等多个来源的结果说明插件已经正常工作了。 小技巧不同插件可以同时启用。MusicFree 会把所有已装插件的搜索结果聚合在一起展示这也是全网聚合搜索的体验来源。插件地图四类插件一次讲清插件虽多但按用途可以分成四大家族选装思路一下子就清晰了。第一类视频平台取流把视频变成歌代表插件bilibili、youtube、kuaishou、yinyuetai。这类插件负责把视频网站上的音频内容提取出来。以 bilibili 插件为例它的源码plugins/bilibili/index.ts实现了搜索视频、获取分 P 信息、按音质挑选音频流、甚至导入收藏夹歌单的完整链路。打开一个 UP 主的音乐视频播放器就能拿到纯音频播放地址而且支持low / standard / high / super四档音质切换。第二类歌词匹配让界面跟着唱代表插件geciwang、geciqianxun。听歌怎么能没有滚动歌词这类插件专门负责搜索和抓取歌词文本。以歌词网插件plugins/geciwang/index.ts为例它通过解析歌词站点页面返回带时间轴的 LRC 歌词。当你在播放器里点开歌词面板播放器会自动拿着当前歌曲的标题和歌手去歌词插件里做一次寻词。第三类专业音频与 AI 生成内容代表插件audiomack、maoerfm、suno、udio。猫耳FM 是中文有声内容社区Audiomack 是海外音乐平台而 suno 和 udio 则对接了当下热门的 AI 音乐生成服务。装这几个插件等于给播放器接上了新鲜内容的水龙头——既有专业平台的正版音频也有 AI 实时生成的创意作品。第四类自建服务器把私有乐库搬进播放器代表插件navidrome、webdav、airsonic。如果你自己搭过音乐服务器这三款插件就是为你准备的。它们不访问任何公网平台而是连接你自己的服务器或网盘把你收藏多年的无损音乐库直接接入 MusicFree实现所有音乐一个播放器。场景实战把自家音乐服务器接进播放器这一节以 Navidrome 为例演示私有乐库如何接入顺便看看插件配置里的用户变量是怎么回事。Navidrome 插件的源码plugins/navidrome/index.ts在导出时声明了三个用户变量userVariables: [ { key: url, name: 服务器地址 }, { key: username, name: 用户名 }, { key: password, name: 密码 }, ]安装这类插件后播放器会提示你填写这些信息。填入你的 Navidrome 服务器地址、账号和密码插件内部就会用它们做签名认证然后像调用本地接口一样搜索、取流、拿专辑信息。WebDAV 插件的逻辑更直白——它只做三件事列出指定目录下的音频文件、按文件名过滤搜索、生成下载链接相当于把网盘文件夹映射成了你的音乐库。⚠️ 避坑提示自建服务器类插件强依赖正确的地址格式。如果填的服务器地址没带http://或https://前缀插件会自动帮你补全但如果是局域网地址请确认手机和服务器在同一网络下。常见问题排查清单问装完插件搜索却没有任何结果按顺序排查先确认插件确实处于已启用状态再换一个更简短的关键词试试有些站点对长句搜索不友好最后检查目标平台本身是否可访问——视频站的反爬策略变化很快插件失效往往发生在平台接口调整之后。问能搜到歌但点播放就报错这类问题多半出在音源链接失效上。可以先在设置里切换到标准音质再试一次如果仍不行说明该资源当前不可用换一个来源换插件播放即可。问插件需要手动更新吗建议定期回到插件管理页检查更新。plugins.json里的每个条目都带版本号scripts/generate.js这个脚本会在打包时自动读取各插件源码里的版本字段、重新生成清单所以新版本发布后在播放器里刷新一次就能拿到。进阶玩法动手写一个自己的插件仓库的设计初衷就是让开发者也能轻松造插件。插件导出的其实是一个符合规范的对象核心字段如下完整定义见 types/plugin.d.ts字段作用platform插件名称也是聚合搜索时的来源标识version插件版本号search搜索函数按关键词和页码返回结果getMediaSource根据歌曲信息返回实际播放地址getLyric返回歌词文本getAlbumInfo获取专辑内歌曲列表getTopLists获取榜单/歌单入口想要快速入门最省力的方式是读一遍 example/freesound.js。它只有五十多行却完整演示了搜索 → 解析页面 → 返回结果的最小闭环用 axios 请求搜索页 HTML用 cheerio 解析出标题、作者、封面和音频地址最后组装成一个带id字段的结果对象返回。看懂这一个文件你就掌握了插件开发的八成套路。写好后把编译产物放到dist/目录再跑一遍打包脚本重新生成plugins.json你的插件就上架了——整个过程在 scripts/generate.js 里都有体现。说在最后MusicFree 插件体系的精髓是播放器保持纯净把可能性交给插件。装上视频取流插件B 站和 YouTube 成了你的曲库装上歌词插件跟唱体验完整了接上自建服务器多年收藏的私有乐库也终于统一了入口。从零开始到搭建完毕前后不过几分钟。现在就可以动手克隆仓库、打开plugins.json、在播放器里导入插件、搜索你的第一首歌。如果对源码感兴趣就从example/freesound.js和types/plugin.d.ts读起。 温馨提示本仓库的插件均为示例性质数据来自网络公开接口已过滤掉所有 VIP、收费与试听内容仅供学习参考请勿用于商业用途。合理、合法地使用这些资源才能让免费音乐生态走得更远。【免费下载链接】MusicFreePluginsMusicFree播放插件项目地址: https://gitcode.com/gh_mirrors/mu/MusicFreePlugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考