1. 注册必要账号#

• GitHub账号
• Vercel账号（推荐使用GitHub账号直接登录）

2. 了解项目依赖#

SPlayer需要以下两个API服务支持：

1. 网易云音乐API Enhanced(Reborn增强版本) - 提供核心音乐服务

方法一：一键部署（推荐）#

1. 点击下方按钮直接部署到Vercel：

2. 等待部署完成，记下生成的域名（如https://api-xxx.vercel.app）

尽量使用自己的域名, 默认域名已经被大陆墙了

方法二：手动部署#

1
# 克隆仓库
2
git clone https://github.com/neteasecloudmusicapienhanced/api-enhanced.git
3

4
# 进入目录
5
cd api-enhanced
6

7
# 安装依赖
8
pnpm install
9

10
# 本地测试
11
pnpm start

方法一：Fork仓库部署（推荐）#

1. 访问SPlayer GitHub仓库

2. 点击右上角”Fork”按钮，复制到你的账号

3. 在Vercel控制台点击”New Project”

4. 选择你Fork的SPlayer仓库

5. 在配置页面进行以下设置：

   • Framework Preset: 选择”Vue”
   • Build Command: pnpm build 或 npm run build
   • Output Directory: out/renderer
   • Environment Variables:

现在配置文件已经设置好构建目录和框架, 直接点击配置环境变量即可

1
 ```
2
 RENDERER_VITE_SERVER_URL = "你的网易云API地址"
3
 RENDERER_VITE_SITE_URL = "你的SPlayer部署地址"
4
 ```

6. 点击”Deploy”开始部署，部署完成后配置域名 （一定要配置！）

方法二：手动部署#

1. 克隆仓库：

   1
   git clone https://github.com/MoeFurina/SPlayer.git
   2
   cd SPlayer
   

2. 复制环境变量文件：

   1
   cp .env.example .env
   

3. 编辑.env文件：

   1
   RENDERER_VITE_SERVER_URL="你的网易云API地址"
   2
   RENDERER_VITE_SITE_URL="你的SPlayer部署地址"
   

4. 安装依赖：

   1
   pnpm install
   

5. 构建项目：

   1
   pnpm build
   

6. 将out/renderer目录上传到你的托管服务

更新SPlayer#

1. 进入你Fork的仓库
2. 点击”Sync fork”同步最新代码
3. Vercel会自动触发重新部署

更新API服务#

API服务更新只要你启用了Github Action, Action会自动同步最新内容, Vercel也会自动部署
服务器更新需要重新部署

1. Vercel构建失败#

• 检查out/renderer目录是否正确设置
• 确认环境变量配置正确

2. 跨域问题#

确保.env文件中：

1
RENDERER_VITE_SERVER_URL = "你的API地址"
2
RENDERER_VITE_SITE_URL = "你的前端地址"

3. 登录功能异常#

• 检查API服务是否正常运行
• 确认网络没有被防火墙拦截

4.以上都不是我遇到的问题#

• 加入QQ群423016289, 向群主或管理员询问问题

使用同级域名API#

在vercel.json中添加：

1
{
2
  "rewrites": [
3
    {
4
      "source": "/:path*",
5
      "destination": "/index.html"
6
    },
7
    {
8
      "source": "/api/:apiurl*",
9
      "destination": "https://你的API域名/:apiurl*"
10
    }
11
  ]
12
}

.env配置：

1
RENDERER_VITE_SITE_ROOT=true