---
title: HCCL_WHITELIST_FILE
description: "当通过HCCL_WHITELIST_DISABLE开启了通信白名单校验功能时，需要通过此环境变量配置指向HCCL通信白名单配置文件的路径，只有在通信白名单中的IP地址才允许进行集合通信。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/hcclug/hcclenvref_07_0038.html
sourcePath: /source/zh/canncommercial/900/API/hcclug/hcclenvref_07_0038.html
indexId: 23bd5c1ece646613c501438bb0e1d8acc092bbb43d5a73c8d49b89e7c4c54a1b64
---
# 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 推理卡。）