跳转至

Netlify 部署指南

手机用户提示

本页截图基于电脑端浏览器。手机浏览器里菜单可能会折叠，按钮位置也可能略有差异；如果某一步找不到入口，先把手机浏览器切换为"桌面版网站"或"电脑端 UA"再继续。

目标

完成本教程后，你将拥有一个运行在 Netlify 上的弹幕 API 服务，地址格式为 https://xxx.netlify.app/ 或 https://xxx.netlify.com/ 。

准备工作

开始之前，请确认你已有：

  1. GitHub 账号 — 用于 Fork 仓库
  2. Netlify 账号 — 可以用 GitHub 直接注册

第 1 步：先 Fork 上游仓库

打开上游仓库页面：

按顺序操作：

  1. 点击页面右上角的 Fork
  2. 选择你自己的 GitHub 账号
  3. 等页面变成 你的GitHub用户名/danmu_api

Fork 按钮位置

先点 Fork。

确认 Fork 页面

确认 Fork 到你自己的账号下。

第 2 步：前往 Netlify

直接打开：

分两种情况：

  1. 还没有账号：点右上角 Sign up
  2. 已经有账号：点右上角 Log in

Netlify 首页

先到 Netlify 首页。没有账号就点 Sign up，有账号就点 Log in。

第 3 步：用 GitHub 注册

如果你还没有 Netlify 账号，按顺序做：

  1. 打开注册页：app.netlify.com/signup
  2. 点 GitHub
  3. 如果后面出现资料填写页，按正常信息填完继续

如果你已经有账号，这一步跳过，直接登录。

Netlify 选择 GitHub

注册时直接选 GitHub。

填写资料

如果出现资料页，正常填完继续。

第 4 步：打开导入页，点 GitHub

登录后直接打开：

如果你已经在后台，也可以自己点：

  • Add new project

到导入页后，直接点 GitHub。

Add new project

到这里后直接点 GitHub。

第 5 步：给 GitHub 仓库授权

跳到 GitHub 授权页后，按顺序做：

  1. 怕麻烦就直接选 All repositories
  2. 如果你选 Only select repositories，一定要把你自己的 danmu_api 勾进去
  3. 点授权按钮继续

GitHub 授权

最省事就是直接选 All repositories。

第 6 步：回 Netlify，选你自己的 danmu_api

授权完成后会回到 Netlify。

这里只做 3 件事：

  1. 搜 danmu_api
  2. 选 你的GitHub用户名/danmu_api
  3. 不要选 huangxd-/danmu_api

重要提示

一定要选择你自己账号下的仓库，不要选择 huangxd- 开头的上游仓库。

第 7 步：先把站点创建出来

进入站点创建页后，先这样做：

  1. 构建配置先保持默认（不要自己乱改 build command 和 publish directory）
  2. 直接点 Deploy site
  3. 等它创建完成

创建完成后，会进入站点概览页面。

站点概览页

创建完成后会进入这个概览页。

第 8 步：添加环境变量

首次部署完成后，需要补充环境变量才能正常使用。

路径： Site configuration → Environment variables → Add a variable

必填变量

变量名 说明
ADMIN_TOKEN 管理员密码，用于登录后台系统配置页面
TOKEN API 访问令牌（默认 87654321）

管理员界面必配变量

必配说明

以下变量用于管理员界面修改系统配置，不配置无法进入系统配置界面，会提示"更新失败"。

变量名 说明
DEPLOY_PLATFROM_ACCOUNT Netlify Team slug 或 Team ID
DEPLOY_PLATFROM_PROJECT Site ID / Project ID
DEPLOY_PLATFROM_TOKEN Netlify Personal Access Token

变量详情参见：

第 9 步：手动重新部署一次

变量保存后，再按这个路径走：

Deploys → Trigger deploy → Deploy site

不同版本按钮名字可能略有差异，也可能显示为 Retry deploy 或 Clear cache and deploy site。新手先选普通的 Deploy site，等这次部署成功，再继续测试。

第 10 步：测试验证

重新部署成功后，访问你的 Netlify 地址（格式：https://xxx.netlify.app/）：

测试首页

直接访问根路径，应该能看到 danmu_api 的欢迎页面。

测试 API

在浏览器访问搜索接口：

https://xxx.netlify.app/api/v2/search/anime?keyword=鬼灭之刃&token=87654321

将 xxx.netlify.app 替换为你的实际域名，将 87654321 替换为你设置的 TOKEN 值。

如果返回 JSON 数据（包含弹幕搜索结果），说明部署成功。

测试管理员后台

访问 https://xxx.netlify.app/admin/，输入你设置的 ADMIN_TOKEN 密码登录。

常见问题

积分提醒

Netlify 免费账户每月有 300 积分，升级配置或触发重新部署扣 15 分。请注意积分消耗，积分用完后需等到下个月重置。

下一步