
简介华为OLTMA5680T常用查询与配置命令速查文档面向从事FTTH接入网维护的新手和一线运维工程师帮助读者快速掌握设备状态查看、ONU注册/删除、VLAN与上行口配置、用户及时钟管理等高频操作。资源包为单个doc文档大小约136KB命令按类别组织查阅复制都很方便。文档重点整理ONU线路信息、板卡与端口状态、LOID自动发现等查询命令并以实际示例说明MAC认证添加/删除ONU、下发管理地址、配置业务虚端口、三层接口IP、DHCP服务器组和时钟源优先级等操作多数步骤附带输出状态判断和注释便于现场对照执行。同时也补充了普通用户与全局配置模式下的单板、端口状态检查、保存配置等基础操作对新手友好尤其适合开局上电后的板卡识别、ONU离线定位、用户业务开通与复核等场景。目前有一万两千余人浏览学习适合作为开局调测、日常巡检和故障定位时的速查手册。1. 华为OLT查询命令为什么是日常维护的第一板斧夜间值班电话响起来多半是“你们那片网又断了”或者“家里光猫一直闪红灯”。人还在路上就得先在脑子里把故障层级过一遍是主干光缆、PON口、单台ONU还是上联业务华为OLTMA5680T、MA5800这一系的日常维护里百分之八十的判断动作靠一串以 display 开头的查询命令完成查版本、查单板、查ONU注册状态、查光功率、查告警、查service-port。命令本身不难难的是知道故障发生时先敲哪一条、输出里的哪个字段才是关键证据。这套查询命令用对了能把故障定位从“几小时”压到“几分钟”。这篇笔记适合接入网维护、装维支撑和刚接手FTTx的网工按设备层、用户层、业务层把常用命令串成一套能照着敲完的流程每步都给出我平时看输出的习惯。2. 从登录到看家底华为OLT查询命令里的版本、单板与告警接到报障先别急着翻用户配置先在设备上把“家底”看清楚。我习惯按固定顺序走一遍登录、看版本、看单板状态、扫一轮告警。这套动作不挑具体故障三分钟内能确认设备本身是否健康避免后面查用户状态时被一块“假活”的单板带偏。很多新手上来直接查ONT结果查了半天用户侧最后发现是单板在反复复位方向完全跑反。2.1 登录设备并让告警实时上屏enable、config 与 terminal monitor华为OLT的登录方式和主流网络设备一致通过串口或带外管理网进命令行界面多数账号还要过一次 enable 才能进特权级。我建议在 config 视图下做查询少数命令比如后面要讲的注册信息类在全局视图下输出才完整。查询命令不用进入什么特殊模式华为OLT没有单独划分“查询模式”这是一个容易误会的点。# 进入特权模式提示符会变化 enable # 进入全局配置视图display类命令在这里也能正常执行 config # 打开当前终端的实时告警显示设备主动上报的告警会直接刷屏 terminal monitor逻辑说明enable 是提权操作部分账号默认只读敲 display 没问题敲 config 会被拒绝。terminal monitor 这条很容易被忽略它负责把设备主动推送的告警打到当前终端上否则你只能靠 display alarm 被动去捞时效差不少。参数说明config 后的提示符变化只是视图切换不影响 display 类命令的返回内容。登录后顺手看一眼时间同步用 display clock 确认设备时钟准确告警日志时间错乱会直接影响故障判断——凌晨三点掉线的告警实际可能发生在晚高峰后续分析全乱。2.2 用 display version、display board 0、display device 0 查清设备底细版本和单板状态是所有后续判断的基准。老 MA5680T 和新 MA5800 在个别查询命令写法上有差异光功率相关命令在 GPBD 老单板和 MA5800 上关键词都不一样。所以第一件事是确认当前跑的软件版本后面遇到“命令敲了没反应”时能快速判断是版本差异还是敲错了。# 查看系统软件版本、补丁与设备启动时间关键看VRP版本和补丁号 display version # 查看0框所有单板的在位状态、温度、电压 display board 0 # 查看设备CPU、内存占用以及单板运行时长判断设备是否“忙过头” display device 0版本输出里的 VRP 版本号决定了命令语法兼容范围同一产品线不同大版本之间ONT 光功率查询命令就有命名差异后面避坑章会细说。board 输出主要盯状态字段不是正常状态的单板都要记下来温度超过 70 摄氏度或电压偏移明显的先处理否则查了半天用户侧根子在单板过热。device 里的 CPU 占用需要长稳观察瞬时飙高不说明问题持续高占用才会拖垮查询响应。这块经常被跳过但挽回过很多瞎忙的晚上。有一次用户反复掉线ONT 光功率和业务配置都正常最后翻 board 看到一块 GPBD 单板温度告警、频繁复位换了单板后问题消失。单板状态这一眼值得养成默认动作。2.3 告警是所有问题的信号灯display alarm 0 all 的看板顺序告警列表是定位故障最快的入口但信息量很大直接全屏拉取容易把关键条目淹没在历史噪声里。我一般的做法是先看当前存在的实时告警再按端口级光路告警定位最后才翻历史。历史告警适合事后分析不适合当下排障它会把你带进“过去的问题”里。# 查看0框当前所有告警包含PON口LOS、单板温度、电源等 display alarm 0 all输出里 LOS信号丢失是最常见的用户侧告警对应某个 PON 口下 ONU 大面积掉光ONT-LOS 则表示单台 ONU 光路中断。看告警的顺序建议是先排掉电源和单板类高等级告警再按 PON 口聚合统计最后逐台 ONU 看光功率。看板时我会特别留意重复上报的同一类告警比如某个 PON 口每隔几分钟报一次 LOS这往往不是用户侧光猫问题而是分光器到机房这段光路老化需要安排人测光纤。用 display alarm 0 all 定位到问题 PON 口后下一步切到 ONT 查询命令组细看设备。这一章相当于给设备做体检设备本身有问题时用户侧查得再细也白搭。3. 用户侧第一现场用 ONT 查询命令组判断掉线与弱光用户报障九成落在 ONT 这一层要么光信号闪红灯要么频繁掉线要么新装死活注册不上。华为OLT里这组命令集中在 ont 关键词上一次能查整个 PON 口下的全部用户状态也能单独看某台的光功率和注册信息。这一章是查询命令密度最高的一章建议在测试环境里把每条命令敲一遍记住字段长什么样排障时才能一眼看出异常。3.1 一次查出所有离线用户display ont info by-state 0 0 offline用户报障单上写着“某栋某单元断网”先别急着找那一台先把整个 PON 口下用户状态拉出来确认是个体故障还是片区故障。个体故障查 ONT 本身片区故障直接跳去查光模块和分光器两个方向的工作量差好几倍。# 列出0框0槽所有PON口下处于离线状态的ONT优先处理全离线场景 display ont info by-state 0 0 offline # 对应的在线状态列表可用来做前后对比 display ont info by-state 0 0 onlineby-state 是过滤参数offline 表示只看离线online 只看在线。输出里的关键字段是 F/S/P 和 ONT-IDF/S/P 是框/槽/口三段索引ONT-ID 是该 PON 口下的逻辑编号。这两个字段是后续所有查询命令的“地址”光功率命令、注册信息命令都靠它定位到具体设备。Control 表示 OLT 侧对 ONT 的管理状态Config 表示配置是否下发成功Run 表示实际运行状态。只要 Run 不是 online说明设备已经掉线。如果 online 占比很低大概率是 PON 口级别故障不用继续逐台查光功率。不习惯用 by-state 时直接敲 display ont info 0 0 all 也能看但输出行数多定位慢。by-state 是更推荐优先记的命令尤其在割接后验收一条命令就能看出哪些设备没起来。另外注意有些版本还支持按 ONT-ID 精确查询单台display ont info 0 0 0 1输出更干净适合查某一台的具体状态。3.2 光功率才是弱光的实锤display ont optical-info 与判读阈值装维经常在微信里报“光猫红灯”但红灯不等于弱光也可能是上层断电或者主干光缆被挖断。能直接判断物理层质量的命令是查询 ONT 收发光功率华为OLT上以 display ont optical-info 为核心。这条命令在排障里地位很高因为它直接反映光路真实质量。# 查询0框0槽0口下ONT-ID为1的收发光功率索引顺序是框/槽/口/ONT-ID display ont optical-info 0 0 0 1 # 不带ONT-ID时列出该PON口下全部ONT的光功率适合批量扫弱光 display ont optical-info 0 0 0 0输出分成 ONT 接收光功率RX和 ONT 发送光功率TX两项。RX 是排障主要依据GPON 场景下 OLT 侧发光一般 2dBm 到 3dBm经过 1:32 分光器和法兰损耗ONT 收到的合理区间大约在 -8dBm 到 -27dBm。低于 -28dBm 开始出现间歇丢包低于 -30dBm 基本进入不稳定区。看到 -8dBm 以上的高收光也要警惕说明分光比或衰减出了问题长期高收光会损伤光模块。注意 display ont optical-info 读的是 ONT 芯片上报的数值不是 OLT 自己测的。如果 ONT 彻底离线上报通道中断这个命令可能显示 -40dBm 左右的保留值或者干脆显示“--”。这属于查询结果的坑后面避坑章单独讲。所以每次查光功率我会先确认 ont info 里 Run 状态是不是 online只有在线状态下读到的光功率才有参考价值。批量扫弱光时我习惯连查三次、每次间隔三十秒RX 读数上下跳动超过 3dB 说明光路不稳定比单次固定值更能说明问题。3.3 新装和换机必查display ont autofind all 与 display ont register-info新装用户“光猫上了电但注册不了”是工单重灾区。OLT 侧要能看到未注册 ONT才能判断是设备没被发现还是发现了但认证不通过。这组命令在新装、换机、私接终端排查三个场景下都是必查项。# 查看端口下未被注册的ONT即自动发现列表 display ont autofind all # 查看指定ONT的注册模式、SN/LOID和认证状态 display ont register-info 0 0 0 1autofind 的输出里会出现一台裸 ONT显示它的 SN 序列号和所在端口。如果这里看不到新 ONT问题在物理层或 ONT 本身不用去查注册配置。如果能看到继续用 register-info 看注册模式是不是和 OLT 侧配置一致比如 SN 注册还是 LOID 注册LOID 的用户名密码对不对。常见坑是旧 ONT 换新后OLT 侧还绑定着旧设备的 SN新设备在 register-info 里显示认证失败。这时候要去解绑重绑而不是反复重启光猫——重启解决不了绑定关系不一致的问题。autofind 在正常维护中还会牵出一个安全点如果端口下突然冒出一台不在台账里的 ONT说明有人私接终端。这种情况不算少见看到了顺手记录别直接忽略它可能是潜在的网络隐患。新装场景下我的固定动作是先 autofind 看到序列号再 register-info 确认认证模式最后 ont optical-info 确认光功率达标三步齐了才允许装维做用户侧配置。4. 业务层查询service-port、DBA 与 MAC 的链路对应问题定位ONT 在线、光功率正常但用户还是上不了网故障就从物理层转移到了业务层。业务层要看三条线业务虚端口有没有配置、带宽模板给得够不够、MAC 有没有在正确端口下学到。这三者的对应关系查清楚绝大多数“物理正常但业务不通”的问题能定位到具体环节。4.1 业务通不通先查 display service-port 0 0 all华为OLT上 ONU 的业务通过 service-port 业务虚端口把用户 VLAN 和物理端口绑定在一起。ONT 在线只代表能注册不代表业务已下发。我处理过不止一次用户侧光功率漂亮得很但 service-port 里根本没有对应条目一问是割接时漏配置。这类问题用光功率查询命令查不出来必须回到业务视图。# 查看0框0槽下所有业务虚端口确认用户端口和VLAN是否有对应条目 display service-port 0 0 all # 按VLAN反查业务端口适合已知VLAN找端口归属 display service-port 0 0 all | include vlan 100输出的核心字段是端口索引、VLAN、业务类型。看的时候注意 VLAN 是用户的内层 VLAN 还是外层 VLANGPON 组网里经常是双层 VLANservice-port 上绑定的通常是对外那一层。如果用户侧配的 VLAN 和 service-port 里的对不上数据包会在 OLT 上被丢得无声无息。include 过滤在 V800R 版本上基本可用但也见过老版本不支持管道符遇到提示语法错误就老实翻页看别硬刚。MA5680T 和 MA5800 的 service-port 输出格式略有差别但“VLAN 与端口索引要能对应上”这个原则不变。查询时也要注意端口索引写法OLT 上三段式框/槽/口和四段式都出现过不要拿着四段式索引去填三段式命令。排查拨号不通时我一般先用这个命令确认业务条目存在再继续查 VLAN 透传和上联口配置。4.2 带宽上不去时查 DBA 模板与流量模板测速不达标也是高频工单。晚高峰宽带跑不满ONU 在线、光功率正常、路由也没问题这时候多半是带宽模板没配够。华为OLT里 DBA 模板控制 ONU 上行带宽流量模板控制用户侧以太网口速率等级。这两块配置错了测速永远跑不满换了光猫也没用。# 查看0框下所有DBA模板的带宽类型和分配参数 display dba-profile 0 all # 查看流量模板索引及上下行速率约束 display traffic-profile 0 allDBA 模板的 type 要会认type1 是固定带宽适合 VoIP 这类对时延敏感的业务type4 是固定加保证加最大带宽宽带上网通常用它type2、type3 是不同组合的保证带宽和最大带宽。看到 ONU 配的是 type1 且固定带宽只有几十兆用户抱怨 500M 宽带跑不满就别再怀疑光路了先把 DBA 模板改到匹配的 type4 并核对保证带宽和最大带宽。需要提醒的是华为不同版本里 DBA 模板和流量模板的查询命令前缀不完全一样有的版本里流量模板叫 traffic-table 而不是 traffic-profile敲之前用问号补全最稳。DBA 改动会影响该模板下所有 ONU改前务必查询确认模板被哪些 ONU 引用改挂了影响面很大。4.3 环路与 MAC 漂移display mac-address 一眼看出数据包从哪来业务配好、带宽也够但用户还是时通时断要考虑二层环路和 MAC 漂移。华为OLT可以通过查询 MAC 地址表确认用户报文实际从哪个端口上来。这条命令在环路排查里比任何光功率查询都管用因为环路问题是逻辑层问题物理光路完全正常。# 查看设备上学习到的MAC地址表重点关注VLAN和端口对应关系 display mac-address 0 # 按指定VLAN过滤缩小排查范围 display mac-address 0 | include vlan 100正常的 MAC 表里一个 MAC 应该固定出现在一个端口下如果同一个 MAC 在多个 PON 口或 ONU 下反复出现基本可以确认下面有环路或者有人私接交换机导致广播风暴。这种故障光功率查不出来必须回到 MAC 表上看。输出里的 Type 字段是动态学习就正常如果出现大量异常刷新配合第 2 章的告警看板很快能锁定是哪个端口下的子网问题。处理完环路后再执行一次 MAC 表查询确认漂移消失这步容易被跳过但值得养成习惯——环路解除后 MAC 表不会立刻变干净需要等老化时间隔几分钟复查才能确认根因真的消失。5. 华为OLT查询命令避坑5 个常见误判与排查思路查询命令本身不难难的是结果怎么解读。这一章写几个实际踩过的坑按现象、原因、解决三步拆开重点提醒那些“看起来正常”的结果往往才是最危险的误判来源。5.1 现象ONT 显示 online但用户拨号不通这种情况最容易让人怀疑用户路由器或光猫实际上 OLT 侧在线不代表业务通了。我见过不只一次ONT 注册成功、光功率正常但 OLT 上对应 service-port 没配或者 VLAN 与用户侧不一致。原因ONT 在线只代表注册和认证通过业务虚端口是独立配置的一层。解决先 display service-port 0 0 all 确认有无该 ONU 的业务条目再对照 ONT 上的用户 VLAN。如果 service-port 存在但匹配错误用 display vlan 查 VLAN 是否透传到上联口。拨号不通且光路正常时不要反复换光猫先在 OLT 侧把业务链路捋一遍。这个坑在割接后特别常见配置复核时一眼扫过漏掉一条 service-port 就能让整片用户断网。5.2 现象光功率显示 -40dBm且数值“整齐得不像话”第一次见 -40 时以为是真实弱光后来才发现这是设备在 ONT 失联时输出的保留值不是实测读数。原因ONT 已离线或光模块上报通道中断OLT 拿不到真实光功率用保留值填充输出。解决先 display ont info 确认 Run 状态如果是 offline-40 这个数不要去分析直接排物理层查 ONT 供电、光缆、法兰、分光器。这算查询命令里的小玄学记住一个原则——读数前提是设备在线在线状态下的光功率才有分析意义。另外EPON 和 GPON 的光功率范围不一样同一个 -25dBm 在 GPON 下可能还能用在 EPON 下已经到临界判读时先确认端口制式。5.3 现象换新 ONT 后 Run 状态一直 offline电源灯倒是亮的这个现象很像光路问题但根因常在认证匹配上。原因OLT 侧配置了 SN 绑定或 LOID新旧设备的序列号不一致注册被拒。解决用 display ont autofind all 看新设备是否被发现再用 display ont register-info 对比注册模式。如果是 SN 绑定解绑旧 SN 再绑定新 SN如果是 LOID 密码问题核对密码是否复制错了空格或大小写。这个判断依据比反复重启光猫扎实得多。装维经常先斩后奏换设备台账没更新后台一查绑定关系就对不上。所以换机前务必先查 register-info 确认绑定模式再决定是直接换还是先在 OLT 侧解绑。5.4 现象告警列表干干净净用户却反馈频繁掉线没有告警不等于没有问题。最常见原因是弱光还没到 LOS 门限处于能注册但误码率高的临界区。原因光路衰减在告警阈值边缘波动设备不报硬告警但实际传输质量已经很差。解决连续多次执行 display ont optical-info观察 RX 的波动方向。如果读数在 -26 和 -30 之间来回跳基本是光路老化或接头脏污优先清洁法兰、检查弯折半径而不是直接换 ONT。这种间歇性故障用单次查询容易漏建议每次间隔三十秒连查三次取中间值。还有一种情况是分光器尾纤没插紧震动后偶尔接触不良告警时有时无多测几次才能抓出来。5.5 现象同一套命令在另一台 OLT 上“敲不出来”华为OLT的 MA5680T 和 MA5800 系列命令体系大部分一致但光模块、ONT 光功率、流量模板这几类命令存在版本差异。老版本可能用 display optical-module-info新版本集中在 ont optical-info 下框槽端口的索引位数也不同。解决敲错命令时用问号在关键词后面补全让设备把可选参数列出来再不行就回 display version 确认软件版本对照对应版本找语法。别硬记某一条命令万能按版本走最稳。另外注意不同单板类型支持的查询命令也不一样GPBD、GPFD、XG-PON 单板的光功率查询方式有差异换单板后要重新确认命令是否适用。6. 把查询命令串成三步定位法从 ONT 到 PON 口再到业务的验证技巧前面章节把查询命令拆开了最后把这串命令串成一个固定排查顺序遇到报障直接按步走比临时想命令快得多也少漏项。第一步ONT 层display ont info by-state 0 0 offline 确认哪些设备离线再对离线设备执行 display ont optical-info 看是否有弱光。第二步PON 口层如果大批设备同时离线跳过逐台 ONT 查询直接查 display board 0 和 display alarm 0 all确认单板与 PON 口光模块状态必要时用 PON 口光功率类命令或告警定位分光器问题。第三步业务层设备在线但业务不通时依次 display service-port、display dba-profile、display mac-address把业务虚端口、带宽模板和数据转发三个点串起来验证。这个顺序也适合割接验收后做批量巡检先看离线、再看弱光、最后确认业务数量一轮命令敲下来半小时内能覆盖几百户。处理完故障别急着收工把维修前后的光功率读数都留档下次用户再报障时可以直接对比是继续恶化还是已经恢复。改 DBA 模板这类影响面大的操作前先把 display dba-profile 和引用关系存一份改挂了有后悔药可吃。早年间我只看了 ONT 在线状态就判断故障恢复结果 service-port 配错导致用户依然不通白跑一趟。从那以后给自己定了个规矩凡是拨号类报障三步全部走完才能收工少一步都可能在用户侧翻车。这套查询节奏不一定是最短路径但一定是稳定路径。希望帮到你。本文还有配套的精品资源点击获取