从 GitHub 等公开渠道发现并整理洛雪音乐(lx-music)自定义音源脚本的发布链接, 定期检查链接可达性,并在一个 Web 页面中展示,方便复制导入。
本项目只做下面几件事:
- 发现公开仓库/页面中发布的音源脚本直链(
.js); - 记录元数据(名称、版本、作者等,全部来自脚本头部注释的静态解析);
- 定期检查链接是否仍可下载、脚本文本是否具备 lx 音源特征(
globalThis.lx等静态特征); - (可选)把实测置信度最高的若干个脚本按固定文件名覆盖导出到本地目录,方便自建长期不变的对外 URL。
本项目不做:不存储/解析/提供任何音乐内容;不请求任何音乐免费/付费资源的下载分页。
音源脚本本身的内容、合法性与使用风险由使用者自行承担。
在默认的静态检查之上,提供一个可选的增强能力:把收录的音源脚本放入
Node 沙箱(node vm + 全局 lx 环境模拟)真实运行一次,看其能否返回音频地址:
- 词条为固定测试歌曲(128k 起步),只测"存活与可用性",不验证账号/付费权限;
- 结果分级
usable / degraded / not-loadable,配合各平台失败原因逐一展示; - 支持
deep模式对 flac/flac24bit 声明做音质核验(Bitrate/采样率/位深); - 默认
probe.enabled=false;后台「配置管理 → 沙箱实测」可一键开关并设置定时任务 (保存即生效,无需重启),开启需运行环境有 Node ≥20(官方 Docker 镜像已内置, 源码裸机部署需自行安装);详见 沙箱实测。
按实测置信度取 Top N(默认 3,可配)个音源脚本,以固定文件名(默认
lx-source-1.js / -2 / -3)覆盖写入容器内固定目录 /app/outjs/,并可定时或
在每轮实测后自动刷新。文件名只由名次决定,Top 榜换人时覆盖同名文件,因此
/local/lx-source-1.js 这类对外地址永远不变,适合为音源本地化提供一个稳定的
导入 URL。写入走原子替换,不会读到半截脚本。
Docker 部署时在 docker-compose.yml 里把宿主机/NAS 目录挂载到 /app/outjs 即可
自定义落盘位置:
volumes:
- ./data:/app/data
- /vol1/docker/lxhub/outjs:/app/outjs后台「配置管理 → 本地化输出」可开关、设置 TopN / 文件名模板 / 周期,查看已导出
文件与「立即导出」;命令行也可 python main.py export-local。详见
配置说明。
| 文档 | 内容 |
|---|---|
| 快速开始 | 安装、首次爬取、启动服务、命令行 |
| 配置 GitHub Token | 建议优先看——不配置会严重限制收录量 |
| 配置说明 | config.json 全部字段与环境变量 |
| 脚本类型 | 音源 / 配套脚本 / 存疑 的判定依据 |
| 加速前缀 | 复制链接时自动拼接镜像前缀 |
| 部署方式 | Docker Compose / Railway 自部署 |
| 工作原理 | 发现 → 收录 → 判定 的完整流程 |
| 沙箱实测 | 可选的"真实取歌核验"(probe):原理、配置、风险边界 |
| API | 接口列表 |
| 常见问题 | 收录少、链接失效等问题 |