华三(H3C)无线控制器(AC)的命令体系基于 Comware V7 平台。要列出“正好100个”常用命令并不完全准确,因为实际工作中常用的核心命令大约在 40-50 个左右,其余多为参数组合或特定场景命令。
为了帮你全面掌握,我将这些命令按功能场景分类,整理了最核心、最高频的命令清单(涵盖配置、查看、调试、维护等),数量接近百条实用指令组合,足以应对 95% 的日常运维工作。
一、基础系统与视图切换 (System & View)#
进入不同配置视图是执行命令的前提。
system-view(进入系统视图)quit/return(退出当前视图 / 直接退回到用户视图)sysname <name>(修改设备名称)clock datetime <HH:MM:SS> <YYYY/MM/DD>(修改时间)clock timezone <zone-name> <offset>(配置时区,如clock timezone Beijing add 08:00:00)display current-configuration(查看当前运行配置)display saved-configuration(查看保存的配置)save(保存配置)display version(查看版本信息)display device(查看设备硬件状态)display cpu-usage(查看 CPU 利用率)display memory-usage(查看内存利用率)display interface brief(查看接口简要状态)ping <ip>(测试连通性)tracert <ip>(路由追踪)
二、CAPWAP 隧道与 AP 管理 (AP Management)#
AC 最核心的功能,管理 AP 的上线与状态。
wlan apdb <ap-model>(导入/AP 型号定义,旧版本常用)wlan ap <ap-name> Serial-ID <serial>(手动添加 AP,序列号绑定)wlan ap <ap-name> mac-address <mac>(手动添加 AP,MAC 地址绑定)undo wlan ap <ap-name>(删除 AP)display wlan ap all(查看所有 AP 状态,最常用)display wlan ap name <ap-name>(查看指定 AP 详细信息)display wlan ap serial-id <serial>(通过序列号查 AP)wlan ap-reset <ap-name>(远程重启指定 AP)wlan ap-reset all(远程重启所有 AP,慎用)display wlan ap configuration <ap-name>(查看 AP 下发的配置)display wlan ap run-info <ap-name>(查看 AP 运行信息)display wlan ap link-quality <ap-name>(查看 AP 链路质量)ap-mode fit(确认 AP 模式为 FIT 模式,通常在 AP 上配,AC 侧主要看隧道)display wlan ap firmware(查看 AP 固件版本)wlan ap-image-update <ap-name>(升级指定 AP 固件)wlan ap-image-update all(升级所有 AP 固件)display capwap configuration(查看 CAPWAP 隧道配置)display capwap link all(查看 CAPWAP 链路状态)capwap source interface <interface>(指定 CAPWAP 隧道的源接口,必配)undo wlan ap <ap-name> disable(启用被禁用的 AP)wlan ap <ap-name> disable(禁用 AP)display wlan ap offline-record(查看 AP 离线记录)wlan ap <ap-name> location <text>(配置 AP 物理位置信息)display wlan ap name <ap-name> radio all(查看 AP 所有射频信息)display wlan ap statistics(查看 AP 统计信息)
三、射频管理 (Radio Management)#
优化无线信号覆盖与质量。
wlan radio-policy <policy-name>(创建射频策略)radio-type <11a|11b|11g|11ac|11ax>(指定射频类型)channel <channel-number>(固定信道)channel auto(开启自动信道)max-txpower <value>(设置最大发射功率)min-txpower <value>(设置最小发射功率)txpower auto(开启自动功率调整)bandwidth <20|40|80|160>(设置频宽)coverage-hole-detection enable(开启覆盖空洞检测)interference-detection enable(开启干扰检测)display wlan radio all(查看所有射频状态)display wlan radio name <ap-name> radio <id>(查看指定射频详情)display wlan channel-plan(查看信道规划结果)display wlan interference(查看干扰情况)manual-calibrate(手动触发射频校准)radio <1|2> disable(关闭指定射频卡)radio <1|2> enable(开启指定射频卡)beacon-interval <value>(调整信标间隔)dtim-period <value>(调整 DTIM 周期)rts-threshold <value>(设置 RTS 阈值)
四、SSID 与服务模板 (Service Template & SSID)#
配置 Wi-Fi 名称、密码和认证方式。
wlan service-template <id>(进入服务模板视图)ssid <name>(配置 Wi-Fi 名称)cipher-suite tkip/ccmp(配置加密套件,推荐 ccmp)_security akm psk pass-phrase <password>(配置 WPA2-PSK 密码)_security akm psk(启用 PSK 认证模式)authentication-method open-system(设置认证方式为开放系统)client-security authentication-mode psk(旧版本配置 PSK)vlan <vlan-id>(配置业务 VLAN)service-template enable(启用服务模板,关键步骤)undo service-template enable(禁用服务模板)display wlan service-template all(查看所有服务模板)display wlan service-template <id>(查看指定模板详情)hide-ssid(隐藏 SSID)undo hide-ssid(显示 SSID)client-max-count <value>(限制单个 SSID 最大接入用户数)traffic-filter inbound/outbound(配置流量过滤)qos-policy <policy-name>(绑定 QoS 策略)multicast-suppression(开启组播抑制)uapsd enable(开启节能模式)isolate-users(开启用户隔离)
五、VAP 模板与射频绑定 (VAP & Binding)#
将 SSID 下发到具体的 AP 和射频上。
wlan vap-template <name>(创建 VAP 模板)service-template <id>(在 VAP 模板中绑定服务模板)ssid-profile <name>(绑定 SSID 配置文件,V7 新版本常用)security-profile <name>(绑定安全配置文件,V7 新版本常用)vlan <vlan-id>(VAP 模板下配置 VLAN)vap-template <name>(进入 AP 视图或射频视图绑定 VAP)radio <1|2> enable(在 AP 视图下开启射频)radio <1|2> service-template <id>(旧版本:射频直接绑定服务模板)radio <1|2> vap-template <name>(新版本:射频绑定 VAP 模板)display wlan vap all(查看所有 VAP 状态)display wlan vap name <ap-name>(查看指定 AP 的 VAP)broadcast-ssid enable(在 VAP 模板下开启广播)
六、高级功能与安全 (Advanced & Security)#
wlan blacklist mac-address <mac>(将用户加入黑名单)wlan whitelist mac-address <mac>(将用户加入白名单)display wlan client all(查看所有在线无线用户,排障必用)display wlan client mac-address <mac>(查看指定用户详情)wlan client disconnect mac-address <mac>(强制踢除指定用户)wlan client bulk-disconnect(批量踢除用户)rogue-detection enable(开启非法 AP 检测)display wlan rogue-ap all(查看非法 AP 列表)wids-profile <name>(配置 WIDS/WIPS 策略)attack-detection enable(开启攻击检测)radius scheme <name>(配置 Radius 方案,用于 802.1X/Portal)domain <name>(配置认证域)portal enable(开启 Portal 认证)wlan load-balance(开启负载均衡)wlan fast-roaming enable(开启快速漫游 802.11r/k/v)display wlan statistics(查看无线整体统计)debugging wlan all(开启无线调试,生产环境慎用)undo debugging all(关闭所有调试)terminal logging(开启终端日志显示)terminal debugging(开启终端调试信息显示)reset wlan ap <ap-name> statistics(重置 AP 统计信息)reset wlan client statistics(重置用户统计信息)archive configuration(配置配置归档)
💡 核心命令速记口诀 (Top 10)#
如果你只能记 10 个,请记住下面这些,能解决 80% 的问题:
- 看状态:
display wlan ap all(AP 上线了吗?) - 看用户:
display wlan client all(谁连上了?) - 看配置:
display current-configuration(现在的配置是什么?) - 进配置:
system-view(去改配置) - 配隧道:
capwap source interface Vlan-interface X(AP 能连上 AC 的关键) - 配 SSID:
wlan service-template 1->ssid XXX->service-template enable - 绑射频:
wlan ap XXX->radio 1->vap-template XXX - 踢用户:
wlan client disconnect mac-address XXXX - 重启 AP:
wlan ap-reset XXX - 保存:
save(别重启后配置丢了)
⚠️ 注意事项#
- 版本差异: H3C Comware V5 和 V7 命令有较大区别(特别是安全配置部分,V7 倾向于使用
security-profile,ssid-profile,vap-template分离配置,而 V5 直接在service-template下配)。以上命令以主流的 V7 为主,兼顾 V5 常用写法。 - 上下文: 大多数配置命令必须在特定的视图下(如
wlan view,ap view,radio view)才能执行。 - AP 模式: 确保 AP 是 Fit AP (瘦 AP) 模式,AC 才能管理。如果是 Fat AP (胖 AP),这些命令大部分无效。