三步开启中兴光猫工厂模式zteOnu 完整实战指南【免费下载链接】zteOnuA tool that can open ZTE onu device factory mode项目地址: https://gitcode.com/gh_mirrors/zt/zteOnu深夜十二点家里的光猫因为运营商远程下发配置而自动重启。重启本身没什么可当你重新登录后台发现上次好不容易打开的 Telnet 服务又悄悄消失了——一切回到原点。如果你也经历过这种每次配置都被重置的循环那么今天要介绍的 zteOnu 或许就是你要找的答案这是一款专门面向中兴ZTE光猫ONU的开源命令行工具核心能力是帮你打开设备的工厂模式factory mode并在此基础上永久开启 Telnet 服务让配置不再随重启丢失。本文不打算堆砌参数表而是按一条真实的从折腾到省心的旅程来写先讲清楚问题根源再带你完成安装、首次运行、进阶玩法最后给出避坑指南。全程尽量用大白话解释每个命令背后的原理你可以跟着一步步操作。一、先搞明白Telnet 为什么会一觉醒来就没了在动手之前值得花两分钟理解你遇到的问题到底是什么。中兴光猫出厂时有一套完整的权限分层普通用户useradmin只能改 Wi-Fi 密码之类的基础设置很多高级功能在界面上是隐藏的超级管理员telecomadmin能进入完整 Web 后台但即便如此Telnet 服务默认仍是关闭的工厂模式factory mode设备内部最高权限级别进入之后你才能拿到 Telnet 的登录凭证从而通过命令行做深度配置。问题在于即使你费劲手动进入了工厂模式、临时打开了 Telnet光猫一重启这些配置往往会被重置回默认值。你需要一个工具在每次需要时快速重走一遍认证 → 进工厂模式 → 开 Telnet的完整流程最好还能自动化。zteOnu 做的事就是把这条流程封装成一条命令行帮你自动完成通过设备的 Web 管理接口默认8080端口发起一系列请求完成加密认证这部分用到了 AES 加密和内置密钥池请求进入工厂模式换取 Telnet 的用户名和密码可选地自动登录 Telnet 并写入配置让 Telnet永久保持开启。听起来挺玄乎但用起来其实就是一条命令的事。下一节我们就把它跑起来。二、安装只需三步从源码到可执行文件zteOnu 用 Go 编写好处是编译出的二进制文件不依赖运行时环境Windows、Linux、macOS 都能直接运行。前提是你机器上已经有 Go 环境当前版本需要 Go 1.26 以上安装最新版即可。第一步把仓库克隆到本地并进入目录git clone https://gitcode.com/gh_mirrors/zt/zteOnu cd zteOnu第二步编译生成可执行文件。项目根目录下的go.mod已经声明好了依赖直接构建即可go build -o zteonu .这条命令会读取main.go作为入口把整个程序编译成名为zteonu的二进制文件。编译过程中会拉取cobra命令行框架和restyHTTP 客户端两个依赖库网络正常的话几秒就能完成。第三步验证是否编译成功./zteonu version如果能看到类似ZteONU dev, built at unknown的输出说明程序已经就绪。想全局使用的话可以把二进制放到系统 PATH 里例如sudo mv zteonu /usr/local/bin/之后在任何目录都能直接敲zteonu了。 提示本文所有命令都假设你在光猫同一局域网内运行并且能访问光猫的管理地址默认192.168.1.1。操作前建议先用浏览器确认能打开光猫后台避免在连不上设备的情况下干等。三、核心操作用一条命令打开工厂模式现在进入正题。zteOnu 最基础的使用方式是运行下面这条命令./zteonu -i 192.168.1.1这里的-i指定光猫的 IP 地址。工具会自动完成我们第一节说的完整流程你会看到类似这样的分步输出----------------------------------- step [0] reset factory: ok step [1] request factory mode: ok step [2] send sq: ok step [3] check login auth: ok step [4] enter factory mode: ok ----------------------------------- user: telnet用户名 pass: telnet密码每一行 step 都在干什么简单拆解一下这也是理解工具的关键步骤动作通俗解释step 0请求SendSq.gch重置工厂接口相当于敲门激活设备的 Web 服务提高后续成功率step 1请求RequestFactoryMode.gch向设备申请进入工厂模式step 2发送随机数协商加密密钥设备会返回一个随机数工具用它从内置密钥池里算出本次会话的 AES 密钥step 3加密发送用户名密码校验身份用上一步的密钥加密认证请求设备验证通过后返回凭证step 4请求FactoryMode.gch换取 Telnet 凭证拿到最终可用的 Telnet 用户名和密码打印在屏幕上看到这里你可能有个疑问为什么步骤 3 要加密因为这类认证请求如果明文传输很容易被局域网内的人抓包窃听。zteOnu 用 AES-ECB 加密密钥则根据设备返回的随机数动态生成每次会话都不同。这些细节工具都帮你处理好了你只需要关心最后打印出来的那一对用户名和密码。如果你运行的设备较新可能还会遇到另一种认证方式需要加--new参数我们放到下一节讲。四、进阶玩法永久 Telnet 与新旧两种认证方式4.1 一键永久开启 Telnet拿到 Telnet 凭证只是第一步真正省心的是让 Telnet 一直保持开启。zteOnu 提供--telnet参数在换取凭证之后会自动登录 Telnet、修改数据库配置、保存并重启设备./zteonu -i 192.168.1.1 --telnet命令执行后工具会依次执行这么几件事对应源码app/telnet/telnet.go用刚才拿到的凭证登录 Telnet执行sendcmd 1 DB set TelnetCfg ...系列命令把 Telnet 的开关、用户名、密码、最大连接数、安全级别写进配置数据库执行sendcmd 1 DB save保存配置执行reboot重启设备让配置生效。完成后屏幕上会提示Permanent Telnet succeed user: root, pass: Zte521 wait reboot..也就是说重启之后 Telnet 依然可用默认账号是root、密码是Zte521。如果你不想用默认的 23 端口可以用--tp自定义例如--tp 2323。⚠️安全提醒--telnet会把 Telnet 永久开放同时把账号密码设为一个公开默认值root / Zte521。这意味着任何能连到设备的人都有可能拿到控制权。建议只在受控的内网环境中使用操作完成后尽快修改密码或通过防火墙限制访问来源。这属于高危操作请务必确认你有权管理这台设备。4.2 新旧两种认证方式怎么选你可能注意到不同批次的光猫固件对认证协议的处理并不一样。zteOnu 为此支持两种方式参数适用场景说明默认旧方式老固件直接发送加密认证请求兼容性好--new新固件需要额外发送一个SendInfo报文里面编码了客户端 MAC 地址新方式的关键在于 MAC 地址。设备会校验发送方 MAC 是否在白名单里如果 MAC 不匹配认证就会失败返回info error。所以使用--new时你通常要同时指定一个设备认可的 MAC# 用指定 MAC 推导 SendInfo 报文历史上设备接受 00:07:29:55:35:57 ./zteonu -i 192.168.1.1 --new -m 00:07:29:55:35:57 # 或者指定本机某个网卡的 MAC 作为来源 ./zteonu -i 192.168.1.1 --new --iface en0这里-m是手动指定 MAC优先级最高--iface是从指定网卡读取 MAC两者都不给时工具会自动选择本机第一个非回环网卡的 MAC。项目源码里有一段很有意思的注释SendInfo报文是逆向设备内置校验虚拟机得到的——46 字节的报文由 12 个小端uint16值组成每个值后面跟两个零字节MAC 被异或进数值字节中。正因为搞清了这套规则工具才能对任意 MAC 重新计算报文而不是死记一份抓包数据。 建议如果你不确定自己的光猫属于哪种固件可以先跑一次不带参数的旧方式命令。如果认证一直失败、日志里出现info error再改用--new配合-m指定 MAC 试试。五、避坑指南与安全使用建议5.1 常见错误与排查思路作为新手第一次跑命令大概率会遇到下面某个问题。对照表格排查能省不少时间现象可能原因处理方法连接超时IP 填错或不在同一网段用ping 192.168.1.1确认网络连通返回errors user or password认证账号密码不对确认光猫的 telecomadmin 账号密码默认组合是telecomadmin / nE7jA%5m返回info error新固件要求SendInfo且 MAC 不被认可改用--new -m 00:07:29:55:35:57重试请求反复重试Attempt retrying..设备繁忙或请求时序不对工具本身会自动重试最多 10 次仍失败就等设备空闲后再跑端口被拒管理端口不是默认 8080用--port指定光猫实际 HTTP 端口源码里有一个细节值得知道工厂模式的整个流程最多自动重试 10 次每次间隔 0.5 秒见app/factory/factory.go的Handle方法。所以看到Attempt retrying..(1/10)这样的输出时先别慌给工具一点时间自己调整。5.2 负责任地使用三条底线工厂模式和永久 Telnet 本质上是绕过设备限制的能力用得好是运维利器用得不好就是安全隐患。请务必遵守只在你有权操作的设备上使用。如果你是给客户或公司设备操作先确认授权违规操作可能违反服务条款甚至法律。最小权限原则。能只开 Telnet 就不必开工厂模式能临时开就不要永久开。--telnet开完后尽快改掉默认密码Zte521。先备份再操作。光猫配置一旦改错可能导致断网动手前记下当前设置最好在测试设备上先演练一遍。5.3 批量管理的小技巧如果你负责多台光猫可以把 zteOnu 包进一个简单的 Shell 循环逐台执行并顺手记录每台的成功/失败状态。要点是逐台串行、加延时避免同一时间打爆设备。举个思路示例#!/bin/bash for dev in 192.168.1.1 192.168.1.2 192.168.1.3; do echo $dev ./zteonu -i $dev --new -m 00:07:29:55:35:57 --telnet echo OK: $dev || echo FAIL: $dev sleep 2 done这段脚本对每一台设备依次执行新方式认证 永久 Telnet每台之间休息 2 秒避免请求过密。真实生产环境里建议把sleep拉长到 5~10 秒并记录日志方便事后审计。六、写在最后把反复折腾变成一次搞定回到开头那个深夜场景。有了 zteOnu你不再需要记住那一长串手动的认证步骤也不再担心重启后一切归零——一条命令工厂模式、永久 Telnet全部搞定。这正是这类工具最大的价值把依赖经验的手工操作变成可复制、可脚本化、可批量执行的标准流程。如果你接下来想深入理解它的原理推荐按这个顺序阅读源码认证与工厂模式核心逻辑app/factory/factory.go重点看handle()的五步流程和密钥协商新方式报文逆向细节app/factory/model.go注释里完整解释了 MAC 如何编进 46 字节报文Telnet 永久开启逻辑app/telnet/telnet.go看它如何用sendcmd改数据库命令行参数入口cmd/root.go所有 flag 的定义和默认值都在这里。最后再叮嘱一次工具本身没有善恶关键看使用方式。在受控环境里用它提升效率同时守住安全底线。如果你在真机上跑通了欢迎把你遇到的设备型号和固件版本记录下来分享给社区——多一份数据这个工具对后来者就更友好一点。【免费下载链接】zteOnuA tool that can open ZTE onu device factory mode项目地址: https://gitcode.com/gh_mirrors/zt/zteOnu创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考