字
字节笔记本
2026年2月22日
洛雪音乐移动版：基于 React Native 的开源音乐播放器
本文介绍洛雪音乐移动版（LX Music Mobile），一个基于 React Native 开发的开源音乐播放器。该项目在 GitHub 上已获得超过 15,000 stars，支持 Android 平台，提供多源音乐聚合播放功能。
项目简介
洛雪音乐移动版（LX Music Mobile）是一款免费开源的移动端音乐播放软件，由开发者 lyswhut 维护。该项目基于 React Native 跨平台框架开发，目前主要支持 Android 5 及以上版本。截至 2025 年 2 月，项目在 GitHub 上已获得 15.7k stars 和 1.8k forks。
该软件的核心特点是支持多个音乐平台的音源聚合，用户可以通过自定义音源接口来播放不同平台的音乐资源。
核心特性
- 多平台音源支持：内置支持酷我、酷狗、咪咕等多个官方音乐平台音源
- 自定义音源：支持通过"自定义源"设置接入第三方音源接口
- 数据同步服务：提供独立的数据同步服务端，支持多端数据同步
- 本地音乐管理：支持本地音乐文件的扫描和播放
- 播放列表机制：灵活的播放列表管理系统
- 开源免费：基于 Apache-2.0 协议开源，完全免费无广告
技术栈
| 技术 | 用途 |
|---|---|
| React Native | 跨平台移动应用框架 |
| Redux | 状态管理 |
| TypeScript | 类型安全的 JavaScript 超集 |
安装指南
前置要求
- Android 5.0 及以上版本
- 开启"允许安装未知来源应用"权限
安装步骤
- 访问 GitHub Releases 页面
- 下载最新版本的 APK 文件（如
lx-music-mobile-v1.8.1-arm64-v8a.apk） - 在 Android 设备上安装下载的 APK 文件
注意：目前暂无计划支持 iOS 和 HarmonyOS NEXT 平台。
使用说明
初始设置
软件默认设置不以新手友好为目标，建议首次使用时：
- 浏览并调整软件设置以符合个人喜好
- 阅读音乐播放列表机制文档
- 配置"自定义源"以获取音源接口
数据同步
从 v1.0.0 版本起，项目提供了独立的数据同步服务：
- 同步服务端项目：lx-music-sync-server
- 支持部署到私人服务器实现多端数据同步
- 同步内容包括播放列表、收藏歌曲等用户数据
项目协议与免责声明
本项目基于 Apache License 2.0 许可证发行，并附加以下协议条款：
数据来源说明
- 在线数据来源于各官方平台的公开服务器，与未登录状态下在官方 APP 获取的数据相同
- 本项目本身不具备获取音频数据的能力，音频链接由用户配置的"源"返回
- 本项目不对数据的合法性、准确性负责
使用限制
- 使用过程中产生的版权数据需在 24 小时内 清除
- 禁止在违反当地法律法规的情况下使用本项目
- 本项目仅用于技术学习交流，不接受任何商业合作及捐赠
相关项目
- 桌面版：https://github.com/lyswhut/lx-music-desktop
- 数据同步服务：https://github.com/lyswhut/lx-music-sync-server
- 官方文档：https://lyswhut.github.io/lx-music-doc/
贡献代码
本项目欢迎社区贡献，贡献前请注意：
- 添加新功能建议先创建 Issue 讨论
- 修复 bug 的 PR 请提供问题说明和重现方式
- 开发请基于
dev分支，PR 也提交至dev分支
详细的源码使用方法请参考官方文档。
项目链接
分享: