简介：傲天动联技术出品的《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 Admin@2024 [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 admin@192.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快照留档。这个习惯在多次网络事故排查里帮了大忙——对比配置快照比翻聊天记录可靠太多了。希望这篇的内容对你手头的配置手册整理工作有实际帮助。
本文还有配套的精品资源，点击获取
