华为 WLAN AC 配置技能 (wlan-ac-config)

适用平台：AirEngine 9700S-S / 9700S / 8760 / 6760 / 5760 系列 AP + AC 适用版本：V200R024C00（V200R022C00+ 大部分命令兼容） 文档来源：华为《WLAN 典型配置案例集（V200）》（CHM，2024-06-30）+《无线接入控制器(AC和FIT AP) V200R024C00 配置指南(命令行)》 案例库：CHM 案例 24 basic + 20 web_basic + 8 auth + 6 roam + 8 qos + 4 sec + 7 reliab + 5 rrm 等 200+ 个

一、触发场景

召唤关键词：无线 / WLAN / Wi-Fi / AC / FIT AP / FAT AP / AirEngine / SSID / VAP / 漫游 / 信道 / 频谱 / 802.1X / WPA3 / Mesh / 物联网 / 电子价签 / 客流分析 / SmartRadio / CAPWAP

典型问题：

• "AC 上加一台 AP 怎么配？"
• "SSID 怎么发？加密选 WPA2 还是 WPA3？"
• "STA 在 AP 之间漫游掉线 / 业务中断"
• "信道冲突 / 同频干扰"
• "Mesh 组网怎么做？"
• "电子价签 / 客流分析 IoT 怎么接？"
• "FIT AP 转 FAT AP 模式怎么切？"
• "AP 上线失败 / 反复重启 / 离线"

二、AC WLAN 配置六步走

第 1 步：网络层准备（交换机 / 路由器配置）

AC 跟普通交换机一样跑在网络层，WLAN 配置之前先把网络打通。

1.1 VLAN 规划（最少 2 个）

1.2 交换机配置（接入 AP 的 SwitchA）

<HUAWEI> system-view
[SwitchA] vlan batch 100
[SwitchA] interface gigabitethernet 0/0/1     # 接 AP 的口
[SwitchA-GigabitEthernet0/0/1] port link-type trunk
[SwitchA-GigabitEthernet0/0/1] port trunk pvid vlan 100
[SwitchA-GigabitEthernet0/0/1] port trunk allow-pass vlan 100
[SwitchA-GigabitEthernet0/0/1] port-isolate enable    # AP 间二层隔离（防环路）
[SwitchA-GigabitEthernet0/0/1] quit

1.3 AC 配置（核心步骤）

<HUAWEI> system-view
[AC] sysname AC
[AC] vlan batch 100 101
[AC] interface gigabitethernet 0/0/1              # 接上行交换机口
[AC-GigabitEthernet0/0/1] port link-type trunk
[AC-GigabitEthernet0/0/1] port trunk allow-pass vlan 100 101
[AC-GigabitEthernet0/0/1] quit

# CAPWAP 管理 VLANIF
[AC] dhcp enable
[AC] interface vlanif 100
[AC-Vlanif100] ip address 10.23.100.1 24
[AC-Vlanif100] dhcp select interface              # AP 通过 DHCP 拿 IP
[AC-Vlanif100] quit

# 业务 VLAN 网关（在 AC 上终结）
[AC] interface vlanif 101
[AC-Vlanif101] ip address 10.23.101.1 24
[AC-Vlanif101] dhcp select interface
[AC-Vlanif101] quit

# CAPWAP 隧道源接口（关键：AC 用此接口 IP 与 AP 建隧道）
[AC] capwap source interface vlanif 100

第 2 步：进入 wlan 视图 + 建 AP 组 + 域管理模板

[AC] wlan
[AC-wlan-view] ap-group name ap-group1           # AP 组（一组 AP 共用配置）
[AC-wlan-ap-group-ap-group1] quit

# 域管理模板：国家码（决定可用信道和功率）
[AC-wlan-view] regulatory-domain-profile name default
[AC-wlan-regulate-domain-default] country-code cn
[AC-wlan-regulate-domain-default] quit

# AP 组引用域管理模板
[AC-wlan-view] ap-group name ap-group1
[AC-wlan-ap-group-ap-group1] regulatory-domain-profile default
# ⚠️ 警告：此操作会清空 radio 信道/功率配置，可能重启 AP
[AC-wlan-ap-group-ap-group1] quit

第 3 步：AP 上线（认证 + 注册）

两种 AP 认证模式（按场景选）：

[AC-wlan-view] ap auth-mode mac-auth             # 或 sn-auth

# 按 MAC 注册 AP（从 AP 设备贴纸查 MAC）
[AC-wlan-view] ap-id 0 ap-mac 00e0-fc76-e360
[AC-wlan-ap-0] ap-name area_1                    # AP 改名（建议带位置）
[AC-wlan-ap-0] ap-group ap-group1
[AC-wlan-ap-0] quit

验证上线（关键命令）：

[AC-wlan-view] display ap all
# 看 State 字段：nor = normal（正常上线）
# Total AP information: nor : normal [1]

上线失败常见原因（详见 troubleshooting）：

• VLAN 不通 / DHCP 没下发
• CAPWAP 源接口配错
• AP 认证模式不匹配
• AP 固件版本 AC 不识别（需 ap-type-switch）

第 4 步：SSID + 安全 + VAP 三模板（业务下发）

三模板关系：SSID 模板（名字）+ 安全模板（加密）+ VAP 模板（业务绑定）

# 4.1 安全模板
[AC-wlan-view] security-profile name wlan-net
[AC-wlan-sec-prof-wlan-net] security wpa-wpa2 psk pass-phrase YsHsjx_202206 aes
#                                                              ↑ 密码 ≥ 8 位
[AC-wlan-sec-prof-wlan-net] quit

# 4.2 SSID 模板
[AC-wlan-view] ssid-profile name wlan-net
[AC-wlan-ssid-prof-wlan-net] ssid wlan-net
[AC-wlan-ssid-prof-wlan-net] quit

# 4.3 VAP 模板（绑定 SSID + 安全 + 业务 VLAN）
[AC-wlan-view] vap-profile name wlan-net
[AC-wlan-vap-prof-wlan-net] forward-mode tunnel             # tunnel=集中转发 / direct=本地转发
[AC-wlan-vap-prof-wlan-net] service-vlan vlan-id 101        # 业务 VLAN
[AC-wlan-vap-prof-wlan-net] security-profile wlan-net
[AC-wlan-vap-prof-wlan-net] ssid-profile wlan-net
[AC-wlan-vap-prof-wlan-net] quit

# 4.4 在 AP 组下引用 VAP（绑定到 radio 0=2.4G / radio 1=5G）
[AC-wlan-view] ap-group name ap-group1
[AC-wlan-ap-group-ap-group1] vap-profile wlan-net wlan 1 radio 0
[AC-wlan-ap-group-ap-group1] vap-profile wlan-net wlan 1 radio 1
[AC-wlan-ap-group-ap-group1] quit

验证 STA 连接：

[AC-wlan-view] display vap ssid wlan-net        # 看 VAP 是否下发到 AP
[AC-wlan-view] display station ssid wlan-net    # 看 STA 是否关联

第 5 步：射频管理（SmartRadio）

核心原则：让 AP 自动选信道 + 自动调功率，避免手工配置的滞后。

[AC-wlan-view] ap-group name ap-group1
[AC-wlan-ap-group-ap-group1] radio 0
[AC-wlan-group-radio-ap-group1/0] calibrate auto-channel-select enable
[AC-wlan-group-radio-ap-group1/0] calibrate auto-txpower-select enable
[AC-wlan-group-radio-ap-group1/0] quit

[AC-wlan-ap-group-ap-group1] radio 1
[AC-wlan-group-radio-ap-group1/1] calibrate auto-channel-select enable
[AC-wlan-group-radio-ap-group1/1] calibrate auto-txpower-select enable
[AC-wlan-group-radio-ap-group1/1] quit
[AC-wlan-ap-group-ap-group1] quit

# 全局定时校准（每天凌晨 3 点）
[AC-wlan-view] calibrate enable schedule time 03:00:00

射频模板（如果需要更精细控制）：

# 2G 射频模板（信道 1-13）
[AC-wlan-view] radio-2g-profile name wlan-radio2g
[AC-wlan-radio-2g-prof-wlan-radio2g] channel-set 1,6,11    # 互不干扰信道
[AC-wlan-radio-2g-prof-wlan-radio2g] quit

# 5G 射频模板（信道 36-165）
[AC-wlan-view] radio-5g-profile name wlan-radio5g
[AC-wlan-radio-5g-prof-wlan-radio5g] channel-set 149,153,157,161
[AC-wlan-radio-5g-prof-wlan-radio5g] quit

# AP 组引用射频模板
[AC-wlan-view] ap-group name ap-group1
[AC-wlan-ap-group-ap-group1] radio-5g-profile wlan-radio5g radio 1
[AC-wlan-ap-group-ap-group1] radio-2g-profile wlan-radio2g radio 0
[AC-wlan-ap-group-ap-group1] quit

第 6 步：保存配置（必须！）

⚠️ CE 系列教训同源：V200R022+ 起所有改动必须 commit 才生效。AC WLAN 配置同样不例外。

[AC] save
The current configuration will be written to the device.
Are you sure to continue?[Y/N]y
Now saving the current configuration to the slot 0.
Save successfully

三、命令体系（六大类视图）

视图层级

[AC]                          # 系统视图
└── [AC-wlan-view]            # wlan 视图（wlan 命令进入）
    ├── [AC-wlan-ap-group-X]  # AP 组视图
    │   ├── [AC-wlan-ap-X]    # 单 AP 视图（ap-id 命令）
    │   └── [AC-wlan-ap-group-X/Y]  # AP 组下 radio Y 视图
    └── [AC-wlan-sec-prof-X]  # 各 profile 视图（安全/SSID/VAP/射频/域）

6 大模板速记

关键监控命令

display ap all                      # 全部 AP 状态（State 字段）
display vap ssid <SSID>             # VAP 下发情况
display station ssid <SSID>         # STA 关联情况
display radio all                   # 射频状态
display ap radio <ap-id>            # 单 AP 射频详情
display ap run-info <ap-id>         # AP 运行时信息
display station roam-track <MAC>    # STA 漫游轨迹
display ap firmware version          # AP 固件版本

四、平台差异

V200R024C00 vs V200R022C00 差异

CAPWAP DTLS 认证（V200R021C00+ 改动）

# V200R021C00+ 默认要求关闭 DTLS 不认证模式
[AC-wlan-view] quit
[AC] capwap dtls authentication-mode certificate     # 证书认证
# 或
[AC] capwap dtls authentication-mode psk             # 预共享密钥

老胡命令复习：V200R024C00 起必须配 DTLS 认证，否则 AP 上线失败告警。

AirEngine 9700S-S 专属

• Wi-Fi 6E 三频（2.4G + 5G + 6GHz）
• 6GHz 信道需在国家码 cn + dca-channel 6g channel-set 单独配置
• 室内放装，PoE 供电（802.3at）

五、常见安全配置

WPA2 个人版（最常用）

[AC-wlan-view] security-profile name sec-wpa2
[AC-wlan-sec-prof-sec-wpa2] security wpa-wpa2 psk pass-phrase <密码> aes
[AC-wlan-sec-prof-sec-wpa2] quit

WPA3 个人版（推荐新网络）

[AC-wlan-view] security-profile name sec-wpa3
[AC-wlan-sec-prof-sec-wpa3] security wpa3 psk pass-phrase <密码> aes
[AC-wlan-sec-prof-sec-wpa3] quit

802.1X 企业版（需 RADIUS 服务器）

[AC] radius-server template radius1
[AC-radius-radius1] radius-server authentication 10.23.100.200 1812
[AC-radius-radius1] radius-server shared-key cipher <密钥>
[AC-radius-radius1] quit

[AC] aaa
[AC-aaa] authentication-scheme auth1
[AC-aaa-authen-auth1] authentication-mode radius
[AC-aaa-authen-auth1] quit

[AC-wlan-view] security-profile name sec-dot1x
[AC-wlan-sec-prof-sec-dot1x] security wpa2 dot1x aes
[AC-wlan-sec-prof-sec-dot1x] quit

六、漫游配置（要点）

详见 AC 配置指南 第 13 章。

3 类漫游：

• intra-AC：STA 在同一 AC 下的不同 AP 间漫游（默认支持，无需配置）
• inter-AC（同 AC 集群）：通过 AC 间 CAPWAP 隧道，需配 mobility-group
• inter-AC（跨集群）：通过 AC 间 Mobility Controller (MC)，企业级场景

同 AC 集群配置：

[AC-wlan-view] mobility-group name mgl
[AC-wlan-mobility-group-mgl] member ip 10.23.100.2            # 对端 AC IP
[AC-wlan-mobility-group-mgl] member ip 10.23.100.3
[AC-wlan-mobility-group-mgl] quit

七、Mesh 组网（AP 间无线回传）

适用场景：AP 间无有线连接，靠 AP 之间无线互联组网（仓库 / 室外）。

# AP 1（root AP）：连 AC
[AC-wlan-ap-0] radio 1
[AC-wlan-ap-0/1] mesh-profile name mesh-1
[AC-wlan-mesh-prof-mesh-1] mesh-id 1
[AC-wlan-mesh-prof-mesh-1] mesh-pass-phrase <密码>
[AC-wlan-mesh-prof-mesh-1] quit

# AP 2（leaf AP）：无线连 AP 1
[AC-wlan-ap-1] radio 1
[AC-wlan-ap-1/1] mesh-role leaf
[AC-wlan-ap-1/1] mesh-profile mesh-1

详细案例见 CHM dc_wlan_example_mesh_*.html（3 个案例）

八、IoT 扩展（V200R024C00 增强）

电子价签（ESL）

• 协议：私有 RF（433MHz）
• 配置模板：esl-profile，AP 组引用
• 场景：商超 / 零售

客流分析（Hotspot Service）

• 协议：Wi-Fi 探针 + 蓝牙 Beacon
• 配置：hotspot2-profile
• 场景：商超 / 商场 / 展馆

医疗物联网 / 资产管理

• 配置：iot-profile
• 场景：医院 / 仓库

详细案例见 CHM dc_wlan_example_hs2_*.html / dc_wlan_example_web_netmgt_*.html

九、巡检 / 排错基础命令

设备信息

display version                              # AC 软硬件版本
display ap firmware version                  # 全部 AP 固件版本
display ap type all                          # 全部 AP 型号

状态类

display ap all                               # AP 在线状态
display ap offline-record                    # AP 离线历史
display ap run-info <ap-id>                  # AP 运行时信息
display station all                          # 全部 STA
display station abnormal                     # 异常 STA

故障定位

display ap alarm active                      # AP 当前告警
display station roam-track <MAC>             # STA 漫游轨迹
display logbuffer | include AP                # AP 相关日志

十、不适用

• 路由器（AR/NE）→ 用 ospf-config / static-route
• 交换机 / 防火墙 → 用 vlan-config / interface-config / security-policy 等
• 网管平台（iMaster NCE-Campus）→ 暂无 skill，本地命令行配置可覆盖 80%
• AP 二层漫游组网（FIT AP 模式）→ 本 skill 覆盖

十一、版本与文档

十二、待补充（Q4 候选）

• ⏳ FAT AP 模式配置：AP 独立组网，无 AC（家用 / 小型办公室）
• ⏳ 双频负载均衡（band steering）：5G 优先接入
• ⏳ 用户 CAC 限速（per-user bandwidth）
• ⏳ AP 上线策略（按 MAC/序列号白名单）
• ⏳ AP 故障逃生（AP 跟 AC 断链后本地转发）

版权：本 skill 基于华为公开技术文档整理，所有命令引用均标注案例来源（CHM 案例编号 / 指南章节号）。