<img width="2736" height="754" alt="01-nimux" src="https://assets.kitploit.com/production/public/readmes/42073/990b885e0d920b45be23f7fbd0a21cb6e755a01ed017ef57088549ce265638ca.png" />
<p align="center"><i>纯 Nim 网络枚举与远程执行工具包</i></p>
<p align="center">
<a href="https://github.com/blue0x1/nimux/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/badge/license-AGPL--3.0-blue"></a>
<a href="https://nim-lang.org"><img alt="Nim" src="https://img.shields.io/badge/language-Nim-f3d400"></a>
<a href="https://docs.nimux.wiki"><img alt="Docs" src="https://img.shields.io/badge/docs-docs.nimux.wiki-00bcd4"></a>
<a href="https://github.com/blue0x1/nimux/releases"><img alt="Release downloads" src="https://img.shields.io/github/downloads/blue0x1/nimux/total?label=downloads"></a>
</p>
# nimux - 原生操作员工具包
nimux 是一个用于授权安全评估的原生命令界面。它将网络枚举、轻量级 Web 发现、凭据验证、Active Directory 操作、Kerberos 工作流、远程执行、文件传输、机密收集、DCSync、GPO 操作、数据库客户端和 SOCKS 路由整合到一个纯 Nim 工具包中。
当前版本:`v1.0.7`
您正在访问 nimux 的官方公共仓库。
- 网站:https://nimux.wiki
- 文档:https://docs.nimux.wiki
- 源代码:https://github.com/blue0x1/nimux
## 声明
nimux 仅用于授权测试。未经书面许可,请勿将其用于第三方系统。开发者不对滥用、损害或法律后果承担责任。
# 文档
使用示例、命令参考和工作流说明均维护在文档中:
https://docs.nimux.wiki
# AI 集成
智能体指南和 MCP 集成文件位于 `SKILLS.md` 和 `integrations/` 中。
核心 `nimux` 二进制文件保持独立。AI 集成应将 `nimux` 作为原生执行引擎调用,优先使用 `--json`,在支持的写入操作前使用 `--dry-run`,并且执行或更改操作需要明确批准。
## MCP 封装
`nimux-mcp` 是面向 AI 客户端的独立 MCP stdio 封装。
位置:
```text
integrations/mcp/nimux-mcp
```
构建:
```bash
cd integrations/mcp/nimux-mcp
nimble build -y
```
示例 MCP 客户端配置:
```json
{
"mcpServers": {
"nimux": {
"command": "/path/to/nimux/integrations/mcp/nimux-mcp/nimux_mcp",
"env": {
"NIMUX_BIN": "/usr/local/bin/nimux",
"NIMUX_MCP_POLICY": "/path/to/policy.json"
}
}
}
}
```
该封装器支持 MCP `Content-Length` 分帧的 JSON-RPC、本地换行分隔的 JSON-RPC 测试、策略检查、审批门控、脱敏、进度通知以及 SOCKS 枢轴元数据。
延伸阅读:
https://docs.nimux.wiki/mcp-integration
# 安装
## Nimble
Nimble 会从源码构建 nimux,因此必须先安装原生开发库。在 Kali、Debian 或 Ubuntu 上:
```bash
sudo apt update
sudo apt install -y build-essential ca-certificates git libssl-dev libkrb5-dev
nimble install nimux
```
不要使用 `sudo` 运行 Nimble。如果 Nimble 报告 SSL 证书错误,请在重试前刷新系统 CA 存储:
```bash
sudo apt install --reinstall ca-certificates
sudo update-ca-certificates
nimble refresh
```
MinGW-w64 对于基础安装是可选的,但构建 Windows 辅助二进制文件的执行路径需要它:
```bash
sudo apt install -y mingw-w64
```
## 下载发布版本
GitHub 上提供了预构建的发布资源:
https://github.com/blue0x1/nimux/releases
从发布页面下载最新的 Linux 二进制文件或 Debian 软件包。
安装 Debian 软件包:
```bash
sudo dpkg -i nimux_*_amd64.deb
sudo apt --fix-broken install
```
使用独立的 Linux 二进制文件:
```bash
chmod +x nimux
./nimux --help
./nimux --version
```
## Docker
公共容器镜像可从 GitHub Container Registry 获取:
```bash
docker run --rm -it --network host ghcr.io/blue0x1/nimux:latest --help
```
运行扫描:
```bash
docker run --rm -it --network host ghcr.io/blue0x1/nimux:latest \
scan 10.10.10.0/24 --port 445,389,5985 --open
```
运行轻量级 Web 发现:
```bash
nimux http app.example.local --dirs words.txt --workers 100 --status 200,301,302,403 --baseline
nimux http app.example.local --dirs words.txt --auto-calibrate --recursion --depth 2 --extract-links
nimux http app.example.local --files words.txt --extensions php,txt,bak --workers 100 --filter-regex 'Not Found' -fs 325
nimux http 192.0.2.10 --vhosts vhosts.txt -d app.example.local --workers 100 --resume seen.jsonl --json
nimux dns app.example.local --subdomains subdomains.txt --workers 200 --json
```
运行只读 SMB 爬取:
```bash
nimux smb files01.example.local --shares
nimux smb files01.example.local --spider --share Public --max-depth 3
nimux smb files01.example.local --spider --interesting --size-limit 10485760
```
运行 MCP 包装器:
```bash
docker run --rm -i --network host --entrypoint nimux_mcp \
ghcr.io/blue0x1/nimux:latest
```
## Arch Linux AUR
nimux 已在 AUR 上提供:
https://aur.archlinux.org/packages/nimux
使用 AUR 助手安装:
```bash
yay -S nimux
```
或手动构建:
```bash
git clone https://aur.archlinux.org/nimux.git
cd nimux
makepkg -si
```
## BlackArch
nimux 已在 BlackArch 中提供:
```bash
sudo pacman -S nimux
```
## 从源码构建
```bash
git clone https://github.com/blue0x1/nimux
cd nimux
nimble build -y
```
要求:
- Nim 1.6.10 或更新版本
- OpenSSL 开发库
- Kerberos 库
- 用于某些执行路径的 Windows 辅助构建所需的 MinGW-w64
## Debian 软件包
从源代码构建本地 Debian 软件包:
```bash
dpkg-buildpackage -us -uc -b
sudo apt install ../nimux_*.deb
```
## 离线 BloodHound 检查
`bh` 在本地读取已保存的 BloodHound ZIP 文件。它提供清单、采集覆盖范围、对象搜索以及直接/嵌套组成员关系检查:
```bash
nimux bh collection.zip --summary
nimux bh collection.zip --interesting
nimux bh collection.zip --high-value
nimux bh collection.zip --search alice
nimux bh collection.zip --inspect '[email protected]'
nimux bh collection.zip --summary --json
nimux bh collection.zip --graph --high-value
nimux bh --help
```
`--interesting` 会高亮显示关键对象、特权账户、密码策略例外、陈旧活动以及收集缺口。`--high-value` 会显示被知名域 SID 标记或归类为高价值的对象。
### 图形输出
添加 `--graph` 可在终端中打印有向关系图。无需浏览器、数据库或网络连接。输出保留在正常的终端回滚缓冲区中,并且可以重定向。
```bash
nimux bh collection.zip --interesting --graph --limit 0
nimux bh collection.zip --graph --from '[email protected]' --to 'DOMAIN [email protected]'
nimux bh collection.zip --graph --inspect '[email protected]'
```
使用 `--user`、`--computer` 或 `--group` 将范围限定到单个对象:
```bash
nimux bh collection.zip --user alice --interesting
nimux bh collection.zip --computer dc01 --interesting
nimux bh collection.zip --group 'HELP DESK' --interesting
```
支持的输入:单卷、未加密的 ZIP,采用 BloodHound JSON schema v5 或 v6。无需外部工具;分析完全在进程内运行。
开发者检查:
```bash
nim c -r tests/test_bloodhound.nim
nim c -r tests/check_bloodhound_archives.nim /path/to/collection.zip
```
# 快速示例
```bash
nimux scan 10.10.10.0/24 --port 445,389,5985 --open
nimux smb dc01.example.local -u operator -H <nt_hash> -d example.local --shares --users
nimux smb files01.example.local -u operator -p '<password>' -d example.local --spider --max-depth 3 --interesting
nimux ldap dc01.example.local -u operator -p '<password>' -d example.local --bloodhound --legacy --bloodhound-out bh-legacy.zip
nimux winrm host.example.local -u operator -p '<password>' -d example.local --cmd whoami
nimux kerberos dc01.example.local -u operator -p '<password>' -d example.local --request kinit --out <ccache>
nimux scan 10.10.10.0/24 --port 445,389,5985 --proxy socks5://127.0.0.1:1080
```
ADCS 策略与证书工作流示例:
```bash
nimux ldap dc01.example.local -u '<gmsa-account>$' -H <nt_hash> -d EXAMPLE.LOCAL \
--adcs-policy --ca CORP-CA --adcs-get-disable-extension-list
nimux ldap dc01.example.local -u '<gmsa-account>$' -H <nt_hash> -d EXAMPLE.LOCAL \
--adcs-policy --ca CORP-CA \
--adcs-set-disable-extension-list 1.3.6.1.4.1.311.25.2
nimux ldap dc01.example.local -u <service-user> -p '<password>' -d EXAMPLE.LOCAL \
--adcs-request --adcs-rpc --ca CORP-CA --template User \
--upn <admin>@example.local \
--sid S-1-5-21-1111111111-2222222222-3333333333-500 \
--out <admin>.pfx
```
LDAP 捕获监听器:
```bash
nimux ldap --server
nimux ldap --server --srvhost 0.0.0.0 --srvport 2222
nimux ldap --server --srvhost 0.0.0.0 --srvport 2222 --challenge 1122334455667788
```
# 功能特性
- 支持 TCP 和 UDP 扫描,并配备协议感知探测
- 轻量级 HTTP 目录/文件/虚拟主机发现与 DNS 子域名发现
- SMB 认证、枚举、只读共享爬取、文件操作、强制认证及票据捕获工作流
- LDAP 与 Active Directory 枚举、写入、ACL 路径、roasting、RBCD、shadow credentials 及 ADCS 支持
- 兼容 BloodHound Legacy 4.x 的 LDAP 导出模式
- Kerberos TGT、TGS、S4U、ccache、kirbi、续期、清除及票据伪造工作流
- WinRM、WMI、SCM、DCOM、计划任务及辅助服务执行模式
- MSSQL、PostgreSQL、MySQL、HTTP、HTTPS、WebDAV、FTP、SSH、RDP、VNC、NFS 及 AFP 客户端
- SAM、LSA、缓存凭据、DPAPI 材料及原生 DCSync 操作
- GPO 发现、备份、文件操作、链接及策略修改工作流
- SOCKS 辅助程序部署及通过 `--proxy` 的全局 SOCKS5 路由
- 面向自动化的 JSON 输出
# 命令族
| 命令 | 用途 |
| --- | --- |
| `scan` | TCP 和 UDP 服务发现 |
| `smb` | SMB 枚举、认证检查、文件操作及强制认证 |
| `ldap` | AD 查询、写入、roasting、ACL、RBCD、shadow credentials、ADCS |
| `http`、`https`、`dns` | 轻量级 Web 与 DNS 发现 |
| `kerberos` | TGT、TGS、S4U、票据转换、续期、清除、伪造 |
| `winrm` | WinRM 命令执行、shell 及文件辅助工具 |
| `scm`、`bin`、`cim`、`tsch`、`mmc` | 远程执行传输方式 |
| `mssql`、`postgres`、`mysql` | 数据库协议客户端 |
| `secrets`、`dcsync` | 凭据材料与复制工作流 |
| `socks` | SOCKS 辅助程序部署 |
| `put`、`get`、`ls`、`mkdir`、`rm` | SMB 文件操作 |
# 开发
本地构建:
```bash
nimble build -y
```
运行命令帮助:
```bash
./nimux --help
./nimux smb --help
./nimux kerberos --help
```
# 致谢
Chokri Hammedi
<a href="https://www.buymeacoffee.com/blue0x1" target="_blank"><img src="https://assets.kitploit.com/production/public/readmes/42073/608ca47c77206e90cac89def2d3fa14b17084ebc4a0a8dce231e4f0b3a78be1a.webp" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a>
# 许可证
nimux 依据 GNU Affero 通用公共许可证 v3.0 发布。参见 [LICENSE](https://github.com/blue0x1/nimux/blob/main/LICENSE)。