华三(H3C)无线控制器(AC)的命令体系基于 Comware V7 平台。要列出“正好100个”常用命令并不完全准确,因为实际工作中常用的核心命令大约在 40-50 个左右,其余多为参数组合或特定场景命令。

为了帮你全面掌握,我将这些命令按功能场景分类,整理了最核心、最高频的命令清单(涵盖配置、查看、调试、维护等),数量接近百条实用指令组合,足以应对 95% 的日常运维工作。


一、基础系统与视图切换 (System & View)#

进入不同配置视图是执行命令的前提。

  1. system-view (进入系统视图)
  2. quit / return (退出当前视图 / 直接退回到用户视图)
  3. sysname <name> (修改设备名称)
  4. clock datetime <HH:MM:SS> <YYYY/MM/DD> (修改时间)
  5. clock timezone <zone-name> <offset> (配置时区,如 clock timezone Beijing add 08:00:00)
  6. display current-configuration (查看当前运行配置)
  7. display saved-configuration (查看保存的配置)
  8. save (保存配置)
  9. display version (查看版本信息)
  10. display device (查看设备硬件状态)
  11. display cpu-usage (查看 CPU 利用率)
  12. display memory-usage (查看内存利用率)
  13. display interface brief (查看接口简要状态)
  14. ping <ip> (测试连通性)
  15. tracert <ip> (路由追踪)

二、CAPWAP 隧道与 AP 管理 (AP Management)#

AC 最核心的功能,管理 AP 的上线与状态。

  1. wlan apdb <ap-model> (导入/AP 型号定义,旧版本常用)
  2. wlan ap <ap-name> Serial-ID <serial> (手动添加 AP,序列号绑定)
  3. wlan ap <ap-name> mac-address <mac> (手动添加 AP,MAC 地址绑定)
  4. undo wlan ap <ap-name> (删除 AP)
  5. display wlan ap all (查看所有 AP 状态,最常用)
  6. display wlan ap name <ap-name> (查看指定 AP 详细信息)
  7. display wlan ap serial-id <serial> (通过序列号查 AP)
  8. wlan ap-reset <ap-name> (远程重启指定 AP)
  9. wlan ap-reset all (远程重启所有 AP,慎用)
  10. display wlan ap configuration <ap-name> (查看 AP 下发的配置)
  11. display wlan ap run-info <ap-name> (查看 AP 运行信息)
  12. display wlan ap link-quality <ap-name> (查看 AP 链路质量)
  13. ap-mode fit (确认 AP 模式为 FIT 模式,通常在 AP 上配,AC 侧主要看隧道)
  14. display wlan ap firmware (查看 AP 固件版本)
  15. wlan ap-image-update <ap-name> (升级指定 AP 固件)
  16. wlan ap-image-update all (升级所有 AP 固件)
  17. display capwap configuration (查看 CAPWAP 隧道配置)
  18. display capwap link all (查看 CAPWAP 链路状态)
  19. capwap source interface <interface> (指定 CAPWAP 隧道的源接口,必配)
  20. undo wlan ap <ap-name> disable (启用被禁用的 AP)
  21. wlan ap <ap-name> disable (禁用 AP)
  22. display wlan ap offline-record (查看 AP 离线记录)
  23. wlan ap <ap-name> location <text> (配置 AP 物理位置信息)
  24. display wlan ap name <ap-name> radio all (查看 AP 所有射频信息)
  25. display wlan ap statistics (查看 AP 统计信息)

三、射频管理 (Radio Management)#

优化无线信号覆盖与质量。

  1. wlan radio-policy <policy-name> (创建射频策略)
  2. radio-type <11a|11b|11g|11ac|11ax> (指定射频类型)
  3. channel <channel-number> (固定信道)
  4. channel auto (开启自动信道)
  5. max-txpower <value> (设置最大发射功率)
  6. min-txpower <value> (设置最小发射功率)
  7. txpower auto (开启自动功率调整)
  8. bandwidth <20|40|80|160> (设置频宽)
  9. coverage-hole-detection enable (开启覆盖空洞检测)
  10. interference-detection enable (开启干扰检测)
  11. display wlan radio all (查看所有射频状态)
  12. display wlan radio name <ap-name> radio <id> (查看指定射频详情)
  13. display wlan channel-plan (查看信道规划结果)
  14. display wlan interference (查看干扰情况)
  15. manual-calibrate (手动触发射频校准)
  16. radio <1|2> disable (关闭指定射频卡)
  17. radio <1|2> enable (开启指定射频卡)
  18. beacon-interval <value> (调整信标间隔)
  19. dtim-period <value> (调整 DTIM 周期)
  20. rts-threshold <value> (设置 RTS 阈值)

四、SSID 与服务模板 (Service Template & SSID)#

配置 Wi-Fi 名称、密码和认证方式。

  1. wlan service-template <id> (进入服务模板视图)
  2. ssid <name> (配置 Wi-Fi 名称)
  3. cipher-suite tkip / ccmp (配置加密套件,推荐 ccmp)
  4. _security akm psk pass-phrase <password> (配置 WPA2-PSK 密码)
  5. _security akm psk (启用 PSK 认证模式)
  6. authentication-method open-system (设置认证方式为开放系统)
  7. client-security authentication-mode psk (旧版本配置 PSK)
  8. vlan <vlan-id> (配置业务 VLAN)
  9. service-template enable (启用服务模板,关键步骤)
  10. undo service-template enable (禁用服务模板)
  11. display wlan service-template all (查看所有服务模板)
  12. display wlan service-template <id> (查看指定模板详情)
  13. hide-ssid (隐藏 SSID)
  14. undo hide-ssid (显示 SSID)
  15. client-max-count <value> (限制单个 SSID 最大接入用户数)
  16. traffic-filter inbound/outbound (配置流量过滤)
  17. qos-policy <policy-name> (绑定 QoS 策略)
  18. multicast-suppression (开启组播抑制)
  19. uapsd enable (开启节能模式)
  20. isolate-users (开启用户隔离)

五、VAP 模板与射频绑定 (VAP & Binding)#

将 SSID 下发到具体的 AP 和射频上。

  1. wlan vap-template <name> (创建 VAP 模板)
  2. service-template <id> (在 VAP 模板中绑定服务模板)
  3. ssid-profile <name> (绑定 SSID 配置文件,V7 新版本常用)
  4. security-profile <name> (绑定安全配置文件,V7 新版本常用)
  5. vlan <vlan-id> (VAP 模板下配置 VLAN)
  6. vap-template <name> (进入 AP 视图或射频视图绑定 VAP)
  7. radio <1|2> enable (在 AP 视图下开启射频)
  8. radio <1|2> service-template <id> (旧版本:射频直接绑定服务模板)
  9. radio <1|2> vap-template <name> (新版本:射频绑定 VAP 模板)
  10. display wlan vap all (查看所有 VAP 状态)
  11. display wlan vap name <ap-name> (查看指定 AP 的 VAP)
  12. broadcast-ssid enable (在 VAP 模板下开启广播)

六、高级功能与安全 (Advanced & Security)#

  1. wlan blacklist mac-address <mac> (将用户加入黑名单)
  2. wlan whitelist mac-address <mac> (将用户加入白名单)
  3. display wlan client all (查看所有在线无线用户,排障必用)
  4. display wlan client mac-address <mac> (查看指定用户详情)
  5. wlan client disconnect mac-address <mac> (强制踢除指定用户)
  6. wlan client bulk-disconnect (批量踢除用户)
  7. rogue-detection enable (开启非法 AP 检测)
  8. display wlan rogue-ap all (查看非法 AP 列表)
  9. wids-profile <name> (配置 WIDS/WIPS 策略)
  10. attack-detection enable (开启攻击检测)
  11. radius scheme <name> (配置 Radius 方案,用于 802.1X/Portal)
  12. domain <name> (配置认证域)
  13. portal enable (开启 Portal 认证)
  14. wlan load-balance (开启负载均衡)
  15. wlan fast-roaming enable (开启快速漫游 802.11r/k/v)
  16. display wlan statistics (查看无线整体统计)
  17. debugging wlan all (开启无线调试,生产环境慎用)
  18. undo debugging all (关闭所有调试)
  19. terminal logging (开启终端日志显示)
  20. terminal debugging (开启终端调试信息显示)
  21. reset wlan ap <ap-name> statistics (重置 AP 统计信息)
  22. reset wlan client statistics (重置用户统计信息)
  23. archive configuration (配置配置归档)

💡 核心命令速记口诀 (Top 10)#

如果你只能记 10 个,请记住下面这些,能解决 80% 的问题:

  1. 看状态: display wlan ap all (AP 上线了吗?)
  2. 看用户: display wlan client all (谁连上了?)
  3. 看配置: display current-configuration (现在的配置是什么?)
  4. 进配置: system-view (去改配置)
  5. 配隧道: capwap source interface Vlan-interface X (AP 能连上 AC 的关键)
  6. 配 SSID: wlan service-template 1 -> ssid XXX -> service-template enable
  7. 绑射频: wlan ap XXX -> radio 1 -> vap-template XXX
  8. 踢用户: wlan client disconnect mac-address XXXX
  9. 重启 AP: wlan ap-reset XXX
  10. 保存: 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),这些命令大部分无效。