
Pure-Nim Netzwerk-Erkennungs- und Remote-Ausführungstoolkit für autorisierte Sicherheitsbewertungen. Unterstützt SMB, LDAP, Kerberos, WinRM, Datenbank-Clients, Geheimnissammlung, DCSync, GPO-Operationen und SOCKS-Routing.
<img width="2736" height="754" alt="01-nimux" src="https://assets.kitploit.com/production/public/readmes/42073/990b885e0d920b45be23f7fbd0a21cb6e755a01ed017ef57088549ce265638ca.png" />
<p align="center"><i>Reines Nim-Toolkit für Netzwerk-Enumeration und Remote-Ausführung</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 - Native Operator Toolkit
nimux ist eine native Kommandooberfläche für autorisierte Sicherheitsbewertungen. Es kombiniert Netzwerk-Enumeration, leichtgewichtige Web-Discovery, Credential-Validierung, Active-Directory-Operationen, Kerberos-Workflows, Remote-Ausführung, Dateibewegung, Secrets-Sammlung, DCSync, GPO-Operationen, Datenbank-Clients und SOCKS-Routing in einem einzigen Pure-Nim-Toolkit.
Aktuelle Version: `v1.0.7`
Sie befinden sich auf dem offiziellen öffentlichen Repository für nimux.
- Website: https://nimux.wiki
- Dokumentation: https://docs.nimux.wiki
- Quellcode: https://github.com/blue0x1/nimux
## Hinweis
nimux ist ausschließlich für autorisierte Tests konzipiert. Verwenden Sie es nicht gegen Systeme Dritter ohne schriftliche Genehmigung. Die Entwickler sind nicht verantwortlich für Missbrauch, Schäden oder rechtliche Konsequenzen.
# Dokumentation
Anwendungsbeispiele, Befehlsreferenzen und Workflow-Hinweise werden in der Dokumentation gepflegt:
https://docs.nimux.wiki
# KI-Integrationen
Anleitungen für Agenten und MCP-Integrationsdateien sind in `SKILLS.md` und `integrations/` verfügbar.
Die zentrale `nimux`-Binärdatei bleibt unabhängig. KI-Integrationen sollten `nimux` als native Ausführungs-Engine aufrufen, `--json` bevorzugen, `--dry-run` vor unterstützten Schreibvorgängen verwenden und eine ausdrückliche Genehmigung für Ausführungen oder Änderungen verlangen.
## MCP-Wrapper
`nimux-mcp` ist ein separater MCP-stdio-Wrapper für KI-Clients.
Speicherort:
```text
integrations/mcp/nimux-mcp
```
Build:
```bash
cd integrations/mcp/nimux-mcp
nimble build -y
```
Beispielkonfiguration für einen MCP-Client:
```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"
}
}
}
}
```
Der Wrapper unterstützt MCP-`Content-Length`-gerahmtes JSON-RPC, lokale Tests mit zeilengetrenntem JSON-RPC, Policy-Prüfungen, Genehmigungsschranken, Redaktion, Fortschrittsbenachrichtigungen und SOCKS-Pivot-Metadaten.
Mehr erfahren:
https://docs.nimux.wiki/mcp-integration
# Installation
## Nimble
Nimble baut nimux aus dem Quellcode, daher müssen zuerst native Entwicklungsbibliotheken installiert werden. Unter Kali, Debian oder Ubuntu:
```bash
sudo apt update
sudo apt install -y build-essential ca-certificates git libssl-dev libkrb5-dev
nimble install nimux
```
Führe Nimble nicht mit `sudo` aus. Wenn Nimble einen SSL-Zertifikatsfehler meldet,
aktualisiere den CA-Speicher des Systems, bevor du es erneut versuchst:
```bash
sudo apt install --reinstall ca-certificates
sudo update-ca-certificates
nimble refresh
```
MinGW-w64 ist für die Basisinstallation optional, wird jedoch von Ausführungspfaden benötigt, die Windows-Hilfsbinärdateien erstellen:
```bash
sudo apt install -y mingw-w64
```
## Release herunterladen
Vorgefertigte Release-Assets sind auf GitHub verfügbar:
https://github.com/blue0x1/nimux/releases
Laden Sie die neueste Linux-Binärdatei oder das Debian-Paket von der Releases-Seite herunter.
Installieren Sie das Debian-Paket:
```bash
sudo dpkg -i nimux_*_amd64.deb
sudo apt --fix-broken install
```
Verwenden Sie die eigenständige Linux-Binärdatei:
```bash
chmod +x nimux
./nimux --help
./nimux --version
```
## Docker
Das öffentliche Container-Image ist über die GitHub Container Registry verfügbar:
```bash
docker run --rm -it --network host ghcr.io/blue0x1/nimux:latest --help
```
Einen Scan ausführen:
```bash
docker run --rm -it --network host ghcr.io/blue0x1/nimux:latest \
scan 10.10.10.0/24 --port 445,389,5985 --open
```
Führe eine leichtgewichtige Web-Discovery durch:
```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
```
Führe schreibgeschütztes SMB-Spidering aus:
```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
```
Führe den MCP-Wrapper aus:
```bash
docker run --rm -i --network host --entrypoint nimux_mcp \
ghcr.io/blue0x1/nimux:latest
```
## Arch Linux AUR
nimux ist im AUR verfügbar:
https://aur.archlinux.org/packages/nimux
Installation mit einem AUR-Helper:
```bash
yay -S nimux
```
Oder manuell erstellen:
```bash
git clone https://aur.archlinux.org/nimux.git
cd nimux
makepkg -si
```
## BlackArch
nimux ist in BlackArch verfügbar:
```bash
sudo pacman -S nimux
```
## Aus dem Quellcode erstellen
```bash
git clone https://github.com/blue0x1/nimux
cd nimux
nimble build -y
```
Anforderungen:
- Nim 1.6.10 oder neuer
- OpenSSL-Entwicklungsbibliotheken
- Kerberos-Bibliotheken
- MinGW-w64 für Windows-Helper-Builds, die von einigen Ausführungspfaden verwendet werden
## Debian-Paket
Ein lokales Debian-Paket aus dem Quellcode erstellen:
```bash
dpkg-buildpackage -us -uc -b
sudo apt install ../nimux_*.deb
```
## Offline-BloodHound-Inspektion
`bh` liest gespeicherte BloodHound-ZIPs lokal. Es bietet Inventarisierung, Sammlungsabdeckung, Objektsuche und Inspektion direkter/verschachtelter Gruppenmitgliedschaften:
```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` hebt kritische Objekte, privilegierte Konten, Ausnahmen von der Kennwortrichtlinie, veraltete Aktivitäten und Erfassungslücken hervor. `--high-value` zeigt Objekte an, die durch bekannte Domänen-SIDs als hochwertig markiert oder eingestuft wurden.
### Graph-Ausgabe
Fügen Sie `--graph` hinzu, um einen gerichteten Beziehungsgraphen im Terminal auszugeben. Es ist kein Browser, keine Datenbank und keine Netzwerkverbindung erforderlich. Die Ausgabe verbleibt im normalen Terminal-Verlauf und kann umgeleitet werden.
```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]'
```
Mit `--user`, `--computer` oder `--group` auf ein einzelnes Objekt eingrenzen:
```bash
nimux bh collection.zip --user alice --interesting
nimux bh collection.zip --computer dc01 --interesting
nimux bh collection.zip --group 'HELP DESK' --interesting
```
Unterstützte Eingabe: einteiliges, unverschlüsseltes ZIP mit BloodHound-JSON-Schema v5 oder v6. Keine externen Tools erforderlich; die Analyse läuft vollständig prozessintern ab.
Entwicklerprüfungen:
```bash
nim c -r tests/test_bloodhound.nim
nim c -r tests/check_bloodhound_archives.nim /path/to/collection.zip
```
# Kurzbeispiele
```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-Richtlinien- und Zertifikatsworkflow-Beispiele:
```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-Capture-Listener:
```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
```
# Funktionen
- TCP- und UDP-Scanning mit protokollbewussten Probes
- Leichtgewichtige HTTP-Verzeichnis-/Datei-/Vhost-Erkennung und DNS-Subdomain-Erkennung
- SMB-Authentifizierung, Enumeration, Read-only-Share-Spidering, Dateioperationen, Coercion und Ticket-Capture-Workflows
- LDAP- und Active-Directory-Enumeration, Schreibvorgänge, ACL-Pfade, Roasting, RBCD, Shadow Credentials und ADCS-Unterstützung
- BloodHound Legacy 4.x-kompatibler LDAP-Exportmodus
- Kerberos-TGT-, TGS-, S4U-, ccache-, kirbi-, Renewal-, Purge- und Ticket-Forge-Workflows
- WinRM-, WMI-, SCM-, DCOM-, Scheduled-Task- und Helper-Service-Ausführungsmodi
- MSSQL-, PostgreSQL-, MySQL-, HTTP-, HTTPS-, WebDAV-, FTP-, SSH-, RDP-, VNC-, NFS- und AFP-Clients
- SAM, LSA, gecachte Anmeldeinformationen, DPAPI-Material und native DCSync-Operationen
- GPO-Erkennung, Backup, Dateioperationen, Verknüpfung und Richtlinienänderungs-Workflows
- SOCKS-Helper-Bereitstellung und globales SOCKS5-Routing mit `--proxy`
- JSON-Ausgabe für Automatisierung
# Befehlsfamilien
| Befehl | Zweck |
| --- | --- |
| `scan` | TCP- und UDP-Service-Erkennung |
| `smb` | SMB-Enumeration, Auth-Prüfungen, Dateioperationen und Coercion |
| `ldap` | AD-Abfragen, Schreibvorgänge, Roasting, ACLs, RBCD, Shadow Credentials, ADCS |
| `http`, `https`, `dns` | Leichtgewichtige Web- und DNS-Erkennung |
| `kerberos` | TGT, TGS, S4U, Ticket-Konvertierung, Renewal, Purge, Forge |
| `winrm` | WinRM-Befehlsausführung, Shell und Datei-Helfer |
| `scm`, `bin`, `cim`, `tsch`, `mmc` | Remote-Ausführungstransporte |
| `mssql`, `postgres`, `mysql` | Datenbankprotokoll-Clients |
| `secrets`, `dcsync` | Anmeldeinformationsmaterial und Replikations-Workflows |
| `socks` | SOCKS-Helper-Bereitstellung |
| `put`, `get`, `ls`, `mkdir`, `rm` | SMB-Dateioperationen |
# Entwicklung
Lokal bauen:
```bash
nimble build -y
```
Befehlshilfe ausführen:
```bash
./nimux --help
./nimux smb --help
./nimux kerberos --help
```
# Danksagungen
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>
# Lizenz
nimux wird unter der GNU Affero General Public License v3.0 veröffentlicht. Siehe [LICENSE](https://github.com/blue0x1/nimux/blob/main/LICENSE).