mirror of
https://github.com/Suxiaoqinx/Netease_url.git
synced 2026-05-06 13:50:51 +08:00
main
网易云音乐无损解析
⚠️ 重要声明
本项目采用 MIT 许可证开源。根据 MIT 许可证的条款,任何个人或组织均可自由使用、修改和分发本项目的源代码,包括用于商业项目。
注意:本项目旨在为开源社区做贡献,我们鼓励用户:
- 在遵守开源精神的前提下使用和分享代码
- 如有改进,欢迎贡献回本项目
- 在商业使用中,请考虑对开源项目的支持和回馈
虽然 MIT 许可证允许商业使用,但我们希望用户能尊重开源精神,合理使用本项目。
✨ 功能特性
🎵 核心功能
- 🔍 歌曲搜索:支持关键词搜索网易云音乐库中的歌曲
- 🎧 单曲解析:解析单首歌曲的详细信息和下载链接
- 📋 歌单解析:批量解析歌单中的所有歌曲信息
- 💿 专辑解析:批量解析专辑中的所有歌曲信息
- ⬇️ 音乐下载:支持多种音质的音乐文件下载
🎼 音质支持
standard:标准音质 (128kbps)exhigh:极高音质 (320kbps)lossless:无损音质 (FLAC)hires:Hi-Res音质 (24bit/96kHz)jyeffect:高清环绕声sky:沉浸环绕声jymaster:超清母带
🌐 使用方式
- Web界面:直观友好的网页操作界面
- RESTful API:完整的API接口支持
- 批量处理:支持歌单和专辑的批量解析
- 多格式支持:支持ID和链接多种输入格式
🚀 快速开始
环境要求
- Python 3.7+
- 网易云音乐黑胶会员账号
安装步骤
1. 克隆项目
git clone https://github.com/Suxiaoqinx/Netease_url.git
cd Netease_url
2. 安装依赖
pip install -r requirements.txt
3. 配置Cookie
在 cookie.txt 文件中填入黑胶会员账号的Cookie:
💡 获取Cookie方法:登录网易云音乐网页版 → F12开发者工具 → Network标签页 → 复制任意请求的Cookie值
4. 启动服务
python main.py
5. 访问界面
打开浏览器访问:http://localhost:5000
🐳 Docker部署
# 使用Docker Compose
docker-compose up -d
# 或使用Docker
docker build -t netease-music-api .
docker run -d -p 5000:5000 netease-music-api
📖 使用指南
Web界面使用
🔍 歌曲搜索
- 选择功能:歌曲搜索
- 输入关键词(歌曲名、歌手名等)
- 点击搜索按钮
- 在搜索结果中点击解析或下载按钮
🎧 单曲解析
- 选择功能:单曲解析
- 输入歌曲ID或网易云音乐链接
- 支持格式:
1234567890或https://music.163.com/song?id=1234567890
- 支持格式:
- 点击解析按钮查看歌曲信息
📋 歌单解析
- 选择功能:歌单解析
- 输入歌单ID或网易云音乐歌单链接
- 支持格式:
1234567890或https://music.163.com/playlist?id=1234567890
- 支持格式:
- 点击解析按钮查看歌单中所有歌曲
- 点击单首歌曲的解析或下载按钮
💿 专辑解析
- 选择功能:专辑解析
- 输入专辑ID或网易云音乐专辑链接
- 支持格式:
1234567890或https://music.163.com/album?id=1234567890
- 支持格式:
- 点击解析按钮查看专辑中所有歌曲
- 点击单首歌曲的解析或下载按钮
⬇️ 音乐下载
- 选择功能:音乐下载
- 输入歌曲ID或链接
- 选择音质(标准/极高/无损/Hi-Res等)
- 点击下载按钮
支持的链接格式
# 歌曲链接
https://music.163.com/song?id=1234567890
https://music.163.com/#/song?id=1234567890
# 歌单链接
https://music.163.com/playlist?id=1234567890
https://music.163.com/#/playlist?id=1234567890
# 专辑链接
https://music.163.com/album?id=1234567890
https://music.163.com/#/album?id=1234567890
# 直接使用ID
1234567890
🔌 API接口文档
基础信息
- Base URL:
http://localhost:5000 - 请求方式: GET / POST
- 响应格式: JSON
接口列表
1. 健康检查
GET /health
响应示例:
{
"status": "ok",
"message": "Service is running"
}
2. 歌曲搜索
POST /search
Content-Type: application/json
{
"keywords": "周杰伦 稻香",
"limit": 10
}
响应示例:
{
"code": 200,
"result": {
"songs": [
{
"id": 185668,
"name": "稻香",
"artists": ["周杰伦"],
"album": "魔杰座",
"duration": 223000
}
]
}
}
3. 单曲解析
POST /song
Content-Type: application/json
{
"id": "185668"
}
4. 歌单解析
POST /playlist
Content-Type: application/json
{
"id": "123456789"
}
5. 专辑解析
POST /album
Content-Type: application/json
{
"id": "123456789"
}
6. 音乐下载
POST /download
Content-Type: application/json
{
"id": "185668",
"quality": "lossless"
}
响应: 直接返回音频文件流
音质参数说明(仅限单曲解析)
standard:标准音质exhigh:极高音质lossless:无损音质hires:Hi-Res音质jyeffect:高清环绕声sky:沉浸环绕声jymaster:超清母带
黑胶VIP音质:standard, exhigh, lossless, hires, jyeffect
黑胶SVIP音质:sky, jymaster
Docker 一键部署
-
修改参数
-
如需修改端口,请编辑
.env或docker-compose.yml文件中的ports配置,例如:ports: - "8080:5000"
-
-
启动服务
docker-compose up -d
在线演示
注意事项
- 必须使用黑胶会员账号的 Cookie 才能解析高音质资源。
- Cookie 格式请严格按照
cookie.txt示例填写。
致谢
反馈与交流
欢迎 Star、Fork 和 PR!
Languages
Python
73.7%
HTML
26%
Dockerfile
0.2%