耳朵一旦习惯了无损音质,再回头听普通 MP3 就像从 4K 屏换回 720p——不是不能用,是没那个感觉了。网易云里那些 无损、Hi-Res、超清母带 的曲目,官方 App 不让直接下载到本地存起来;想攒一套自己的音乐库,总得有个顺手的路子。

今天说的这个开源项目 Netease_url(网易云无损解析工具)就是干这个的:贴一首歌、一个歌单或一张专辑的链接,选个音质,它就把音频、封面、歌词一并解析出来给你。网页界面和 API 都有,批量处理直接调接口,还能 Docker 一键部署。GitHub 上 2.7k+ 星,MIT 协议,Python 写的,一个人也能顺手跑起来。

一句话定位:这是一个自部署的网易云无损音乐解析服务——你贴链接、选音质,它返回可下载的音频文件加封面歌词。支持 7 档音质(标准 → 超清母带),网页 + API 双入口,Docker 一键起。唯一的硬前提:得用你自己的黑胶会员 Cookie,高音质才解得开。

一、它是什么,能干啥

Netease_url 是一个用 Python + Flask 写的小服务(默认端口 5000),MIT 协议开源,仓库 Suxiaoqinx/Netease_url。截至 2026 年 9 月,GitHub 上 约 2,769 星、417 fork,最近一次提交在 2026 年 8 月,还活跃着。它不是一套客户端 App,而是部署在你自己机器 / NAS 上的一台”解析服务器”——你浏览器或脚本访问它,它替你去网易云拿数据。

核心能力就四件事:歌曲搜索、单曲解析、歌单 / 专辑批量解析、多音质下载。输入可以是歌曲 ID、完整链接,也可以是歌单 / 专辑的 ID 或链接,工具自己识别。

二、七档音质,从通勤到收藏级全有

这是它最吸引人的地方:音质档位一路铺到收藏级。每一档对应什么规格、适合什么听法,下面这张表列清楚了:

音质档位标识规格适合场景
标准音质standardMP3 128kbps通勤、省流量
极高音质exhighMP3 320kbps普通耳机,讲究点
无损音质losslessFLAC入门 Hi-Fi
Hi-Res 音质hiresFLAC 24bit/96kHz发烧友首选
高清环绕声jyeffect空间音频环绕 / 沉浸式听法
沉浸环绕声sky空间音频更沉浸的空间体验
超清母带jymaster母带级收藏、对音质最讲究

每档都能连同封面、歌词一起拿到。注意最后几档(无损、Hi-Res、环绕声、母带)对账号的要求更高,下面第三节专门说。

三、那个绕不过去的门槛:黑胶会员 Cookie

必须先把这条讲清楚,因为它是整个工具能不能用好高音质的前提。普通账号只能解到 standard / exhigh;想拿 无损、Hi-Res、环绕声、超清母带,你的账号得是黑胶会员,并且把会员 Cookie 喂给工具。原因很简单:网易云对高音质资源的下载链接做了会员身份校验,Cookie 里带 MUSIC_U 等字段就是那把钥匙。这个限制是平台侧的,工具本身”没法绕”,也没必要绕。

合规提醒:这个工具解决的是“把自己订阅权益内能听到的音质存到本地”的问题。请只解析你自己的会员账号下有权播放的内容,用于个人收藏,别拿去二次传播或商用——项目 LICENSE 里也明确写了”禁止用于商业或付费项目”。

四、怎么拿到并喂上 Cookie

流程不复杂:登录网易云网页版,按 F12 开开发者工具,切到 Network,随便点一个请求,把它请求头里的 Cookie 整串复制出来,存进项目里的 cookie.txt。项目里还带了 cookie_manager.py,会自动校验格式、备份关键信息,少走弯路。Cookie 过期了(会员续期、换设备)再重抓一次即可。

五、三种部署方式,看你要哪种

它给的是源码直跑、Docker、Docker Compose三条路,环境要求 Python 3.7+(Docker 走仓库里的 Dockerfile 不占你本机环境)。下面是最常用的两条,命令不多,挑顺手的就行。

5.1 源码直跑

bash
# 1. 克隆并进入项目
git clone https://github.com/Suxiaoqinx/Netease_url.git
cd Netease_url

# 2. 装依赖
pip install -r requirements.txt

# 3. 把黑胶会员 Cookie 写进 cookie.txt(步骤见上一节)

# 4. 启动服务
python main.py

起完在浏览器打开 http://localhost:5000,就是那个能搜索 / 解析 / 下载的网页界面。

5.2 Docker Compose 一键起(NAS / VPS 上跑最合适)

把服务挂到你的 NAS 或任何能常驻的机器上,全家设备都能访问。仓库里带 docker-compose.yml,起之前把 Cookie 配置好,然后:

bash
# 在 Netease_url 目录里
docker compose up -d

# 查看运行状态
docker compose logs -f

起完访问你机器 IP 的 5000 端口即可。想换端口、映射数据目录,改一下 compose 文件就行。

六、网页界面 + REST API,批量直接调接口

除了网页,它暴露了一套 RESTful API,歌单 / 专辑这种”一次几百首”的场景直接脚本化批量拉,比手点快得多。日常用网页;想把下载流程接进自己任务里(比如每晚自动补库),就调 API。输入格式上,歌曲 ID、歌曲 / 歌单 / 专辑链接都能识别,省心。

网页界面

图形化操作,搜索、解析、选音质、下载一条龙,适合手动整理少量曲目。

REST API

批量歌单 / 专辑、定时任务、对接本地音乐库,走接口最利落。

Docker / Compose

常驻在 NAS 或 VPS,全家设备共享同一套解析服务。

七、适合谁、不适合谁

适合

  • 有黑胶会员、想把常听的无损 / Hi-Res 曲目攒到本地
  • 有 NAS 或一台常驻机器,愿意部署一次
  • 喜欢脚本化,用 API 批量建自己的音乐库

不适合

  • 没黑胶会员还想要无损 / 母带——高音质档位解不开
  • 只想开箱即用、不想折腾部署的纯小白
  • 打算下载后二次传播、商用——违反项目协议
Netease_url开源MIT网易云解析

网易云音乐链接解析服务:网页端粘贴链接就能拿到 7 档音质直链,同时提供 REST API 与 Docker 部署,常驻 NAS / VPS 全家共用。

★ 2769
GitHub Star
⑂ 417
Fork
MIT
开源协议
PythonFlaskDockerREST API