Profile
Back to NewsBack
GitHub Trending 5 min
Reader Mode
hebijunge/musicfree-plugins: MusicFree 插件订阅(57 个)+ 澜音 CeruMusic 插件(57 个)+ 洛雪 LX 五源合一自定义源;三套协议独立分发,附加速订阅、离线包与胶囊式插件导航页

hebijunge/musicfree-plugins: MusicFree 插件订阅(57 个)+ 澜音 CeruMusic 插件(57 个)+ 洛雪 LX 五源合一自定义源;三套协议独立分发,附加速订阅、离线包与胶囊式插件导航页

musicfree-plugins

三套音源插件生态的发布仓库:MusicFree(57 个订阅插件)、澜音 CeruMusic(57 个 v2 适配插件)、洛雪 LX(五源合一自定义源)。三套协议互不通用,各自在对应播放器的插件入口安装。

  • MusicFree 插件:通过「订阅」机制安装/更新,订阅清单不含任何洛雪 / 澜音内容
  • 澜音 Ceru 插件:由本仓 57 个 MF 插件适配成的 v2 artifact,单个 raw URL 导入(详见 CERU-README.md)
  • 洛雪自定义源:五源合一脚本,适用于所有 LX 协议播放器,单独下载导入,与 MusicFree 插件不通用(详见下方专节)
订阅站首页(生态胶囊 + 音乐平台胶囊左右滑动筛选、订阅地址一键复制):https://hebijunge.github.io/musicfree-plugins/

在 MusicFree「插件设置 → 订阅」中填入下面的订阅地址即可一键安装/更新全部插件。

按类别订阅(推荐)

插件按用途拆成 5 份清单,用哪个类别就只装哪份,不必一次拉 57 个(全量 8.2 MB,分类后常用平台只有 2.9 MB)。

主地址走 gh.padao.fun 加速:实测「常用六平台」6 并发下载 0.31~1.59 秒,全部落在 MusicFree 的 2 秒超时内。GitHub Pages 官方直出在同一测试下要 17~33 秒,会被 App 判超时,已降为备用线路。

| 类别 | 条目 | 体积 | 订阅地址(主 · gh.padao.fun) | |---|---|---|---| | ① 常用六平台 | 6 | 2.9 MB | https://gh.padao.fun/https://raw.githubusercontent.com/hebijunge/musicfree-plugins/master/sub/padao/main.json | | ② DJ / 舞曲 / 电音 | 30 | 0.96 MB | https://gh.padao.fun/https://raw.githubusercontent.com/hebijunge/musicfree-plugins/master/sub/padao/dj.json | | ③ 听书 / 电台 / 播客 | 10 | 0.62 MB | https://gh.padao.fun/https://raw.githubusercontent.com/hebijunge/musicfree-plugins/master/sub/padao/radio.json | | ④ 其它音乐平台 | 11 | 3.7 MB | https://gh.padao.fun/https://raw.githubusercontent.com/hebijunge/musicfree-plugins/master/sub/padao/music.json | | ⑤ 全部插件 | 57 | 8.2 MB | https://gh.padao.fun/https://raw.githubusercontent.com/hebijunge/musicfree-plugins/master/sub/padao/all.json |

  • ① 常用六平台 = QQ音乐 / 酷我 / 酷狗 / 咪咕 / 网易云 / 汽水
  • ④ 其它音乐平台 = B站 / 5sing / 千千 / 一听 / 街声 / Apple Music / 华为 / Jamendo / 聚合 / JOOX / 好听轻音乐
  • 分类清单随 plugins.json 同步生成:node scripts/gen-subscriptions.js
换线路只需换前缀(同一类别文件在所有线路下内容一一对应):

| 线路 | 前缀写法 | 说明 | |---|---|---| | gh.padao.fun | https://gh.padao.fun/https://raw.githubusercontent.com/hebijunge/musicfree-plugins/master/sub/padao/ | 主用,实测最快 | | GitHub Pages | https://hebijunge.github.io/musicfree-plugins/sub/githubio/ | 最稳,但下载慢,易触发 2 秒超时 | | fastly | https://fastly.jsdelivr.net/gh/hebijunge/musicfree-plugins@master/sub/fastly/ | jsDelivr 节点,速度同样偏慢 |

例:常用六平台的 Pages 版 = https://hebijunge.github.io/musicfree-plugins/sub/githubio/main.json

全部插件(57 个)· 备用线路

内容完全一致,只是插件下载源不同:

  • 主线路 gh.padao.fun:https://gh.padao.fun/https://raw.githubusercontent.com/hebijunge/musicfree-plugins/master/plugins.json
  • GitHub Pages 直出:https://hebijunge.github.io/musicfree-plugins/plugins.json
  • fastly:https://hebijunge.github.io/musicfree-plugins/plugins-fastly.json
  • gcore:https://hebijunge.github.io/musicfree-plugins/plugins-gcore.json
  • 其它 20 条:plugins-proxy-01.json ~ plugins-proxy-20.json(见首页「全部插件 · 备用线路」折叠区)

2026-10-30 导入速度实测(常用六平台,模拟 App 流程:拉清单 + 6 并发,连测 3 轮)

| 线路 | 拉清单 | 6 并发总耗时 | 最慢单文件 | 超 2s 条数 | |---|---|---|---|---| | gh.padao.fun | 170~598 ms | 0.31 / 0.34 / 0.35 / 0.37 / 0.54 / 1.59 s | 1.59 s(冷启动) | 0 | | GitHub Pages | 122~604 ms | 17.0 / 17.8 / 20.8 / 21.4 / 25.5 / 32.9 s | 32.9 s | 6 / 6 | | fastly | 92~286 ms | 14.4 / 16.0 / 16.1 / 17.0 / 17.6 / 18.3 s | 17.6 s | 6 / 6 |

  • 三种线路下载到的文件 sha256 均与源文件一致,差别只在速度。
  • GitHub Pages 并发下载实际速率约 24 KB/s(628 KB 的 QQ 插件 25.7 s),单文件串行时约 96 KB/s,说明它对并发有限速。
  • MusicFree 源码 axios.defaults.timeout = 2000 是硬上限,超时即报 timeout of 2000ms exceeded,因此慢线路表现为「导入失败」而不是「慢」。
  • 测试为本机直连结果,手机运营商不同会有差异;主线路若在你的网络下也超时,换下表任一前缀即可。

离线安装包(在线导入失败时用)

在线订阅对每个插件文件有 2 秒下载超时(MusicFree 源码 axios.defaults.timeout = 2000),网络一慢就报失败。离线包下载到本地再安装,完全不走这个超时。

下载页:https://hebijunge.github.io/musicfree-plugins/download.html

| 包 | 内容 | 大小 | 直链(加速) | |---|---|---|---| | mf-common-6.zip | 常用六平台 6 个 | 1.06 MB | https://gh.padao.fun/https://raw.githubusercontent.com/hebijunge/musicfree-plugins/master/dl/mf-common-6.zip | | mf-all.zip | 全部 57 个 | 2.99 MB | https://gh.padao.fun/https://raw.githubusercontent.com/hebijunge/musicfree-plugins/master/dl/mf-all.zip | | mf-dj.zip | DJ / 舞曲 / 电音 30 个 | 0.38 MB | https://gh.padao.fun/https://raw.githubusercontent.com/hebijunge/musicfree-plugins/master/dl/mf-dj.zip | | mf-radio.zip | 听书 / 电台 10 个 | 0.24 MB | https://gh.padao.fun/https://raw.githubusercontent.com/hebijunge/musicfree-plugins/master/dl/mf-radio.zip | | mf-music.zip | 其它音乐平台 11 个 | 1.31 MB | https://gh.padao.fun/https://raw.githubusercontent.com/hebijunge/musicfree-plugins/master/dl/mf-music.zip |

官方 Pages 直链把前缀换成 https://hebijunge.github.io/musicfree-plugins/dl/ 即可(较慢,但一定在)。

安装步骤:下载 zip → 系统文件管理器解压出 .js → MusicFree「插件设置」→ 右下角 + →「从本地安装插件」→ 多选 .js 文件。

选文件时若看不到 .js,把文件选择器的类型筛选切到「所有文件」。

重新打包:node scripts/pack-zips.js。

2026-10-30 线路实测(本机直连,基准文件 qq-source 643 KB,超时 12s)

| 线路 | 结果 | |---|---| | gh.padao.fun | ✓ 1.9s / 643 KB 完整 | | down.mxw.xx.kg | ✓ 3.0s | | 30006000.xyz | ✓ 3.6s | | wget.la | ✓ 3.7s | | fastly.jsdelivr.net | ✓ 3.7s | | github.cnxiaobai.com | ✓ 3.8s | | cdn.akaere.online | ✓ 4.0s | | xsadwsd.kdns.fr | ✓ 4.3s | | ghpxy.hwinzniej.top | ✓ 4.5s | | gh.acmsz.top | ✓ 5.1s | | ghproxy.053000.xyz | ✓ 5.2s | | gcore.jsdelivr.net | ✓ 5.6s | | git.yylx.win | ✓ 5.8s | | hebijunge.github.io | ✓ 6.7s | | cdn.jsdelivr.net / raw.githubusercontent.com / ghproxy.net / gh.927223.xyz / gh.halonice.com / js.jiangss.shop | ✗ 连不通(000) | | gh-proxy.com(302 KB)/ ghm.078465.xyz(490 KB) | ✗ 内容被截断(正常 643 KB),插件必解析失败 | | gh.felicity.ac.cn / gh.idayer.com | ✗ 429 限流 | | github.xxlab.tech | ✗ 302 跳转异常 |

本次已把 plugins-cdn.json 等旧文件的内容重排到上面 14 条可用线路,文件名保持不变以兼容历史链接;不可用线路不再生成订阅。

说明

  • 清单文件均托管在本仓库(GitHub Pages 直出,实时同步);区别仅在清单内插件文件的下载源。
  • 导入失败先查两点:① 订阅地址是否以 .json 结尾(MusicFree 的硬性校验,否则直接提示"订阅地址需以 .js/.json 结尾");② 换一条更快的线路。MusicFree 对单个文件下载有超时限制(源码 axios.defaults.timeout = 2000),慢线路上全量 8.2 MB 容易中途报错,只装常用平台稳得多。
  • 已失效通道对应的旧文件(plugins-proxy-06/07/13.json 等)保留在仓库中但已重排到可用线路,不再单独推荐。
  • 单个插件备用直链:fastly / gcore 可用;raw 直连不可用,需加代理前缀。
  • 校验脚本:node scripts/verify-subscriptions.js padao — 逐条下载比对字节数与 sha256。

jihulab 兜底(待配置,方案已就绪)

jihulab.com(GitLab 国内镜像)可作为 jsdelivr 之外的独立兜底源:仓库不依赖 GitHub 存活,且无 jsdelivr 的 12h 缓存问题(raw 直出最新 main)。接入需要 jihulab 账号与 Personal Access Token(本机无凭据,尚未建镜像仓库),方案二选一:

  • 全自动:在 GitHub 仓库 Settings → Secrets 配置 JIHULAB_TOKEN(jihulab PAT,write_repository 权限)与 JIHULAB_PATH(jihulab 命名空间/项目路径),.github/workflows/mirror-jihulab.yml 会在每次 master 推送后自动镜像(触发分支已修正为 master);未配置 Secrets 时该工作流自动跳过、不报错。
  • 手动/半自动:jihulab 网页建空项目后,本地克隆本仓库运行 JITOKEN= JIPATH=<命名空间>/<项目> ./scripts/sync-jihulab.sh(token 只走环境变量)。
  • 镜像建成后的兜底订阅地址:https://jihulab.com/<命名空间>/<项目>/-/raw/main/plugins.json

洛雪(LX)自定义源 · 多播放器通用

五源合一 LX 格式自定义源脚本(v1.6.0),适用于所有支持洛雪(LX)插件协议的播放器,已验证可用:洛雪 Music、澜音(CeruMusic),以及其它兼容 LX 协议的客户端。

说明:这是 LX(洛雪)格式脚本,不是 MusicFree 原生插件格式,无法在 MusicFree 的「插件订阅」里直接安装;请在对应播放器的自定义源 / LX 导入入口使用(见下方各播放器导入方法)。
https://hebijunge.github.io/musicfree-plugins/plugins/five-source-lx.plugin.v1.6.0.js

导入方法(按播放器):

  • 洛雪 Music:设置 → 自定义源管理 → 导入(选「在线链接」粘贴上方地址,或下载 .js 后选「本地文件」导入)
  • 澜音 CeruMusic:插件管理 → 添加插件 → 粘贴上方「在线导入链接」,或选择本地 .js 导入;首次启用授予 network(网络)权限即可
  • 说明:LX 自定义源为非订阅机制,一次导入一个脚本,导入后不会随清单自动更新;版本升级需重新导入。

澜音(CeruMusic)v2 插件 · 57 个

由本仓 57 个 MusicFree 插件适配为澜音 v2 原生 artifact,搜索 / 取链 / 歌词沿用原插件实现。

  • 清单:ceru-plugins.json(57 条,含能力与 sha256);逐条 raw URL 见 CERU-README.md
  • 安装:澜音 → 插件管理 → 添加插件 → 粘贴某个 .js 的加速直链(raw.githubusercontent.com 在国内常被重置);首次启用授予 network 权限
  • 能力:搜索 / 取链 / 歌词 57/57,榜单 49/57,歌单导入 26/57(已桥接为 playlistImporters)
  • 注意:v2 artifact 不是订阅清单,也不兼容 LX 脚本;超大插件(agg)采用精简构建以满足澜音 AST 节点上限

插件清单(MusicFree · 57 个)

| QQ音乐 | 1.9.26 | qq-source.plugin.v1.9.26.js | | 酷我音乐 | 1.9.24 | kuwo-source.plugin.v1.9.24.js | | 酷狗音乐 | 1.9.24 | kugou-source.plugin.v1.9.24.js | | 咪咕音乐 | 1.9.20 | migu-source.plugin.v1.9.20.js | | 网易云音乐 | 1.9.27 | netease-source.plugin.v1.9.27.js | | 汽水音乐 | 1.9.23 | qishui-source.plugin.v1.9.23.js | | B站 | 1.1.4 | bilibili-source.plugin.v1.1.4.js | | 番茄畅听 | 1.3.1 | fanqie-source.plugin.v1.3.1.js | | DJ多多 | 1.0.2 | djduoduo-source.plugin.v1.0.2.js | | 5sing | 1.0.2 | 5sing-source.plugin.v1.0.2.js | | 千千音乐 | 1.0.4 | qianqian-source.plugin.v1.0.4.js | | Y2002电音 | 1.0.2 | y2002-source.plugin.v1.0.2.js | | 一听音乐 | 1.0.2 | 1ting-source.plugin.v1.0.2.js | | 懒人听书 | 1.0.3 | lrts-source.plugin.v1.0.3.js | | 博看听书 | 1.0.2 | bokantingshu-source.plugin.v1.0.2.js | | 街声 | 1.0.1 | streetvoice-source.plugin.v1.0.1.js | | 火龙DJ | 1.0.4 | huolongdj-source.plugin.v1.0.4.js | | 快音 | 1.0.2 | kuaiyin-source.plugin.v1.0.2.js | | 猫耳FM | 1.0.3 | missevan-source.plugin.v1.0.3.js | | DJ串烧集 | 1.0.1 | djcsj-source.plugin.v1.0.1.js | | DJ秀 | 1.0.4 | djshow.plugin.v1.0.4.js | | Apple Music | 1.0.2 | apple-music-v1.0.2.js | | 华为音乐 | 1.0.3 | hwmusic-source.plugin.v1.0.3.js | | 蜻蜓FM | 1.0.3 | qingting-source.plugin.v1.0.3.js | | 喜马拉雅 | 1.2.1 | ximalaya-source.plugin.v1.2.1.js | | 荔枝FM | 1.0.2 | lizhi-source.plugin.v1.0.2.js | | 网易云电台 | 1.1.3 | neteaseradio-source.plugin.v1.1.3.js | | CCTV听音 | 1.0.2 | cctv-source.plugin.v1.0.2.js | | Jamendo | 1.0.2 | jamendo-source.plugin.v1.0.2.js | | 聚合 | 1.9.19 | agg-source.plugin.v1.9.19.js | | JOOX音乐 | 1.1.3 | joox-source.plugin.v1.1.3.js | | djuu DJ | 1.1.2 | djuu-source.plugin.v1.1.2.js | | 相声评书 | 1.0.3 | xiangsheng-pingshu-source.plugin.v1.0.3.js | | 皮狗DJ | 1.1.2 | pgdjz-source.plugin.v1.1.2.js | | DJKK | 1.1.2 | djkk-source.plugin.v1.1.2.js | | 水晶舞曲 | 1.2.2 | dj14-source.plugin.v1.2.2.js | | 清风DJ | 1.2.2 | ddddj-source.plugin.v1.2.2.js | | DJ766 | 1.4.1 | dj766-source.plugin.v1.4.1.js | | 82DJ | 1.2.1 | 82dj-source.plugin.v1.2.1.js | | QQDJ | 1.2.2 | qqdjs-source.plugin.v1.2.2.js | | 36DJ | 1.2.2 | 36dj-source.plugin.v1.2.2.js | | 宝贝DJ | 1.2.1 | bibdj-source.plugin.v1.2.1.js | | 172Mix | 1.2.1 | 172mix-source.plugin.v1.2.1.js | | DJ耶耶耶 | 1.1.2 | djyyy-source.plugin.v1.1.2.js | | 黑色音频 | 1.1.2 | hy57-source.plugin.v1.1.2.js | | 好听轻音乐 | 1.2.3 | htqyy-source.plugin.v1.2.3.js | | 我是DJ | 1.1.2 | 54dj-source.plugin.v1.1.2.js | | 电音阁 | 1.1.2 | dianyinge-source.plugin.v1.1.2.js | | SpaceDJ | 1.1.2 | spacedj-source.plugin.v1.1.2.js | | DJ6 | 1.0.2 | dj6-source.plugin.v1.0.2.js | | 73DJ | 1.0.1 | 73dj-source.plugin.v1.0.1.js | | 先上DJ | 1.1.1 | xsdj123-source.plugin.v1.1.1.js | | MixDJ | 1.0.2 | mixdj-source.plugin.v1.0.2.js | | 波比DJ | 1.0.1 | bobidj-source.plugin.v1.0.1.js | | 魅力DJ | 1.0.1 | djmei-source.plugin.v1.0.1.js | | DJ娱乐 | 1.2.1 | djyule-source.plugin.v1.2.1.js | | 小熊电音 | 1.0.2 | xxedm-source.plugin.v1.0.2.js |

目录结构

  • index.html — 订阅站首页(顶部生态胶囊「MusicFree / 澜音 Ceru / 洛雪 LX」左右滑动切换,下方音乐平台胶囊横向滑动筛选;数据自动跟随两份清单,含插件搜索)
  • plugins.json — MusicFree 订阅清单(结构对齐 musicfreepluginshub:desc + plugins[],每项 name/url/version;不含洛雪脚本,也不含澜音插件)
  • ceru-plugins.json — 澜音 v2 插件清单(57 条,含 capabilities 与 sha256;仅用于页面展示与校验,澜音端按单个 raw URL 导入)
  • ceru-plugins/*.js — 澜音 v2 插件文件(57 个)
  • CERU-README.md — 澜音插件完整说明与全部 raw URL
  • plugins/five-source-lx.plugin.v1.6.0.js — 洛雪自定义源脚本(仅洛雪专区入口分发,不进任何 plugins*.json)
  • plugins-fastly.json / plugins-gcore.json / plugins-cdn.json / plugins-ghproxy.json / plugins-proxy-01..20.json — 备用通道订阅清单(结构与 plugins.json 完全一致,仅插件 url 前缀不同)
  • scripts/sync-jihulab.sh — jihulab 镜像手动同步脚本(token 走环境变量,不落盘)
  • .github/workflows/mirror-jihulab.yml — master 推送后自动镜像到 jihulab(需 Secrets,未配置自动跳过;触发分支配置当前仍为 main,启用前需改为 master)
  • plugins/ — 插件 js 直链文件,文件名含版本号;更新插件时新增带新版本号的文件,并在 plugins.json 中把该项 url 与 version 指向新文件

维护约定

  • 新插件完成后:将 js 按命名规范放入 plugins/,在 plugins.json 追加一条(name/url/version 与插件内部声明一致)即可,订阅端自动生效
  • 插件升级:远端 plugins/ 每个源只保留最新版本文件,旧版本不保留(需要回看历史走 git 记录),plugins.json 中 url/version 更新到新文件
  • 版本号以各插件 js 内部 version 字段为权威依据
  • 洛雪自定义源脚本与 MusicFree 插件严格分离:只放 plugins/ 目录与订阅站洛雪专区,禁止写入 plugins.json 及任何镜像清单
Chat with me