docs: add Netts onboarding steps

This commit is contained in:
你的用户名
2025-11-03 21:02:28 +08:00
parent 891c32e288
commit 4543c6bf98
2 changed files with 39 additions and 0 deletions

View File

@@ -8,6 +8,33 @@
- 配置 IP 白名单(若使用代理,可在 `config.yaml` 中设置 `netts.realIp`
- 充值余额,以便购买能量周期。
## Netts 账号准备流程
1. **注册 Workspace 账号**
- 打开 [https://netts.io/workspace](https://netts.io/workspace) 使用邮箱注册并登录;
- 首次登录后系统会自动给当前账号生成一组 API Key。
2. **完成余额充值**
- 在 Workspace → Wallet 菜单中充值 TRX建议先充 1020 TRX 做验证);
- Netts 扣费直接来自账户余额,没有余额将无法下单购买能量。
3. **配置 IP 白名单**
- 进入 Workspace → API → IP Whitelist将本服务所在服务器的出口 IP 填入;
- 如果经由代理访问,可在配置文件 `netts.realIp` 中设置对应的公网 IP。
4. **获取并保管 API Key**
- 在 Workspace → API 区域复制 Key
- 设置到 `config.yaml``netts.apiKey` 字段,或通过 `NETTS_API_KEY` 环境变量注入;
- 生产环境请妥善存储在 Secrets 或 Vault 中。
5. **可选:配置回调地址**
- 若希望接收能量下发事件,可在 Workspace → Host Mode Callback处填写统一回调 URL
- 亦可在调用本服务的 `/api/v1/energy/rent` 时传入 `callback_url` 覆盖。
6. **API 验证**
- 使用 cURL/ Postman 请求 `https://netts.io/apiv2/userinfo`,在 Header 中携带 `X-API-KEY``X-Real-IP`
- 当返回 `status=success`说明账号、Key 与白名单均已生效。
## 构建
```bash