UI 与环境变量
目标:配置云平台部署必须补齐的环境变量,让后续可以直接在前端 系统配置 界面修改变量并触发重新部署。
如果你是 电脑本地部署 或 Docker 部署,先回对应页面把 TOKEN 和 ADMIN_TOKEN 写进 config/.env。云平台继续往下看。
云平台按下面的平台步骤继续
Section titled “云平台按下面的平台步骤继续”Vercel
Section titled “Vercel”第 1 步:先回项目,再打开 Settings
Section titled “第 1 步:先回项目,再打开 Settings”先回到已经部署好的项目里,后面的值都从这个项目继续找。

进项目后,再点左侧 Settings。

General 和 Environment Variables 都从这里进去。第 2 步:在 General 里找到 Project ID
Section titled “第 2 步:在 General 里找到 Project ID”进到 Settings 后,先点左侧 General。
然后在右侧找到 Project ID 这一项,把这一行的值记下来。

General。再看 2,把 Project ID 这一行的值记下来。这里抄到的是 Project ID,不是项目名。 把它填到:
DEPLOY_PLATFROM_PROJECT=刚才抄下来的 Project ID第 3 步:创建 Vercel Token
Section titled “第 3 步:创建 Vercel Token”这个值在账号设置里。 直接打开:
打开后按顺序做:
- 点
Create Token - 名字随便填一个你自己看得懂的,例如
danmu-api - 创建后立刻复制这串 Token
- 把它填到
DEPLOY_PLATFROM_TOKEN

DEPLOY_PLATFROM_TOKEN。第 4 步:值记好以后,回项目里的 Environment Variables
Section titled “第 4 步:值记好以后,回项目里的 Environment Variables”前面两个值记好以后,再回来填环境变量。
不要去账号设置里找这个页面。

Environment Variables 页面。第 5 步:填入这几项
Section titled “第 5 步:填入这几项”这里统一把刚才记下来的值填进去。
ADMIN_TOKEN 用来打开管理员页面;TOKEN 只有在要改普通访问地址时再换成自己的值。
ADMIN_TOKEN=87654321TOKEN=87654321DEPLOY_PLATFROM_PROJECT=刚才抄下来的 Project IDDEPLOY_PLATFROM_TOKEN=刚才创建的 Vercel Token如果要改普通访问地址,再把 TOKEN=87654321 换成自己的值。

Project ID 和 Token 对调。第 6 步:回 Deployments,重新部署一次
Section titled “第 6 步:回 Deployments,重新部署一次”改完环境变量后,再做一次:

Redeploy 后,再打开管理员 UI。第 7 步:打开管理员 UI
Section titled “第 7 步:打开管理员 UI”https://你的域名/你的ADMIN_TOKEN看到系统配置页,就说明 Vercel 这一条已经配好了。
前面的部署过程看 Vercel 部署。
Netlify
Section titled “Netlify”第 1 步:先在 Projects 里点进你的项目,进去后先找 Project configuration
Section titled “第 1 步:先在 Projects 里点进你的项目,进去后先找 Project configuration”先在 Netlify 的 Projects 列表里点进你的项目。点进去以后,你会先看到下面这个界面。
现在先不要去找环境变量,先把后面要填的值一个个记下来。

Project configuration。后面的 Project ID / Site ID 就在这里继续找。第 2 步:在 Project details 里找到 Project ID,把它记下来
Section titled “第 2 步:在 Project details 里找到 Project ID,把它记下来”继续按这个顺序走:
这一步先找:
DEPLOY_PLATFROM_PROJECT=这里抄到的 Site ID注意:这里页面上通常显示的是 Project ID,但它下面会写 Also known as Site ID。你要记下来的就是这一项。

Project ID 记下来。它就是后面要填到 DEPLOY_PLATFROM_PROJECT 的值。下面那条被单独框出来的是 Also known as Site ID 提示,用来确认你找对了。第 3 步:继续找 Team slug 或 Team ID,也先记下来
Section titled “第 3 步:继续找 Team slug 或 Team ID,也先记下来”现在还不要去找环境变量,继续把下一个值找出来。 按这个顺序走:
这一步要找的是:
DEPLOY_PLATFROM_ACCOUNT=你的 Team slug 或 Team ID优先记 Slug;如果你当前后台更容易拿到的是 Team ID,也可以直接记 Team ID。不要记 team 显示名称。

Team details;再看 2 和 3。优先记 Slug;如果你这里更方便用 Team ID,也可以记 Team ID。第 4 步:再去创建 Personal Access Token,也记下来
Section titled “第 4 步:再去创建 Personal Access Token,也记下来”到这一步,你已经先找到了两个值:
-
DEPLOY_PLATFROM_PROJECT -
DEPLOY_PLATFROM_ACCOUNT
现在再去拿最后一个值:
打开 Netlify Personal Access Token 页面
打开后按这个顺序做:
- 点创建新的 Personal Access Token
- 名字自己填一个能看懂的,例如
danmu-api - 创建后立刻复制这串 Token
- 把它记到
DEPLOY_PLATFROM_TOKEN
到这里,你后面真正要填进环境变量页的 3 个平台值就齐了:
DEPLOY_PLATFROM_ACCOUNT=刚才记下来的 Team slug 或 Team IDDEPLOY_PLATFROM_PROJECT=刚才记下来的 Site IDDEPLOY_PLATFROM_TOKEN=刚才创建的 Personal Access Token第 5 步:现在再回 Environment variables,统一开始配置
Section titled “第 5 步:现在再回 Environment variables,统一开始配置”值都找齐以后,再回到:

Environment variables 页面后,点右上角 Add a variable,然后把下面这些一项项加进去。按这个顺序补:
ADMIN_TOKEN=你自己的管理员值TOKEN=你想换掉默认 87654321 时再填DEPLOY_PLATFROM_ACCOUNT=刚才记下来的 Team slug 或 Team IDDEPLOY_PLATFROM_PROJECT=刚才记下来的 Site IDDEPLOY_PLATFROM_TOKEN=刚才创建的 Personal Access Token如果你现在只是想先打开管理员 UI,至少先加:
ADMIN_TOKEN=你自己的管理员值第 6 步:去 Deploys 触发一次新部署
Section titled “第 6 步:去 Deploys 触发一次新部署”Netlify 改完环境变量以后,新的值不会自动进旧实例,所以这里还要继续点:
触发一次新的部署,让刚才补进去的变量真正生效。
第 7 步:用管理员地址打开 UI
Section titled “第 7 步:用管理员地址打开 UI”https://你的域名/你的ADMIN_TOKEN看到系统配置页,就说明 Netlify 这一条已经配好了。
这段步骤依据 danmu_api/ui/README.md、Netlify 官方 Environment variables 文档、Netlify 官方 Manage deploys 文档 整理。
前面的部署过程看 Netlify 部署。
Cloudflare Workers
Section titled “Cloudflare Workers”第 1 步:先进入你已经部署好的 Worker,把 Worker 脚本名记下来
Section titled “第 1 步:先进入你已经部署好的 Worker,把 Worker 脚本名记下来”这条线先不要急着去填环境变量,先把后面要用到的值找齐。 先按这个顺序进入:
然后先记下 Worker 脚本名。 后面要填的是:
DEPLOY_PLATFROM_PROJECT=你的 Worker 脚本名
DEPLOY_PLATFROM_PROJECT 就填这个,不是域名,也不是自定义标题。第 2 步:再去抄 Account ID
Section titled “第 2 步:再去抄 Account ID”继续在 Cloudflare 控制台里找到你的 Account ID。 后面要填的是:
DEPLOY_PLATFROM_ACCOUNT=你的 Cloudflare Account ID
Account ID。先把它记下来,后面回环境变量页再填。第 3 步:再去创建 Cloudflare API Token,也先记下来
Section titled “第 3 步:再去创建 Cloudflare API Token,也先记下来”直接打开:
创建好以后,先把这个值记下来:
DEPLOY_PLATFROM_TOKEN=你的 Cloudflare API Token
DEPLOY_PLATFROM_TOKEN。第 4 步:值找齐以后,再回 Variables and Secrets 统一配置
Section titled “第 4 步:值找齐以后,再回 Variables and Secrets 统一配置”现在你已经先找到了这 3 个值:
DEPLOY_PLATFROM_ACCOUNT=刚才记下来的 Cloudflare Account IDDEPLOY_PLATFROM_PROJECT=刚才记下来的 Worker 脚本名DEPLOY_PLATFROM_TOKEN=刚才创建的 Cloudflare API Token这时候再按下面这个顺序回去:
第 5 步:把需要的变量一项项补进去
Section titled “第 5 步:把需要的变量一项项补进去”按这个顺序补:
ADMIN_TOKEN=你自己的管理员值TOKEN=你想换掉默认 87654321 时再填DEPLOY_PLATFROM_ACCOUNT=刚才记下来的 Cloudflare Account IDDEPLOY_PLATFROM_PROJECT=刚才记下来的 Worker 脚本名DEPLOY_PLATFROM_TOKEN=刚才创建的 Cloudflare API Token如果你现在只是想先打开管理员 UI,至少先加:
ADMIN_TOKEN=你自己的管理员值第 6 步:保存后直接测试,不用再额外找一次重部署
Section titled “第 6 步:保存后直接测试,不用再额外找一次重部署”当前项目这里走的是 Worker Settings 写回。 所以这一步把变量写好并保存后,直接继续测试就行,不用像 Vercel / Netlify 那样再单独回部署列表点一次重部署。
第 7 步:用管理员地址打开 UI
Section titled “第 7 步:用管理员地址打开 UI”https://你的 Worker 地址/你的ADMIN_TOKEN看到系统配置页,就说明 Cloudflare Workers 这一条已经配好了。
这段步骤依据 danmu_api/ui/README.md、Cloudflare 官方 Find account and zone IDs、Cloudflare 官方 Create API token、Cloudflare Workers environment variables 整理。
前面的部署过程看 Cloudflare Workers 部署。
EdgeOne Pages
Section titled “EdgeOne Pages”第 1 步:先打开你自己的控制台入口,再在项目列表里点进 danmu_api
Section titled “第 1 步:先打开你自己的控制台入口,再在项目列表里点进 danmu_api”如果你前面走的是中文站,就从这里进:
如果你前面走的是国际站,就从这里进:
先用和你部署时一致的站点入口登录,再停在 Pages -> 项目 列表,点进你自己的 danmu_api 项目。

danmu-api 项目详情。第 2 步:点进项目详情后,先停在项目概览页
Section titled “第 2 步:点进项目详情后,先停在项目概览页”点进去以后,先确认你已经进入项目详情页。 后面找值、回环境变量页,都从这个项目详情页继续走。

第 3 步:看浏览器地址栏,把 pages-xxxxxxxxxxxx 这一段记下来
Section titled “第 3 步:看浏览器地址栏,把 pages-xxxxxxxxxxxx 这一段记下来”这里要填的是 项目详情页 URL 里的那一段项目值。 在 EdgeOne Pages 里,这一段通常直接出现在浏览器地址栏里,格式类似:
pages-xxxxxxxxxxxx也就是说,点进项目详情以后,直接看浏览器 URL,把里面这一段记下来,稍后填到 DEPLOY_PLATFROM_PROJECT。
它不是项目显示名,也不是项目访问域名。

pages-abb8ox 这种值,就是这一步要记下来的内容,后面直接填到 DEPLOY_PLATFROM_PROJECT。第 4 步:再去创建 API Token,也先记下来
Section titled “第 4 步:再去创建 API Token,也先记下来”如果你前面走的是中文站,就从这里进:
打开腾讯云 EdgeOne Pages API Token 页面
如果你前面走的是国际站,就从这里进:

API Token 标签页;再看 2,页面标题就是 API Token Documentation。在这里创建一个可用 Token,然后把它记到 DEPLOY_PLATFROM_TOKEN。第 5 步:值找齐以后,再回项目的环境变量页面
Section titled “第 5 步:值找齐以后,再回项目的环境变量页面”按这个顺序回去:

第 6 步:把前端后面要用到的变量一次配齐
Section titled “第 6 步:把前端后面要用到的变量一次配齐”先补这 3 项:
ADMIN_TOKEN=87654321DEPLOY_PLATFROM_PROJECT=刚才地址栏里记下的 pages-xxxxxxxxxxxxDEPLOY_PLATFROM_TOKEN=刚才创建的 EdgeOne API Token如果你还想把普通访问地址也一起换掉,再额外补:
TOKEN=87654321这里再记住 2 条:
DEPLOY_PLATFROM_ACCOUNT这条对当前 EdgeOne 实现不用填,可以留空。- 当前项目对 EdgeOne 的在线重部署固定走
main分支。
第 7 步:保存后重新部署,再打开管理员 UI
Section titled “第 7 步:保存后重新部署,再打开管理员 UI”https://你的域名/你的ADMIN_TOKEN这一步打开后,系统设置页里的环境变量保存和“重新部署”按钮才会真正可用。
第 8 步:EdgeOne 这条线把 Upstash 一起补上
Section titled “第 8 步:EdgeOne 这条线把 Upstash 一起补上”这一步不要等报错了再补。 实测请求一旦落到新的运行环境,前一次匹配结果就可能接不上,常见表现就是匹配弹幕直接返回 404,或者同一个地址多次访问不稳定。
- 先在 Upstash 建一个 Redis 数据库
- 再把
UPSTASH_REDIS_REST_URL和UPSTASH_REDIS_REST_TOKEN补进 EdgeOne 环境变量 - 如果你想先单独看缓存这条线,也可以直接跳到 缓存配置
先去 Upstash 创建一个 Redis 数据库:

REST URL 和 REST TOKEN。然后把这两项补进 EdgeOne 的环境变量:
UPSTASH_REDIS_REST_URL=你的 REST URLUPSTASH_REDIS_REST_TOKEN=87654321 REST TOKEN第 9 步:补完后再回管理员 UI 检查
Section titled “第 9 步:补完后再回管理员 UI 检查”https://你的域名/你的ADMIN_TOKEN这段步骤依据 danmu_api/ui/README.md、EdgeOne Pages 官方 Project Management、EdgeOne Pages 官方 API Token、EdgeOne Pages 官方 Manage Deploys 整理。
前面的部署过程看 EdgeOne Pages 部署。
以后怎么改变量
Section titled “以后怎么改变量”第 1 步:打开管理员 UI,进入 系统配置
Section titled “第 1 步:打开管理员 UI,进入 系统配置”https://你的域名/你的ADMIN_TOKEN把你部署平台需要的变量补齐以后,后面就不用再回平台管理页改变量了。

系统配置 里改就行。第 2 步:改完以后怎么处理
Section titled “第 2 步:改完以后怎么处理”- Vercel / Netlify / EdgeOne Pages:改完后点
重新部署。 - Cloudflare Workers:改完变量后直接保存测试,不用额外再找一次重新部署。
- 本地 Node.js / Docker:大多数配置支持热更新,通常不用点重新部署;如果改的是端口,再按原部署页重启服务。
正文依据:huangxd-/danmu_api、danmu_api/ui/README.md 与当前实现代码。配图优先使用社区教程作者、论坛用户或公开控制台截图;其中 Vercel 参考 Linked Blog Starter / delasign,Netlify 参考第三方教程作者与论坛用户截图,Cloudflare 参考社区教程作者截图,Upstash 使用官方控制台真实截图。
纠错与建议
这一步有问题?
可以直接提交纠错或建议。我会按页面和步骤整理处理。
教程反馈