
Pure-Nim toolkit de enumeración de red y ejecución remota para evaluaciones de seguridad autorizadas. Soporta SMB, LDAP, Kerberos, WinRM, clientes de bases de datos, recolección de secretos, DCSync, operaciones GPO y enrutamiento SOCKS.
<img width="2736" height="754" alt="01-nimux" src="https://assets.kitploit.com/production/public/readmes/42073/990b885e0d920b45be23f7fbd0a21cb6e755a01ed017ef57088549ce265638ca.png" />
<p align="center"><i>Toolkit de enumeración de red y ejecución remota en Nim puro</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 - Toolkit de operador nativo
nimux es una superficie de comandos nativa para evaluaciones de seguridad autorizadas. Combina enumeración de red, descubrimiento web ligero, validación de credenciales, operaciones de Active Directory, flujos de trabajo Kerberos, ejecución remota, movimiento de archivos, recolección de secretos, DCSync, operaciones de GPO, clientes de bases de datos y enrutamiento SOCKS en un único toolkit en Nim puro.
Versión actual: `v1.0.7`
Estás en el repositorio público oficial de nimux.
- Sitio web: https://nimux.wiki
- Documentación: https://docs.nimux.wiki
- Código fuente: https://github.com/blue0x1/nimux
## Aviso
nimux está diseñado únicamente para pruebas autorizadas. No lo utilices contra sistemas de terceros sin permiso por escrito. Los desarrolladores no se hacen responsables del uso indebido, los daños o las consecuencias legales.
# Documentación
Los ejemplos de uso, las referencias de comandos y las notas de flujo de trabajo se mantienen en la documentación:
https://docs.nimux.wiki
# Integraciones de IA
La guía para agentes y los archivos de integración MCP están disponibles en `SKILLS.md` e `integrations/`.
El binario principal `nimux` sigue siendo independiente. Las integraciones de IA deben llamar a `nimux` como motor de ejecución nativo, preferir `--json`, usar `--dry-run` antes de las escrituras compatibles y requerir aprobación explícita para la ejecución o los cambios.
## Wrapper MCP
`nimux-mcp` es un wrapper MCP stdio independiente para clientes de IA.
Ubicación:
```text
integrations/mcp/nimux-mcp
```
Compilación:
```bash
cd integrations/mcp/nimux-mcp
nimble build -y
```
Ejemplo de configuración del cliente 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"
}
}
}
}
```
El wrapper admite JSON-RPC enmarcado con `Content-Length` de MCP, pruebas locales de JSON-RPC delimitadas por saltos de línea, comprobaciones de políticas, puertas de aprobación, redacción, notificaciones de progreso y metadatos de pivote SOCKS.
Más información:
https://docs.nimux.wiki/mcp-integration
# Instalación
## Nimble
Nimble compila nimux desde el código fuente, por lo que primero deben instalarse las bibliotecas de desarrollo nativas. En Kali, Debian o Ubuntu:
```bash
sudo apt update
sudo apt install -y build-essential ca-certificates git libssl-dev libkrb5-dev
nimble install nimux
```
No ejecute Nimble con `sudo`. Si Nimble informa un error de certificado SSL,
actualice el almacén de CA del sistema antes de volver a intentarlo:
```bash
sudo apt install --reinstall ca-certificates
sudo update-ca-certificates
nimble refresh
```
MinGW-w64 es opcional para la instalación base, pero es requerido por las rutas de ejecución que compilan binarios auxiliares de Windows:
```bash
sudo apt install -y mingw-w64
```
## Descargar la versión
Los recursos de la versión precompilada están disponibles en GitHub:
https://github.com/blue0x1/nimux/releases
Descargue el binario de Linux más reciente o el paquete Debian desde la página de versiones.
Instale el paquete Debian:
```bash
sudo dpkg -i nimux_*_amd64.deb
sudo apt --fix-broken install
```
Utilice el binario independiente de Linux:
```bash
chmod +x nimux
./nimux --help
./nimux --version
```
## Docker
La imagen de contenedor pública está disponible en GitHub Container Registry:
```bash
docker run --rm -it --network host ghcr.io/blue0x1/nimux:latest --help
```
Ejecutar un escaneo:
```bash
docker run --rm -it --network host ghcr.io/blue0x1/nimux:latest \
scan 10.10.10.0/24 --port 445,389,5985 --open
```
Ejecutar descubrimiento web ligero:
```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
```
Ejecutar spidering SMB de solo lectura:
```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
```
Ejecuta el wrapper de MCP:
```bash
docker run --rm -i --network host --entrypoint nimux_mcp \
ghcr.io/blue0x1/nimux:latest
```
## Arch Linux AUR
nimux está disponible en el AUR:
https://aur.archlinux.org/packages/nimux
Instalar con un asistente de AUR:
```bash
yay -S nimux
```
O compilar manualmente:
```bash
git clone https://aur.archlinux.org/nimux.git
cd nimux
makepkg -si
```
## BlackArch
nimux está disponible en BlackArch:
```bash
sudo pacman -S nimux
```
## Compilar desde el código fuente
```bash
git clone https://github.com/blue0x1/nimux
cd nimux
nimble build -y
```
Requisitos:
- Nim 1.6.10 o superior
- Bibliotecas de desarrollo de OpenSSL
- Bibliotecas de Kerberos
- MinGW-w64 para las compilaciones auxiliares de Windows utilizadas por algunas rutas de ejecución
## Paquete Debian
Compilar un paquete Debian local desde el código fuente:
```bash
dpkg-buildpackage -us -uc -b
sudo apt install ../nimux_*.deb
```
## Inspección de BloodHound sin conexión
`bh` lee archivos ZIP de BloodHound guardados localmente. Proporciona inventario, cobertura de recopilación, búsqueda de objetos e inspección de pertenencia a grupos directa y anidada:
```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` resalta objetos críticos, cuentas privilegiadas, excepciones de política de contraseñas, actividad obsoleta y brechas de recopilación. `--high-value` muestra objetos marcados o clasificados como de alto valor por SIDs de dominio conocidos.
### Salida de grafo
Añade `--graph` para imprimir un grafo de relaciones dirigido en la terminal. No se requiere navegador, base de datos ni conexión de red. La salida permanece en el scrollback normal de la terminal y puede redirigirse.
```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]'
```
Limitar a un solo objeto con `--user`, `--computer` o `--group`:
```bash
nimux bh collection.zip --user alice --interesting
nimux bh collection.zip --computer dc01 --interesting
nimux bh collection.zip --group 'HELP DESK' --interesting
```
Entrada admitida: ZIP de un solo volumen y sin cifrar con esquema JSON de BloodHound v5 o v6. No se requieren herramientas externas; el análisis se ejecuta completamente en el proceso.
Comprobaciones para desarrolladores:
```bash
nim c -r tests/test_bloodhound.nim
nim c -r tests/check_bloodhound_archives.nim /path/to/collection.zip
```
# Ejemplos rápidos
```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
```
Ejemplos de flujo de trabajo de políticas y certificados de 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
```
Receptor de captura 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
```
# Características
- Escaneo TCP y UDP con sondas conscientes del protocolo
- Descubrimiento ligero de directorios/archivos/vhosts HTTP y de subdominios DNS
- Flujos de trabajo de autenticación SMB, enumeración, spidering de recursos compartidos en modo solo lectura, operaciones de archivos, coerción y captura de tickets
- Enumeración de LDAP y Active Directory, escrituras, rutas de ACL, roasting, RBCD, credenciales shadow y soporte de ADCS
- Modo de exportación LDAP compatible con BloodHound Legacy 4.x
- Flujos de trabajo de Kerberos TGT, TGS, S4U, ccache, kirbi, renovación, purga y forja de tickets
- Modos de ejecución de WinRM, WMI, SCM, DCOM, tareas programadas y servicios auxiliares
- Clientes de MSSQL, PostgreSQL, MySQL, HTTP, HTTPS, WebDAV, FTP, SSH, RDP, VNC, NFS y AFP
- SAM, LSA, credenciales en caché, material DPAPI y operaciones nativas de DCSync
- Flujos de trabajo de descubrimiento, copia de seguridad, operaciones de archivos, vinculación y modificación de políticas de GPO
- Despliegue del helper SOCKS y enrutamiento global SOCKS5 con `--proxy`
- Salida JSON para automatización
# Familias de Comandos
| Comando | Propósito |
| --- | --- |
| `scan` | Descubrimiento de servicios TCP y UDP |
| `smb` | Enumeración SMB, comprobaciones de autenticación, operaciones de archivos y coerción |
| `ldap` | Consultas AD, escrituras, roasting, ACLs, RBCD, credenciales shadow, ADCS |
| `http`, `https`, `dns` | Descubrimiento ligero de web y DNS |
| `kerberos` | TGT, TGS, S4U, conversión de tickets, renovación, purga, forja |
| `winrm` | Ejecución de comandos WinRM, shell y helpers de archivos |
| `scm`, `bin`, `cim`, `tsch`, `mmc` | Transportes de ejecución remota |
| `mssql`, `postgres`, `mysql` | Clientes de protocolos de bases de datos |
| `secrets`, `dcsync` | Material de credenciales y flujos de trabajo de replicación |
| `socks` | Despliegue del helper SOCKS |
| `put`, `get`, `ls`, `mkdir`, `rm` | Operaciones de archivos SMB |
# Desarrollo
Compilar localmente:
```bash
nimble build -y
```
Ejecutar ayuda del comando:
```bash
./nimux --help
./nimux smb --help
./nimux kerberos --help
```
# Créditos
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>
# Licencia
nimux se distribuye bajo la GNU Affero General Public License v3.0. Consulte [LICENSE](https://github.com/blue0x1/nimux/blob/main/LICENSE).