RustHound-CE命令行参数全清单:-d/-u/-H/-t/-c一个都不漏的实战速查
RustHound-CE命令行参数全清单:-d/-u/-H/-t/-c一个都不漏的实战速查
RustHound-CE 是一个用 Rust 编写的跨平台 Active Directory(AD)数据采集器,通过 LDAP(S) 或 ADWS 协议收集域内对象,并输出可直接导入 BloodHound Community Edition 的 JSON 文件。本文给出 RustHound-CE 命令行参数的完整清单,覆盖 -d、-u、-H、-k、-t、-c 等全部 30 余个参数,配合速查表、实战命令组合与常见坑位说明,适合新手收藏备用。
📌 RustHound-CE 是什么:30秒了解
| 特性 | 说明 |
|---|---|
| 定位 | BloodHound CE 的 AD 数据采集器(collector) |
| 实现语言 | Rust,可交叉编译出 Linux / Windows / macOS 静态二进制 |
| 传输协议 | LDAP(S) 或 ADWS(Active Directory Web Services,TCP 9389) |
| 输出 | 一组 JSON 文件,可导入 BloodHound CE 分析攻击路径 |
| 认证方式 | 用户名密码、NT 哈希(Pass-the-Hash)、Kerberos、客户端证书 |
一句话工作流:rusthound-ce 收集 → 生成 JSON(可 zip)→ 导入 BloodHound CE → 可视化最短攻击路径。
📋 RustHound-CE 命令行参数速查表(全清单)
以下参数来自 src/args.rs 中的 cli() 定义,与 rusthound-ce -h 输出一致:
必填参数(REQUIRED VALUES)
| 参数 | 长格式 | 作用 | 默认值 |
|---|---|---|---|
-d |
--domain |
必填,域名,如 DOMAIN.LOCAL |
— |
-v... |
— | 日志详细程度,可叠加(1次 Debug、2次 Trace) | Info |
可选取值(OPTIONAL VALUES)
| 参数 | 长格式 | 作用 | 默认值 |
|---|---|---|---|
-u |
--ldapusername |
LDAP 用户名,如 user@domain.local |
— |
-p |
--ldappassword |
LDAP 密码 | — |
-H |
--hashes |
NT 哈希(Pass-the-Hash),接受 NTHASH、:NTHASH、LMHASH:NTHASH |
— |
-f |
--ldapfqdn |
域控 FQDN,如 DC01.DOMAIN.LOCAL |
— |
-i |
--ldapip |
域控 IP,如 192.168.1.10 |
— |
-P |
--ldapport |
LDAP 端口(ADWS 模式下即 ADWS 端口) | 389(--ldaps 时 636) |
-n |
--name-server |
自定义 DNS 服务器 IP | — |
-o |
--output |
JSON 输出目录 | ./ |
证书认证(CERTIFICATE AUTHENTICATION)
| 参数 | 作用 |
|---|---|
--pfx |
PFX/PKCS#12 客户端证书(Pass-the-Certificate) |
--pfx-pass |
PFX 文件保护密码 |
--crt |
PEM 客户端证书(配合 --key) |
--key |
PEM 私钥(配合 --crt) |
可选标志(OPTIONAL FLAGS)
| 参数 | 长格式 | 作用 | 默认值 |
|---|---|---|---|
-t |
--transport |
传输协议:ldap 或 soap/adws |
ldap |
-c |
--collectionmethod |
收集方法(见下文 10 种取值) | All |
--ldap-filter |
— | 自定义 LDAP 过滤条件 | (objectClass=*) |
--ldaps |
— | 强制 LDAPS(ldaps://DOMAIN/) |
关 |
-k |
--kerberos |
使用 Kerberos 票据(读 ccache) | 关 |
--dns-tcp |
— | DNS 查询改用 TCP | 关 |
-z |
--zip |
将 JSON 压缩为 zip 归档 | 关 |
--cache |
— | 搜索结果落盘缓存,降低大域内存占用 | 关 |
--cache-buffer |
— | 缓存缓冲区大小 | 1000 |
--resume |
— | 从上次保存的状态恢复收集 | 关 |
可选模块(OPTIONAL MODULES)
| 参数 | 作用 |
|---|---|
--fqdn-resolver |
通过 DNS 解析计算机对象的 IP 地址 |
🔑 核心参数逐个精讲
-d 域名:唯一必填参数
所有命令必须提供 -d DOMAIN.LOCAL。这是整个采集的根。若不知道域控地址,可配合 -f(FQDN)或 -i(IP)直接指定,跳过部分 DNS 解析环节。
💡 特殊场景:通过 Makefile 的
make windows_noargs可编译出"无参数版"二进制,它会从本地 Windows 注册表自动读取域名并自动走 Kerberos 认证(对应 src/args.rs 的auto_args())。
-u / -p 用户名密码:Simple Bind 认证
最基础的认证方式。用户名推荐用 UPN 格式:
rusthound-ce -d north.sevenkingdoms.local -u 'jeor.mormont@north.sevenkingdoms.local' -p '_L0ngCl@w_' -o /tmp/demo -z
注意 Windows 下 cmd.exe 执行时不要加引号。
-H NT 哈希:Pass-the-Hash 免密码认证
只有哈希时用它,格式支持三种:NTHASH、:NTHASH、LMHASH:NTHASH:
rusthound-ce -d sevenkingdoms.local -u vagrant -H e02bc503339d51f71d913c245d35b50b -o /tmp/demo -z
-k Kerberos:从票据文件取凭据
在 Linux 上通过 KRB5CCNAME 环境变量指定 ccache 票据文件,-k 声明使用 Kerberos(GSSAPI)认证:
export KRB5CCNAME="/tmp/jeor.mormont.ccache"
rusthound-ce -d sevenkingdoms.local -f kingslanding -k -z
Windows 上 -k 则直接使用当前会话的 GSSAPI 凭据。
-t 传输协议:LDAP 还是 ADWS/SOAP
默认 -t ldap(端口 389/636)。-t soap(别名 adws,大小写不敏感)走 ADWS 协议(TCP 9389)——当 LDAP 被过滤或重点监控时常用,且 DC 会在内部代理到本地 LDAP,产出与 LDAP 路径完全相同的 BloodHound CE JSON。
rusthound-ce -d essos.local -u 'daenerys.targaryen' -p 'BurnThemAll!' -t soap -o /tmp/demo -z
⚠️ 注意:ADWS 目前仅支持 NTLM(密码或 -H 哈希),Kerberos 与证书认证暂未接入 ADWS 通道。
-c 收集方法:10 种取值决定"采多少、动多少机器"
这是最影响横向触达面的参数。各取值含义源自 src/args.rs 的 CollectionMethod 定义:
| 取值 | 采集内容 |
|---|---|
All(默认) |
LDAP/ADWS + 会话 RPC(SRVSVC/WKSSVC/WINREG)+ SMB 读 SYSVOL + 本地组 |
DCOnly |
只接触域控:LDAP + SYSVOL,不连接任何成员机器 |
Session |
LDAP + 通过 RPC 收集用户会话 |
RegistryOnly |
LDAP + WINREG 注册表收集 |
LdapOnly |
纯 LDAP,不碰机器、不碰 SYSVOL |
GPOLocalGroup |
LDAP + SMB SYSVOL 读取 GPO 本地组成员 |
LocalGroup |
LDAP + SAMR 读取 BUILTIN 别组成员 |
WebClient |
LDAP + SMB WebDAV 管道探测(IsWebClientRunning) |
CARegistry |
LDAP + MS-RRP WinReg 读取 CA 注册表值(ESC 相关) |
SOAPOnly / ADWSOnly |
仅 ADWS 目录读取(必须搭配 -t soap) |
踩坑提醒:-c SOAPOnly 单独使用会直接报错退出,必须搭配 -t soap:
-c SOAPOnly or -c ADWSOnly requires --transport soap or -t adws
⚡ 常用辅助参数速查
| 参数 | 何时用 | 示例 |
|---|---|---|
--ldaps |
目标只开放 636 / 需加密 | rusthound-ce -d essos.local --ldaps -u user -p pwd -z |
-P |
非标准端口(LDAP 或 ADWS) | --ldaps -P 3636 或 -t soap -P 9389 |
-f / -i |
绕过 SRV 记录、直指某台 DC | -f kingslanding 或 -i 192.168.56.11 |
--ldap-filter |
缩小采集范围、降低噪音 | --ldap-filter '(objectClass=computer)' |
-o / -z |
指定输出目录、压缩输出 | -o /tmp/demo -z |
--fqdn-resolver |
给计算机对象补上真实 IP | 配合 --dns-tcp -n 192.168.56.12 指定 DNS |
--cache / --cache-buffer |
超大域防止内存吃满 | --cache --cache-buffer 10000 |
--resume |
中断后从 .rusthound-cache/ 断点续采 |
rusthound-ce -d essos.local -o /tmp/demo -z --resume |
--pfx / --crt+--key |
证书认证(Pass-the-Certificate) | 默认 StartTLS 389,加 --ldaps 走 636 |
-v |
排错时看详细日志 | -v(Debug)、-v -v(Trace) |
💡 证书认证模式下没有可用 SMB 凭据,SMB 类模块(会话、GPO/SYSVOL)会自动跳过,LDAP 部分正常采集。
🛠 实战命令组合:直接复制可用
# 1) 最常用:用户名密码 + 压缩输出
rusthound-ce -d north.sevenkingdoms.local -u 'jeor.mormont@north.sevenkingdoms.local' -p '_L0ngCl@w_' -o /tmp/demo -z
# 2) 只碰域控的低噪音收集
rusthound-ce -c DCOnly -d north.sevenkingdoms.local -u 'jeor.mormont@north.sevenkingdoms.local' -p '_L0ngCl@w_' -o /tmp/demo -z
# 3) ADWS 协议 + 仅 SOAP 收集
rusthound-ce -d essos.local -u 'daenerys.targaryen' -p 'BurnThemAll!' -t soap -c SOAPOnly -o /tmp/demo -z
# 4) LDAPS + 自定义端口 + 计算机 IP 解析
rusthound-ce -d essos.local --ldaps -P 3636 -u 'daenerys.targaryen@essos.local' -p 'BurnThemAll!' -o /tmp/demo --fqdn-resolver -z
# 5) 大域:磁盘缓存 + 断点续传
rusthound-ce -c All -d sevenkingdoms.local -u vagrant -p vagrant -o /tmp/demo -z --cache --cache-buffer 10000
rusthound-ce -d sevenkingdoms.local -o /tmp/demo -z --resume
# 6) 控制台输出重定向存档
rusthound-ce -d essos.local -u user@essos.local -p pwd -o /tmp/demo --fqdn-resolver > /tmp/rh_output 2>&1
完整参数帮助与更多示例见 HELP.md 与 README.md 的 Quick usage 章节;参数解析与校验逻辑在 src/args.rs 的 extract_args() 中。
🖼 采集结果长什么样
JSON 文件导入 BloodHound CE 后,即可查询任意对象之间的最短攻击路径。下图是 essos.local 测试域的示例,RustHound-CE 采集的结果与 SharpHound 的产出等效:
❓ 常见问题(FAQ)
Q1:-H 到底能写几种格式?
三种都认:NTHASH、:NTHASH、LMHASH:NTHASH。
Q2:Windows 上 -k 还需要 -u 吗?
不需要。Windows 下 -k 直接复用当前会话的 GSSAPI 凭据;Linux 下 -k 从 KRB5CCNAME 指向的 ccache 文件取票据。
Q3:证书认证默认走哪个端口?
--pfx/--crt 默认 LDAP 389 + StartTLS;目标 DC 拒绝 StartTLS 时加 --ldaps 改走 636。
Q4:想只看日志排错怎么加?
-v 出现 1 次为 Debug,2 次及以上为 Trace(见 src/args.rs)。
Q5:如何构建跨平台二进制?
用 Makefile 里的 make release(本机)、make windows、make linux 等目标,或 cargo install rusthound-ce 直接安装。
✅ 小结
RustHound-CE 的命令行参数围绕一条主线展开:-d 定域 → -u/-p/-H/-k/证书 四选一认证 → -t 选 LDAP 或 ADWS → -c 控制采集广度 → -o/-z 决定输出。记住这张速查表,基本可以覆盖从日常采集到低噪音、大域、断点续采的所有场景。

