<div id="白名单"></div>

# 白名单（域名）

此白名单为域名白名单，不同于[全局白名单](/docs/uewaf/features/global/white_list)，域名白名单仅对当前域名生效。

域名白名单可以放行指定 IP 地址或地址段内的地址的访问请求，不进行任何规则判断。域名白名单受黑白名单状态开关控制，仅当黑白名单状态为开启时生效。

<!-- image-todo -->

> 各类规则的优先级参见[规则优先级](/docs/uewaf/features/rule/mode#规则优先级)。

## 规则列表

规则列表展示了域名下所有的黑名单规则，可以根据备注查询规则，也可以对规则进行修改或删除。

| 参数     | 说明                                                   |
| -------- | ------------------------------------------------------ |
| 规则名称 | 白名单规则的名称，可以为任意中英文字符                 |
| IP 内容  | 规则所包含的具体 IP 地址，可以是 IP 地址段或 CIDR 网段 |
| IP 类型  | 规则中的 IP 地址的类型                                 |
| 动作     | 放行，不进行任何规则判断                               |
| 加入时间 | 规则生成的时间                                         |
| 操作     | 编辑或删除，可以修改或删除规则                         |

## 添加白名单

自定义添加域名白名单规则

<!-- image-todo -->

### 规则参数说明

| 参数    | 说明                                                   |
| ------- | ------------------------------------------------------ |
| IP 类型 | 规则中的 IP 地址的类型                                 |
| IP 内容 | 规则所包含的具体 IP 地址，可以是 IP 地址段或 CIDR 网段 |
| 动作    | 放行，不进行任何规则判断                               |
| 备注    | 标注规则，可在规则较多的情况快速搜索规则               |

!> 注意：  
1 添加域名黑白名单前请先选择需要添加的域名；
2 添加的白名单是 IP 地址，若黑名单添加的 IP 段包含了白名单的 IP 地址，则仅对白名单中的指定 IP 地址进行放行，其余同网段 IP 仍然会拦截。

## 白名单说明

1. 每个域名的自定义白名单最大数目参考[性能及配额对比](/docs/uewaf/steer/version_selection#性能及配额对比)，每一条条目内可包含 200 个 IP 或 IP 段；
2. 域名白名单优先级低于全局白名单，高于全局白名单及域名白名单。

<!--
3. 机器行为检测添加至黑名单的条数最大为 1 万条。不进行合并处理。
-->
