## 节点接入令牌 (`node-enroll-tokens`)

生成一次性注册令牌与节点一行安装命令,并可按 id 查令牌是否已被节点用掉;令牌原文只在生成时返回一次。

鉴权: 仅管理员 · 文档: https://www-sa2.kuxitong.com/zh/docs/api/node-enroll-tokens

### POST `/api/v2/node-enroll-tokens`

生成节点接入令牌 · 鉴权: 仅管理员

```sh
curl -X POST "https://panel.example.com/api/v2/node-enroll-tokens" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### GET `/api/v2/node-enroll-tokens/{token_id}`

查节点接入令牌状态 · 鉴权: 仅管理员

```sh
curl "https://panel.example.com/api/v2/node-enroll-tokens/{token_id}" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

节点接入令牌对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `command` | string |  | 节点一行安装命令,只放可执行命令:含物料站地址、主控地址与信任根指纹 --trust-sha256(节点装机时从主控 7444 口取信任根包按指纹核对);令牌由 shell 内建 printf 写进 mktemp -d 建的临时目录、以 --token-file 交给装机脚本,不进任何进程的命令行参数。command_status 不是 ok 时为空串。 |
| `command_status` | string |  | 安装命令能不能给:ok = command 是可执行命令;no_mirror = 暂时取不到节点安装包的下载地址(没配 https 物料站或取不到,或本机还没有本版本验过签的发版清单、核不了装机脚本);no_master_key = 主控密钥未初始化(重跑主控安装命令);master_addr_unknown = 认不出主控地址(在「系统管理 › 升级与维护 › 节点通信」页填节点通信公网地址 node.master_addr,或用节点能访问到的主控地址打开面板)。 可选值: ["ok","no_mirror","no_master_key","master_addr_unknown"] |
| `expires_at` | string |  | 过期时间 |
| `id` | string |  | 令牌 id(不是凭据):用它 GET /node-enroll-tokens/{token_id} 查令牌是否已被节点用掉。 |
| `internal_master_host` | string |  | 命令里的主控地址是本机/内网地址时为该地址(没配节点通信公网地址、取自打开面板用的地址),别的机器上的节点多半连不上它;否则不出现。 |
| `node_id` | integer |  | 用它注册出的节点 id(注册后进待初始化列表);没用过不出现。 |
| `token` | string |  | 一次性注册令牌原文,只在本次响应里出现。 |
| `token_in_command` | boolean |  | 命令里是否带令牌原文(true = 命令本身就是凭据,别贴进工单或日志);command_status 不是 ok 时为 false。 |
| `used` | boolean |  | 是否已有节点用它注册(一次性,用过即作废)。 |
| `used_at` | string |  | 节点用它注册的时刻;没用过不出现。 |
