简介面向网络运维人员与系统集成商的迈普交换机常用命令手册系统梳理了迈普交换机从登录到日常维护的常用配置命令。文档首先介绍普通用户、特权用户、全局、端口四种命令模式的进入与切换方法并分别说明各模式的权限边界与适用操作随后按典型维护场景给出查看运行配置、端口概述、POE供电状态、MAC地址表、ARP映射、设备型号等查询命令以及开启/关闭端口、启停POE、配置access/hybrid/trunk模式及VLAN归属、保存配置、重启交换机等管理命令每条命令均注明所用命令模式并附典型执行示例便于现网直接参照执行。资源包为1个docx文档大小229KB内容结构分明适合作为日常排错和配置参考手册。文档末尾还附有现网常用交换机型号及登录口令参考方便运维人员快速完成设备接入。已有15555人学习下载适用于需要快速掌握迈普交换机基础配置与维护的网络工程师。1. 拿到一台没文档的迈普交换机先靠这本“手册”续命新接手一台迈普交换机常用命令手册.docx这大概是交接资料里最常出现的文件名。可你真正打开它的时候往往已经是深夜割接网络不通面前只有一台连 console 线的设备能查的资料全在手机里。文档如果只是一份命令列表根本救不了你。真正能续命的手册是按场景组织、每条命令带参数解释和验证方法、还有人把坑写进去的“活文档”。这篇笔记就按一线运维的做法把迈普交换机最常用的命令、 docx 手册的整理方式以及没人提醒就容易翻车的点一次讲清楚。适合刚接手设备的新手也适合要给别人写交接文档的熟手。2. 命令行骨架模式、补全和保存是理解一切的基础2.1 不理解“模式”命令基本靠猜迈普交换机的命令行是典型的分级模式结构类似业界大多数企业级设备的通用做法。刚开机进的是用户模式提示符末尾是这里只能看少量信息改不了配置。输入enable后进入特权模式提示符变成#能看全部状态但改配置还要再进一步。特权模式下输入configure terminal进入全局配置模式提示符变成(config)#真正的配置工作大多在这里完成。这三级模式不是摆设。每条命令都有它允许执行的位置在用户模式敲configure会直接报错。很多新手手册读得明白一上手就懵问题不在命令本身而在不知道当前站在哪个楼层。Switch enable Switch# configure terminal Switch(config)# vlan 10 Switch(config-vlan)# name office Switch(config-vlan)# exit Switch(config)# end Switch#这段过程演示了一次典型的“上楼”和“下楼”vlan 10进入的是 VLAN 配置视图name给 VLAN 起名exit退回上一层end则是从任何配置视图直接跳回特权模式。我见过有人贪图方便一路用end结果想继续配 VLAN 时发现已经退回特权模式敲什么都说无效命令其实就是没注意提示符变了。判断当前位置不要靠猜盯住提示符的括号部分。2.2 Tab 补全和?是随身的迷你命令手册命令行自带两个省事工具很多老手不常用新手反而该把它们当拐杖。第一个是 Tab 键补全输入命令开头的几个字母按 Tab 自动补全。第二个是问号?它不执行任何东西只负责在当前位置列出所有可用的命令或参数。Switch# sh? show Switch# show running-config ? | Output modifiers cr Switch# show running-config | include hostname?放在单词后面列出的是“下一步能接什么”。show running-config ?的结果里出现了|意思是后面可以跟过滤符。这时输入| include hostname输出里就只剩包含 hostname 的行这在排查配置差异时非常实用。注意这里的cr表示直接回车也能执行不需要追加参数。不用害怕问号。它只是把内置帮助打出来不会真的执行命令也不会把交换机搞出问题。有些设备的参数提示会被终端软件遮挡可以按空格再试一次或者干脆把输出重定向到日志文件里看。命令行简写也是同理只要缩写不产生歧义en能代表enableconf t能代表configure terminal但不同型号对简写的容忍度不完全一样保守的做法是缩到两个字母以上再拿不准就用 Tab 补全。2.3 配置进 running-config不保存一重启就没这是整个命令体系里最要命的一条认知。你敲的配置第一时间只改进了内存里的 running-config设备正在按它运行但它跟“出厂后已保存的配置”是两回事。只要重启内存清空没保存的内容全部蒸发。所谓保存就是把 running-config 覆盖到 startup-config。Switch(config)# hostname SW-CORE SW-CORE(config)# end SW-CORE# copy running-config startup-config改完hostname提示符马上变了这就是 running-config 已生效的直接证据。但如果不执行最后那行保存一次断电就让设备回到旧名字。copy running-config startup-config是常见做法部分设备也接受write memory效果一样。我一般保存后还会顺手敲一条show startup-config核对关键配置确实写进去了这个习惯能避开很多“当时明明配了重启却没了”的血泪教训。3. 日常运维常碰的命令按三类场景过一遍3.1 刚拿到设备先看状态那几条 show 命令接手一台陌生设备第一件事不是配业务而是把家底盘清楚。下面这张表列出的是我常用的挂牌命令按使用频率排命令看什么什么时候用show version系统版本、运行时间、设备型号开局核对版本升级前确认show running-config当前生效配置排查变更、备份配置show startup-config已保存配置核对重启后会不会还原show interface端口状态、流量、丢包、错误端口 down、有流量异常时show vlanVLAN 表与成员端口二层划分检查show mac-address-tableMAC 地址表排查环路、找设备接入位置show arpIP 和 MAC 的映射关系排查三层不通、IP 冲突show ip route路由表确认路由是否生效这些命令单独敲都有输出但真正顺手的是组合过滤。设备配置多的时候翻屏不是办法过滤才是。Switch# show running-config | include hostname Switch# show interface GigabitEthernet0/1 Switch# show interfaces status | include down第一条只摘 hostname第二条单独看一个口的完整状态第三条把状态含 down 的接口挑出来。注意第三条里show interfaces status和show interface不是一回事前者是接口状态概览后者是接口详情命令写法在不同型号上略有差异。如果敲?时发现命令被拒绝就先show ?看设备到底认哪种写法实在吃不准就只敲show running-config去翻接口段落。3.2 二层配置VLAN、Access 口和 Trunk 口二层业务最常见的诉求就是划分 VLAN、把终端口放进对应 VLAN、上行口做成 trunk。这里给一段可抄作业的配置流程Switch(config)# vlan 10 Switch(config-vlan)# name office Switch(config-vlan)# exit Switch(config)# vlan 20 Switch(config-vlan)# name service Switch(config-vlan)# exit Switch(config)# interface GigabitEthernet0/1 Switch(config-if)# switchport mode access Switch(config-if)# switchport access vlan 10 Switch(config-if)# no shutdown Switch(config-if)# exit Switch(config)# interface GigabitEthernet0/24 Switch(config-if)# switchport mode trunk Switch(config-if)# switchport trunk allowed vlan 10,20 Switch(config-if)# no shutdownvlan 10是创建 VLAN 并进入 VLAN 配置视图name是给它起个业务名方便后续维护。接口下的switchport mode access把口设成 access 口switchport access vlan 10把该口划进 VLAN 10。trunk 口则是switchport mode trunk加switchport trunk allowed vlan 10,20只放通指定 VLAN。no shutdown是打开接口的保险动作很多离线设备接口虽在 VLAN 里配置正确但端口被 shutdown链路就是起不来。这里有两个参数坑。第一个switchport access vlan 10里的 VLAN 必须在前面创建过否则设备可能拒绝也可能回车后才提示 VLAN 不存在。第二个trunk 口的 allowed vlan 列表是“设置后覆盖”不是“追加”。你今天写了vlan 10,20明天想加 VLAN 30只打一句switchport trunk allowed vlan 30会把前面两个 VLAN 直接挤掉正确写法是重新写完整的10,20,30。这个坑我见过不止一次改完 trunk 后业务静默丢 VLAN查半天才发现列表被覆盖了。3.3 三层与管理配置让交换机可远程可路由二层配通了交换机还只是一台傻交换机要让它能远程管理、能跨网段转发得配三层接口和路由。常见做法是给业务 VLAN 配一个接口 IP再配上默认路由和远程登录通道。Switch(config)# interface Vlan10 Switch(config-if)# ip address 192.168.10.1 255.255.255.0 Switch(config-if)# no shutdown Switch(config-if)# exit Switch(config)# ip route 0.0.0.0 0.0.0.0 192.168.10.254 Switch(config)# enable secret your-password Switch(config)# username admin password your-password Switch(config)# line vty 0 4 Switch(config-line)# transport input ssh Switch(config-line)# login local Switch(config-line)# exitinterface Vlan10是创建 VLAN 口并进入三层配置视图ip address给这个 VLAN 配上管理/网关地址。ip route加的是默认路由下一跳指向核心交换机或出口网关这样设备才能访问其他网段。enable secret设特权密码username admin password创建本地账号line vty 0 4管理远程登录通道transport input ssh限制只允许 SSH 接入login local要求登录时用本地账号验证。注意login local与本地用户是耦合关系。如果先配了login local但还没创建username远程登录时即使密码对了也可能被拒绝因为设备找不到这个用户。所以顺序一般是先建用户和特权密码再改 vty 通道防止把自己锁在外面。另外transport input ssh这条命令有些老设备并不支持不支持时强行配置会报错。稳妥做法是先配transport input all调试连通性再改成ssh收紧不要一上来就设死。改成ssh之后还要确认设备已生成 SSH 密钥、有域名配置否则 SSH 握手失败到时候只能跑 console 口救人。4. 把常用命令整理成 docx 手册我惯用的分类与版式4.1 按场景分类不按字母排序命令手册最忌讳做成命令字典。字典适合查阅但不适合应急应急时你需要的是“我现在卡在哪个环节该翻哪一节”而不是“以 S 开头的命令有哪些”。所以我整理 docx 手册时目录永远按工作场景切而不是按命令首字母切。我常用的目录骨架大致这样一、开局检查 1.1 查看版本与运行状态 1.2 查看当前配置与保存配置 二、VLAN 与接口 2.1 创建 VLAN 与命名 2.2 配置 access 口 2.3 配置 trunk 口 三、路由与三层 3.1 配置 VLAN 接口 IP 3.2 配置静态路由与默认路由 四、远程管理 4.1 配置本地用户 4.2 配置 SSH 登录 4.3 配置登录超时与密码策略 五、备份与恢复 5.1 保存配置 5.2 导出配置 5.3 恢复出厂 六、排障命令 6.1 接口状态检查 6.2 ARP 与路由检查 6.3 日志抓取这套目录的好处是新人在现场可以按“我是来干什么的”对号入座。开局检查对应刚上电的设备怎么验排障命令对应业务异常时怎么查。把“恢复出厂”单独列一节不是鼓励你去按是因为这类危险操作必须能在一页内找到完整步骤省得临时抱佛脚。4.2 每条命令写清楚 5 个要素光有目录不够具体每条命令要写透。我给自己定了个规矩一个命令条目至少包含 5 个要素缺一项就是不合格的交付物。要素写什么示例目的这条命令解决什么问题把接口从 shutdown 状态拉起完整语法全称不要只给缩写no shutdown参数说明每个参数含义与取值范围无参数在接口视图下执行典型输出真实敲完显示的反馈或关键行配置后接口状态变 up注意事项会踩的坑、依赖的前置条件必须先在接口视图下回到全局配置会报错完整语法写全称是为了让拿着多个品牌设备的人不混淆参数说明写取值范围是为了防止有人把0 4写成0-4。典型输出部分不必贴整屏回显摘关键几行讲清楚就行但要让读者知道“看到什么算成功”。注意事项这一栏最重要我会把上面第三节里说过的坑全部写进去比如 trunk 的 allowed vlan 覆盖规则、SSH 需要先有密钥和用户等。4.3 用截图和“边界提示”把 docx 做成排障工具docx 手册的护城河在于排版和信息密度。我在每一类命令后面会附两张截图一张是命令敲完后的正常输出另一张是常见报错输出。截图比文字更直观比如接口 down 时的状态行、保存配置后的提示符变化新手一眼就能看出对错。除了截图我还会给每个章节加“边界提示”用醒目的段落说明这条命令在哪些模式下才适用、生效条件和验证方法。这比把命令堆在一起更有用。例如 VLAN 配置节末尾写“以上配置均需在全局配置模式下执行trunk 口放通列表为覆盖式更新”SSH 节末尾写“请先确认设备已配置域名并生成加密密钥否则 SSH 登录会直接超时”。docx 本身不是只能存静态内容。做完了别让文件躺在桌面吃灰。我习惯在每个条目末尾留一行“最近验证日期”每完成一次割接或巡检就把验证过的命令勾一次顺带纠正过时的语法。这样一来手册不是交接时的应付文件而是跟着设备状态一起更新的活文档。若干月后再翻开你依然能靠它快速定位问题不会对着旧命令怀疑人生。5. 避坑5 个常见故障和应对命令5.1 现象配置没保存重启一夜回到解放前设备重启后前一天做的 VLAN、接口 IP、路由全部丢失网络乱成一锅粥。原因大概率是配置只写进了 running-config没有同步到 startup-config。很多人以为敲完命令就万事大吉忘了保存是独立动作。解决办法是养成“改完必存”的习惯特权模式下执行copy running-config startup-config保存后再show startup-config核对几条关键配置。如果现场配置量大可以分业务段逐段保存避免中途断电导致一半保存一半丢失。5.2 现象管理口 IP 配错远程连接全部打不开有人在办公网里配交换机管理地址嘴上说着网关手指却把掩码填错远程网段全部不同。现象是 console 线插着还能操作一拔线就再也连不上。原因往往出在 IP 地址、掩码、默认路由三者不一致或者是管理 VLAN 本身没有对应的三层接口。解决步骤先用 console 线回到设备执行show interface Vlan10看管理口状态确认 IP 和掩码没有手滑再执行show ip route确认默认路由在表里下一跳可达。如果是管理 VLAN 没建三层口就重新创建interface Vlan10配 IP。另一个稳妥做法是专门划一个管理 VLAN不跟业务 VLAN 混在一起避免业务广播风暴把管理通道挤垮。5.3 现象no命令删不掉配置提示 Incomplete command想删掉一条配置输入no加一段命令结果报 Incomplete command配置还躺在那里。原因是no不是独立命令它只是“取反”修饰符后面必须跟完整的命令语法。很多命令被拒绝是因为你把模式记错了比如在全局配置模式下删接口的配置设备根本不知道你要删哪个接口。正确做法是进入对应视图再执行完整no命令。例如删 VLAN要先在全局配置模式下执行no vlan 10删接口上的 access VLAN要先进入接口视图执行no switchport access vlan 10。不确认语法时先敲no switchport access vlan ?问号会提示你当前模式能接受的后续参数照着填就不会报错。5.4 现象接口状态一直是 down物理链路明明插好网线、光纤都插了对端设备也亮着本机接口就是 down。我先看show interfaces status如果状态显示 down 且协议也是 down排查顺序不是换线而是先确认这个口是不是被shutdown。原因常见于两类一是设备默认关闭某些接口或者之前误操作执行过shutdown二是光口的光模块没有插好或协商不匹配。解决方法是进入接口视图执行no shutdown拉起端口再看状态是否变 up。如果还是 down检查光模块型号、光衰值和对端设备是否强制了速率与双工模式。注意不要一边拔插光纤一边在交换机上反复shutdown/no shutdown这会让排查完全失去方向。5.5 现象升级或恢复配置后旧配置与新软件不兼容有人把老设备上导出的配置原封不动灌到新软件版本上启动后一堆命令被跳过业务全乱。原因不是配置坏了而是新版本改了命令语法或者删掉了旧命令。升级前的 release notes 就是干这个用的但很多人不看。解决方法是升级前先完整备份show running-config和show version升级后逐段核对配置。重点关注接口命名是否变化、VLAN 接口配置是否保留、SSH 相关命令是否仍然支持。发现不兼容的命令不要硬刚回到手册里查新版本语法改完再保存。生产环境升级永远给自己留一条还原到旧版本的路别把后悔药扔了。6. 验证配置的四个动作和一份“后悔药”6.1 前后对照确认改动范围没有超纲改配置前先落一份show running-config改完再落一份用文本对比工具只挑差异行。这一步能抓出很多“顺手改错”的隐患比如本想改 VLAN 10却把 trunk 放通列表误动了。我一般结合过滤命令show running-config | include vlan快速锁定差异区域。6.2 抓一轮日志别让事故现场消失遇到地址冲突、端口反复 up/down、路由震荡光看配置不够要抓日志。配置日志输出到统一日志平台没条件的就show logging留底。事件现场一旦重启就没了该导出的一定要导出。6.3 给配置定期做带日期的备份备份不是点一下保存键是把配置文件按日期归档。我习惯用“设备名-配置-日期”这样的命名方式把导出的配置复制到本地目录。看似老土但真遇到配置回滚时一份一周前的稳定配置比现拍的配置值钱得多。平时注意保留距离当前时间最近的两到三个版本恢复时选一个没有症状的时间点。最后一条教训是动手之前先确认手里有一份能恢复的配置。没有备份就上生产环境改配置等于没有后悔药。这句话我是真用掉好几次学费换来的。希望你不用再交。希望帮到你。本文还有配套的精品资源点击获取