WX510H-HPW如何下发map文件

WX510H-HPW是什么产品

集中转发和本地转发是在无线模板里配置

wlan service-template xx

client forwarding-location ac 集中转发(默认集中转发)
                                           ap 本地转发

map文件是在ap组的型号下，下发

AP本地转发时，需要下发map文件，map文件中最常见的配置是配置AP上行口允许的VLAN。例如：

#apconfig.txt配置：

system-view

vlan 200

quit

interface GigabitEthernet 1/0/1

port link-type trunk

port trunk permit vlan 200

但是经常见到如下配置：

system-view

vlan 1 to 4094

quit

interface GigabitEthernet 1/0/1

port link-type trunk

port trunk permit vlan all   //下发全部vlan

但是AP最多只支持下发256个VLAN，导致AP中只能创建前256个VLAN，超过这个数目的VLAN无法创建，如果下发的VLAN编号大于256，则无法下发到AP中，导致终端无法通过AP注册。因此在map文件中配置vlan要注意不要下发全部vlan，而要根据需要下发vlan.

本地转发案例参考，1 WLAN本地转发典型配置

在WX510H-HPW无线控制器上下发map文件实现本地转发，核心是两步走：先在AC上创建并上传map文件，再在AP的配置中引用这个文件。

第一步：创建并上传map文件 (apcfg.txt)

这个文件包含了要下发给AP执行的本地配置命令。

1. 创建文件：在电脑上用记事本创建一个文本文件，命名为 apcfg.txt。

2. 编辑内容：在文件里按顺序写入以下命令。特别注意，每行命令末尾不能有多余的空格或Tab键，否则会导致配置下发失败。

   bash

   system-view vlan 200 quit interface GigabitEthernet 1/0/1 port link-type trunk port trunk permit vlan 200

   • 命令解释：这段配置的作用是，让AP的 GigabitEthernet 1/0/1 接口变为Trunk模式，并允许业务VLAN 200通过。请务必根据你的实际业务VLAN ID修改“200”。

3. 上传文件到AC：你需要将 apcfg.txt 文件上传到AC的存储介质中（通常是flash）。根据你的使用习惯，有两种方式：

   • 方式一：Web页面上传（推荐）

     1. 登录AC的Web管理页面。

     2. 导航到“系统” > “文件管理”。

     3. 点击“上传”按钮，选择你电脑上的 apcfg.txt 文件并确认上传。

   • 方式二：TFTP上传

     1. 在电脑上开启TFTP服务器，并将 apcfg.txt 文件放在其根目录下。

     2. 通过Console或SSH登录AC，执行以下命令（10.88.18.160替换为你的TFTP服务器IP）：

        bash

        <H3C> tftp 10.88.18.160 get apcfg.txt

 第二步：在AC上配置AP并引用map文件

文件上传完成后，需要在AC的AP配置中，用 map-configuration 命令来指定这个文件。

1. 进入AP配置视图：

   bash

   [AC] wlan ap officeap model WA4320i-ACN

   • officeap 是你的AP名称，WA4320i-ACN 是AP型号，请根据实际情况修改。

2. 引用map文件：

   bash

   [AC-wlan-ap-officeap] map-configuration apcfg.txt

   这条命令告诉AC，当这个AP上线后，就把 apcfg.txt 里的配置下发给它。

 第三步：配置无线服务模板（开启本地转发）

这是确保无线用户流量在AP本地转发出去的先决条件。

1. 创建或进入服务模板：

   bash

   [AC] wlan service-template 1 [AC-wlan-st-1] ssid service

2. 开启本地转发：

   bash

   [AC-wlan-st-1] client forwarding-location ap vlan 200

   这条命令是关键，它指定了该服务模板下的用户流量，在AP上进行本地转发，并且业务VLAN是200。

3. 启用服务模板：

   bash

   [AC-wlan-st-1] service-template enable

 补充说明与验证

• 适用性：以上方法是基于H3C V7无线控制器平台的通用配置，你的WX510H-HPW属于此系列，完全适用。

• 验证配置：配置完成后，可以通过以下命令检查状态。

  • 查看AP是否获取到map文件：display wlan ap name officeap verbose，在输出信息中查找 Map configuration 字段。

  • 查看AP的详细状态：display wlan ap name officeap running-configuration，确认接口配置已生效。

# WX510H‑HPW（Comware V7）map‑configuration 本地转发下发完整操作

>
> WX510H‑HPW V7，**map 文件本质 txt 文本，里面是 AP 上要执行的命令**，用来配置 AP 上联口 Trunk 放行业务 VLAN，实现本地转发。
> 两种下发方式：①单台 AP 绑定 map 文件；②AP‑model 按 AP 型号批量绑定 map 文件（推荐，同型号 AP 统一模板）。

## 一、制作 map 配置文件（本地电脑编辑记事本，保存为 UTF‑8 无 BOM）

文件名示例：`local‑map.txt`

>
> ⚠️重要：**不要多余空格、tab、空行不要过多，命令格式跟设备命令行完全一致，结尾建议换行**；编码选 UTF‑8，不要 ANSI，部分 AP 会解析异常H3C。

map 文件内容示例：

```
system‑view
vlan 10
vlan 20
quit
#AP的上联物理口，FIT AP上联口一般是GigabitEthernet1/0/1
interface GigabitEthernet 1/0/1
port link‑type trunk
port trunk permit vlan 10 20 100
port trunk native vlan 100
quit
save
Y
```

>
> 说明：
>
>
> - native vlan 100：CAPWAP 管理 VLAN；
> - vlan10、20：无线业务本地转发 VLAN；
> - 末尾必须带上`save Y`，AP 执行完 map 配置自动保存配置，否则 AP 重启 map 配置丢失。

## 二、上传 map 文件到 WX510H‑HPW flash 根目录

### 方式 1：命令行 FTP/TFTP 上传

```
#ftp上传示例
ftp 192.168.1.100
get local‑map.txt flash:/local‑map.txt
quit
```

### 方式 2：Web 专家模式上传

Web 页面→【系统】→【文件管理】，上传`local‑map.txt`保存到 flash 根目录。

校验是否上传成功：

```
dir flash:/
```

可以看到`local‑map.txt`文件。

## 三、AC 配置无线服务模板开启本地转发

```
wlan service‑template st‑local
ssid Local‑WiFi
vlan‑id 10
#开启本地转发，流量在AP本地转发，不走CAPWAP数据隧道
client forwarding‑location ap
service‑template enable
quit
```

## 四、下发 map 文件两种模式

### 模式 A：按 AP 型号批量下发（推荐，同型号所有 AP 自动加载 map）

```
wlan ap‑group default
ap‑model WA6638
#绑定flash下的map文件名
map‑configuration local‑map.txt
radio 1
service‑template st‑local
radio enable
quit
radio 2
service‑template st‑local
radio enable
quit
quit
quit
```

>
> 后续该型号 AP 上线，会**自动下载执行 map 文件**，不需要逐个 AP 配置。

### 模式 B：针对单个 AP 序列号单独下发

```
wlan ap ap‑WA6638 serial‑id 210235Axxxxxx
map‑configuration local‑map.txt
radio 1
service‑template st‑local
radio enable
quit
radio 2
service‑template st‑local
radio enable
quit
quit
```

## 五、关键配套网络要求（极易踩坑）

1. AP 上联交换机端口配置 Trunk，**放行管理 VLAN + 全部业务 VLAN**；
2. 业务 VLAN 网关不在 AC 上，在汇聚 / 接入交换机；
3. CAPWAP 管理 VLAN（本示例 vlan100）做 PVID (native‑vlan)。

## 六、查看与排错命令

```
#查看AP绑定的map‑configuration文件名
display wlan ap name ap‑WA6638 verbose

#查看map文件是否下发成功（AP上执行，可通过AP调试输出）
display wlan ap log name ap‑WA6638

#查看AP上线状态
display wlan ap all

#查看service‑template确认本地转发开启
display wlan service‑template verbose
```

### 常见故障

1. map 文件不生效：
- 文件编码错误、行尾多余空格 /tab；
- map 里面没有写`save Y`，AP 重启丢失 map 配置；
- 文件名大小写严格匹配 V7 系统区分大小写；
2. 无线终端获取不到 IP：
- AP 上联口没有 permit 业务 VLAN；上联交换机没有放行业务 VLAN；
3. map 文件下载失败：确认文件确实在 AC 的`flash:/`根目录，不要放到子目录。

>
> 双机热备场景：**备 AC 同样需要上传一模一样 map 文件，否则主备切换后 AP 拿不到 map 文件**H3C。