企业官网建设流程全解析

简介：华为OLT（MA5680T）常用查询与配置命令速查文档，面向从事FTTH接入网维护的新手和一线运维工程师，帮助读者快速掌握设备状态查看、ONU注册/删除、VLAN与上行口配置、用户及时钟管理等高频操作。资源包为单个doc文档，大小约136KB，命令按类别组织，查阅复制都很方便。文档重点整理ONU线路信息、板卡与端口状态、LOID自动发现等查询命令，并以实际示例说明MAC认证添加/删除ONU、下发管理地址、配置业务虚端口、三层接口IP、DHCP服务器组和时钟源优先级等操作，多数步骤附带输出状态判断和注释，便于现场对照执行。同时也补充了普通用户与全局配置模式下的单板、端口状态检查、保存配置等基础操作，对新手友好，尤其适合开局上电后的板卡识别、ONU离线定位、用户业务开通与复核等场景。目前有一万两千余人浏览学习，适合作为开局调测、日常巡检和故障定位时的速查手册。

1. 华为OLT查询命令为什么是日常维护的第一板斧

夜间值班电话响起来，多半是“你们那片网又断了”或者“家里光猫一直闪红灯”。人还在路上，就得先在脑子里把故障层级过一遍：是主干光缆、PON口、单台ONU还是上联业务？华为OLT（MA5680T、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 online

by-state 是过滤参数，offline 表示只看离线，online 只看在线。输出里的关键字段是 F/S/P 和 ONT-ID：F/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 1

autofind 的输出里会出现一台裸 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 还是外层 VLAN，GPON 组网里经常是双层 VLAN，service-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 all

DBA 模板的 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 配错导致用户依然不通，白跑一趟。从那以后给自己定了个规矩：凡是拨号类报障，三步全部走完才能收工，少一步都可能在用户侧翻车。这套查询节奏不一定是最短路径，但一定是稳定路径。希望帮到你。

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