brute

brute 库是弱口令爆破框架，内置对多种协议/服务（如 SSH、FTP、数据库、Web 等）的爆破插件，支持自定义用户名/密码字典、并发控制与自定义校验回调，是认证安全评估的核心工具。

典型使用场景：

选择爆破类型：brute.GetAvailableBruteTypes 列出支持的服务类型，brute.New(type, opts...) 创建爆破器并对目标执行。
字典管理：brute.userList / brute.passList 指定字典，brute.autoDict 启用内置字典，brute.GetUsernameListFromBruteType / brute.GetPasswordListFromBruteType 取出某类型的内置字典。
速率与策略：brute.concurrent / brute.concurrentTarget 控制并发，brute.minDelay / brute.maxDelay 控制节流，brute.okToStop / brute.finishingThreshold 控制命中后停止，brute.bruteHandler 自定义校验逻辑。

与相邻库的关系：brute 常接在资产发现之后——synscan/servicescan 找到开放服务，brute 对其做口令爆破，命中结果可经 risk 记录、report 汇总。

共 21 个函数

函数索引

函数	参数	返回值	说明
brute.GetAvailableBruteTypes	-	`[]string`	返回当前支持的所有内置爆破类型(协议/服务)名称列表
brute.GetPasswordListFromBruteType	`t string`	`[]string`	返回指定爆破类型对应的内置密码字典
brute.GetUsernameListFromBruteType	`t string`	`[]string`	返回指定爆破类型对应的内置用户名字典
brute.autoDict	-	`BruteOpt`	根据爆破类型自动加载内置的用户名与密码字典
brute.bruteHandler	`cb func(item bruteutils.BruteItem) bruteutils.BruteItemResult`	`BruteOpt`	自定义爆破的核心处理函数，覆盖默认的协议爆破逻辑
brute.concurrent	`c int`	`BruteOpt`	设置单个目标内部的并发尝试数量
brute.concurrentTarget	`c int`	`BruteOpt`	设置同时进行爆破的目标数量(默认 256)
brute.debug	`b bool`	`BruteOpt`	设置爆破器是否开启调试模式，开启后会输出更详细的过程日志
brute.finishingThreshold	`i int`	`BruteOpt`	设置单个目标的失败容忍阈值，连续失败达到该值后提前结束该目标的爆破
brute.maxDelay	`max int`	`BruteOpt`	设置每个目标两次尝试之间的最大间隔秒数
brute.minDelay	`min int`	`BruteOpt`	设置每个目标两次尝试之间的最小间隔秒数
brute.okToStop	`b bool`	`BruteOpt`	设置当某个目标爆破出有效凭据后是否立即停止对该目标的后续尝试
brute.oracleEncryption	`policy string`	`BruteOpt, error`	设置原生加密策略：accepted/rejected/requested/required。
brute.oracleSID	`sid string`	`BruteOpt`	使用指定 SID 连接 Oracle，替代 SERVICE_NAME。
brute.oracleSysDBA	`enabled bool`	`BruteOpt`	显式选择 SYSDBA 模式；默认仅用户名 SYS 自动启用。
brute.oracleTimeout	`seconds float64`	`BruteOpt, error`	设置整个凭证验证的秒数预算，所有服务和重试共享，最多 20 秒。

可变参数函数索引

函数	参数	返回值	说明
brute.New	`typeStr string, opts ...BruteOpt`	`*yakBruter, error`	创建一个指定类型的弱口令爆破器，可通过选项配置字典、并发、延迟等，再调用 Start 对目标执行爆破
brute.oracleService	`services ...string`	`BruteOpt`	指定 Oracle SERVICE_NAME 候选，不再猜测默认服务名。
brute.oracleTLS	`serverName string, caPEM ...string`	`BruteOpt, error`	强制使用 TCPS 并校验证书，失败不会退回明文。
brute.passList	`passes ...string`	`BruteOpt`	设置爆破使用的密码字典
brute.userList	`users ...string`	`BruteOpt`	设置爆破使用的用户名字典

函数详情

GetAvailableBruteTypes

GetAvailableBruteTypes() []string

返回当前支持的所有内置爆破类型(协议/服务)名称列表

在 yak 中通过 brute.GetAvailableBruteTypes 调用

返回值

序号	类型	说明
r1	`[]string`	支持的爆破类型名称字符串切片，如 ssh、ftp、redis、mysql 等

示例

types = brute.GetAvailableBruteTypes()
assert len(types) > 0, "should expose builtin brute types"
// 常见服务 ssh 应在支持列表中
println("ssh" in types)   // OUT: true
assert "ssh" in types, "ssh brute type should be available"

GetPasswordListFromBruteType

GetPasswordListFromBruteType(t string) []string

返回指定爆破类型对应的内置密码字典

在 yak 中通过 brute.GetPasswordListFromBruteType 调用

参数

参数名	类型	说明
t	`string`	爆破类型名称，如 ssh、mysql

返回值

序号	类型	说明
r1	`[]string`	该类型的内置密码候选列表

示例

passwords = brute.GetPasswordListFromBruteType("ssh")
assert len(passwords) > 0, "ssh password dict should not be empty"

GetUsernameListFromBruteType

GetUsernameListFromBruteType(t string) []string

返回指定爆破类型对应的内置用户名字典

在 yak 中通过 brute.GetUsernameListFromBruteType 调用

参数

参数名	类型	说明
t	`string`	爆破类型名称，如 ssh、mysql

返回值

序号	类型	说明
r1	`[]string`	该类型的内置用户名候选列表

示例

users = brute.GetUsernameListFromBruteType("ssh")
assert len(users) > 0, "ssh username dict should not be empty"

autoDict

autoDict() BruteOpt

根据爆破类型自动加载内置的用户名与密码字典

在 yak 中通过 brute.autoDict 调用

返回值

序号	类型	说明
r1	`BruteOpt`	一个 brute.New 可接收的配置选项

示例

// 该示例为示意性用法：自动使用内置字典
bruter = brute.New("ssh", brute.autoDict())~

bruteHandler

bruteHandler(cb func(item *bruteutils.BruteItem) *bruteutils.BruteItemResult) BruteOpt

自定义爆破的核心处理函数，覆盖默认的协议爆破逻辑

在 yak 中通过 brute.bruteHandler 调用

参数

参数名	类型	说明
cb	`func(item bruteutils.BruteItem) bruteutils.BruteItemResult`	处理单个爆破项并返回结果的回调函数

返回值

序号	类型	说明
r1	`BruteOpt`	一个 brute.New 可接收的配置选项

示例

// 该示例为示意性用法：自定义爆破处理逻辑

	bruter = brute.New("ssh", brute.bruteHandler(func(item) {
	    return item.Result()
	}))~

concurrent

concurrent(c int) BruteOpt

设置单个目标内部的并发尝试数量

在 yak 中通过 brute.concurrent 调用

参数

参数名	类型	说明
c	`int`	单目标并发数

返回值

序号	类型	说明
r1	`BruteOpt`	一个 brute.New 可接收的配置选项

示例

// 该示例为示意性用法：单目标并发设为 1
bruter = brute.New("ssh", brute.concurrent(1))~

concurrentTarget

concurrentTarget(c int) BruteOpt

设置同时进行爆破的目标数量(默认 256)

在 yak 中通过 brute.concurrentTarget 调用

参数

参数名	类型	说明
c	`int`	并发目标数量

返回值

序号	类型	说明
r1	`BruteOpt`	一个 brute.New 可接收的配置选项

示例

// 该示例为示意性用法：同时爆破 10 个目标
bruter = brute.New("ssh", brute.concurrentTarget(10))~

debug

debug(b bool) BruteOpt

设置爆破器是否开启调试模式，开启后会输出更详细的过程日志

在 yak 中通过 brute.debug 调用

参数

参数名	类型	说明
b	`bool`	是否开启调试

返回值

序号	类型	说明
r1	`BruteOpt`	一个 brute.New 可接收的配置选项

示例

// 该示例为示意性用法：开启调试模式
bruter = brute.New("ssh", brute.debug(true))~

finishingThreshold

finishingThreshold(i int) BruteOpt

设置单个目标的失败容忍阈值，连续失败达到该值后提前结束该目标的爆破

在 yak 中通过 brute.finishingThreshold 调用

参数

参数名	类型	说明
i	`int`	失败阈值

返回值

序号	类型	说明
r1	`BruteOpt`	一个 brute.New 可接收的配置选项

示例

// 该示例为示意性用法：设置失败阈值
bruter = brute.New("ssh", brute.finishingThreshold(50))~

maxDelay

maxDelay(max int) BruteOpt

设置每个目标两次尝试之间的最大间隔秒数

在 yak 中通过 brute.maxDelay 调用

参数

参数名	类型	说明
max	`int`	最大间隔(秒)

返回值

序号	类型	说明
r1	`BruteOpt`	一个 brute.New 可接收的配置选项

示例

// 该示例为示意性用法：设置最大间隔 5 秒
bruter = brute.New("ssh", brute.maxDelay(5))~

minDelay

minDelay(min int) BruteOpt

设置每个目标两次尝试之间的最小间隔秒数

在 yak 中通过 brute.minDelay 调用

参数

参数名	类型	说明
min	`int`	最小间隔(秒)

返回值

序号	类型	说明
r1	`BruteOpt`	一个 brute.New 可接收的配置选项

示例

// 该示例为示意性用法：设置最小间隔 1 秒
bruter = brute.New("ssh", brute.minDelay(1))~

okToStop

okToStop(b bool) BruteOpt

设置当某个目标爆破出有效凭据后是否立即停止对该目标的后续尝试

在 yak 中通过 brute.okToStop 调用

参数

参数名	类型	说明
b	`bool`	命中后是否停止

返回值

序号	类型	说明
r1	`BruteOpt`	一个 brute.New 可接收的配置选项

示例

// 该示例为示意性用法：命中即停止
bruter = brute.New("ssh", brute.okToStop(true))~

oracleEncryption

oracleEncryption(policy string) (BruteOpt, error)

设置原生加密策略：accepted/rejected/requested/required。

required 要求原生加密，不会静默降级；此选项独立于 TCPS。

参数

参数名	类型	说明
policy	`string`

返回值

序号	类型	说明
r1	`BruteOpt`
r2	`error`

示例

enc = brute.oracleEncryption("required")~
b = brute.New("oracle", enc)~

oracleSID

oracleSID(sid string) BruteOpt

使用指定 SID 连接 Oracle，替代 SERVICE_NAME。

参数

参数名	类型	说明
sid	`string`

返回值

序号	类型	说明
r1	`BruteOpt`

示例

b = brute.New("oracle", brute.oracleSID("ORCL"))~

oracleSysDBA

oracleSysDBA(enabled bool) BruteOpt

显式选择 SYSDBA 模式；默认仅用户名 SYS 自动启用。

参数

参数名	类型	说明
enabled	`bool`

返回值

序号	类型	说明
r1	`BruteOpt`

示例

b = brute.New("oracle", brute.oracleSysDBA(false))~

oracleTimeout

oracleTimeout(seconds float64) (BruteOpt, error)

设置整个凭证验证的秒数预算，所有服务和重试共享，最多 20 秒。

参数

参数名	类型	说明
seconds	`float64`

返回值

序号	类型	说明
r1	`BruteOpt`
r2	`error`

示例

timeoutOpt = brute.oracleTimeout(15)~
b = brute.New("oracle", timeoutOpt)~

可变参数函数详情

New

New(typeStr string, opts ...BruteOpt) (*yakBruter, error)

创建一个指定类型的弱口令爆破器，可通过选项配置字典、并发、延迟等，再调用 Start 对目标执行爆破

在 yak 中通过 brute.New 调用

必填参数

参数名	类型	说明
typeStr	`string`	爆破类型名称，如 ssh、mysql、redis

可选参数

参数名	类型	说明
opts	`...BruteOpt`	可选配置项，如 brute.userList、brute.passList、brute.concurrent 等

返回值

序号	类型	说明
r1	`*yakBruter`	爆破器对象，可调用 Start(targets...) 执行爆破
r2	`error`	错误信息，类型不支持时非 nil

示例

// 该示例为示意性用法：对目标执行 ssh 弱口令爆破
bruter = brute.New("ssh",

	brute.userList("root", "admin"),
	brute.passList("123456", "password"),
	brute.concurrent(1),

)~
res = bruter.Start("127.0.0.1:22")~

	for item = range res {
	    if item.Ok {
	        println("found:", item.Username, item.Password)
	    }
	}

oracleService

oracleService(services ...string) BruteOpt

指定 Oracle SERVICE_NAME 候选，不再猜测默认服务名。

可选参数

参数名	类型	说明
services	`...string`

返回值

序号	类型	说明
r1	`BruteOpt`

示例

b = brute.New("oracle", brute.oracleService("SALES_PDB"))~

oracleTLS

oracleTLS(serverName string, caPEM ...string) (BruteOpt, error)

强制使用 TCPS 并校验证书，失败不会退回明文。

serverName 为空时按目标主机校验；可选 caPEM 指定信任的 PEM CA，省略时用系统 CA。

必填参数

参数名	类型	说明
serverName	`string`

可选参数

参数名	类型	说明
caPEM	`...string`

返回值

序号	类型	说明
r1	`BruteOpt`
r2	`error`

示例

tlsOpt = brute.oracleTLS("db.example.com")~
b = brute.New("oracle", brute.oracleService("SALES"), tlsOpt)~

passList

passList(passes ...string) BruteOpt

设置爆破使用的密码字典

在 yak 中通过 brute.passList 调用

可选参数

参数名	类型	说明
passes	`...string`	一个或多个密码

返回值

序号	类型	说明
r1	`BruteOpt`	一个 brute.New 可接收的配置选项

示例

// 该示例为示意性用法：指定密码字典
bruter = brute.New("ssh", brute.passList("123456", "password"))~

userList

userList(users ...string) BruteOpt

设置爆破使用的用户名字典

在 yak 中通过 brute.userList 调用

可选参数

参数名	类型	说明
users	`...string`	一个或多个用户名

返回值

序号	类型	说明
r1	`BruteOpt`	一个 brute.New 可接收的配置选项

示例

// 该示例为示意性用法：指定用户名字典
bruter = brute.New("ssh", brute.userList("root", "admin"))~

函数索引​

可变参数函数索引​

函数详情​

GetAvailableBruteTypes​

GetPasswordListFromBruteType​

GetUsernameListFromBruteType​

autoDict​

bruteHandler​

concurrent​

concurrentTarget​

debug​

finishingThreshold​

maxDelay​

minDelay​

okToStop​

oracleEncryption​

oracleSID​

oracleSysDBA​

oracleTimeout​

可变参数函数详情​

New​

oracleService​

oracleTLS​

passList​

userList​

函数索引

可变参数函数索引

函数详情

GetAvailableBruteTypes

GetPasswordListFromBruteType

GetUsernameListFromBruteType

autoDict

bruteHandler

concurrent

concurrentTarget

debug

finishingThreshold

maxDelay

minDelay

okToStop

oracleEncryption

oracleSID

oracleSysDBA

oracleTimeout

可变参数函数详情

New

oracleService

oracleTLS

passList

userList