## IP 归属地库 (`geoip`)

主控在用的 IP 归属地库(服务商下发 > 内置)、节点对齐进度与地址查询。

鉴权: 仅管理员 · 文档: https://www.gocdn888.com/zh/docs/api/geoip

### GET `/api/v2/geoip`

IP 归属地库状态 · 鉴权: 仅管理员

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

### GET `/api/v2/geoip/lookup`

查询 IP 归属地 · 鉴权: 仅管理员

查询参数:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `ip` | string | 有 | IPv4 或 IPv6 地址。 |

```sh
curl "https://panel.example.com/api/v2/geoip/lookup" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

IP 归属地库对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `active` | GeoipActive |  | 当前下发给节点的库与各级来源状态;sha256 为空表示还没核出(节点用包里的内置库)。 |
| `country` | string |  | 国家/地区编号(ISO 3166-1 两位大写),没有为空。 |
| `coverage` | GeoipCoverage |  | 免费版与商业版的覆盖率对比,由授权带下来;哪一侧没有统计就省略哪一侧(页面显示「—」),与有没有开通商业版无关。 |
| `found` | boolean |  | 库里有这个地址(至少一个字段有值)。 |
| `ip` | string |  | 查询的地址。 |
| `isp` | string |  | 运营商编号,没有为空。 |
| `nodes` | GeoipNodes |  | 节点对齐进度(按心跳回报的在用库)。 |
| `prov` | string |  | 省份编号(只有中国大陆),没有为空。 |
| `region_enabled` | boolean |  | 恒为 true:省份/运营商对免费版同样开放,字段留给老前端。 |
| `source` | string |  | 在用库来源:provider 服务商下发、builtin 内置。 可选值: ["provider","builtin"] |
| `tier` | string |  | 当前下发给节点的档位:biz 服务商下发的商业库,free 内置免费版。 可选值: ["free","biz"] |
| `version` | string |  | 在用库版本。 |
