ung220z-tool README

项目的 README,来自 github.com/Hut-hzf/ung220z-tool。合并为一个 markdown 文件:README.md。

ung220z-tool

针对 UNG220Z(九联 / Unionman 中国移动光猫) 的一键凭据提取工具。

⚠️ 仅用于你自己的设备,用于找回自己忘记的管理密码、迁移宽带配置或安全自查。 未经授权对他人设备使用属于违法行为,作者不承担任何责任。

背景

这类光猫的 Web 管理页基于 .gch CGI 框架,登录口令由 TR-069 定期轮换,普通用户拿到的密码往往几天就失效。本工具走 Telnet 通道,直接读取设备配置库,拿到当下有效的全部凭据。

工作流程

用户输入账号密码
   ↓
拼出 http://<ip>/usr=<user>&psw=<pass>&cmd=1&telnet.gch 并打开浏览器(同时脚本直连兜底)
   ↓
Telnet 登录 → root shell
   ↓
sidbg 1 DB decry /userconfig/cfg/db_user_cfg.xml 解密配置
   ↓
提取 Web 账号 / Telnet 口令 / PPPoE / WiFi 密钥 / root 口令
   ↓
打印凭据表 + 落盘日志

用法

python3 ung220z.py

会依次询问:

※ 用户名和密码通常印在光猫【背面贴纸】上(S/N 标签)
  形如「用户名:user   密码:xxxxxxxx」,把光猫翻过来就能看到

① 光猫地址 [192.168.1.1]:
② 用户名 [user]:
③ 密码(输入时不显示)
   密码:

也可以全部走命令行:

python3 ung220z.py -i 192.168.1.1 -u user -p '你的密码'
python3 ung220z.py -i 192.168.1.1 -u user -p '你的密码' --no-browser

常用参数

参数 说明
-i, --ip 光猫地址,默认 192.168.1.1
-u, --user 登录用户名,默认 user
-p, --password 登录密码,不填则交互输入
--telnet-user Telnet 用户名,默认 CMCCAdmin
--telnet-password Telnet 口令(部分机型与 Web 口令不同)
--no-browser 不调用浏览器,纯 HTTP 请求
--unlock Web 被会话锁占住时重启 httpd 解锁
--no-release 不尝试释放残留 Web 会话

输出示例

[22:15:00] INFO   会话开始  目标=192.168.1.1  账户=user
[22:15:00] HTTP   已发送给浏览器: http://192.168.1.1/usr=user&psw=***&cmd=1&telnet.gch
[22:15:00] HTTP   telnet.gch → TelnetSet Success!
[22:15:00] PROBE  nc -zv 192.168.1.1 23 → succeeded
[22:15:01] AUTH   Telnet CMCCAdmin / ****** → 登录成功(root)
[22:15:02] SHELL  sidbg 1 DB decry /userconfig/cfg/db_user_cfg.xml → /tmp/debug-decry-cfg
[22:15:03] DATA   DevAuthInfo  CMCCAdmin  / ******  Level=1
[22:15:04] CRACK  MATCH: ******  (/etc/shadow)

最后输出凭据汇总表,并写入 ung220z_<时间戳>.log。

依赖

原理说明

环节 说明
开 Telnet GET /usr=<user>&psw=<pass>&cmd=1&telnet.gch,返回 TelnetSet Success! 即成功
Web 登录 密码前端只做 base64,Frm_Logintoken 每次响应递增,必须回填实时值
配置解密 sidbg 1 DB decry 无口令即可解密,得到明文 XML
root 口令 /etc/shadow 中为 SHA-256 crypt,工具会用常见出厂口令比对

免责声明

本项目仅用于教育与自有设备维护。使用者应确保对目标设备拥有合法管理权限。

ung220z-tool (Hut-hzf/ung220z-tool)

正在搜索数据库…

这是什么?这是一款一键工具,用于从 UNG220Z(Jiulian / Unionman,中国移动)光网络终端上提取当前有效的管理员凭据。README 说明,它仅供你用于自己的设备:找回忘记的管理员密码、迁移宽带设置,或检查自身的安全性。
它是图形界面应用还是命令行脚本?它是一个 Python 命令行脚本。它会一步步提问,你也可以把所有参数直接写成标志,例如用 -i 指定调制解调器 IP,用 -u 指定用户名。运行结束时会打印一份凭据汇总。
我要怎么让它跑起来?安装 Python 3.8+,将电脑连接到调制解调器的网络,然后带参数运行脚本,或以交互方式运行。使用 --no-browser 可以跳过浏览器,只发送普通的 HTTP 请求。
除了 Python,还需要别的东西吗?不需要 pip 包,只用 Python 标准库。调制解调器上必须开启 Telnet,但脚本会通过 telnet.gch 请求尝试自行开启。有些型号的 Telnet 密码与网页密码不同,因此可以传入 --telnet-password。
安装时有哪些坑,或者哪些情况可能不好用?网页登录密码每隔几天就会轮换,所以脚本改为通过 Telnet 读取配置。网页会话有时会被调制解调器锁定;--unlock 参数会重启 httpd 来清除锁定,--no-release 则跳过释放残留的网页会话。
它是怎么拿到密码的?它先通过 GET 请求 telnet.gch 开启 Telnet,然后读取设备的配置数据库。命令 'sidbg 1 DB decry' 无需口令即可解密,得到明文 XML。root 密码是 /etc/shadow 中的 SHA-256 crypt 哈希值,脚本会将其与常见的出厂密码进行比对。
为什么不直接登录网页?网页登录密码通过 TR-069 轮换,往往几天内就会失效,所以从网页上拿到的密码很快就不能用了。Telnet 直接读取设备中保存的配置,返回的是当前真正有效的凭据。
能用在别人的调制解调器上吗?不能。README 说明,未经授权在他人设备上使用本工具是违法的,作者不承担任何责任。它仅适用于你拥有或依法拥有管理员权限的设备。
有哪些类似的项目?BLEhound, wifit3, ESP32-Bit-Pirate, binwalk, PwnPad, rea, httpx, w1700k-sdr
作者
Hut-hzf
大小
<0.1 MB
星标
1.2K
更新
提交Nov 15
时长
3天
提交 · 90 天