Hut-hzf/ung220z-tool
安全通过 Telnet 从自己的 UNG220Z 光猫中提取当前有效的管理、PPPoE、WiFi 与 root 凭据。
项目介绍
UNG220Z(九联 / Unionman 中国移动光猫)的 Web 管理页基于 .gch CGI 框架,登录口令由 TR-069 定期轮换,用户从背面贴纸拿到的密码往往几天就失效。本工具通过光猫自身的 telnet.gch 接口打开 Telnet,登录 root shell,用 sidbg 1 DB decry 解密设备配置库,然后输出当前有效的 Web 账号、Telnet 口令、PPPoE、WiFi 密钥和 root 口令。适用场景是设备所有者找回忘记的管理密码、迁移宽带配置或做安全自查;未经授权对他人设备使用属于违法行为。
快速使用
前提:Python 3.8+(仅标准库,无需 pip 安装),电脑与光猫在同一局域网。在仓库目录执行:
python3 ung220z.py
脚本会依次询问光猫地址(默认 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
Web 会话被锁住时用 --unlock 重启 httpd;--no-release 跳过释放残留 Web 会话;当 Telnet 账号与 Web 口令不同时,用 --telnet-user、--telnet-password 覆盖默认的 CMCCAdmin。成功后输出凭据汇总表,并在当前目录写入 ung220z_<时间戳>.log。
工作原理
工具先请求 /usr=<user>&psw=<pass>&cmd=1&telnet.gch,返回 TelnetSet Success! 即打开 Telnet,随后探测 23 端口并以 root 登录。Web 密码前端只做 base64,Frm_Logintoken 每次响应递增,必须回填实时值。sidbg 1 DB decry /userconfig/cfg/db_user_cfg.xml 无需口令即可解出明文配置;root 口令则取 /etc/shadow 中的 SHA-256 crypt 哈希与常见出厂口令比对。参数和流程详见 用法与参数说明。
使用约束
- 仅针对 UNG220Z(九联 / 中国移动)机型,依赖该型号的 CGI 接口和
sidbg命令。 - 必须与光猫在同一局域网内运行,Telnet 需已开启或能被
telnet.gch打开。 - 输出日志包含明文凭据,需妥善保存并及时删除,不要外传。
- 只能用于自己拥有或负责管理的设备,MIT 许可证不构成访问他人设备的授权。
HotRepo 点评
该项目在 HotRepo 新项目榜 2026-11-17 的记录中,约 1.5 小时的统计窗口内新增 41 Star 和 9 Fork,累计到 146 Star、43 Fork,没有记录到 GitHub 日榜名次。只有这一段短窗口数据,说明的是发布初期的一次性关注,而不是持续采用。它对使用者的价值主要在于针对具体机型的逆向细节:telnet.gch 开启方式、Frm_Logintoken 回填逻辑,以及无需口令的 sidbg 1 DB decry;在真实光猫上运行前,值得先核对这些部分。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。