Meting-API 部署服务器指南

基于 @meting/core 的多平台音乐 API 代理服务，支持网易云、QQ音乐、酷狗、百度、酷我。

前置条件#

Linux 服务器（本文以 OpenCloudOS 为例）
宝塔面板已安装
Docker 已安装（宝塔面板 → 软件商店 → Docker管理器）
域名（可选，用于绑定域名访问）

一、克隆项目#

SSH 连接服务器，执行以下命令：

1
# 进入网站目录
2
cd /www/wwwroot
3

4
# 克隆项目
5
git clone https://github.com/tianshihao2003/Meting-API.git
6
# 进入项目目录
7
cd Meting-API

二、构建 Docker 镜像#

1
docker build -t meting-api .

构建成功会显示：

1
=> => naming to docker.io/library/meting-api

三、运行容器#

1
docker run -d \
2
  --name meting-api \
3
  -p 3003:80 \
4
  -e METING_URL=http://你的服务器IP:3003 \
5
  -e METING_TOKEN=你的密钥 \
6
  --restart always \
7
  meting-api

参数说明：

参数	说明
`-d`	后台运行
`--name meting-api`	容器名称
`-p 3003:80`	端口映射（宿主机:容器）
`-e METING_URL`	API 服务地址
`-e METING_TOKEN`	鉴权密钥
`--restart always`	服务器重启后自动启动容器

注意： 如果端口被占用，换一个端口即可（如 3001、3002、3003 等）。

四、验证部署#

1
# 检查容器状态
2
docker ps | grep meting-api
3

4
# 测试 API
5
curl http://localhost:3003/

浏览器访问：

1
http://你的服务器IP:3003/

测试搜索功能：

1
http://你的服务器IP:3003/api?server=netease&type=search&id=周杰伦

五、防火墙放行端口#

宝塔面板防火墙#

宝塔面板 → 安全 → 防火墙 → 添加规则：

端口：3003
协议：TCP
策略：允许

腾讯云安全组（如果使用腾讯云）#

腾讯云控制台 → 云服务器 → 安全组 → 入站规则 → 添加规则：

类型：自定义
来源：0.0.0.0/0
协议端口：TCP:3003
策略：允许

六、绑定域名（可选）#

1. DNS 解析配置#

在域名管理平台添加 A 记录：

记录类型	主机记录	记录值
A	api	你的服务器IP

2. 宝塔面板配置反向代理#

宝塔面板 → 网站 → 添加站点
填写域名：api.你的域名.com，PHP版本选 纯静态
点击站点名称 → 反向代理 → 添加反向代理

1
代理名称：meting-api
2
目标URL：http://127.0.0.1:3003
3
发送域名：$host

3. 配置 HTTPS#

点击站点名称 → SSL
选择 Let’s Encrypt → 申请证书
开启 强制 HTTPS

七、API 使用说明#

基础地址#

1
http://你的服务器IP:3003/api
2
# 或绑定域名后
3
https://api.你的域名.com/api

请求参数#

参数	类型	必填	说明
`server`	string	是	音乐平台：`netease`/`tencent`/`kugou`/`baidu`/`kuwo`
`type`	string	是	操作类型：`search`/`song`/`album`/`artist`/`playlist`/`lrc`/`url`/`pic`
`id`	string	是	资源 ID 或搜索关键词
`auth`	string	条件	鉴权令牌（`lrc`/`url`/`pic` 类型需要）

功能示例#

搜索歌曲：

1
curl "http://你的IP:3003/api?server=netease&type=search&id=周杰伦"

获取歌词：

1
curl "http://你的IP:3003/api?server=netease&type=lrc&id=歌曲ID&auth=token"

获取播放链接（302 重定向）：

1
curl -L "http://你的IP:3003/api?server=netease&type=url&id=歌曲ID&auth=token"

响应格式#

搜索结果示例：

1
[
2
  {
3
    "title": "歌曲名称",
4
    "author": "艺术家",
5
    "url": "http://你的IP:3003/api?server=netease&type=url&id=xxx&auth=xxx",
6
    "pic": "http://你的IP:3003/api?server=netease&type=pic&id=xxx&auth=xxx",
7
    "lrc": "http://你的IP:3003/api?server=netease&type=lrc&id=xxx&auth=xxx"
8
  }
9
]

歌词格式（LRC）：

1
[00:00.000] 歌词第一行
2
[00:05.123] 歌词第二行

八、常用运维命令#

1
# 查看容器状态
2
docker ps | grep meting-api
3

4
# 查看实时日志
5
docker logs -f meting-api
6

7
# 重启容器
8
docker restart meting-api
9

10
# 停止容器
11
docker stop meting-api
12

13
# 启动容器
14
docker start meting-api
15

16
# 进入容器终端
17
docker exec -it meting-api sh
18

19
# 删除容器（需先停止）
20
docker stop meting-api && docker rm meting-api
21

22
# 强制删除容器
23
docker rm -f meting-api

九、更新版本#

1
# 进入项目目录
2
cd /www/wwwroot/Meting-API
3

4
# 拉取最新代码
5
git pull
6

7
# 重新构建镜像
8
docker build -t meting-api .
9

10
# 停止并删除旧容器
11
docker stop meting-api && docker rm meting-api
12

13
# 重新运行容器
14
docker run -d \
15
  --name meting-api \
16
  -p 3003:80 \
17
  -e METING_URL=http://你的服务器IP:3003 \
18
  -e METING_TOKEN=你的密钥 \
19
  --restart always \
20
  meting-api

十、常见问题#

Q1：端口被占用怎么办？#

1
# 查看端口占用
2
netstat -tlnp | grep 3003
3

4
# 或者直接换一个端口（如 3001、3002、3004）

Q2：容器删除失败？#

1
# 强制删除
2
docker rm -f meting-api
3

4
# 如果还是失败，先停止再删除
5
docker stop meting-api && docker rm meting-api

Q3：API 返回空或错误？#

检查容器日志：docker logs meting-api
确认防火墙端口已放行
检查环境变量是否正确

1
# 运行容器时添加 Cookie 环境变量
2
docker run -d \
3
  --name meting-api \
4
  -p 3003:80 \
5
  -e METING_URL=http://你的IP:3003 \
6
  -e METING_TOKEN=你的密钥 \
7
  -e METING_COOKIE_NETEASE=你的网易云Cookie \
8
  -e METING_COOKIE_TENCENT=你的QQ音乐Cookie \
9
  --restart always \
10
  meting-api

参考链接#

许可证#

MIT License

团子和蛋糕

Meting-API 部署服务器指南

前置条件#

一、克隆项目#

二、构建 Docker 镜像#

三、运行容器#

四、验证部署#

五、防火墙放行端口#

宝塔面板防火墙#

腾讯云安全组（如果使用腾讯云）#

六、绑定域名（可选）#

1. DNS 解析配置#

2. 宝塔面板配置反向代理#

3. 配置 HTTPS#

七、API 使用说明#

基础地址#

请求参数#

功能示例#

响应格式#

八、常用运维命令#

九、更新版本#

十、常见问题#

Q1：端口被占用怎么办？#

Q2：容器删除失败？#

Q3：API 返回空或错误？#

Q4：如何配置 Cookie 提高成功率？#

参考链接#

许可证#

相关阅读

评论区

音乐