MEMZGBL的博客

1162 字

3 分钟

Meting API 安装与搭建教程：一站式音乐数据服务

2026-03-24

MEMZGBL

meting-api

/

音乐API

/

网易云音乐

/

QQ音乐

/

ubuntu

/

部署

Meting API 安装与搭建教程：一站式音乐数据服务#

在开发音乐相关应用（如播放器、歌单系统、歌词展示）时，常常需要对接多个音乐平台的 API，但每个平台的接口规范、签名方式各不相同，开发成本高。Meting API 正是为了解决这一痛点而生，它将网易云音乐、QQ音乐、酷狗音乐等平台的数据统一封装，提供简洁的 RESTful 接口。

本文将详细介绍 Meting API 的三种主流搭建方式（PHP、Node.js、Docker），让你快速拥有自己的音乐数据服务。

1. Meting API 简介#

Meting API 是一个开源的音乐数据接口聚合服务，支持以下平台：

网易云音乐
QQ音乐
酷狗音乐
百度音乐
酷我音乐

主要功能：

搜索歌曲/专辑/歌单
获取歌曲详情、播放链接、歌词
获取歌单详情
获取专辑详情

项目地址：

PHP 版：https://github.com/metowolf/Meting
Node.js 版：https://github.com/metowolf/Meting.js

2. 环境准备#

在开始搭建之前，需要准备一台服务器或本地开发环境。推荐使用 Ubuntu 20.04/22.04 LTS，并确保以下环境：

PHP 版本 ≥ 7.0（PHP 版）
Node.js 版本 ≥ 12（Node.js 版）
Docker 与 Docker Compose（Docker 版）

3. 方式一：PHP 版搭建（最轻量）#

PHP 版是原始版本，单文件部署，适合小型项目或低资源服务器。

3.1 安装 Nginx 与 PHP#

1
sudo apt update
2
sudo apt install nginx php-fpm php-curl -y

3.2 下载 Meting#

1
cd /var/www/html
2
sudo wget https://raw.githubusercontent.com/metowolf/Meting/master/example/index.php -O meting.php

如果无法访问 GitHub，可使用国内镜像或手动下载。

3.3 配置 Nginx#

创建站点配置 /etc/nginx/sites-available/meting：

1
server {
2
    listen 80;
3
    server_name meting.example.com;   # 替换为你的域名
4

5
    root /var/www/html;
6
    index index.php;
7

8
    location / {
9
        try_files $uri $uri/ =404;
10
    }
11

12
    location ~ \.php$ {
13
        include snippets/fastcgi-php.conf;
14
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
15
    }
16
}

启用站点并重载 Nginx：

1
sudo ln -s /etc/nginx/sites-available/meting /etc/nginx/sites-enabled/
2
sudo nginx -t
3
sudo systemctl reload nginx

3.4 使用示例#

访问 http://meting.example.com/meting.php?server=netease&type=song&id=500665346，即可返回歌曲信息。

常用参数：

server：平台名称（netease, qq, kugou, baidu, kuwo）
type：数据类型（song, artist, album, playlist, search）
id：资源 ID
keywords：搜索关键词（type=search 时使用）

4. 方式二：Node.js 版搭建（推荐）#

Node.js 版功能更全面，支持 async/await，性能更好，且易于扩展。

4.1 安装 Node.js#

1
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
2
sudo apt install -y nodejs

4.2 安装 Meting#

1
mkdir ~/meting-api
2
cd ~/meting-api
3
npm init -y
4
npm install @metowolf/meting axios express

4.3 创建服务端代码#

新建 app.js：

1
const express = require('express');
2
const Meting = require('@metowolf/meting');
3

4
const app = express();
5
const port = 3000;
6

7
app.get('/api', async (req, res) => {
8
    const { server = 'netease', type, id, keywords } = req.query;
9
    try {
10
        const api = new Meting(server);
11
        let data;
12
        if (type === 'search') {
13
            data = await api.search(keywords);
14
        } else {
15
            data = await api[type]?.(id);
16
        }
17
        res.json(data);
18
    } catch (error) {
19
        res.status(500).json({ error: error.message });
20
    }
21
});
22

23
app.listen(port, () => {
24
    console.log(`Meting API running at http://localhost:${port}`);
25
});

4.4 运行服务#

1
node app.js

使用 pm2 守护进程（推荐）：

1
npm install -g pm2
2
pm2 start app.js --name meting-api
3
pm2 save
4
pm2 startup

4.5 配置反向代理（Nginx）#

为 Node.js 服务添加 Nginx 反向代理：

1
server {
2
    listen 80;
3
    server_name meting.example.com;
4

5
    location / {
6
        proxy_pass http://127.0.0.1:3000;
7
        proxy_set_header Host $host;
8
        proxy_set_header X-Real-IP $remote_addr;
9
    }
10
}

5. 方式三：Docker 部署（最便捷）#

Docker 部署无需配置环境，一条命令即可启动。

5.1 拉取镜像#

1
docker pull intemd/meting-api

5.2 运行容器#

1
docker run -d --name meting-api -p 3000:3000 intemd/meting-api

5.3 使用 Docker Compose#

创建 docker-compose.yml：

1
version: '3'
2
services:
3
  meting:
4
    image: intemd/meting-api
5
    container_name: meting-api
6
    ports:
7
      - "3000:3000"
8
    restart: always

启动：

1
docker-compose up -d

6. API 使用方法#

6.1 基础请求格式#

1
GET /api?server=<平台>&type=<类型>&id=<资源ID>
2
GET /api?server=<平台>&type=search&keywords=<关键词>

6.2 示例#

获取网易云歌曲信息：

1
/api?server=netease&type=song&id=500665346

搜索 QQ 音乐歌曲：

1
/api?server=qq&type=search&keywords=夜曲

获取网易云歌单：

1
/api?server=netease&type=playlist&id=60198

获取网易云歌词：

1
/api?server=netease&type=lyric&id=500665346

6.3 返回数据示例#

1
{
2
    "id": "500665346",
3
    "name": "有何不可",
4
    "artist": ["许嵩"],
5
    "album": "自定义",
6
    "pic_id": "109951164436462087",
7
    "url": "http://...",
8
    "lyric": "[00:00.00]天空好想下雨...",
9
    "duration": 247
10
}

7. 前端集成示例#

7.1 使用 Fetch 获取并播放歌曲#

1
<input type="text" id="keyword" placeholder="输入歌名">
2
<button onclick="searchSong()">搜索</button>
3
<audio id="player" controls></audio>
4

5
<script>
6
async function searchSong() {
7
    const keyword = document.getElementById('keyword').value;
8
    const response = await fetch(`/api?server=netease&type=search&keywords=${keyword}`);
9
    const data = await response.json();
10
    if (data && data.length > 0) {
11
        const songId = data[0].id;
12
        const detail = await fetch(`/api?server=netease&type=song&id=${songId}`);
13
        const song = await detail.json();
14
        document.getElementById('player').src = song.url;
15
    }
16
}
17
</script>

7.2 配合 APlayer 使用#

APlayer 是一个流行的 HTML5 音乐播放器，可与 Meting API 无缝集成：

1
<link rel="stylesheet" href="https://unpkg.com/aplayer/dist/APlayer.min.css">
2
<div id="aplayer"></div>
3
<script src="https://unpkg.com/aplayer/dist/APlayer.min.js"></script>
4
<script>
5
const ap = new APlayer({
6
    container: document.getElementById('aplayer'),
7
    audio: [{
8
        name: '有何不可',
9
        artist: '许嵩',
10
        url: '/api?server=netease&type=song&id=500665346&raw=url',
11
        cover: '/api?server=netease&type=pic&id=109951164436462087'
12
    }]
13
});
14
</script>

8. 常见问题与解决#

问题	解决方法
返回 404	检查路由是否正确，确认参数名（server, type, id）
播放链接无法访问	部分平台的播放链接有有效期，需重新获取；可能被限制 IP
Node.js 版本报错	确保 Node.js 版本 ≥ 12，使用 `npm install` 重新安装依赖
PHP 版返回空数据	检查 PHP 是否启用了 curl 扩展，执行 `php -m \| grep curl`
Docker 容器无法访问外网	检查 Docker 网络配置，尝试添加 `--network host` 参数
歌词乱码	部分平台返回的歌词可能是 UTF-8 格式，需确保页面编码一致