EdgeOne Pages 部署说明

这是 STUN Nav 的 EdgeOne Pages 专用部署说明。完整使用文档见 README.md。

文件结构

public/                         # 静态页面
edge-functions/api/[[default]].js # /api/* 接口
edgeone.json                    # EdgeOne 配置

部署步骤

在 EdgeOne Pages / Makers 中创建项目。
导入 GitHub 仓库。
确认构建输出目录为：

public

创建 KV Namespace。
给项目绑定 KV，变量名填写：

STUN_NAV_KV

添加环境变量：

WEBHOOK_TOKEN=换成你自己的随机密钥

部署项目。

访问地址

https://你的域名/
https://你的域名/admin

Lucky Webhook

GET 参数方式：

https://你的域名/api/webhook/fnnas?token=你的随机密钥&name=FNNAS&group=NAS&url=http://{STUN_fnnas_ADDR}

POST JSON 方式：

URL: https://你的域名/api/webhook/fnnas?token=你的随机密钥
Method: POST
Content-Type: application/json
Body:
{
  "name": "FNNAS",
  "group": "NAS",
  "url": "http://{STUN_fnnas_ADDR}",
  "note": "家里 NAS"
}

数据存储

EdgeOne 版本的数据保存在 KV 的这个 key 中：

stun_nav_store

不会使用本地的 data/links.json。

故障排查

如果 /api/services 报 KV 错误，优先检查 KV 绑定变量名是不是：

STUN_NAV_KV

如果 webhook 返回 missing service url, addr, or host+port，说明请求里没有传服务地址，需要增加 url、addr，或 host + port。

如果后台保存失败，检查输入的管理密钥是否和环境变量 WEBHOOK_TOKEN 一致。

1.6 KiB Raw Blame History Unescape Escape