更新时间：2026-08-07 GMT+08:00
管理自定义词库
WAF预先内置一套不同类别的词库，用于AI应用的文本和图片的基础语义检测，可满足大部分合规需求。针对特殊业务情况，WAF支持上传自定义词库，构建专属关键词库，用于拦截或豁免文本中的关键词，以提高检测效率和准确度，进一步增强大模型防火墙的防护能力。
约束条件
自定义词库仅用于大模型检测规则的文本检测、AI安全护栏的文本检测和图片检测功能。
| 功能 | 约束说明 |
|---|---|
| 数量限制 | 一个企业项目ID下，最多可添加5个词库，单个词库的关键词数量不超过1,000。 |
添加词库
- 登录Web应用防火墙控制台。
- 在控制台左上角，单击
图标，选择区域或项目。 - (可选) 如果您已开通企业项目，在左侧导航栏上方单击“按企业项目筛选”下拉框，选择您所在的企业项目。完成后，页面将为您展示该企业项目下的相关数据。
- 在左侧导航栏，选择。
- 在词库列表左上方，单击“添加词库”。
- 在“添加词库”面板，完成以下参数配置，添加自定义词库。一个企业项目ID下，最多可添加5个词库。
表1 自定义词库参数说明 参数
参数说明
取值样例
词库名称
填写自定义词库的名称。
水果
词库类别
选择自定义词库的类别。
- 违规：违规类别中的关键词将被视为攻击词汇。输入文本携带该类词汇，则会触发相应防护动作。
- 豁免：豁免类别中的关键词将被视为安全词汇。WAF引擎会根据该类词汇，匹配并过滤输入文本中的关键词后，再对剩余文本进行后续大模型检测规则检测，如合规检测和注入检测等。
例如，豁免关键词为苹果, 香蕉时，输入文本我喜欢吃苹果和香蕉。
- WAF引擎执行豁免词汇检测，得到输入文本我喜欢吃和。
- WAF引擎对我喜欢吃和执行合规检测和注入检测等大模型规则检测。
违规
关键词
填写要加入词库的关键词。
- 填写要求：
- 关键词只能由字母、汉字、&符号组成，且不能超过64个字符，多个关键词之间用回车或半角逗号（,）分隔。
- 单个词库的关键词数量不超过1,000。
- 生效规则：使用回车或半角逗号（,）分隔时，命中其中一个关键词即可生效；使用&符号时，需同时满足&符号连接的关键词才能生效。 例如，关键词为苹果,香蕉,西瓜&哈密瓜时，输入的文本中：
- 存在苹果，执行对应处置。
- 存在西瓜，不会执行对应处置，同时存在西瓜和哈密瓜，执行对应处置。
苹果,香蕉,西瓜&哈密瓜
描述(可选)
填写该词库的备注信息。
--
完成以上配置后，可在自定义词库列表查看、修改、删除已添加的词库。
添加的词库可应用于AI安全护栏的文本检测、图片检测。
