CurrentMusic

简体中文 · English

用浏览器听歌，也可以搭建自己的音乐服务。

逐字歌词 · 云端歌单 · 多人一起听

打开 CurrentMusic 流声屿 · 社区客户端 CurrentMusicX · 流声引擎官网

界面预览 · 功能一览 · 项目实现原理 · 自托管与构建 · API 文档

界面预览

_{当前 Web 界面 · 演示曲库 · 点击图片查看原图}

查看桌面播放页

开始使用

• Web 播放器可直接在浏览器打开。登录 CurrentMusic 后，可以播放歌曲并同步红心、收藏、歌单和搜索历史。按需绑定网易云账号，即可使用对应的歌单和推荐。
• CurrentMusicX 是社区维护的原生 Android 客户端。安装、兼容性和功能说明见其仓库。

功能一览

功能	支持能力
发现音乐	分类搜索、按歌词搜歌、每日推荐、排行榜、私人漫游与心动模式。
播放与歌词	音质选择、自动音源回退、逐字歌词与翻译、音质资料、副歌跳转及版本推荐。
整理曲库	自建歌单、红心、收藏、最近播放和听歌统计，支持绑定网易云。
一起听与分享	房间内同步播放和管理队列，生成歌曲链接、方块或沉浸式分享图。
外观与交互	深浅主题、封面取色、玻璃效果、迷你播放器，以及手机和平板、桌面的响应式布局。在「设置 → 外观 → 界面风格」可选用 Aimo 设计。
账号与交流	通行密钥、两步验证、社区动态、聊天室和可选 AI 助手。

项目实现原理

客户端怎样分流

• Web 流声屿默认把搜索、歌曲详情、歌词、播放取址、账号和社区等业务 API 统一发往流声引擎的 /cm/。可选 LeiZ 音源会直接请求 LeiZ。云盘分步上传由引擎申请令牌和登记文件，中间的文件数据可直传对象存储。
• CurrentMusicX 由客户端按功能、音源设置和登录态选择路径。默认音源的播放取址、站内账号和歌单、社区、站内房间以及云端绑定走引擎。搜索、评论和网易云原生双人一起听可直连网易云，已在手机登录网易云时，个人歌单、收藏和推荐通常也走直连。没有本机网易云会话时，部分账号功能可走引擎复用云端绑定。选择「网易云原生」音源后，播放取址也由手机直连，歌词来源可另选。

流声引擎怎样处理请求

1. HTTPS 反向代理将 /cm/ 转发给 Python 后端，并写入可信客户端 IP。后端按路由处理登录校验、限流和缓存。公开搜索、详情和歌词可供访客查询，媒体取址要求 CurrentMusic 登录。搜索和播放取址可将可信客户端 IP 传给上游，并据此隔离缓存。
2. 站内账号、歌单、社区和房间由后端处理，会话和业务数据保存在 SQLite。聊天室和听歌房可用服务器发送事件（SSE）接收更新。需要访问网易云时，后端通过 CM_NCM_BASE 调用独立部署的 NCM API（Node.js / api-enhanced），由它向网易云发起协议请求并返回结果。
3. 网易云个人操作走单独的鉴权路径。引擎校验 CurrentMusic 会话，再读取该用户绑定的网易云 Cookie 来访问其歌单、收藏等数据。X 端完成本机网易云登录后，可通过 /cm/ncmbind/import 将凭据同步给引擎，由服务端验证账号归属。引擎保存的 Cookie 只用于服务端请求。

匿名 SVIP 怎样取址

1. 用户登录 CurrentMusic 后，以站内令牌请求 GET /cm/ncm/song/url，提交歌曲 ID 和音质档位。这里的「匿名」指取址可以省略个人网易云绑定。
2. 后端读取 CM_NCM_COOKIE 指向的文件，将服务器配置的网易云 SVIP Cookie 注入发往 NCM API 的官方取址请求 /song/url/v1。网易云按该服务端账号的权益、曲目限制和请求档位返回结果。站内令牌用于引擎鉴权，服务端 Cookie 用于上游鉴权。
3. 引擎选择可用音质，探测最终官方地址的音频头。官方取址失败或只返回试听时，可经部署好的匹配器查找候选音源，并校验音频和时长。匹配请求使用公开歌曲资料，发往匹配器的请求不携带这两类网易云 Cookie。
4. 后端返回播放地址和可验证的音频信息。常规播放时，Web 和 X 直接从返回的 CDN 或匹配音源地址读取音频。歌词走独立接口。引擎优先使用官方 YRC，缺少逐字数据时可由 LDDC 补全，最后回退到 LRC 并标记估算的逐字时间。X 可独立选择本机直连或自动多源匹配。

部署记录还记载了一个独立的 ncm-inject 入口。它对符合注入规则且调用方未带 Cookie 的请求补上服务端 SVIP Cookie，再交给 NCM API。上图的 Web 与 X 默认请求链使用的是 /cm/。

后端说明 · 播放取址 · 账号绑定 · 歌词接口 · 部署记录

自托管与构建

启动后端

在仓库根目录执行以下命令。后端需要 Python 3.11+。

python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install -r deploy/requirements-auth.txt -r deploy/requirements-search.txt
mkdir -p data
cp deploy/backend.env.example data/backend.env
# 编辑 data/backend.env，将 CM_DATA_DIR、CM_DB 等路径设为当前实例的绝对路径。
set -a
. data/backend.env
set +a
python3 backend/manage.py init-db
python3 backend/manage.py create-owner admin --nickname 管理员
python3 backend/cm_server.py

后端默认监听 127.0.0.1:3010，可用 GET /health 检查状态。创建站长时省略密码会生成随机密码并显示一次。

音乐功能通过 CM_NCM_BASE 连接独立部署的网易云 API。账号、歌单等本地功能可单独运行，AI、邮件、短信、分享图和 LDDC 按需配置。生产部署和反向代理见 后端说明 与 部署模板。

构建 Web

使用 Node.js 20+ 在仓库根目录构建。

npm --prefix web ci
python3 tools/check-js-refs.py
npm --prefix web run build
python3 tools/deploy-web.py --target data/app

前端产物写入 app/src/main/assets/www/。部署脚本会先同步静态资源，再切换带内容指纹的首页。

Android 壳、官网与文档站构建

Android 构建需要 JDK 17、Android SDK Platform 34 和 Build Tools 34.0.0，最低支持 Android 7.0（API 24）。

export ANDROID_HOME=/path/to/android-sdk
bash build.sh

APK 写入 dist/。版本默认取自 web/src/version.js，也可通过 VER_NAME 和 VER_CODE 设置。首次本地构建会创建自签名密钥，升级时需使用相同签名。签名密码通过 CM_KS_PASS 配置，密钥和密码保存在本机。

# 官网复用 Web 依赖，输出到 data/www。
node site/build.mjs

npm --prefix api-docs ci
npm --prefix api-docs run build
npm --prefix api-docs run publish

文档从当前后端路由和登记表生成。构建时可用 NCM_API_DIR 指定独立的 api-enhanced 源码目录，加入上游接口参数摘录。详见 文档构建说明。

仓库目录

目录	内容
backend/	Python 后端、账号、网易云网关、播放、房间、通行证与 AI
web/	Web 与 Android 共用界面
app/	Java WebView 壳及前端静态资源
windows/	C# / WinUI 3 原生客户端及安装器源码
site/、api-docs/	官网与 API 文档站
deploy/	systemd、Nginx、环境变量与备份模板
tools/、docs/	构建、验证、维护脚本与接口说明

参与贡献

欢迎通过 Issue 反馈问题或提交 PR。提交前按改动范围运行构建与回归检查。后端测试使用临时数据库和数据目录。 反馈问题 · 贡献指南 · 更新日志

常用验证命令

tools/run-tests.sh
python3 tools/test-api-docs.py
python3 tools/test-open-source.py
python3 tools/check-open-source.py

主仓库保留了原公开前端仓库的提交、标签与 Releases，后端及其他组件以审查后的源码快照加入。运行数据和服务凭据保留在部署环境。 公开边界与迁移记录 · 安全问题报告 · RealIP 说明

开源与致谢

项目自有代码采用 MIT。上游文档、依赖、字体和独立服务保留各自许可。LDDC 作为独立服务接入，音乐、封面、用户头像等内容遵循各自授权。 MIT 许可 · 第三方声明