89 lines
1.6 KiB
Markdown
89 lines
1.6 KiB
Markdown
# EdgeOne Pages 部署说明
|
||
|
||
这是 STUN Nav 的 EdgeOne Pages 专用部署说明。完整使用文档见 `README.md`。
|
||
|
||
## 文件结构
|
||
|
||
```text
|
||
public/ # 静态页面
|
||
edge-functions/api/[[default]].js # /api/* 接口
|
||
edgeone.json # EdgeOne 配置
|
||
```
|
||
|
||
## 部署步骤
|
||
|
||
1. 在 EdgeOne Pages / Makers 中创建项目。
|
||
2. 导入 GitHub 仓库。
|
||
3. 确认构建输出目录为：
|
||
|
||
```text
|
||
public
|
||
```
|
||
|
||
4. 创建 KV Namespace。
|
||
5. 给项目绑定 KV，变量名填写：
|
||
|
||
```text
|
||
STUN_NAV_KV
|
||
```
|
||
|
||
6. 添加环境变量：
|
||
|
||
```text
|
||
WEBHOOK_TOKEN=换成你自己的随机密钥
|
||
```
|
||
|
||
7. 部署项目。
|
||
|
||
## 访问地址
|
||
|
||
```text
|
||
https://你的域名/
|
||
https://你的域名/admin
|
||
```
|
||
|
||
## Lucky Webhook
|
||
|
||
GET 参数方式：
|
||
|
||
```text
|
||
https://你的域名/api/webhook/fnnas?token=你的随机密钥&name=FNNAS&group=NAS&url=http://{STUN_fnnas_ADDR}
|
||
```
|
||
|
||
POST JSON 方式：
|
||
|
||
```text
|
||
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 中：
|
||
|
||
```text
|
||
stun_nav_store
|
||
```
|
||
|
||
不会使用本地的 `data/links.json`。
|
||
|
||
## 故障排查
|
||
|
||
如果 `/api/services` 报 KV 错误，优先检查 KV 绑定变量名是不是：
|
||
|
||
```text
|
||
STUN_NAV_KV
|
||
```
|
||
|
||
如果 webhook 返回 `missing service url, addr, or host+port`，说明请求里没有传服务地址，需要增加 `url`、`addr`，或 `host + port`。
|
||
|
||
如果后台保存失败，检查输入的管理密钥是否和环境变量 `WEBHOOK_TOKEN` 一致。
|