From 780337dc2e7eefc0cee65cc69524f6599674b306 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=8B=8F=E6=99=93=E6=99=B4?= <37541680+Suxiaoqinx@users.noreply.github.com> Date: Mon, 25 Aug 2025 01:30:19 +0800 Subject: [PATCH] Update README.md --- README.md | 261 ++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 213 insertions(+), 48 deletions(-) diff --git a/README.md b/README.md index a4844fc..5902f12 100644 --- a/README.md +++ b/README.md @@ -1,78 +1,244 @@ -# 网易云无损音乐解析 +# 网易云音乐无损解析 -> **声明** +
+ +![GitHub stars](https://img.shields.io/github/stars/Suxiaoqinx/Netease_url?style=flat-square) +![GitHub forks](https://img.shields.io/github/forks/Suxiaoqinx/Netease_url?style=flat-square) +![GitHub issues](https://img.shields.io/github/issues/Suxiaoqinx/Netease_url?style=flat-square) +![GitHub license](https://img.shields.io/github/license/Suxiaoqinx/Netease_url?style=flat-square) + +**功能强大的网易云音乐解析工具** + +支持歌曲搜索 | 单曲解析 | 歌单解析 | 专辑解析 | 音乐下载 + +[在线体验](https://api.toubiec.cn/wyapi.html) • [使用文档](./使用文档.md) • [问题反馈](https://github.com/Suxiaoqinx/Netease_url/issues) + +
+ +--- + +> **⚠️ 重要声明** > 本项目为开源软件，遵循 MIT 许可证。任何个人或组织均可自由使用、修改和分发本项目的源代码。但本项目及其任何衍生作品**禁止用于任何商业或付费项目**。如有违反，将视为对本项目许可证的侵犯。欢迎大家在遵守开源精神和许可证的前提下积极贡献和分享代码。 ---- +## ✨ 功能特性 -## 功能简介 +### 🎵 核心功能 +- **🔍 歌曲搜索**：支持关键词搜索网易云音乐库中的歌曲 +- **🎧 单曲解析**：解析单首歌曲的详细信息和下载链接 +- **📋 歌单解析**：批量解析歌单中的所有歌曲信息 +- **💿 专辑解析**：批量解析专辑中的所有歌曲信息 +- **⬇️ 音乐下载**：支持多种音质的音乐文件下载 -本项目可解析网易云音乐无损音质下载链接，支持多种音质选择，支持 API 与命令行（GUI）两种模式。 +### 🎼 音质支持 +- `standard`：标准音质 (128kbps) +- `exhigh`：极高音质 (320kbps) +- `lossless`：无损音质 (FLAC) +- `hires`：Hi-Res音质 (24bit/96kHz) +- `jyeffect`：高清环绕声 +- `sky`：沉浸环绕声 +- `jymaster`：超清母带 + +### 🌐 使用方式 +- **Web界面**：直观友好的网页操作界面 +- **RESTful API**：完整的API接口支持 +- **批量处理**：支持歌单和专辑的批量解析 +- **多格式支持**：支持ID和链接多种输入格式 --- -## 快速开始 +## 🚀 快速开始 -### 1. 安装依赖 +### 环境要求 +- Python 3.7+ +- 网易云音乐黑胶会员账号 +### 安装步骤 + +#### 1. 克隆项目 +```bash +git clone https://github.com/Suxiaoqinx/Netease_url.git +cd Netease_url +``` + +#### 2. 安装依赖 ```bash pip install -r requirements.txt ``` -### 2. 配置 Cookie - - - 在 `cookie.txt` 文件中填入黑胶会员账号的Cookie： - - > 💡 **获取Cookie方法**： - > 1. 登录网易云音乐网页版 - > 2. 按F12打开开发者工具 - > 3. 在Network标签页找到任意请求 - > 4. 复制请求头中的Cookie值 - -### 3. 运行 - -#### GUI 模式 - -```bash -python main.py --mode gui --url <网易云音乐地址> --level <音质参数> +#### 3. 配置Cookie +在 `cookie.txt` 文件中填入黑胶会员账号的Cookie： +``` +MUSIC_U=你的MUSIC_U值;os=pc;appver=8.9.70; ``` -#### API 模式 +> 💡 **获取Cookie方法**：登录网易云音乐网页版 → F12开发者工具 → Network标签页 → 复制任意请求的Cookie值 +#### 4. 启动服务 ```bash -python main.py --mode api +python main.py ``` -- 访问接口：http://ip:port/类型解析 -- 支持 GET 和 POST 请求 +#### 5. 访问界面 +打开浏览器访问：`http://localhost:5000` + +### 🐳 Docker部署 + +```bash +# 使用Docker Compose +docker-compose up -d + +# 或使用Docker +docker build -t netease-music-api . +docker run -d -p 5000:5000 netease-music-api +``` --- -## 参数说明 +## 📖 使用指南 -### GUI 模式参数 +### Web界面使用 -| 参数 | 说明 | -| ------------ | ---------------------------- | -| --mode | 启动模式：api 或 gui | -| --url | 需要解析的网易云音乐地址 | -| --level | 音质参数（见下方音质说明） | +#### 🔍 歌曲搜索 +1. 选择功能：**歌曲搜索** +2. 输入关键词（歌曲名、歌手名等） +3. 点击**搜索**按钮 +4. 在搜索结果中点击**解析**或**下载**按钮 -### API 模式参数 +#### 🎧 单曲解析 +1. 选择功能：**单曲解析** +2. 输入歌曲ID或网易云音乐链接 + - 支持格式：`1234567890` 或 `https://music.163.com/song?id=1234567890` +3. 点击**解析**按钮查看歌曲信息 -| 参数 | 说明 | -| ------------ | -------------------------------------------- | -| url / ids | 网易云音乐地址或歌曲ID（二选一） | -| level | 音质参数（见下方音质说明） | -| type | 解析类型：json / down / text（三选一） | +#### 📋 歌单解析 +1. 选择功能：**歌单解析** +2. 输入歌单ID或网易云音乐歌单链接 + - 支持格式：`1234567890` 或 `https://music.163.com/playlist?id=1234567890` +3. 点击**解析**按钮查看歌单中所有歌曲 +4. 点击单首歌曲的**解析**或**下载**按钮 -| 类型参数 | 说明 | -| ------------ | -------------------------------------------- | -| Song_v1 | 单曲解析 | -| search | 搜索解析 | -| playlist | 歌单解析 | -| album | 专辑解析 | +#### 💿 专辑解析 +1. 选择功能：**专辑解析** +2. 输入专辑ID或网易云音乐专辑链接 + - 支持格式：`1234567890` 或 `https://music.163.com/album?id=1234567890` +3. 点击**解析**按钮查看专辑中所有歌曲 +4. 点击单首歌曲的**解析**或**下载**按钮 + +#### ⬇️ 音乐下载 +1. 选择功能：**音乐下载** +2. 输入歌曲ID或链接 +3. 选择音质（标准/极高/无损/Hi-Res等） +4. 点击**下载**按钮 + +### 支持的链接格式 + +``` +# 歌曲链接 +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. 健康检查 +```http +GET /health +``` +**响应示例**: +```json +{ + "status": "ok", + "message": "Service is running" +} +``` + +#### 2. 歌曲搜索 +```http +POST /search +Content-Type: application/json + +{ + "keywords": "周杰伦 稻香", + "limit": 10 +} +``` +**响应示例**: +```json +{ + "code": 200, + "result": { + "songs": [ + { + "id": 185668, + "name": "稻香", + "artists": ["周杰伦"], + "album": "魔杰座", + "duration": 223000 + } + ] + } +} +``` + +#### 3. 单曲解析 +```http +POST /song +Content-Type: application/json + +{ + "id": "185668" +} +``` + +#### 4. 歌单解析 +```http +POST /playlist +Content-Type: application/json + +{ + "id": "123456789" +} +``` + +#### 5. 专辑解析 +```http +POST /album +Content-Type: application/json + +{ + "id": "123456789" +} +``` + +#### 6. 音乐下载 +```http +POST /download +Content-Type: application/json + +{ + "id": "185668", + "quality": "lossless" +} +``` +**响应**: 直接返回音频文件流 --- @@ -136,5 +302,4 @@ python main.py --mode api --- - 欢迎 Star、Fork 和 PR！