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, China Mobile), который извлекает из устройства текущие действующие учётные данные администратора. В README сказано, что он предназначен только для вашего собственного устройства: чтобы восстановить забытый пароль администратора, перенести настройки широкополосного доступа или проверить безопасность собственного устройства.
Это приложение с графическим интерфейсом или скрипт для командной строки?Это скрипт на Python для командной строки. Он задаёт вопросы по шагам, либо можно передать всё флагами, например -i для IP-адреса модема и -u для имени пользователя. В конце он выводит сводку с учётными данными.
Как его запустить?Установите Python 3.8+, подключите компьютер к сети модема и запустите скрипт с флагами или в интерактивном режиме. Используйте --no-browser, чтобы не открывать браузер и отправлять только простые HTTP-запросы.
Нужно ли что-то кроме Python?Дополнительные пакеты pip не нужны, только стандартная библиотека. На модеме должен быть включён Telnet, но скрипт пытается включить его сам через запрос telnet.gch. У некоторых моделей пароль Telnet отличается от пароля веб-интерфейса, поэтому можно передать --telnet-password.
Есть ли подводные камни при установке или что-то может не работать?Пароли для входа в веб-интерфейс меняются каждые несколько дней, поэтому скрипт читает конфигурацию по Telnet. Веб-сессия может быть заблокирована модемом; флаг --unlock перезапускает httpd, чтобы снять блокировку, а --no-release пропускает освобождение оставшихся веб-сессий.
Как он получает пароли?Он включает Telnet GET-запросом к telnet.gch, затем читает базу данных конфигурации устройства. Команда 'sidbg 1 DB decry' расшифровывает её без парольной фразы и выдаёт открытый XML. Пароль root — это хеш SHA-256 crypt в /etc/shadow; скрипт проверяет его по списку распространённых заводских паролей.
Почему бы просто не войти на веб-страницу?Пароли для веб-входа меняются через 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 дней