---
title: HCCL_WHITELIST_FILE
description: "当通过HCCL_WHITELIST_DISABLE开启了通信白名单校验功能时，需要通过此环境变量配置指向HCCL通信白名单配置文件的路径，只有在通信白名单中的IP地址才允许进行集合通信。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/maintenref/envvar/envref_07_0157.html
sourcePath: /source/zh/canncommercial/900/maintenref/envvar/envref_07_0157.html
indexId: b5c1091f30033eee2b0a81056819844dd6ac85f614e236fe647409db6a85851e67
---
# HCCL_WHITELIST_FILE

#### 功能描述

当通过HCCL_WHITELIST_DISABLE开启了通信白名单校验功能时，需要通过此环境变量配置指向HCCL通信白名单配置文件的路径，只有在通信白名单中的IP地址才允许进行集合通信。

HCCL通信白名单配置文件格式为：

```
{ "host_ip": ["ip1", "ip2"], "device_ip": ["ip1", "ip2"] }
```

其中：

- device_ip为预留字段，当前版本暂不支持。
- IP地址格式为点分十进制。

白名单IP需要指定为集群通信使用的有效IP。


#### 配置示例

```
export HCCL_WHITELIST_FILE=/home/test/whitelist
```


#### 使用约束

无


#### 支持的型号

Atlas 350 加速卡

Atlas A3 训练系列产品 / Atlas A3 推理系列产品

Atlas A2 训练系列产品 / Atlas A2 推理系列产品 （针对 Atlas A2 训练系列产品 / Atlas A2 推理系列产品 ，仅支持Atlas 800T A2 训练服务器、Atlas 900 A2 PoD 集群基础单元、Atlas 200T A2 Box16 异构子框。）

Atlas 训练系列产品

Atlas 推理系列产品 （针对 Atlas 推理系列产品 ，仅支持Atlas 300I Duo 推理卡。）