WNMAX
登录 注册
博客 欲望文字 映像笔记 开发笔记 日志

在ubuntu + 宝塔面板 安装 NeteaseCloudMusicApi 成功的方案 教程

当然，我们就在之前讨论的基础上，整理一份在 Ubuntu + 宝塔面板环境下，成功部署 NeteaseCloudMusicApi 的保姆级教程。

整个部署过程，我们将充分利用宝塔面板的图形化界面，通过以下四个主要步骤来完成：

graph TD
    A[准备工作: 服务器与面板] --> B[第一步: 安装Node.js环境]
    B --> C[第二步: 获取并上传项目]
    C --> D[第三步: 使用PM2管理器运行项目]
    D --> E[第四步: 放行端口并测试]

    B --> B1[在宝塔“软件商店”<br>安装“PM2管理器”]
    C --> C1[从GitHub下载项目<br>或直接在服务器git clone]
    C --> C2[通过宝塔“文件”<br>上传并解压项目]
    D --> D1[在PM2管理器中<br>添加项目，选择app.js]
    D --> D2[设置Node.js版本为v12+]
    E --> E1[在服务器防火墙<br>与宝塔安全中放行3000端口]
    E --> E2[访问 http://你的IP:3000<br>验证是否运行成功]

下面是每一步的详细操作指南。

🏁 第一步：准备工作

在一切开始之前，请确认你手头已经准备好了以下两样东西：

  1. 一台运行 Ubuntu 的服务器：并且你已经成功安装了 宝塔面板。这是我们的操作基地。
  2. 基本的登录信息：确保你能通过 SSH 连接到服务器，也能登录宝塔面板的后台。

🛠️ 第二步：在宝塔面板中安装 Node.js 环境

NeteaseCloudMusicApi 是一个 Node.js 项目，所以我们需要先给它准备好运行环境，这可以通过宝塔面板轻松完成。

  1. 登录你的宝塔面板，点击左侧菜单栏的 软件商店。

  2. 在搜索框中输入 “PM2”，找到 PM2管理器 这个应用（它集成了 Node.js 和 npm，是我们管理 Node 项目的好帮手），点击后面的 安装 按钮 。

    有一点需要注意，宝塔面板的PM2管理器默认安装的Node.js版本可能较低，而 NeteaseCloudMusicApi 需要 Node.js 12 或更高版本。安装完成后，请务必在PM2管理器的设置中，将Node版本切换到 v12.x 以上（比如 v14.x 或更高），这一点很关键 。

⬆️ 第三步：获取并放置项目代码

环境准备好了，现在我们把 NeteaseCloudMusicApi 的项目代码放到服务器上。这里有几种方法，我们选择最直观的通过宝塔面板操作。

  1. 下载项目：

    • 你可以在自己的电脑上访问 NeteaseCloudMusicApi 的 GitHub 地址：https://github.com/Binaryify/NeteaseCloudMusicApi，点击 “Code” 按钮下载整个项目的 ZIP 压缩包 。
    • 或者，如果你熟悉命令行，也可以直接通过 SSH 连接到服务器，用 git clone 命令来下载，这会更加直接。

  2. 上传项目到服务器：

    • 回到宝塔面板，点击左侧菜单的 文件。
    • 进入 /www/wwwroot/ 目录，这是我们通常存放网站项目的地方。
    • 在这个目录下，点击 新建文件夹，给它起一个清晰的名字，比如 NeteaseCloudMusicApi。
    • 然后，进入这个新创建的文件夹，点击 上传，将你刚才下载的 ZIP 压缩包传上去。上传完成后，选中压缩包，点击 解压，就能得到项目的所有文件了 。

🚀 第四步：使用 PM2 管理器运行项目

现在万事俱备，只欠东风。我们来把项目跑起来。

  1. 回到宝塔面板的 软件商店，找到已经安装好的 PM2管理器 并点击进入。
  2. 在 PM2 管理器中，切换到 项目列表 标签，然后点击 添加项目 按钮 。

  3. 在弹出的对话框中，我们需要填写几个关键信息：

    • 项目目录：点击选择，找到我们刚才上传解压的目录，即 /www/wwwroot/NeteaseCloudMusicApi。
    • 启动文件：这里需要填写项目的入口文件。NeteaseCloudMusicApi 的启动文件是 app.js，你可以直接填写这个文件名，或者也有的教程里填写 npm start 也可以 。宝塔面板通常会智能识别，我们选择 app.js 即可。
    • 项目名称：可以随意填写一个好记的名字，比如 NeteaseCloudMusicApi。
  4. 确认信息无误后，点击 提交。如果一切顺利，稍等片刻，你就能在项目列表中看到刚刚添加的项目，并且它的状态会显示为 “已启动” 或 “online” 。

✅ 第五步：放行端口并测试最终成果

项目已经在后台跑起来了，但它还像个在“小黑屋”里的孩子，我们需要给它打开门（端口），才能和外界通信。

  1. 放行防火墙端口：NeteaseCloudMusicApi 默认运行在 3000 端口。我们需要在两个地方为它放行：

    • 服务器商的后台：登录你的云服务商（如阿里云、腾讯云）控制台，找到你的服务器实例，在 安全组 或 防火墙 规则中，添加一条入方向规则，放行 TCP 协议的 3000 端口 。
    • 宝塔面板的安全：回到宝塔面板，点击左侧的 安全，在防火墙规则中，同样 放行 3000 端口 。
  2. 进行最终测试：现在，打开你的浏览器，在地址栏输入 http://你的服务器公网IP:3000。如果能看到一个简单的欢迎页面或者一段 JSON 数据，那恭喜你，部署成功！为了进一步验证，可以访问 http://你的服务器公网IP:3000/banner，如果能正常返回包含轮播图信息的 JSON 数据，就说明 API 已经可以正常工作了 。

至此，你的专属网易云 API 就已经在 Ubuntu + 宝塔面板上成功运行了。之后，你在 PHP 项目中，就可以通过 http://你的服务器公网IP:3000/album?id=专辑ID 这样的地址，轻松获取到专辑图片等信息了。

如果在部署过程中遇到任何问题，比如项目启动失败或者端口无法访问，随时可以再来问我，我们一起看看是什么情况～

暂无评论