## 区域/节点黑名单 (`guard-blacklists`)

按区域或主节点导入的防火墙黑名单文件(每份上限 100 万条),单独成文件下发给节点,不进全局快照。

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

### GET `/api/v2/guard-blacklists`

区域/节点防火墙黑名单一览 · 鉴权: 仅管理员

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

### GET `/api/v2/guard-blacklists/{scope}/{scope_id}`

下载区域/节点防火墙黑名单 · 鉴权: 仅管理员

```sh
curl "https://panel.example.com/api/v2/guard-blacklists/{scope}/{scope_id}" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### PUT `/api/v2/guard-blacklists/{scope}/{scope_id}`

导入区域/节点防火墙黑名单 · 鉴权: 仅管理员

查询参数:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `allow_broad` | boolean |  | 为 true 时允许过短前缀(IPv4 短于 /8、IPv6 短于 /16);不给或 false 时遇到回 422 broad_prefix,面板二次确认后带 true 重发。 |

```sh
curl -X PUT "https://panel.example.com/api/v2/guard-blacklists/{scope}/{scope_id}" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### DELETE `/api/v2/guard-blacklists/{scope}/{scope_id}`

删除区域/节点防火墙黑名单 · 鉴权: 仅管理员

```sh
curl -X DELETE "https://panel.example.com/api/v2/guard-blacklists/{scope}/{scope_id}" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

区域/节点黑名单对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `entries` | integer |  | 条数(去重后)。 |
| `items` | GuardBlacklist[] |  | 本页条目 |
| `limit` | integer |  | 每份名单的条数上限。 |
| `name` | string |  | 区域名或主节点名(节点未定名为空)。 |
| `scope` | string |  | 名单所属的档:region = 区域档;node = 节点档(整份盖掉所在区域档)。 可选值: ["region","node"] |
| `scope_id` | integer |  | 区域 id 或主节点 id。 |
| `sha256` | string |  | 规范化正文的 sha256(节点按它拉取)。 |
| `size` | integer |  | 规范化正文字节数。 |
| `updated_at` | string |  | 导入时间。 |
