Autelan交换机命令行配置手册范本：从CLI基础到开局实战

简介傲天动联技术出品的《Autelan交换机产品命令行配置手册范本》V1.23面向需要管理Autelan交换机的网络工程师与IT运维人员帮助读者由浅入深掌握命令行配置方法。文档从命令行格式约定、五种主要命令模式enable、disable、configure terminal等入手延伸到系统配置管理、管理员账户创建与权限分配、telnet/ssh接入控制等安全配置覆盖日常运维中高频使用的操作要点。包体为单个docx文件压缩包约137KB便于直接查阅和打印。目前已有123人浏览学习适合网络初学者作为入门向导也适合有经验的运维人员快速查询命令语法与配置思路。手册内容帮助读者建立清晰的命令行操作框架并参考具体配置命令示例减少在真实设备上摸索的时间。1. 一份交换机命令行配置手册范本解决的不是命令问题是协作问题拿到一台全新的Autelan交换机最尴尬的不是不会敲命令而是每个人敲命令的习惯都不一样。有人喜欢用缩写有人习惯打全称有人配完不保存有人把管理口划进了业务VLAN也浑然不知。Autelan交换机的CLI体系和主流厂商的思路相近但细节上又有自己的脾气——命令字的完整形态、视图切换逻辑、保存机制每一条都有讲究。网上的命令大全确实能查到零散的命令但你拿不到一套能直接照抄的、带规范格式和参数说明的配置流程。这就是命令行配置手册范本的价值所在它把零散命令固化成团队能复用的流程让新手照着敲也能上线一台设备让老手检查配置时不用一条一条对。这篇文章会从CLI体系讲起把开局配置的完整步骤、关键参数、避坑点一路拆到文档该怎么落笔。适合正在做网络开局、写运维文档、或者想把手里的配置过程整理成标准化手册的工程师。2. Autelan交换机命令行体系登录方式、视图切换和配置保存是三道基础关2.1 第一次进系统Console登录的串口参数与连接方式拿到一台没配置过的新交换机唯一能进去的通道就是Console口。连接Console用的线缆通常是RJ45转DB9的串口线也有部分设备直接带USB Console口。电脑上需要装串口终端软件常见的是SecureCRT、Xshell或者PuTTY。连接前先看设备管理口旁边的标签上面会标注默认波特率绝大多数网络设备出厂默认是9600。打开终端软件后的串口参数是固定的套路波特率9600数据位8停止位1无校验无流控。这个组合在业界被称为“8N1”基本覆盖所有主流交换机的Console登录场景。连接成功后回车会看到用户视图提示符也就是设备主机名加尖括号的形态。如果回车没反应先检查串口线插的是不是Console口而不是网口再看设备是否已经上电。# 以SecureCRT为例新建连接时选择Serial协议 # 端口Windows下查看设备管理器确认COM口号例如COM3 # 波特率9600 # 数据位8 # 校验位None # 停止位1 # 流控全部取消勾选参数说明这里的9600波特率是出厂默认值如果设备被上一手配置者改过波特率登录时会直接花屏或者完全无输出重试不同的波特率是排查手段之一。取消流控是为了避免硬件流控引脚状态不对导致输入没反应。连接成功后第一次进入通常处于用户视图需要输入登录凭据或者直接进入具体取决于是不是出厂状态。连接成功后第一件事是确认设备版本和型号这条命令在任何配置动作之前都应该执行。版本信息决定了后续命令的语法风格不同版本的Autelan设备在命令支持度上有差异尤其是涉及堆叠、链路聚合这类高级功能时。Autelan display version这是一条用户视图下的查询命令输出里能看到设备型号、软件版本、BootROM版本和运行时长。注意保存这段输出的版本号后续写手册、查兼容性、找升级包时都用得上。如果是给客户交付设备版本号必须和验收记录一致。2.2 三视图体系用户视图、系统视图与接口视图的切换逻辑Autelan的CLI体系采用分层视图结构核心是三个视图用户视图、系统视图和接口视图。用户视图是登录后的初始位置提示符为尖括号只能执行查询和ping、tracert这类诊断命令。系统视图是配置主战场进入后提示符变成方括号可以配置全局参数、创建VLAN、配置路由协议等。接口视图是系统视图下的子视图针对某个具体端口做参数配置。视图之间靠命令切换从用户视图进入系统视图用system-view从系统视图进入接口视图用interface 接口类型和编号逐级退出用quit直接回到用户视图用return。这套逻辑和大多数主流厂商一致有过华为或H3C设备操作经验的人几乎可以零成本上手。Autelan system-view # 进入系统视图提示符从尖括号变为方括号 [Autelan] interface GigabitEthernet 0/0/1 # 进入接口视图 [Autelan-GigabitEthernet0/0/1] quit # 退出到系统视图 [Autelan] return # 直接回到用户视图逻辑说明system-view这个命令没有参数是进入系统视图的唯一入口interface后面的接口编号格式因设备型号而异常见的是槽位号/端口号形式。quit是逐级退出return是直接跳回用户视图在两个层级相差较深时效率差别很大。配置写完习惯性地敲return回到用户视图再执行保存能避免在接口视图下敲save报错。常见误区是新手分不清什么时候在哪个视图结果命令敲下去提示Unrecognized command。判断方法很简单看提示符。方括号就是系统视图系列圆括号或者接口名编号就是接口视图。拿不准的时候先敲return回到用户视图再重新进去永远比在一个不确定的视图里试错快。2.3 配置保存与生效机制不保存等于白配Autelan交换机的配置保存机制和绝大多数商用交换机一样运行配置保存在内存里断电就丢。修改配置后必须执行save命令把运行配置写入Flash中的配置文件设备重启后才会加载。很多新手在测试环境里配完一切正常一重启全部还原原因就是漏了保存这一步。Autelan save # 系统提示是否保存配置到配置文件输入Y确认 Save configuration to the device successfully.参数说明save命令在用户视图下执行执行后系统会询问确认保存输入Y或直接回车即可。有些版本支持save文件名的语法可以把配置保存成多个版本文件交换机里也支持指定启动配置文件用display startup命令查看下次启动加载哪个文件。Autelan display startup # 查看当前启动配置文件和下次启动的配置文件位置 Autelan display current-configuration # 查看当前运行配置的全部内容这是排查问题时最常用的命令display current-configuration的输出内容非常多包含所有视图下的生效配置。检查配置保存是否成功最稳妥的办法就是重启设备后执行display current-configuration对比关键配置项还在不在。资深的做法是改完一批配置马上保存一次而不是全部改完再统一保存——一旦中途断电已经保存的配置还能兜底。3. 开局配置实战把一台Autelan交换机从零配到可上线3.1 管理通道先行配置管理IP、SSH登录和用户认证设备上线的第一步永远是先把管理通道打通。Console口只是物理接入手段日常维护还得靠网络远程登录而远程登录的安全基线就是SSH。Autelan交换机的SSH配置逻辑分为几个部分生成加密密钥、开启SSH服务、创建远程登录用户、配置认证方式。Autelan system-view [Autelan] sysname Core-SW01 # 修改设备主机名 [Autelan] interface Vlanif 10 # 进入管理VLAN的三层接口 [Autelan-Vlanif10] ip address 192.168.10.2 24 # 配置管理IP [Autelan-Vlanif10] quit [Autelan] ssh server enable # 开启SSH服务 [Autelan] rsa local-key-pair create # 生成本地RSA密钥用于SSH加密 The key name will be: Core-SW01_Host # 输入密钥长度通常直接回车使用默认值2048逻辑说明sysname修改的是设备标识符会显示在提示符里多台设备管理时靠这个区分命名规则建议包含机房和角色信息。interface Vlanif是创建VLAN三层接口必须先有这个接口才能给交换机本身配IP。ssh server enable是开启SSH服务rsa local-key-pair create是生成加密用的密钥对首次配置SSH时必须执行。接下来创建远程管理用户并配置认证。Autelan支持本地认证和AAA认证两种方式小型网络用本地认证就够设备数量多就考虑对接AAA服务器。本地认证就是把用户名和密码存在交换机里登录时设备自己验证。[Autelan] aaa [Autelan-aaa] local-user admin password irreversible-cipher Admin2024 [Autelan-aaa] local-user admin service-type ssh [Autelan-aaa] local-user admin privilege level 15 [Autelan-aaa] quit [Autelan] user-interface vty 0 4 [Autelan-ui-vty0-4] authentication-mode aaa [Autelan-ui-vty0-4] protocol inbound ssh [Autelan-ui-vty0-4] quit [Autelan] return Autelan save参数说明local-user后面的admin是用户名password irreversible-cipher后面跟的是密码irreversible-cipher表示密码在配置里以密文形式保存即使看配置文件也看不到明文。privilege level 15是最高权限级别普通运维账号建议给3到5的级别只有管理员才给15。协议里protocol inbound ssh是限制这个终端通道只允许SSH接入Telnet被禁掉这是网络设备安全基线的标准要求。配置完成后用网线把交换机管理口接到网络里从电脑上执行ssh admin192.168.10.2验证。如果登录失败先确认电脑和交换机管理IP能互通再确认SSH服务开启状态。SSH连不上是日常运维里最高频的问题之一后面避坑章节会专门展开。3.2 端口基础配置速率、双工、端口描述和shutdown端口的物理参数配置是开局的基础动作。现代交换机端口大多支持自协商也就是速率和双工模式自动协商但总有些场景需要手工指定——比如接老旧设备、接特殊的光模块、或者排查协商异常。端口描述是很多人忽略但非常重要的配置它直接决定了半年后你还能不能认出这个端口是干什么的。[Autelan] interface GigabitEthernet 0/0/1 [Autelan-GigabitEthernet0/0/1] description To-Server-Rack3-UPS [Autelan-GigabitEthernet0/0/1] speed 1000 [Autelan-GigabitEthernet0/0/1] duplex full [Autelan-GigabitEthernet0/0/1] undo shutdown [Autelan-GigabitEthernet0/0/1] quit参数说明description是端口描述建议格式为“对端设备-位置-用途”比如To-Server-Rack3-UPS就表示连接3号机架UPS服务器。speed和duplex配合使用在强制速率时必须同时指定双工模式否则会出现速率匹配但双工不匹配的情况表现是接口能up但丢包严重。undo shutdown是开启端口默认状态下端口是开启的但如果设备有配置过端口安全策略部分端口可能被shutdown过。查看端口状态的命令是display interface brief输出里能看到每个端口的连接状态、速率和双工模式。如果发现端口down优先检查物理链路——光纤模块是否插紧、网线是否松动、对端设备是否上电。这些基础检查往往比查配置更有效。[Autelan] display interface brief # 输出示例 # Interface PHY Protocol InUti OutUti inErrors outErrors # GigabitEthernet0/0/1 up up 0.01% 0.01% 0 0display interface brief的输出中PHY表示物理层状态Protocol表示链路协议状态两者都up才代表端口正常工作。inErrors和outErrors出现非零数值说明端口在收发数据时有错误常见原因包括双工不匹配、网线质量差、光模块衰减过大等。3.3 VLAN划分与Trunk放通把业务从端口里分出来VLAN是二层交换的核心概念Autelan交换机的VLAN创建和端口划分逻辑与主流厂商一致。Access端口用于连接终端设备Trunk端口用于交换机之间的互联。配置VLAN的典型场景是把不同的业务隔离在不同的二层广播域里比如办公网、监控网、服务器网分开。[Autelan] vlan batch 10 20 30 # 批量创建VLAN 10、20、30 [Autelan] interface GigabitEthernet 0/0/10 [Autelan-GigabitEthernet0/0/10] port link-type access # 设置端口类型为Access [Autelan-GigabitEthernet0/0/10] port default vlan 10 # 划入VLAN 10 [Autelan-GigabitEthernet0/0/10] quit [Autelan] interface GigabitEthernet 0/0/24 [Autelan-GigabitEthernet0/0/24] port link-type trunk # 设置端口类型为Trunk [Autelan-GigabitEthernet0/0/24] port trunk allow-pass vlan 10 20 30 # 放通VLAN逻辑说明vlan batch是批量创建VLAN的命令比一个一个创建效率高很多。port link-type access是将端口设为Access模式这个模式下端口只能属于一个VLAN。port default vlan 10指定该端口所属的VLAN。Trunk端口用于级联port trunk allow-pass vlan 10 20 30明确哪些VLAN的流量允许从这条链路通过没有列出的VLAN就会被过滤掉。Trunk配置里最容易犯的错误是漏写allow-pass的VLAN列表。默认情况下创建Trunk端口后只放通了VLAN 1如果不手动添加其他VLAN跨交换机的通信就会失败。另一个细节是端口原生的PVID也就是端口默认所属的VLAN。对于Trunk端口PVID通常保留为1如果对端设备的PVID配置不同可能出现VLAN标签错乱的问题。3.4 链路聚合 Eth-Trunk把两条物理链路捆成一条逻辑链路交换机之间如果只靠一根网线互联这根线就是单点故障。链路聚合Eth-Trunk能把多条物理链路捆绑成一条逻辑链路既增加带宽又实现冗余。在Autelan交换机上Eth-Trunk的配置分为两步创建聚合接口、把物理接口加入聚合组。[Autelan] interface Eth-Trunk 1 # 创建聚合接口 [Autelan-Eth-Trunk1] trunkport GigabitEthernet 0/0/23 # 将物理口加入聚合组 [Autelan-Eth-Trunk1] trunkport GigabitEthernet 0/0/24 [Autelan-Eth-Trunk1] port link-type trunk [Autelan-Eth-Trunk1] port trunk allow-pass vlan 10 20 30 [Autelan-Eth-Trunk1] quit参数说明interface Eth-Trunk 1是创建编号为1的聚合接口trunkport是往聚合组里添加物理端口。负载分担方式默认按源目MAC地址哈希流量会被自动分散到多条物理链路上。需要强调一个原则物理口加入聚合组后不能再单独配置二层属性所有的VLAN配置都在Eth-Trunk接口下完成。如果你先在物理口上配置了VLAN再把它加入聚合组系统会报错或者自动清除原有配置。链路聚合的另一个关键问题是两端设备的聚合模式必须一致。Autelan默认支持静态聚合和LACP动态聚合两种模式静态聚合就是手工指定哪些端口聚合LACP模式则让两端设备自动协商。手动配置时最常见的问题是两端的物理端口数量和编号不一致——交换机A聚合了23和24口交换机B只聚合了23口结果是一条链路在聚合组里一条在外面流量转发路径完全不符合预期。[Autelan] display eth-trunk 1 # 查看聚合组状态确认成员端口都在线display eth-trunk 1的输出里能看到聚合接口的状态、成员端口列表以及每个成员端口的物理状态。如果某个端口显示down物理链路的问题或者两端配置不一致需要逐项排查。3.5 生成树 MSTP防止广播风暴把全网打挂二层网络最危险的故障就是环路。一旦交换机之间出现多余的物理连接广播帧就会在网络里无限循环最终打满所有端口带宽全网瘫痪。生成树协议STP就是为了解决这个问题而存在的它在逻辑上阻断冗余链路当主链路故障时自动切换到备份链路。Autelan交换机的STP默认状态通常是开启的但默认使用的是STP还是MSTP需要检查。现代网络推荐使用MSTP多生成树协议它支持按VLAN划分生成树实例可以做到不同VLAN走不同链路实现负载均衡。[Autelan] stp mode mstp # 切换运行模式为MSTP [Autelan] stp region-configuration # 进入MSTP区域配置 [Autelan-mst-region] region-name CORE # 区域名称同一区域的设备必须一致 [Autelan-mst-region] instance 1 vlan 10 20 # 实例1映射VLAN 10和20 [Autelan-mst-region] instance 2 vlan 30 # 实例2映射VLAN 30 [Autelan-mst-region] active region-configuration # 激活区域配置 [Autelan-mst-region] quit参数说明stp mode mstp是切换STP运行模式不执行这条命令的话默认可能是STP或RSTP。region-name是MSTP区域名称同一台交换机里所有设备必须配置相同的区域名才能组成一个域。instance是实例与VLAN的映射关系上边的例子把VLAN 10和20映射到实例1把VLAN 30映射到实例2。active region-configuration是激活配置漏掉这一步的话前面配置不生效。在实际网络中MSTP的坑主要在区域配置不一致。两台交换机互联如果region-name或者VLAN映射表不同它们会认为彼此不在同一个MSTP域内导致生成树计算异常可能出现链路被意外阻塞或者环路没有被正确阻断的情况。配置完成后用display stp instance 1查看每个实例的根桥和端口角色确认阻塞端口是预期的那个。4. 避坑指南配置手册里不会写的六个翻车场景与排查方法4.1 save成功了重启后配置却全部丢失现象配置完成后执行了save系统也提示保存成功但设备断电重启后配置回到出厂状态。原因最常见的原因是设备里存在多个配置文件save默认写入的配置文件和系统启动时加载的配置文件不是同一个。用display startup查看当前启动文件路径确认save写入的文件是否被设置为下次启动的配置文件。解决执行save后再执行display startup确认“Next startup configuration file”指向的路径。如果不是预期文件用startup saved-configuration文件名命令指定启动配置文件然后再次重启验证。4.2 端口状态显示up但业务不通现象display interface brief显示端口up对端设备也能link但终端上不了网ping网关不通。原因这是VLAN配置问题的典型表现。端口虽然up但端口所属的VLAN不对或者Trunk链路没有放通对应VLAN。还有一种可能是端口的PVID和对端不匹配导致接收到的数据帧带上了错误的VLAN标签。解决先display vlan查看VLAN和端口的对应关系再display interface查看端口的实际PVID和允许通过的VLAN列表。对照对端设备的配置逐项检查——曾经遇到过两台交换机互联Trunk两端都配置了allow-pass vlan all但PVID被改成了不同的值结果所有帧都带上了错误标签排查了一个多小时最后发现就是PVID不一致。4.3 配置了SSH客户端却一直报连接失败现象从电脑SSH登录交换机提示连接超时或者连接被拒绝。连接被拒绝说明网络能通但服务没起来连接超时则是网络层的问题。原因连接被拒绝大概率是SSH服务没开或者vty通道的inbound协议没有改。连接超时更像防火墙拦截或者管理IP不对。解决先用Console口登录设备执行display ssh server status看服务是否开启再执行display user-interface vty查看vty通道配置。确认ssh server enable已执行、vty通道的protocol inbound是ssh。如果服务都开了还是连不上检查交换机管理IP网关配置能不能回包在交换机上执行ping电脑IP验证双向连通性。4.4 配置了Eth-Trunk拔掉一根线后业务全断现象两条物理链路聚合后拔掉其中一条业务没有自动切换到另一条反而全部中断。原因两端设备聚合模式不一致或者其中一端没有把端口成功加入聚合组。可能一端是静态聚合另一端是LACP模式两种模式的心跳协商机制不同导致拔线后生成树和聚合状态都出现问题。解决用display eth-trunk 1查看两端设备的聚合成员状态确认两端的成员端口一一对应模式一致。如果一端显示端口处于独立状态说明它没有成功加入聚合组需要重新把端口加入并检查两端配置的聚合模式。最好在开局阶段就统一规划好所有互联设备使用LACP模式避免后续混用踩坑。4.5 手滑把管理口的VLAN改错远程直接失联现象通过SSH远程配置交换机时想修改管理VLAN的接口配置结果配完后立断——设备再也ping不通远程登录直接失效。原因管理IP所在的Vlanif接口对应的VLAN被误删了或者管理口被重新划分到了其他VLAN导致管理流量路径中断。这是远程运维中最典型的自杀式操作。解决如果是Console莲可到达用Console登录恢复。如果没有Console接入条件只能到机房物理操作。避免方法有两条一是改管理VLAN前先把管理口的access配置记录下来任何修改后立即恢复二是提前配置一个带外管理通道比如独立的带外网管口管理流量和业务流量彻底分离。4.6 命令敲了不生效回头才发现视图不对现象明明在某个位置看到了配置命令但自己敲的时候提示Unrecognized command。同一批指令在不同版本的设备上执行结果不一致有的报错有的正常。原因设备软件版本不同命令的语法和视图要求可能有差异。某些命令在用户视图下执行和在系统视图下执行结果完全不同。解决养成敲命令前先确认当前视图的习惯最容易的判断方法就是看提示符。如果某条命令在版本A上能用但在版本B上报错用display version确认版本号对照发布说明查看命令变更记录。Autelan的命令体系和主流厂商同源但不完全一致不要想当然地照搬其他厂商的配置语法每条命令都值得认真看一下帮助信息。5. 把范本落进文档命令行配置手册的结构、表格与变更记录5.1 手册结构开局、上线、维护三段式一份真正好用的配置手册范本首先要有一个哪怕离开了原工程师也能继续维护的结构。常见的做法是把整个手册分成三个大段落开局配置、业务上线配置、日常维护与变更。开局配置覆盖设备出厂后的首次配置包括Console登录、版本信息确认、管理IP规划、SSH开启和用户创建。业务上线配置覆盖端口划分、VLAN规划、链路聚合和生成树配置。日常维护章节则包含备份配置、密码重置、端口排查等经常要做的事情。每章内部统一用编号列表组织步骤每个步骤给出完整的代码块代码块下方紧跟参数说明。这是整个配置手册的核心价值——命令背后的参数解释、适用版本和注意事项都比命令本身更值钱。5.2 参数表格和注释的写作规范手册里的每个配置场景都要配套参数表格列出每一个需要现场填写的值。管理IP地址、VLAN编号、端口号、用户名密码策略这些全部以空表形式存在新项目上线时套用模板填写即可。表格格式建议保持四列参数项、示例值、必填与否、说明。比如“管理VLAN编号”这个参数必填列标“是”说明列写“建议使用独立VLAN不要复用业务VLAN”。代码块内部的关键行必须写注释。注释是给后面的运维同事看的他们拿到手册配置另一台设备时不需要再查命令帮助就能知道每一行在干什么。注释要在参数变化处着重标注比如接口编号、VLAN号、IP地址变化的位置用“# 按实际规划修改”这类提示。5.3 变更记录与回退方案手册的最后的一页不能省手册最后一章必须是变更记录表记录每一次变更的日期、操作人、变更内容和回退方案。网络配置的生效时间往往滞后于人的盲区一个看似无害的修改可能在一周后才暴露出问题。没有变更记录的配置手册半年之后就是一本无法追溯的黑匣子出了问题没人说得清哪台设备改过什么。回退方案的具体写法是每条变更旁边标注清楚“回退命令”比如改动了Trunk放通的VLAN列表回退就是把原配置执行undo并重新加入原VLAN。设备如果是远程管理的回退方案里还要写明这条命令会不会导致管理通道中断如果会必须提醒操作者保留Console通道或者安排现场人员待命。一份好的手册范本本质上是一份配置操作的时间轴。它记录的不只是命令还有为什么这么配置、配置后验证什么、出了问题怎么回退。把这些写下来团队成员对设备状态的认知才有统一的基准。我个人的习惯是每次变更后不管改动多小都在手册的变更记录表里补一行顺手执行一次display current-configuration快照留档。这个习惯在多次网络事故排查里帮了大忙——对比配置快照比翻聊天记录可靠太多了。希望这篇的内容对你手头的配置手册整理工作有实际帮助。本文还有配套的精品资源点击获取