https://lxmusic.toside.cn/

一个基于 Electron 的音乐软件，官网：https://www.lxmusic.cn/，秒杀市面上一切音乐APP，

教程：https://zhuanlan.zhihu.com/p/2016513313782113612

如果你用洛雪音乐（LX Music），应该早就体会过它的好：免费、开源、无广告、跨平台，Windows / macOS / Linux / Android 都能装，桌面歌词、歌单管理、本地音乐一应俱全。

但很多人装完之后，卡在了最后一步——歌是灰的，点开不响。

原因很简单：洛雪音乐是一款「播放器」，它本身不提供任何音乐内容。它需要一个「音源接口」接进来，才能把你想要的歌真正放出来。

也就是说，洛雪音乐是身体，音源接口才是灵魂。 没有好的音源，再漂亮的播放器也只是个空壳。

音源接口，才是真正的分水岭

市面上的免费音源接口，问题一个接一个：

三天两头失效，昨天还能听，今天全灰；
音质参差，好歌只能听 128k 的糊味；
歌单不全，新歌、冷门歌、翻唱根本搜不到；
维护靠爱发电，说停就停，你的歌单说没就没。

你缺的不是一个播放器，而是一个稳定、持续维护、音质在线的音源接口。

为什么值得为它付费

一个真正用心维护的音源接口，背后是持续的服务器成本、接口适配、失效修复、曲库更新。它不是一次性下载，而是一项需要长期投入的服务。

为它付一点小钱，你换来的是：

稳定：不用再隔三差五找新接口，打开就能听；
音质：高清音源，让你的耳机不白买；
全：新歌同步、热门冷门都能搜到；
省心：失效了有人第一时间修，你什么都不用管。

一个月十几块钱，换一个「打开就听、永不折腾」的音乐体验——比开一个视频会员还值。

现在订阅，解锁完整体验

我已经把稳定音源接口整理好了，一次配置、长期使用，支持随时更新。

限时开通，早订早享受。 想要稳定听歌、告别灰歌单的朋友，私聊我了解详情。

一次配置，长久享受。你的歌，本该想听就听。

洛雪音乐（LX Music）音源方案归档

归档时间：2026-10-03 环境：洛雪音乐手机版（cn.toside.music.mobile）+ 极空间 NAS（192.168.5.178，Docker）结论：已自建私有解析服务器（主力）+ 公共音源离线包（备胎）

一、背景：为什么音源会大面积失效

现象：洛雪里导入的 ikun 音源 v6、独家音源、野花野草等，之前秒放，后来大量歌曲无法播放。

原因：洛雪本体只是播放器，所有在线播放能力依赖第三方音源脚本，而脚本又依赖脚本作者维护的"解析服务器"。这些公益服务器被大量用户共用，音乐平台风控封 IP、接口规则改动后，中间环节即整体失效。脚本没坏，是服务器死了。这不是手机或网络问题。

二、原理：一次播放请求的完整链路

角色	作用	关键点
音源脚本（.js）	"问路纸条"，告诉洛雪向哪个地址、按什么格式要链接	本身不含音乐，不生产链接
解析服务器	"跑腿的"，向平台官方接口请求并算出临时直链	失效几乎都发生在这环
平台官方接口	音乐文件真正存放处	直链是有时效的通行证

推论：自建 = 把"跑腿的"从别人的公益服务器换成自己 NAS 上的私有服务器。只有自己在用，请求量小、IP 干净，稳定性远好于公共服务。

三、自建方案完整流程（已跑通）

3.1 最终架构

NAS（极空间，192.168.5.178）Docker 运行两个容器：
- lx-music-api：解析服务（镜像 sunuo/lx-music-api-server，端口 9000）
- lx-music-redis：缓存数据库（新版代码必需，redis:6.2-alpine）

洛雪音源脚本由服务端自动生成：http://192.168.5.178:9000/script

配置文件：项目目录/data/config.json（cookie、API key 等在此修改）

compose 文件备份：docker-compose.yml（本目录）

3.2 部署踩坑记录（重要，重装/换机时照着避坑）

坑	现象	解法
docker.io 被墙	拉镜像超时 `registry-1.docker.io ... timeout`	镜像名加国内加速站前缀：`docker.1ms.run/镜像名`（备选 `docker.xuanyuan.me/`、`docker.m.daocloud.io/`）
`ikun0014/lx-music-api-server-python` 已下架	加速站报 `manifest unknown`	该镜像已被作者删除，改用社区镜像 `sunuo/lx-music-api-server`
刚启动时访问 9000 拒绝连接	`ERR_CONNECTION_REFUSED`	首次启动容器内要装 Python 依赖（约 1 分钟），日志出现 `Uvicorn running on http://0.0.0.0:9000` 即正常
根路径无法访问	浏览器打开 `http://IP:9000` 报错	正常，服务无首页，只响应 `/script`、`/url/...` 等接口
VIP 歌曲放出"酷我已为你开启免费听歌权限"语音	解析"成功"但内容是提示音	不是故障：VIP 歌曲需要在 config.json 填对应平台会员账号的 cookie

3.3 日常使用

导入音源：洛雪 → 设置 → 自定义源管理 → 导入 → 在线导入 → http://192.168.5.178:9000/script

填 VIP cookie（听周杰伦等 VIP 曲库必需）：
1. 电脑浏览器打开平台官网（如 kuwo.cn）登录 VIP 账号；
1. F12 → Network → 刷新 → 任一请求 → 请求头复制 Cookie: 整串；
1. 粘贴到 data/config.json 对应平台 cookie 字段，重启项目。
1. 过期表现 = VIP 歌又放提示音，重新粘贴即可。酷我 cookie 最耐用（数月）；kg/tx 服务端自动刷新登录。

外网使用（手机流量）：内网 IP 出门不可用，方案为 Tailscale 组网（compose 中已备好注释段）：NAS 跑 tailscale 容器（host 网络）+ 手机装 Tailscale 登录同账号 → 用 http://100.x.x.x:9000/script 重新在线导入一次（服务端按访问地址自动生成脚本，100.x 地址内外网通用）。

3.4 维护

容器已设 restart: always，NAS 重启自动拉起；

平台接口改版导致全部失效时：重新拉取镜像升级（docker compose pull && docker compose up -d），或关注 MeoProject/lx-music-api-server 仓库动态；

镜像只需拉取一次，加速站失效不影响已部署服务。

附录 A：可用公共音源清单（2026-10-03 实测可下载）

来源仓库：github.com/pdone/lx-music-source（社区维护最勤的音源汇总仓，2026-09 仍在更新）。

国内网络说明：

raw.githubusercontent.com 国内无法直连，必须加 https://ghproxy.net/ 前缀；

若 ghproxy.net 失效，可替换为：https://gh.llkk.cc/、https://github.moeyy.xyz/、https://ghproxy.cn/、https://ghp.ci/（前缀格式相同）；

网络能直连 GitHub 时，去掉前缀用原始链接更佳。

本地离线包：以上 10 个音源已全部下载到本目录 lx-sources-offline/（文件名如 lx-latest.js、sixyin-latest.js），传到手机后"本地导入"即可，完全不依赖网络。

附录 B：音源脚本的本地离线导入方法

从链接保存：浏览器打开音源链接（显示一堆代码，混淆属正常）→ Ctrl+S → 保存类型"所有文件" → 文件名改 xxx.js。不要改动文件内任何字符；

传到手机：微信文件传输助手 / 数据线 / NAS 共享文件夹；

导入：洛雪 → 设置 → 自定义源管理 → 导入 → 本地导入 → 选择 js 文件 → 勾选启用，显示"初始化成功"即可。

附录 C：使用策略建议

主力：自建源（192.168.5.178:9000/script 或 Tailscale 100.x 地址）——稳定、可控、五平台；

备胎：离线包中挑 2~3 个公共源导入（推荐独家音源 + 六音 + 一个聚合源），某个失效删掉换下一个，互不影响；

听 VIP 曲库：唯一正路是自建源 + 自己的会员 cookie；公共源对 VIP 歌曲同样无能为力；

排错顺序：清歌曲 URL 缓存并重启洛雪 → 换源 → 检查服务端日志（lx-music-api 容器）→ 检查 cookie 是否过期。

相关文件：docker-compose.yml（NAS 部署配置）、lx-sources-offline/（10 个公共音源离线包）、lx-custom-source-nas.js（手写对接脚本，已被服务端自动脚本取代，留作参考）

瑟谷智学 · 全站解锁弹窗

示例页：关闭弹窗后，右下角出现「解锁全站」入口可再次唤起｜嵌入博客时删除本行提示

此处内容已隐藏，「密码可见」