简介：面向网络运维人员与系统集成商的迈普交换机常用命令手册，系统梳理了迈普交换机从登录到日常维护的常用配置命令。文档首先介绍普通用户、特权用户、全局、端口四种命令模式的进入与切换方法，并分别说明各模式的权限边界与适用操作；随后按典型维护场景给出查看运行配置、端口概述、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能代表enable，conf 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 命令

接手一台陌生设备，第一件事不是配业务，而是把家底盘清楚。下面这张表列出的是我常用的挂牌命令，按使用频率排：

这些命令单独敲都有输出，但真正顺手的是组合过滤。设备配置多的时候，翻屏不是办法，过滤才是。

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 shutdown

vlan 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)# exit

interface 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 个要素，缺一项就是不合格的交付物。

完整语法写全称，是为了让拿着多个品牌设备的人不混淆；参数说明写取值范围，是为了防止有人把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 给配置定期做带日期的备份

备份不是点一下保存键，是把配置文件按日期归档。我习惯用“设备名-配置-日期”这样的命名方式，把导出的配置复制到本地目录。看似老土，但真遇到配置回滚时，一份一周前的稳定配置比现拍的配置值钱得多。平时注意保留距离当前时间最近的两到三个版本，恢复时选一个没有症状的时间点。

最后一条教训是：动手之前先确认手里有一份能恢复的配置。没有备份就上生产环境改配置，等于没有后悔药。这句话我是真用掉好几次学费换来的。希望你不用再交。希望帮到你。

本文还有配套的精品资源，点击获取