简介华为OLT常用基本查询命令文档包聚焦M5680T等光接入设备的日常维护场景适合光网络运维工程师、网络管理员在开局调试、业务开通或故障排查时快速查阅。文档按功能模块整理高频命令完整覆盖ONU信息查询、LOID认证信息查看、ONU自动发现检查、VLAN配置、板卡与端口状态检测、注册信息添加/删除、业务虚端口与DHCP配置、用户及系统时钟设定等基本覆盖OLT开局初始化和日常排障的常见操作。命令区分普通用户、全局配置和接口模式并附关键参数说明便于从入门到进阶逐步对照练习。资源压缩包共1个doc文件大小约136KB内容为便携式命令说明既可对着终端逐条执行也能打印随身参考。目前已有12561人浏览学习被广泛用于一线操作培训。读者可据此高效掌握MAC认证注册、线路模板绑定、管理VLAN下发等配置逻辑快速定位ONU未注册、端口状态异常、上行链路中断等问题。文档末尾的保存配置、时钟优先级及DHCP服务器组配置示例还能帮助理解完整的OLT业务开通流程减少翻阅手册的时间成本。1. 华为 OLT 查询与配置不是背命令是知道去哪查、怎么收尾干过 GPON/EPON 开局的人都有这种体验华为 OLTMA5680T、MA5606T 这一系的命令体系说大不大但每次开新小区、查故障翻来翻去就那么几十条。真正让你加班到凌晨的不是命令记不住而是「该查的时候想不起来查什么」「查到了不知道状态正不正常」「配完了忘了 save」。这份资料把日常运维里最常用的查询、注册、业务放通命令都收进去了适合刚接手 OLT 的装维和网工也适合那种被叫去救火的老手当速查清单用。下面按我的实操习惯把这些命令重新捋一遍带参数说明和踩坑点。2. 日常巡检先掌握七条查询命令覆盖 90% 的故障判断2.1 单板与端口状态先看硬件再看链路拿到一台华为 OLT第一步不是急着配 VLAN而是先确认硬件在位、端口 link 正常。资料里这几条命令顺序很讲究我一般按这个路径走display board 0普通用户模式下就能敲无需进入全局配置模式。它显示 0 号机框所有单板的状态。判断标准有两条一是单板在线状态为 Online二是运行状态不为 Fault。我见过不少现场业务不通先怀疑配置结果一查是 GPBD 板松动或者槽位报 Fault这种问题重插单板就能解决。上行口状态用下面两条组合看interface giu 0/19 display port state进入 GIU 上联板后查端口状态。正常时端口状态为 activate链路状态为 online。这里注意一下端口编号规则0/19 里的 19 是槽位号不是端口号新手容易把这两个概念搞混。业务口同理interface gpon 0/1 display port stateGPON 业务板的端口状态只要处于 On 就是正常的。看板卡在职情况用display board 0/1这个带槽位号的写法比不带号的更精准。2.2 VLAN 与业务配置查询从全局到单板查询 VLAN 配置是排查业务放通问题的高频操作资料里给了三条display vlan all display vlan 1231 display port vlan 0/19 0第一条列出全部 VLAN适合开局时确认规划没冲突第二条看单个 VLAN 的属性比如是不是 QinQ、是不是 smart 类型第三条查某个上联口放通了哪些 VLAN。判断 VLAN 配置是否正确重点看三处VLAN 属性smart/standard/mux、上联口是否透传、业务虚端口 service-port 是否关联。这三个点只要有一个没对上业务就起不来排查顺序也是按这个来。2.3 ONU 自动发现查询定位未注册设备新装宽带最常遇到的场景是光猫注册不上OLT 上没反应。这时候用display ont autofind all查看所有自动发现的 ONU 设备。这条命令能看到 MAC 地址、所属 PON 口、发现时间是判断「光路通没通」「光猫有没有上电」的第一手证据。如果 autofind 里啥都没有光路基本就有问题别急着查注册配置。查看已注册设备用interface epon 0/2 display ont info 1 all1是 PON 口编号all表示该 PON 口下所有 ONU。display ont info 1 1则是看单个 ONU 的详细信息输出里要重点核对 SNMP profile ID 和 Line profile ID 这两个值它们分别对应管理通道模板和业务线路模板注册不上或者管理不通十有八九是这两个 ID 和实际模板不匹配。状态为 active 的才是注册完成的其他的都属于「看见了但没办手续」的状态。3. ONU/ONT 注册与删除全流程MAC 认证命令的参数边界3.1 添加 ONU 的三条命令缺一不可资料里ont add、ont snmp-profile、ont ipconfig这三条命令要连着看它们是一个完整的注册动作缺一条 ONU 都起不来。interface epon 0/2 ont add 2 27 mac-auth 0018-82C6-938C snmp ont-lineprofile-id 12 desc LiuPo_anzhifang1#1D进入 EPON 口后在 2 号端口添加 ID 为 27 的 ONU。注册方式 mac-auth 是以 MAC 地址作为认证凭据ont-lineprofile-id 12 是线路模板 ID这个模板里定义了上下行带宽、DBA 参数等desc 后面是描述信息实际工程建议写成「小区_楼栋_单元_设备类型」的格式。MAC 地址的输入格式是0018-82C6-938C这种带连字符的四段式少了连字符或者大小写不对都认不了。作为对比GPON 口下的注册命令是ont add 0 7 mac-auth 0018-82E8-1007 snmp ont-lineprofile-id 13 desc XXX参数结构一致只是进入的是 gpon 模式而不是 epon 模式。给 ONU 下发管理地址让它能被网管 ping 通ont ipconfig 2 27 ip-address 220.180.76.116 mask 255.255.255.0 gateway 220.180.76.1 manage-vlan 13 priority 0这条命令的含义是给 2 号端口下 27 号 ONU 配上管理 IP、掩码、网关put 管理 VLAN 13 和优先级 0。manage-vlan 这个参数容易踩坑它必须和 OLT 上规划的管理 VLAN 一致而且这个 VLAN 要在上联口透传否则网管侧根本访问不到设备。3.2 删除 ONU 的两步顺序不能反删除已注册 ONU 时资料里给了一个反直觉的操作顺序——先删管理地址再删 MAC 认证undo ont ipconfig 2 27 ip-address 220.180.76.116 mask 255.255.255.0 gateway 220.180.76.1 manage-vlan 13 priority 0 undo ont add 2 27 mac-auth 0018-82C6-938C snmp ont-lineprofile-id 12 desc LiuPo_anzhifang1#1D先 undo ipconfig 把 OLT 下发的管理地址收回再 undo ont add 抹掉注册信息。顺序反了会出现什么情况个别版本下直接删 ont addOLT 可能还留着残留的管理路由条目下次再添加同一台设备时接口状态会异常。我自己的习惯是删除前先display ont info 2 27把现有参数拍下来因为 undo 命令的参数必须和 add 时完全一致——特别是 desc 里面的空格和特殊字符少一个字符命令都执行不成功。这算是华为命令行里最折磨人的一点删除命令要复述添加时的完整参数不像 Cisco 那样直接no ont add 2 27就完事。3.3 SNMP profile 单独绑定如果 ONU 的 SNMP 模板不是默认的还需要单独配一条ont snmp-profile 2 27 profile-id 10这条命令把 2 号 PON 口下 27 号 ONU 的 SNMP 协议模板设为 10。网管系统要纳管这台设备profile-id 必须和网管侧约定的模板一致。上一节讲的ont ipconfig管的是三层管理通道这条管的是网管协议参数两个都得配齐。实战中如果网管能看到设备但读不到数据先查这条命令的 profile-id 和实际模板编号对不对得上。3.4 单板是否注册成功的验证路径配完以后别急着走验证路径是这样的display board 0/2这条命令能看到 PON 板下各端口设备的在线状态。输出里重点看 Run State 列显示 up 才表示设备已经上线Control Flag 列显示 active 表示控制状态正常。我只见过一种情况是 Run State 显示 up 但业务不通的——service-port 没配那是下一章的内容。所以这个命令的验证结论是「设备注册成功」不代表「业务通了」。4. 业务放通与 service-port 下发VLAN、QinQ 和 gemport 的关键细节4.1 上联口透传 VLAN业务能不能到上层的关键注册完 ONU接下来要打通业务通道。第一步是创建 VLAN 并让它在上联口透传vlan 1231 smart port vlan 1231 0/19 0第一条创建 smart 类型的 VLAN 1231第二条把它放在 0/19 口上联口的 0 号子端口透传。smart 类型是华为 OLT 上最常用的业务 VLAN 类型它允许多个上联口同时转发这个 VLAN 的流量如果你只需要单上联standard 类型就够要隔离不同用户组可以考虑 mux 类型。选择依据很简单——组网里有没有双上行、需不需要跨板卡转发。这里再补一条上行口的 native-vlan 配置interface giu 0/19 native-vlan 0 vlan 10含义是把 0 号子端口的 native VLAN 设为 10这样上联口收到的 untag 流量都会打上 VLAN 10 的标签。如果没有特殊需求这个 native-vlan 和前面的port vlan保持一致就行不一致容易出「标签双层」这种隐蔽问题。4.2 QinQ VLAN 属性开小区必配的一步资料里给了这样一组命令专用于新开小区的场景vlan 1231 smart vlan attrib 1231 q-in-q port vlan 1231 0/1 0第二行vlan attrib 1231 q-in-q把 VLAN 1231 设置成 QinQ 属性这是运营商宽带接入的常见做法——外层 VLAN 用于区分上联口或业务类型内层 VLAN 由用户侧设备自由规划。实际操作里还有个容易漏掉的配套项如果 MDU 下挂的用户需要分配不同内层 VLAN还要在 ONU 侧做内层 VLAN 的转换OLT 只负责透传。判断这个 VLAN 是不是需要 QinQ就看上联 BRAS/SR 侧怎么规划的不需要的时候别乱开开了之后报文多一层 tag普通业务会直接断。4.3 service-port 批量下发与单条配置业务放通的核心操作是配 service-port。资料里给了两种写法service-port 49 vlan 1231 epon 0/2/0 ont all multi-service user-vlan 1051 to 1881这条命令把 0/2/0 PON 口下所有 ONT 的 1051 到 1881 这段内层 VLAN 全部映射到外层 VLAN 1231一条命令完成一个 PON 口的所有上网业务放通。注意几个关键参数49是 service-port 索引号全局唯一不能和已有索引冲突ont all表示该 PON 口所有 ONUuser-vlan 1051 to 1881是一段连续的内层 VLAN 区间。如果分光器下面还要接 IAD 语音设备建议这段 range 配大一点这样的好处是后续扩容时不用再加新 service-port直接复用。单个用户的精确放通用这种写法service-port 50 vlan 42 epon 0/2/0 ont 0 multi-service user-vlan 42这条只针对 0 号 ONU、内层 VLAN 42 做映射常用于语音业务、专线业务这类需要单独收敛的场景。multi-service关键字的意思是这个业务端口可以承载多种业务类型数据、语音、组播都走同一个 GEM port不再单独区分 service-port 类型。GPON 侧的对应写法则多一个 gemport 参数service-port vlan 2 gpon 0/2/0 gemport 128 multi-service user-vlan 10 rx-cttr 5 tx-cttr 5gemport 是 GPON 特有的承载通道标识GEM Port 128 通常承载管理/信令129 及以后承载用户数据。rx-cttr 5 和 tx-cttr 5 是上下行流量整形模板的索引模板里定义了带宽参数新开局没特殊要求用默认模板即可。4.4 三层接口与网关的关联业务 VLAN 打通后OLT 还要有管理面或业务面的 IP 才能跟 DHCP 服务器、网管系统通信interface vlanif 1231 ip address 60.60.60.1 24为 VLAN 1231 创建三层接口并配置 IP。注意一个前提三层接口要能工作VLAN 必须已经存在并且至少放通了一个物理口。然后绑定 DHCP 服务器组interface vlanif 2 dhcp-server 1这条命令把 vlanif 2 和之前定义好的 DHCP 服务器组 1 关联OLT 会把该 VLAN 下用户的 DHCP 请求中转到组里的服务器。关联完以后OLT 在这条 VLAN 上就是一个 DHCP Relay 网关的角色。所有配置改完记得save不然设备一重启全部打回原形——这条命令值得多敲几遍。5. DHCP 三层转发与 Super VLAN两种模式拆开看5.1 layer-3 standard 与 option60 的选型OLT 侧 DHCP 转发模式有讲究华为 MA5680T 上主要分两种dhcp mode layer-3 standard dhcp-server 1 ip 10.1.1.1 10.1.1.2standard 模式适合纯上网业务的场景创建 DHCP 服务器组并指向两台服务器默认走负荷分担当 DHCP 服务器主备切换或业务侧有特殊 parameter 需求时大概率需要第二种dhcp mode layer-3 option60 dhcp-server 2 ip 10.10.10.10 10.10.10.11 dhcp domain msft定义 option60 的域并绑定服务器组之后配置网关地址时要把域挂上dhcp domain msft gateway 10.1.2.1选择两种模式的依据很简单普通宽带用 standard需要按 DHCP Option 60 区分用户类型或接入方式的场景用 option60。Option60 本质上是在 DHCP 报文里识别终端的 vendor class然后按域分发地址和网关适合划分不同用户群或做差异化 IP 规划的现场。5.2 mac-range 模式按 MAC 地址段划分地址池还有一种较老但仍在现网使用的模式dhcp mode layer-3 mac-range dhcp mac-range huawei mac-range 0000-0000-0001 to 0000-0000-0100 dhcp-server 2按 ONU 的 MAC 地址段划分 DHCP 服务器组。MAC 地址段只能用这种做法不能跨段写。我见过一次这种模式下的故障MAC 段写得太小新装用户挂不进去ipconfig 后一直拿不到地址。解决方式是先把display dhcp mac-range看当前段覆盖范围然后再扩段。这种模式选型的核心判断标准是上层 DHCP 服务器是不是按 MAC 段做策略的。如果是就按规划把段分开如果不是老老实实用 standard 模式免得给自己挖坑。5.3 Super VLAN 与 ARP Proxy 配合Super VLAN 是为了解决 IP 地址浪费问题——多个子 VLAN 共享一个三层接口和一个网关 IP不同 VLAN 的用户通过 ARP Proxy 实现三层互通。配置链路如下vlan 100 super vlan 10 smart vlan 20 mux supervlan 100 subvlan 10 supervlan 100 subvlan 20Super VLAN 100 套了两个子 VLAN 10 和 20。接着配业务虚端口和三层接口service-port vlan 10 gpon 0/2/0 gemport 128 multi-service user-vlan 15 rx-cttr 5 tx-cttr 5 interface vlanif 100 ip address 10.0.0.254 24 arp proxy enable最后一步是启动 Super VLAN 接口的 ARP Proxy 功能这个命令一定要在 vlanif 100 接口下执行。还要注意 Sub VLAN 之间互访的场景必须配这个否则同 Super VLAN 下不同子 VLAN 的 PC 之间 ping 不通。如果只是单 VLAN 互通这步可以省略。6. 华为 OLT 常见问题与避坑五个高频故障的排查路径6.1 ONU 一直显示 autofind 但注册不上现象display ont autofind all能看到 MAC但ont add加不进去提示 ONU 已存在或参数错误。 原因一般是这台 ONU 之前注册过OLT 上残留了旧的注册信息或者 MAC 地址格式不对。 解决先用display ont info 0 all确认该 PON 口下有没有同 MAC 设备的注册记录有的话按本章第 3 节的顺序先删干净再重新添加。MAC 格式必须保证XXXX-XXXX-XXXX全大写带连字符。6.2 设备注册成功但网管 ping 不通现象display board 0/2里 Run State 显示 up但网管侧 ping 管理 IP 不通。 原因管理 VLAN 没在上联口透传或者ont ipconfig里 manage-vlan 写错了也可能 OLT 侧没有这条 VLAN 的路由。 解决先在 OLT 上ping 220.180.76.116 -vlan 13测试管理通道通不通不通就查port vlan 13 0/19 0有没有放通再查管理 VLAN 的三层接口路由。网络能通就直接进设备检查业务 VLAN 配置别在网管侧瞎折腾。6.3 undo 命令执行失败提示参数错误现象按原命令反着敲undo ont add提示错误。 原因undo 命令要求参数和 add 时完全一致哪怕 desc 里少一个空格都会失败。 解决先display ont info 2 27查出当前实际参数把 desc 原样复制出来再执行 undo。最稳妥的办法是把设备上的配置导出成文本用文本对比工具核对差异而不是靠记忆手敲。6.4 service-port 索引冲突导致业务异常现象下发 service-port 时提示索引已存在或者下发成功后部分用户上网时断时续。 原因全局 service-port 索引号冲突或者外层 VLAN 的 QinQ 属性和内层 VLAN 区间重叠。 解决用display service-port查当前所有 service-port 的索引和映射关系确认新索引没占用、内层 VLAN 区间没重叠。批量下发时建议用 49、50、51 这种固定段每台设备的索引规划写入开局文档别随机写。6.5 save 之后重启配置丢失现象save执行成功但设备重启后配置回到初始状态。 原因这个场景多半是 save 路径不对或者设备没执行save就断电。 解决华为 OLT 的保存命令就是save执行完会有进度提示确认输出没有报错。保险起见保存后执行display saved-config last确认配置文件时间戳已经刷新。开新站时我习惯保存后顺手把配置文件导出一份备份截图存档真出问题还能有后悔药。7. 从自动发现到批量下发新开小区的 20 分钟标准操作流最后分享一个我从新开小区项目里总结出来的标准操作流把前面这些命令串起来。前提是已经拿到数据支撑给的端口、QinQ VLAN、上网业务 VLAN、IAD 管理 IP、语音 VLAN、物理号码和工程队提供的设备 MAC。第一步确认 OLT 上联口和 VLAN 规划display board 0 interface giu 0/19 display port state先确认上联口是 activate 状态且链路 online然后根据规划把外层 VLAN 建好并透传。第二步开启 PON 口自动发现interface gpon 0/0 port 0 ont-auto-find enable port 1 ont-auto-find enable自动发现不开的话现场光猫插上去 OLT 根本不认。这一步做完再用display ont autofind all等待工程队反馈光路已通、设备已上电。第三步注册每台 ONU 并下发管理地址interface epon 0/2 ont add 2 27 mac-auth 0018-82C6-938C snmp ont-lineprofile-id 12 desc LiuPo_anzhifang1#1D ont ipconfig 2 27 ip-address 220.180.76.116 mask 255.255.255.0 gateway 220.180.76.1 manage-vlan 13 priority 0 quit display board 0/2每次添加后立刻display board 0/2确认 Run State 是否 up不等全部加完再统一查这样哪一台注册失败当场就能定位。第四步批量下发业务 service-portservice-port 49 vlan 1231 epon 0/2/0 ont all multi-service user-vlan 1051 to 1881 service-port 50 vlan 42 epon 0/2/0 ont 0 multi-service user-vlan 42 save如果分光器下面后续要接 IAD 设备就把 1051 to 1881 的区间往大配一点避免二次放通。语音业务的 42 号 VLAN 单独放通数据业务的 QINQ VLAN 和语音 VLAN 各配一条。这个流程走下来单台 ONU 从注册到业务放通大概就 20 分钟。如果中途卡住优先检查第二步的 autofind 有没有看到 MAC——这条路径能省掉你一半的排查时间。从那以后我每次开局都强制先跑一遍这四步再碰其他配置确认无误后 save 并导出配置备份。希望帮到你。本文还有配套的精品资源点击获取