简介：这份资源是面向华为OLT设备（M5680T）维护与工程人员的常用命令速查文档，核心解决光纤接入网运维中“查状态、配业务、管ONU”三类高频需求。文档为单个doc文件，大小136KB，按常见命令、查看LOID、添加删除注册信息、详细命令说明等板块组织，条理清晰。常见命令覆盖ONU/板卡/端口状态查询、VLAN信息查看、display boa板卡信息等；查看LOID部分包含ONT自动发现、EPON接口状态、已注册ONU信息及SNMP/Line profile关键参数核对；注册管理则以MAC认证方式演示ont add、ont ipconfig及对应删除操作。此外还包含上行口VLAN配置、三层接口IP设置、时钟源优先级及用户创建等实用示例。已有12569人学习或下载，适合光接入网运维新手快速上手，也可作为日常排障与配置维护的速查手册。

1. 华为OLT常用基本查询命令，先会这些再动配置

华为OLT常用基本查询命令没有太多花活，就是display开头的那一批只读命令，但它的价值被大多数人低估了。做接入网维护的第二天，我就被一句话钉在工位上——网管上显示ONU掉线，用户却坚持说光猫指示灯全正常。带着笔记本到现场一查，发现是改光缆的施工队把分光器出口接反了，后台其实早该看出来。之后我养成了习惯：任何申报“网络不通”的工单，先远程登录华为OLT敲一轮查询命令，再决定要不要出门。

为什么值得专门学一批查询命令？华为OLT的命令体系里，查询类以display开头，只读不改配置，却能在一个终端里看清板卡在位、PON口收发光、ONU注册状态、VLAN承载和活动告警。对装维、接入网运维和刚接手设备的人来说，这套“常用基本查询命令”是远程判断故障在局端还是线路侧的最短路径。关键是它不带风险，业务高峰期也敢放心执行。

这篇笔记按登录开局、PON链路、业务与告警、现场排查这样的顺序，把查询命令拆成可以直接抄到终端里的步骤，连参数含义和判读标准一起讲。适合能拿到设备只读权限但不想翻几百页手册的工程师。我尽量少讲理论，多讲命令输出里哪一列才是重点。

2. 登录视图与开局信息查询：先确认手里是台什么设备

接入一台OLT，第一步不是急着看ONU列表，而是先确认设备本身的状态。设备开机时间、单板在位情况、软件版本、MAC地址，这些基础信息决定了后续查询命令的可用范围——比如某块PON口板卡没注册上，你查ONU信息就全是空。按顺序执行下面的命令，通常能在一分钟内建立起“这台设备是否健康”的基本判断。

2.1 display version 与 display board 0：开局状态确认

以下命令在用户视图和特权视图都可以执行，但建议养成先enable的习惯，后面要切配置视图时不至于混淆。

# 进入特权模式，查询命令大多在特权视图下执行 enable # 查看设备软件版本、主控板、运行时长 display version # 查看0号机框所有单板状态 display board 0

display version输出里要重点看两个地方：软件版本号与补丁级别、设备运行时间。如果运行时间只显示几天，而设备是现网长期运行的，意味着设备近期重启过，ONU掉线往往就是这一段时间内批量发生的。这种时间线对比，是查询命令之外最便宜的排查线索。

display board 0是我用得最多的开局查询。输出表中“BoardName / Status / Subname”三列是重点。Status为Normal表示单板在位且运行正常；为Offline表示主控认不到板卡，需要回局端看硬件或槽位配置；有些版本显示为Wrong，则多半是槽位类型不匹配。注意这里有个体验细节：单板离线时，查询本身依然飞快返回，不会卡顿，真正的问题在输出内容里，不在回显速度上。

注意：display board 0 输出的是“主控看到的板卡状态”，不是“板卡供电灯状态”。现场跟后台对不上时，以主控输出为准。

2.2 display device 0 与 display mac-address：识别设备身份的两种姿势

只有单板状态还不够，还要确认设备在网管里的身份。设备MAC地址是网管识别的唯一凭证，很多“网管上设备离线，但业务还通”的怪现象，最后都回到MAC地址对不上这个问题上。

# 查看0框设备信息：包括设备类型、MAC、槽位数 display device 0 # 查看设备MAC地址与学习到的MAC数量 display mac-address # 过滤查看以太网口学习到的MAC，避免全量刷屏 display mac-address | include ethernet

display device 0比display board 0的粒度更粗，它给出的是整框设备类型和槽位资源；对维护现场来说，真正有价值的是确认主控型号、能开多少PON口，以及和设备出厂参数的对应关系。display mac-address则会把学习到的MAC表刷一大段出来，生产环境慎用不加过滤的全量查询，回显太长容易刷屏，后文会讲到过滤参数。

实际上，多数排查场景在开局阶段只需要两件事：一是把display version和display board 0的输出存成文本，作为设备基线；二是用display mac-address里的设备MAC和网管侧做比对。做完这两步，设备在物理上和逻辑上的“身份”就算确认完毕。顺便说一句，MAC表里如果出现大量未知厂商的MAC，也要留个心眼，排查是否存在异常接入设备。

2.3 display power 与 display temperature：机房环境的第一道防线

OLT设备对环境比很多人想象的敏感。风扇堵转、电源模块异常、高温告警，这些不会直接显示在ONU掉线告警里，但会在设备级查询中露出马脚。

# 查看电源模块工作状态 display power 0 # 查看设备当前温度 display temperature 0 # 查看风扇运行状态 display fan 0

display power 0输出里重点看每个电源模块的Status和输出电压是否在正常范围内。主备电源一路异常时，设备不会立即断电，但冗余能力就少了一半——这个时候再去扩容或整改业务，风险等级完全不同。display temperature 0的结果则直接关联后续查询的可靠性：温度过高时，单板可能出现间歇性复位，ONU掉线告警会是“一批一批地掉”，单看ONU层面很容易被误导成线路故障。

我一般会在设备巡检脚本里把这四条查询命令连续执行：display version、display board 0、display power 0、display temperature 0。它们加起来不超过一分钟，但能告诉你“这台设备能不能安全扛住接下来的操作”。设备本身不健康的时候，先解决问题再查业务，顺序反了会把时间浪费在错误的排查路径上。

2.4 查询命令的执行位置：视图对不上，命令就报错

华为OLT的命令分视图，查询类命令多数集中在特权视图，少数在配置视图也能跑。碰到输入命令后报错“unrecognized command”或“wrong parameter”，先别怀疑命令拼错，很可能就是你当前所在视图不对。

# 从任何视图退回到特权视图 return # 上一个视图，配置视图下可用 quit # 查看当前所在视图提示符 # 特权视图通常显示为: MA5600T> # 配置视图通常显示为: MA5600T(config)#

我自己的习惯是：所有只读查询一律在特权视图完成，只在修改配置时才进入config视图。这样既避免误敲某个修改类命令，也方便把查询输出直接拷贝存档。华为设备对display命令的设计是“只读不写”，这是你可以放心大批量执行的基础，但视图规范仍建议遵守，防止在配置视图里手滑补全出不在预期内的命令。另外要注意，某些display子命令只在登录后第一次enable后的超时窗口内有效，长时间不操作会自动退出，再执行时先确认提示符。

3. PON链路核心查询：ONU在线、光功率与距离判断

接入网百分之八十的报障都出在PON链路上：ONU掉线、光衰大、ONU注册不上、分光器端口错接。华为OLT对PON链路的查询命令是最成体系的，从PON口到单个ONU，逐层往下查，基本能在一屏输出里定位到具体原因。这一章按“PON口状态 → ONU注册状态 → ONU光功率 → 距离与线路质量”的顺序展开。

3.1 display ont info：看ONU在线状态与能力集

确认某个PON口下ONU是否在线，最直接的命令是display ont info。华为设备里“0 0”指代0框0号PON口，如果有多块PON板，第二个0换成对应槽位号。

# 查看0框0号PON口下所有ONU的注册状态 display ont info 0 0 # 查看具体某一个ONU，例如0框0口第1台ONT display ont info 0 0 1 # 查看这个PON口下还没注册的ONU display ont unregistered 0 0

display ont info按ONU ID列出每个ONU的运行状态，State列为online表示注册成功，offline或los表示ONU不在线。配合Control状态还能看出该ONU是否被管理配置放行——有些ONU灯全亮但状态是offline，多半是配置里把它disable了，这类问题跑现场是查不出结果的，远程看一眼配置状态就能省掉一次上门。

在三种查询输出里，我最推荐先执行“display ont info 0 0”拿全量列表，再针对个别ONU追加ONU ID精确查询。全量列表能一眼看出是不是一个PON口下一批ONU集体掉线——集体掉线优先查分光器上行方向，单台掉线才集中查用户侧线路。这是PON维护里最值钱的分流判断，比任何命令都重要。

3.2 display ont optical-info：光功率查询与判读标准

ONU是否在线的下一层，是光功率是否在接收灵敏度范围之内。光模块内部寄存器会记录收发光功率，华为OLT通过以下命令读取：

# 查看0框0口1号ONU的光功率信息 display ont optical-info 0 0 1 # 查PON口光模块自身收发光，用于确认OLT侧激光器工作状态 display port optical-info 0 0

display ont optical-info输出项目里，RX power指ONU接收光功率，TX power指ONU发光功率，单位都是dBm。接收光功率的判读标准一般是这样：

这里有个常见误区——有人看到RX power显示-9就觉得“光很好”，但还要确认这条光路的全程衰耗是否合理。如果用户离分光器很近但收光只有-20dBm，说明中间某个法兰或熔接点已经有明显衰耗，这种隐性劣化才是周末断网的元凶。

display port optical-info看的是PON口光模块自身的发光和收光。OLT侧TX power偏低时，这一PON口下所有ONU的收光都会整体变差；OLT侧RX power收不到某台ONU的光，但ONU本身TX power正常，则是上行链路有问题。两层光功率对照读，是定位分光器及以上线路故障的最快方法。

3.3 用display port state与distance看链路状态

光功率数字只能说明当前时刻的强弱，链路是否稳定还要看PON口状态和测距信息。这里的查询思路：一个是PON口收光状态，另一个是OLT对ONU距离的测距结果。

# 查看PON口运行状态与协商速率 display port state 0 0 # 查看ONU距OLT的距离，单位通常为米 display ont distance 0 0 1

display port state主要看PON口是否处于link up且协商速率正常。GPON口协商为2.5G下行/1.25G上行，EPON口协商在1G上下；如果协商速率明显掉档，先怀疑光模块或线路衰耗。display ont distance的判读则更直接：距离超出OLT测距范围或与物理距离严重不符，往往说明链路经过了异常跳接，比如跨分光器串接、尾纤法兰盘绕过多。

实际维护里，我习惯把光功率与距离两条命令连着打一遍。光功率正常但距离异常，优先怀疑物理链路被改了跳纤；距离正常但光功率很差，优先怀疑活动连接器脏污或熔接点劣化。这两条命令组合起来，基本覆盖了分光器与主干光缆故障的大多数形态。还要补充一点：测距结果偶尔会因为ONU光模块老化出现漂移，不要只看一次结果，多查两次取稳定值再判断。

3.4 GPON与EPON查询差异：一个命令模式避坑点

不同PON模式下的查询命令不完全一致。GPON场景中ONU注册状态多使用display ont info，EPON场景中部分版本的命令中间会多出epon关键字或在参数上有差异。这不是文档写错了，而是设备按协议族做了命令分区。

碰到EPON场景时，先确认设备当前PON模式再决定命令前缀。华为OLT中查看PON口模式的方式如下：

# 查看PON口工作模式 display port mode 0 0

如果输出为gpon，继续用display ont info系列；如果为epon，把ont信息查询换成对应epon命令再执行。这个“先看模式、再选命令”的习惯，能避免在混合组网现场把时间浪费在命令报错上，也方便在碰到第三方OLT时的命令迁移——不同厂商的PON查询命令命名风格不同，但ont info、optical-info这组概念是通用的。

4. 顺着业务查：VLAN、业务流与告警日志的定位顺序

PON链路正常但业务不通的工单，下一步要顺着业务配置查。华为OLT上业务层面查询的重点是四件事：VLAN存在并正确透传、业务流（service-port）绑定关系、MAC学习是否正常、以及活动告警有没有直接指向某个端口或业务。按这个顺序查，基本能把“链路是好的但上不了网”拆解成“配置没下发”或“上层网络故障”。

4.1 display service-port与display vlan：业务不通先查承载

service-port是ONU业务与VLAN之间的桥梁。一个ONU要想上网，至少要存在一套“ONU侧VLAN + 上联VLAN + service-port”的映射。业务不通时，我先查service-port绑定，再用VLAN查上联链路。

# 查看所有业务流 display service-port all # 按VLAN查业务流，例如VLAN 100 display service-port vlan 100 # 查看VLAN配置与VLAN类型 display vlan 100

display service-port的输出里需要确认两个字段：Service-port的VLAN值是否与用户申报的VLAN一致，以及该VLAN是否已绑定到上联口（通常为trunk口）。如果service-port存在但上联口没有该VLAN，业务会在OLT内部被丢弃，用户侧表现为光猫正常但拨号失败。

display vlan 100则回答“这个VLAN在上联口是否放行”，即tagged还是untagged。出现“前一个用户刚装好，同一OLT下第二个用户就上不了网”的工单时，多半是这个VLAN只在一台上联设备上配了放行，第二台上联没配。这类问题光看ONU状态完全看不出异常，必须顺着service-port和外联VLAN查下去才能发现。VLAN查询配合service-port查询，就是业务承载链路的完整体检。

4.2 display alarm active与history：活动告警优先看

告警日志是OLT给运维的最大礼包。华为OLT的告警分活动告警和历史告警两类：活动告警反映当前仍然存在的异常；历史告警记录已恢复或已确认的告警。排查时先看活动，再看历史，用告警码定位到具体槽位和端口。

# 查看当前所有活动告警 display alarm active all # 按严重级别过滤：critical / major / minor / warning display alarm active severity critical # 查看某个PON口的历史告警，例如0框0口 display alarm history 0 0

活动告警按严重级别过滤的效果最好。告警系统里的minor warning数量很多，直接看all会把注意力分散掉；先刷critical和major，把正在影响业务的告警挑出来处理，再回头处理次要告警。历史告警里最常见的是ONT掉线告警，每一条都带ONU ID和时间戳，这些时间戳能直接支撑“这台ONU是几点掉、几点恢复”的结论。

处理这类查询时要注意：告警输出默认分页，如果告警条目很多，终端会停在某个页面等待继续输出。查询类命令本意是只读，不会影响业务，但长时间停在分页界面上，容易让同事误以为你卡住了。我一般会给告警查询加上不分页参数，这个技巧留在第六章一起说。

4.3 display clock与时间基准：告警比对的基本功

告警输出里的时间戳是否可信，取决于设备时钟是否准确。设备本身时间错了，告警时间线和业务申报时间就对不上，很多“掉线发生在什么时候”的判断就失真了。所以涉及告警类查询之前，我习惯先顺手看一下设备时钟。

# 查看设备当前时间，确认时区与时间源 display clock

display clock的输出包括日期和时区。设备重启后，时间可能回退到出厂默认甚至某些固定时刻；如果设备没有配置时间同步源，运行越久积累的偏差越大。比对用户报障与告警时间线时，先确认设备时间与当前时间的偏差；偏差超过几分钟就要考虑时间同步，虽然配置命令不属于本篇查询主题，但这是个“查询结果取决于时间基准”的隐藏前提。

最后一条经验：告警查询要按“槽位-PON口”收窄而不是全量拉取。全量告警在大型设备动辄上千条，既刷屏又难找重点；先按active+severity过滤出来，再针对故障PON口查history，输出总量通常能压缩到一屏以内，判断速度提升一个数量级。

5. 华为OLT查询命令的5个现场排查陷阱

查询命令本身只读，但执行查询不等于不会踩坑。这几年处理过的现场故障里，有不少时间浪费在“命令没报错、输出也正常、结论却不对”上。这里把最常见的五个陷阱列出来，每一条都按现象、原因、解决三步说明，照着排查能少走弯路。

5.1 现象：板卡显示不在位，但现场板卡灯全亮

现象：display board 0输出里某块PON板Status为Offline，可现场看板卡指示灯全部正常，网管上这块板的PON口也“似乎”有流量在跑。

原因：主控单板没有完成配对注册，常见于板卡槽位配置被改过、板卡出现过异常复位、或新插板卡没有正式启用。板卡硬件未损坏但主控侧状态没跟上时，指示灯和业务表象可能正常，但主控已不再处理该板卡上报的数据。

解决：先用display board 0确认具体是Offline还是Wrong状态，再在特权视图执行display sysconf 0查看槽位编号与板卡类型的绑定关系；确认类型不匹配后，按设备规定流程重新绑定板卡类型并复位单板。这里要记住一个原则：查询类命令只能助你定位，不能帮你恢复；涉及复位单板的操作要在低业务时段做，并提前通知相关用户。

5.2 现象：光功率查询返回NULL，ONU掉线原因成谜

现象：display ont optical-info输出里RX power显示NULL或空字符串，其他字段也读不出有效值，换个PON口查询却正常。

原因：最直接的可能是这台ONU当前不在线，OLT无法从光模块寄存器读取信息；另一个可能是该ONU未完成注册、在未认证状态，OLT不会为未认证设备上报光功率。

解决：先执行display ont info 0 0确认ONU的State。State为offline时，打到ONU侧看设备电源和光模块收光灯；State为未注册时，需要核对ONU序列号是否与设备白名单一致。不要拿着光功率NULL就下结论说“光模块坏了”，先排除在线状态这个前提。反过来，如果ONU在线但光功率仍是NULL，再用display port optical-info对比OLT侧收光，确认是否是OLT光模块的问题。

5.3 现象：命令报unrecognized，实际是视图不对

现象：在终端里敲display ont info 0 0 1，设备回复unrecognized command，明明上一轮在同事的设备上还执行成功。

原因：命令行补全机制在特权视图和配置视图都能生效，但在某些视图下，display子命令并未被注册或需要完整的参数格式。很多运维习惯直接粘贴命令，忽略了当前提示符是MA5600T(config)#，导致命令在不该出现的位置被执行。

解决：先看提示符再敲命令。统一做法是每次登录后先enable、再执行查询；一旦误入配置视图，用return退回到特权视图再重新执行。另外注意参数中间的空格数量，华为命令行对“ont info 0 0 1”这种参数个数是严格解析的，漏写ONU ID时设备反馈的往往是parameter error而不是unrecognized，两者含义不同，排查方向也不一样。

5.4 现象：告警时间线对不上，整条判断被推翻

现象：用户说昨晚11点掉线的，告警时间戳却显示凌晨3点，运维按告警时间找人处理，结果线路根本没问题，白白半夜跑一趟。

原因：设备时钟未同步或时区配置不一致。OLT重启后未配置时间源，运行一段时间后时间漂移，告警时间戳与真实时间偏差可能超过一小时；跨网管看告警时，不同设备也可能各自为政。

解决：先执行display clock查看设备当前时间。如果和标准时间偏差在几分钟内，基本不影响判断；偏差较大时，需要在设备上配置时间同步源并校时。校时这个动作虽然属于配置命令，但它解决的是查询结果的信任问题——时间基准错了，所有告警比对都是在沙滩上盖楼。养成“先看钟、后看告警”的习惯，能省掉大量误判。

5.5 现象：同时开两个会话查设备，终端卡死

现象：另开一个终端窗口，同时执行多段display命令，结果某个会话半天不响应，命令像卡住一样。

原因：OLT对并发管理会话有数量限制，部分老设备型号限制两个管理会话；同时也有“display xxx all”输出量过大导致分页缓冲占满的可能。第二个会话的查询请求会在设备侧排队，看起来就像卡死。

解决：查询命令只保留一个会话窗口，退出不用的会话而不是挂着等待；全量查询尽量加过滤条件或使用不分页输出。如果设备已经卡在某个长输出里，按Ctrl+C中断回显，再重新进入一个新会话执行精确查询。把“一次会话专注一轮查询”当纪律，比练熟任何命令都更能避免设备无响应。

6. 查询命令的组合用法：三连查询与输出过滤技巧

查询命令不是一条条单独用的，把它们串成固定组合，日常效率能翻倍。这里给出我习惯的“三连查询”组合：先确认设备状态、再查PON链路、最后查业务和告警，每个组合的输出控制在三屏以内，适合日常巡检，也适合新接手设备时快速摸清健康度。

6.1 一条命令看全局：display ont info summary 0 0

处理“某小区多户报障”时，一条summary查询能代替逐台查看ONU状态：

# 查看0框0口下ONU在线/离线统计，快速判断掉线规模 display ont info summary 0 0

输出会按PON口分列统计在线数和总数。如果某个PON口下面8台ONU全部offline，那是上联链路问题；如果分散在若干个PON口，则优先怀疑主干上行或设备自身问题。这个统计能让你在打开详细查询之前，先判断故障的波及范围和方向。

6.2 输出过滤与不分页：把终端回显收窄到可用范围

华为OLT的查询命令支持管道过滤与不分页输出，这两个参数是查询命令真正的效率开关。

# 不分页输出所有告警，适合保存到日志文件 display alarm active all | no-more # 在service-port里过滤指定VLAN，避免手工翻屏 display service-port all | include vlan 100 # 只看板卡状态中的ONU相关字段 display board 0 | include ONU

| no-more直接关闭交互式分页，让整段回显一次性打出，适合配合终端“记录会话输出”功能把大量查询结果落到文本文件；| include则是把指定关键字所在行留下，过滤后的输出通常在一屏以内，人眼直接可读。这两个管道符建议前者用在日志导出场景，后者用在日常定位场景，换过来容易让关键行淹没在大段回显里。

6.3 整套查询组合的建议顺序

进设备后按这个顺序敲能覆盖大多数工单的首次排查：display version看运行时长、display board 0看板卡健康、display ont summary 0 0看ONU总体状态、display ont optical-info对目标ONU看光功率、display clock加display alarm active severity critical看时间与当前告警。这六条命令做完，大约五分钟，故障在局端还是线路侧、是配置问题还是光路问题的边界就基本清楚了。

我个人的习惯是：把每个组合的输出保存成带时间戳的文本文件，作为每一次排障的现场记录。查询命令不改变设备状态，反复执行没有副作用，同行之间对结论有分歧时，把同一组查询重新跑一遍即可复核。故障总会遇到，但查询的套路是可以提前固定的——少在错误方向上耗时间，就是查询命令带来的最高回报。希望帮到你。

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