EdgeOne Pages 部署指南
手机用户提示
本页截图基于电脑端浏览器。手机浏览器里菜单可能会折叠，按钮位置也可能略有差异；如果某一步找不到入口，先把手机浏览器切换为"桌面版网站"或"电脑端 UA"再继续。
目标
先把 huangxd-/danmu_api Fork 到你自己的 GitHub，再让 EdgeOne Pages 部署你的 fork。这样以后你自己同步上游、自己触发重部署，会比直接用默认模板更好管。
准备工作
开始之前，请确认你已有：
- GitHub 账号 — 用于 Fork 仓库
- 腾讯云账号 — 登录 EdgeOne Pages 用
第 1 步：先 Fork 上游仓库
打开上游仓库页面：
按顺序操作：
- 点击页面右上角的 Fork
- 选择你自己的 GitHub 账号
- 等页面变成
你的GitHub用户名/danmu_api
先点 Fork。
确认 Fork 到你自己的 GitHub 账号下。
第 2 步：打开 EdgeOne Pages
先打开其中一个入口：
- 腾讯云控制台入口 — 中文站入口
- EdgeOne 国际站入口 — 如果你本来就在国际站账号体系里
进入 Pages 后，点 创建项目。
先点 创建项目。
第 3 步：选择通过导入 Git 仓库创建
按这个顺序点：
创建项目 → 通过导入 Git 仓库创建 → GitHub
这里选 通过导入 Git 仓库创建，然后再选 GitHub。
第 4 步：在仓库列表里点你自己的 fork
这里只做 2 件事：
- 找到你自己 Fork 出来的
danmu_api - 点进去
不要点原仓库，也不要点别的仓库。
在仓库列表里选自己账号下的
danmu_api。
第 5 步：填写项目配置
先按下面几项填：
- 项目名称：填
danmu-api - 生产分支：保持
main - 根目录：保持
./（不要改成子目录） - 其他构建设置：先保持默认或自动识别结果，不要先乱改
加速区域单独注意：
- 先选 全球可用区（不含中国大陆）
加速区域这里先选 全球可用区（不含中国大陆）。
第 6 步：先填最少需要的变量，再开始部署
必填变量
| 变量名 | 说明 |
|---|---|
TOKEN |
API 访问令牌（默认 87654321） |
ADMIN_TOKEN |
管理员密码，用于登录后台 |
EdgeOne 必补变量
EdgeOne 必须补 Upstash Redis，否则弹幕匹配会 404：
| 变量名 | 说明 |
|---|---|
UPSTASH_REDIS_REST_URL |
Upstash Redis REST URL |
UPSTASH_REDIS_REST_TOKEN |
Upstash Redis REST Token |
管理员界面必配变量
必配说明
以下变量用于管理员界面修改系统配置，不配置无法进入系统配置界面，会提示"更新失败"。
| 变量名 | 说明 |
|---|---|
DEPLOY_PLATFROM_PROJECT |
EdgeOne 项目 ID（pages-xxxxxxxxxxxx） |
DEPLOY_PLATFROM_TOKEN |
EdgeOne API Token |
变量详情参见：
填完后直接点 开始部署 / Start deployment。
第 7 步：等部署完成，再复制 Pages 地址
项目创建后，等待 EdgeOne Pages 构建完成。
构建成功后，你会拿到一个 Pages 域名。先复制当前项目的访问地址，再进入下一步测试。
部署成功后，在项目概览里复制当前 Pages 地址。
第 8 步：测试验证
构建成功后，访问你的 EdgeOne Pages 地址：
测试首页
直接访问根路径，应该能看到 danmu_api 的欢迎页面。
测试 API
在浏览器访问搜索接口：
将 xxx.edgeone.app 替换为你的实际域名，将 87654321 替换为你设置的 TOKEN 值。
如果返回 JSON 数据（包含弹幕搜索结果），说明部署成功。
测试管理员后台
访问 https://xxx.edgeone.app/admin/，输入你设置的 ADMIN_TOKEN 密码登录。
常见问题
1）创建项目时不知道根目录填什么
就填 ./，不要改成子目录。
2）部署成功了，但你访问的是旧地址
先回项目首页，确认你复制的是当前这次部署生成的域名。
3）自动同步报错了怎么办
直接按上面的"把 GitHub 自动同步先启用好"那一步处理：先回网页端仓库首页看有没有 Sync fork，有就先手动同步，再回 Fork Sync 重新跑一次。