别急着夸:只认一款型号的脚本,解决的其实是少数人的真问题
别急着夸:只认一款型号的脚本,解决的其实是少数人的真问题
一个 442 行、只用标准库、只有一次 commit 的 Python 脚本,几天内拿到 1.1k star、273 fork。按 GitHub 的常规经验,这个比例组合很反常:star 数是 fork 数的四倍出头,意味着大量人是"先收藏、再打算改",而不是"直接拿来用"。更有意思的是,仓库开出的三个 issue 里,没有一个是报 bug 的细节,全是同一个问题的三种问法:电信能用吗、联通能用吗、我这台型号为什么返回 400。
这三个问题恰好说明了窄口径工具的真实处境。它解决的是真问题,但只对一小撮人真;它被传播得很广,但被使用的范围可能远小于 star 数暗示的规模。本文不谈情怀,只把仓库源码、issue 现场和社区里的实际操作记录摆在一起,看这个工具到底做到了什么,又在哪里停下了。
一、先看数据:热度与适配面不是一回事
仓库的元数据很干净:MIT 协议,一个 commit,提交信息写得很规矩,把"交互输入、拼 telnet.gch、Telnet 拿 shell、解密配置库、打印汇总"五个环节列成了清单。代码结构也确实按这五步走,没有多余的抽象层。这种"一次成型"的小工具在传播上有一个天然优势——读者能在五分钟内读完 核心脚本,判断它是不是自己要的东西。
但"读完就能判断"和"读完就能用"是两件事。仓库的三条 issue 都在 2026 年 11 月 17 日至 18 日之间开出,也就是项目公开后的两三天内,说明关注度来得很快;而其中两条至今没有作者回复,说明维护带宽跟不上传播速度。这不是道德问题,是单点工具在走红之后的必然结果:一个人的一次成功实践,被当成了通用方案来提问。
fork 数比 star 数更能说明问题。273 次 fork 里,绝大多数动机不会是"我要给它提 PR",而是"我这台机器得改改"。换句话说,用户在用 fork 投票,表达的是"你的思路我认,但你的假设我不认"。
二、天花板不在代码质量,在固件假设
把失败案例摊开看,三条 issue 指向同一个技术根因。
issue #3 里出现了两台设备:一台移动的 HG6042A1,一台硬件型号 GM232、固件 V1A0.A04.01 的设备。前者的日志里连续两次 HTTP Error 400: Bad Request,随后第三个变体请求返回了一段 function frmLoad() { XHR.get("get_factory_mode", ...) 的 JS;后者两次 404,并附带一句非常关键的服务器指纹:The requested URL 'GET' was not found on this server. [Mini web server]。
这句话说明,对面根本不是同一套 Web 服务。脚本能跑通的那台设备,其 .gch CGI 是按"原始路径"分发的;换一台设备,路径解析规则变了,同一个字符串就成了非法请求。
问题的源头在 ung220z.py 第 127 行:
raw = "%susr=%s&psw=%s&cmd=1&telnet.gch" % (base, user, pw)
注意这里没有 ?。它拼出来的不是标准 HTTP 查询串,而是 http://192.168.1.1/usr=user&psw=xxx&cmd=1&telnet.gch 这样一个"整段当路径"的 URL。这种写法在部分九联/吉比特系固件上确实有效,社区里的手工教程也是这么传的,但它是设备端的一个实现怪癖,不是协议。脚本把怪癖当成了方法,于是第 128 至 133 行只能靠穷举三个变体来兜底:原始串、全量 quote 后的串、以及加 ? 的串。三个变体覆盖不了 /webcmcc/telnet.html、telnet?enable=1&key=... 这类其他厂商的入口——社区资料里这些入口各有各的形态,本来就是碎片化的。
更值得注意的是第 345 到 348 行的失败处理:
log("PROBE", "nc -zv %s 23 → %s" % (ip, "timed out" if not probe_port(ip, 23) else "succeeded"))
if not probe_port(ip, 23):
log("WARN", "23 端口未开放(密码可能已轮换,重跑脚本)")
return 3
这里把"23 端口没开"归因为"密码可能已轮换"。但对 issue #3 那两台设备来说,telnet.gch 返回的是 400 和 404,也就是说开 Telnet 这一步压根没成功,端口当然不会开——重跑一百次也不会变。这条提示语会把人引向错误的方向:用户会以为是自己密码过期,实际是机型不支持。
三、"少数人的真问题"到底有多真
把视角从代码挪到用户身上,这个工具瞄准的痛点其实非常具体,而且高度集中在"装完宽带之后的第二次配置"这个时刻。
恩山论坛上一篇 2024 年 12 月 28 日开的帖子,标题就是"移动的九联光猫,型号 UNG220Z,开启 telnet 仍无法成功登录"。楼主的过程是这样的:telnet 开成功了,但 CMCCAdmin / aDm8H%MdA 登不进去,卡住。中间有人提示"UNG220Z 早期是这个,后续固件升级后就不是这个了",还有人给出 user / nE7jA%5m,楼主回了一句"你这个是自己光猫后面贴的密码,不是超级密码,进不了管理后台设置 IPTV 单线复用"。
这条线索非常关键:用户的真实目标不是"拿到密码"本身,而是"把 IPTV 单线复用配起来"、"把闲置的 LAN 口放出来"、"改成桥接用自己的路由器拨号"。密码只是路径上的一个关卡。
帖子从 2024 年 12 月一直悬到 2025 年 8 月 14 日,第 13 楼给出答案:用户名 admin,密码是设备背面的 SN 码。第 14 楼的回复是整件事最传神的一句——"笑死,搞半天发现超级密码就没变"。第 15 楼楼主确认可用,说"果然三步之内必有解药"。
八个月,3112 次浏览,14 条回复,最后答案是"翻过来看贴纸"。这就是窄口径工具面对的真实世界:技术难点往往不在密码学,而在信息检索和试错成本。
另一篇 2026 年 10 月 12 日的帖子把完整手工流程写了下来:普通用户登录后台,访问带 usr= 和 psw= 的 telnet.gch 链接,看到 TelnetSet Success!,然后 telnet 192.168.1.1,用 admin 加 SN 码登录,cd /userconfig/cfg/,sidbg 1 DB decry /userconfig/cfg/db_user_cfg.xml,再到 /tmp 下 grep 明文配置,最后嫌终端里看不清,用 udpsvd 起 TFTP 把文件拉到本地。整篇帖子浏览量只有 451,回复 1 条。
对比之下,CSDN 上同主题的几篇文章数据高得多:一篇讲 UNG220Z 超密的文章 6.6k 阅读、8 收藏,一篇讲广电单线复用与双 WAN 聚合的 8.8k 阅读、27 收藏,一篇泛讲"如何拿到光猫超级密码"的 1.05 万阅读。这些数字说明需求客观存在,但也说明需求是分散的:每个人遇到的型号、固件、运营商都不同,一篇教程只能命中一小片。
那么这类工具的价值究竟在哪?在于把"翻论坛八个月"压缩成"跑一条命令"。这个价值是真实的,但它有一个硬性上限:同一台光猫,用户一辈子可能只需要成功一次。低频、单次、强场景,这三个特征决定了它的天花板不在技术,而在需求频次。
四、拆开脚本:哪些是可复用的工程,哪些是写死的机型
要判断这个项目离"可复用方法"还有多远,得把 442 行分成两堆。
先说真正有价值、且与机型无关的部分。
第 155 到 173 行的 _parse 是一个精简的 Telnet 选项协商处理器:遇到 IAC DO/DONT/WILL/WONT 统一回 WONT/DONT,遇到子协商 SB...SE 直接跳过,其余字节原样落到输出缓冲。这段代码不长,但它解决的是"裸 socket 连上去满屏乱码"这个实际障碍,实测在很多嵌入式 busybox telnetd 上都稳。
第 236 到 250 行的 run 用了一个很实用的技巧:发完命令后补一句 echo __X__,然后读到这个哨兵字符串为止,再用它切掉回显。对于没有固定提示符、或者提示符会随目录变化的 shell,这比匹配 # 或 $ 可靠得多。
第 49 到 54 行的 dwidth 和 pad,按东亚字符宽度计算列宽,让"Telnet / root shell"和"Web 超管"这些中英混排的标签在终端里对齐。这是小事,但很多同类脚本的输出是一团乱麻,这个细节说明作者确实跑过、看过输出。
第 104 到 122 行的 unlock_web 也值得一提:它检测到 Web 被单会话锁占住时,从 ps 里找出 httpd 的 pid,kill 掉,然后轮询 12 秒等父进程把它拉起来。这个思路对应的是一个真实故障——很多光猫的 Web 管理页只允许一个会话,前一次没正常退出,后面就再也登不进去。
再说写死的部分,它们构成了适配的天花板:
| 位置 | 写死的内容 | 换机型后的后果 |
|---|---|---|
| ung220z.py 第 34 行 | CFG_ENC = "/userconfig/cfg/db_user_cfg.xml" |
配置在 /config/ 或文件名是 db_default_cfg.xml 时直接失效 |
| 第 261 行 | sed -n '/<Tbl name="%s"/,/<\\/Tbl>/p' |
表名或 XML 结构不同则抓不到 |
| 第 369 行 | 只调 sidbg 1 DB decry |
用 sendcmd 的固件没有回退路径 |
| 第 32 行 | TELNET_USER = "CMCCAdmin" |
有的设备是 admin,有的要求 root |
| 第 229 行 | 登录成功判定 / # |
提示符是 #、/tmp #、~ # 时误判为失败 |
| 第 99 行 | if "其他用户" in body |
英文界面的 "Another user" 识别不到 |
| 第 412 行 | 候选口令只有五个 | 覆盖不到运营商改过的口令 |
这些不是"写得不优雅",而是"把一个机型的观测结果直接当成了常量"。第 377 到 407 行解析 DevAuthInfo、TelnetUser、TS_UPwd、WANCPPP、WLANCfg、WLANPSK 六张表的逻辑本身是对的,问题只在于名字是硬编码的。如果把表名、字段名、解密命令、提示符抽成一份"机型描述",代码结构几乎不用动,可覆盖范围就能翻好几倍。这也是这个项目距离"可复用方法"真正的距离——不是几百行代码,而是三层抽象:入口端点、凭据推导链、配置读取后端。
五、在夸之前,有四个问题必须先说清
评价一个安全类工具,功能是否跑通只是一半,另一半是它有没有制造新的风险。这个脚本在这方面有几处需要点明。
第一,口令会以明文写进日志。 第 342 行打日志时是脱敏的:
log("INFO", "补全 URL: http://%s/usr=%s&psw=***&cmd=1&telnet.gch" % (ip, user))
但第 137 行不是:
log("HTTP", "已发送给浏览器%s: %s" % ("" if opened else "(无可用浏览器,改由脚本直连)", raw))
raw 里含完整密码。而第 305 到 306 行在程序一启动就打开了日志文件 ung220z_<时间戳>.log,所有 log() 输出都会落盘。issue #3 里那位用户的日志就实打实地留下了 psw=eTmVWFf#——注意这个 #,它同时也暴露了另一个 bug:URL 里的 # 会被浏览器当作片段分隔符,# 之后的内容根本不会发给服务器,所以带 # 的密码必然开启失败。仓库的 .gitignore 里加了 *.log 和 ung220z_*.log,说明作者意识到了日志敏感,但默认行为仍然是"写到当前目录",而不是"默认不写或默认脱敏"。
第二,"释放会话成功"是假阳性。 第 84 到 90 行的 release_session 只要 POST 拿到 HTTP 200 就返回 True,可设备对一个并不存在的会话执行 logout=1 同样会返回 200。于是日志里出现"释放残留 Web 会话 → ok",用户以为环境干净了。issue #3 的现场正好是反例:日志显示 释放残留 Web 会话 → ok,紧接着 telnet.gch 依然 400 和 404。这个 ok 没有验证语义,只有传输语义。
第三,失败归因是错的,而且两处文档自相矛盾。 前面提到第 347 行把"端口未开"说成"密码可能已轮换"。issue #3 里 Dragon307 的日志更能说明问题:HTTP telnet.gch → TelnetSet Success!,nc -zv → succeeded,说明 Telnet 开成功了、端口也通了,然后 AUTH Telnet CMCCAdmin / fr3k77ct → refused。这是Telnet 口令与 Web 口令不同,不是轮换。这位用户的追问"应该是 telnet 密码和 web 密码不一样,还有办法拯救一下吗",其实恰好被 README.md 第 61 行的参数说明预言了:--telnet-password 的注释就是"部分机型与 Web 口令不同"。工具知道这件事,但默认路径没有为它设计推导逻辑,只是把 Web 密码塞进候选列表碰运气。
至于"轮换"这个说法本身,两处表述还不一致:README.md 第 10 行说"普通用户拿到的密码往往几天就失效",而 ung220z.py 第 435 行说"口令每 15 分钟轮换"。两个数字差了两个数量级,都没有给出处。而恩山那篇帖子第 14 楼的结论——"搞半天发现超级密码就没变"——至少在 UNG220Z 这个机型上,直接反驳了"必然轮换"的前提。轮换可能在部分运营商的 TR-069 模板下存在,但把它写成普适规律,会让用户在真正失败时找不到方向。
第四,文档承诺与代码实现有出入。 README.md 第 84 行写"标准库即可,无需 pip 安装",Python 依赖确实为零,但第 277 到 288 行的 crack_root 会调用宿主机的 openssl passwd:
out = subprocess.run(["openssl", "passwd", algo, "-salt", salt, pw], ...)
Windows 上如果没有 OpenSSL,这一步会抛异常,函数返回 None,然后静默降级成"输出哈希片段"。另一处,README.md 第 94 行说 root 口令是"SHA-256 crypt",而代码第 278 行是 algo = "-5" if hashed.startswith("$5$") else "-6",实际同时处理 $5$ 和 $6$ 两种。还有第 92 行那句"密码前端只做 base64,Frm_Logintoken 每次响应递增,必须回填实时值"——这是一个关于 Web 登录的准确观察,但整份代码从未实现 Web 登录,它走的是 Telnet 路径。这条知识写在"原理说明"里没有错,但它会让读者误以为脚本处理了 token 回填。
六、从单型号到可复用方法,还差三张表
如果要把这个项目从"一条命令"升级成"一套方法",改动量其实不大,但顺序要换。
第一张表:入口端点。 现在第 125 到 151 行只穷举三种 URL 形态,且都围绕 .gch。更稳妥的做法是先探测、再下结论:对目标发一次无副作用的 GET,读服务器头或错误页指纹(issue #3 里那句 [Mini web server] 就是很好的判据),再决定用哪套入口。探不到就明确报"不支持",而不是用"密码可能已轮换"掩盖过去。
第二张表:凭据推导链。 Web 普通口令、Web 超管口令、Telnet 口令、SN 码派生口令、TS_UPwd,这几者在不同固件上的关系是固定的几种模式,而不是随机。恩山 2024 年那篇帖子的答案是 admin + SN,2026 年那篇的答案是 admin + SN、再用 sidbg 从 DevAuthInfo 里读出 CMCCAdmin 的真实口令,CSDN 上 UNG221N 的教程则是默认 CMCCAdmin / aDm8H%MdA 进去后直接 sidbg 1 DB set DevAuthInfo 0 Pass 改掉。把这些模式列成有序候选,比现在第 351 行把 Web 密码塞进列表末尾要有效得多。
第三张表:配置读取后端。 sidbg 和 sendcmd 是同一类 SDK 的两个命令名,db_user_cfg.xml 和 db_default_cfg.xml 是同一类配置库的两个文件名。第 369 行只试一种,第 34 行只认一个路径。加一层"命令与路径候选",配合 ls 与 which 的探测结果,就能覆盖相当一部分同源固件。
除了这三张表,还有两个设计取向值得调整。
一是先读后写。当前流程是"先开 Telnet、再探测端口、再登录",属于先改变设备状态再验证。更安全的顺序是先做只读能力探测,把所有判断做完,再决定要不要开 Telnet;第 359 到 363 行的 --unlock(kill httpd)这种动作,更应该显式二次确认,而不是在检测到 busy 时自动执行——万一设备的父进程没有按预期拉起 httpd,用户失去的是整个管理页面,只能断电重启。
二是按用途裁剪凭据。第 409 到 418 行会去 /etc/shadow 里捞 root 哈希并用五个常见口令比对。但从前面的社区案例看,用户的真实需求是改桥接、放 LAN 口、配 IPTV,这些用 Web 超管加 PPPoE 账号就够了。root shell 属于"能做但不必要",默认开启会显著抬高工具的风险等级,也会让这个项目更容易被误用。把它做成显式开关,比做成默认流程更合适。
七、该夸什么,不该夸什么
回到标题。这个脚本值得夸的地方很具体:它用 442 行、零第三方依赖,把一条原本散落在论坛回帖里的路径——开 Telnet、拿 shell、sidbg 解密、按表提取——固化成了可以重复执行的程序;它处理了 Telnet 协商、无提示符 shell 的输出切分、单会话锁这几个真实的坑;它的 README 把免责声明写在了最前面,没有包装成"通用光猫破解神器"。这些是实打实的工程劳动。
不该夸的地方同样具体:它把一台设备的固件行为当成了协议,于是 issue 区第一天就被"电信能用吗""联通能用吗"填满;它把失败归因给"密码轮换",掩盖了机型不匹配这个真正原因;它把明文口令写进默认日志,还顺手用 # 这类字符给自己挖了一个 URL 解析的坑;它的文档承诺与代码实现有几处对不上,其中"标准库即可"和"调用 openssl"这一对最容易让新用户在最后一步卡住。
窄口径不是原罪。一个只服务一款型号、只服务一次配置动作的工具,只要它把边界说清楚,就有存在价值——它让"翻八个月论坛"变成"跑一条命令",这本身就是效率。真正的问题是叙事:当一个窄工具被当作通用方案传播时,1.1k star 会变成 1.1k 次期待,而其中大部分人会在第一次 400 或第一次 refused 之后离开,并且不知道自己为什么失败。
对这类项目来说,最健康的归宿不是继续冲榜,而是变成一张更大的表里的一行:入口一行、凭据链一行、解密命令一行。到那时,"只认一款型号"就不再是缺陷,而是一个可以被组合的、诚实的能力声明。