以下是一份详细的AP串口命令指南,涵盖了从基础到进阶的常用命令,并特别指出了不同厂商(如Cisco、Aruba/HPE、Ruckus)的命令差异。

准备工作
-
物理连接:
- 使用一条 Console线(通常是USB转串口线),一端连接AP的Console口,另一端连接电脑的USB口。
- Console口通常是一个 RJ45接口,有时会标注为 "CONSOLE" 或 "CONFIG"。
-
软件配置:
- 打开终端模拟软件(如 PuTTY)。
- 选择 Serial 连接类型。
- 设置正确的 串口号(在设备管理器中查看)。
- 设置波特率为 9600,数据位为8,停止位为1,无校验位,无硬件流控,这是最常见的默认配置。
-
登录AP:
- 连接后,通常会看到AP的启动日志。
- 启动完成后,会提示用户名和密码,如果这是新设备,可能使用默认的用户名和密码,如
admin/password或admin/admin,具体请参考对应AP的官方文档。
通用/基础命令(适用于大多数AP)
这些命令主要用于查看设备的基本信息和状态。

| 命令 | 描述 | 示例 |
|---|---|---|
show version |
显示AP的软件版本、硬件型号、启动时间、序列号等关键信息。 | show version |
show inventory |
显示详细的硬件库存信息,包括型号、序列号、组件等。 | show inventory |
show running-config |
显示当前生效的AP配置。注意:此命令可能只显示部分配置,因为很多AP配置(如SSID、安全策略)存储在控制器上。 | show running-config |
show startup-config |
显示AP下次启动时加载的配置。 | show startup-config |
show interface |
显示所有网络接口的状态,尤其是以太网口和无线射频接口。 | show interface |
show interface GigabitEthernet 0 |
查看指定以太网口的详细状态(IP地址、速率、双工模式等)。 | show interface GigabitEthernet 0 |
show interface dot11radio 0 |
查看指定射频(Radio,通常0代表2.4GHz,1代表5GHz)的详细状态。 | show interface dot11radio 0 |
show ip interface brief |
以简洁的表格形式显示所有IP接口及其状态(Up/Down)和IP地址。 | show ip interface brief |
show ip route |
显示AP的路由表,了解其网络连接情况。 | show ip route |
show vlan |
显示AP上配置的VLAN信息。 | show vlan |
show log |
查看AP的日志信息,对排查问题非常有用。 | show log |
show power |
查看AP的供电状态(PoE供电、DC供电等)和功率消耗。 | show power |
show dot11 status |
查看所有射频的总体状态(Enabled/Disabled, Channel, etc.)。 | show dot11 status |
show dot11 associations |
查看所有关联到该AP的客户端列表(MAC地址、信号强度等)。 | show dot11 associations |
特定厂商命令详解
不同厂商的CLI命令和模式有很大差异。
Cisco (AireOS / IOS-XE)
Cisco AP的命令行模式分为 用户模式 和 特权模式,在特权模式下,输入 configure terminal 进入全局配置模式。
进入配置模式:
AP# configure terminal AP(config)#
常用配置命令:

! 设置AP的主机名 AP(config)# hostname Office-AP-01 ! 配置管理IP地址(当AP不连接控制器时使用) AP(config)# interface BVI 1 ! BVI (Bridge-Virtual Interface) 是AP的管理接口 AP(config-if)# ip address 192.168.1.100 255.255.255.0 ! 重置AP到出厂设置(慎用!) AP# delete flash:/private-config AP# reload ! 查看连接的控制器 AP# show capwap summary AP# show wlc ! 重启AP AP# reload
Aruba / HPE (ArubaOS)
Aruba AP的命令行模式非常强大,有多个层级。
进入配置模式:
ArubaAP# configure terminal ArubaAP(config)#
常用配置命令:
! 设置AP的主机名 ArubaAP(config)# hostname Office-AP-02 ! 配置管理VLAN和IP地址 ArubaAP(config)# interface vlan 1 ArubaAP(config-if-vlan)# ip address 192.168.1.101 255.255.255.0 ! 查看AP状态和连接信息 ArubaAP# show ap active ArubaAP# show ap debug ArubaAP# show log ! 重置AP到出厂设置(慎用!) ArubaAP# reset default-config ArubaAP# reboot ! 查看已关联的客户端 ArubaAP# show ap clients all
Ruckus (SmartZone / ZoneDirector)
Ruckus AP的命令结构也很有特点。
进入配置模式:
RuckusAP> enable RuckusAP# configure RuckusAP(config)#
常用配置命令:
! 设置AP的主机名 RuckusAP(config)# hostname Office-AP-03 ! 配置管理IP地址 RuckusAP(config)# interface management RuckusAP(config-if-mgmt)# ip address 192.168.1.102 255.255.255.0 ! 查看AP状态 RuckusAP# show ap status RuckusAP# show zone ! 重置AP到出厂设置(慎用!) RuckusAP# factory reset RuckusAP# reboot ! 查看客户端连接 RuckusAP# show client
常用故障排查场景
场景1:AP无法连接到控制器(CAPWAP/WDS超时)
这是最常见的问题,当AP启动后,无法在控制器的AP列表中找到时,可以通过串口排查。
排查步骤:
- 检查IP配置:确保AP的管理IP地址、子网掩码、网关配置正确,且能ping通控制器。
show ip interface brief ping <控制器IP地址>
- 检查网络连通性:确认AP和控制器之间没有防火墙或ACL阻隔CAPWAP端口(UDP 5246/5247)和DHCP端口(UDP 67/68)。
- 检查DNS:如果AP通过DNS查找控制器,确保DNS服务器配置正确,并能解析控制器域名。
- 查看日志:这是最关键的一步。
show log
在日志中寻找与 "CAPWAP", "WDS", "controller discovery" 相关的错误信息。
CAPWAP: Connection to Controller <IP> failedDHCP: No offer receivedDNS: Cannot resolve controller domain
场景2:AP无法获取IP地址(DHCP问题)
排查步骤:
- 检查AP的DHCP请求:在日志中查找DHCP相关消息。
show log | include DHCP
- 检查DHCP服务器:确认网络中的DHCP服务器工作正常,并且有正确的地址池分配给AP。
- 检查交换机端口:确保连接AP的交换机端口是
access或trunk模式,并且允许对应的VLAN通过,如果是PoE供电,确保端口已供电。
场景3:射频接口未启用
客户端无法连接到某个频段的Wi-Fi。
排查步骤:
- 检查射频状态:
show interface dot11radio 0
查看
line protocol state是否为up,如果为down,说明射频被手动禁用了。 - 检查射频配置:在配置模式下检查射频是否被禁用。
! Cisco 示例 show running-config | include radio ! Aruba 示例 show ap-config <AP_name>
- 检查信道和功率:确认信道和功率设置是否被不当配置(例如信道冲突或功率过低)。
show dot11 status
重要提示
- 安全第一:串口是设备的“后门”,物理安全性极高,务必妥善保管串口访问权限,不要将连接暴露在不安全的环境中。
- 谨慎操作:在配置模式下,错误的命令可能导致设备功能异常,在执行关键操作(如
delete,reset,reboot)前,请务必确认。 - 厂商文档为准:以上命令为通用指南,最准确、最详细的命令列表和解释,请始终参考您所用AP型号的官方技术文档。
- 保存配置:在完成配置修改后,记得保存配置,否则重启后更改会丢失。
- Cisco:
write memory或copy running-config startup-config - Aruba:
write memory - Ruckus:
save
- Cisco:
