
Ferramenta de enumeração de rede e execução remota em Nim puro para avaliações de segurança autorizadas. Suporta SMB, LDAP, Kerberos, WinRM, clientes de banco de dados, coleta de segredos, DCSync, operações de GPO e roteamento SOCKS.
<img width="2736" height="754" alt="01-nimux" src="https://assets.kitploit.com/production/public/readmes/42073/990b885e0d920b45be23f7fbd0a21cb6e755a01ed017ef57088549ce265638ca.png" />
<p align="center"><i>Kit de ferramentas de enumeração de rede e execução remota em 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 - Kit de Ferramentas Nativo para Operadores
nimux é uma superfície de comandos nativa para avaliações de segurança autorizadas. Ele combina enumeração de rede, descoberta web leve, validação de credenciais, operações em Active Directory, fluxos de trabalho Kerberos, execução remota, movimentação de arquivos, coleta de segredos, DCSync, operações de GPO, clientes de banco de dados e roteamento SOCKS em um único kit em Nim puro.
Versão atual: `v1.0.7`
Você está no repositório público oficial do nimux.
- Site: https://nimux.wiki
- Documentação: https://docs.nimux.wiki
- Código-fonte: https://github.com/blue0x1/nimux
## Aviso
O nimux foi criado apenas para testes autorizados. Não o utilize contra sistemas de terceiros sem permissão por escrito. Os desenvolvedores não se responsabilizam por uso indevido, danos ou consequências legais.
# Documentação
Exemplos de uso, referências de comandos e notas de fluxo de trabalho são mantidos na documentação:
https://docs.nimux.wiki
# Integrações de IA
Orientações para agentes e arquivos de integração MCP estão disponíveis em `SKILLS.md` e `integrations/`.
O binário principal `nimux` permanece independente. As integrações de IA devem chamar o `nimux` como mecanismo de execução nativo, preferir `--json`, usar `--dry-run` antes de gravações suportadas e exigir aprovação explícita para execução ou alterações.
## Wrapper MCP
`nimux-mcp` é um wrapper MCP stdio separado para clientes de IA.
Localização:
```text
integrations/mcp/nimux-mcp
```
Compilação:
```bash
cd integrations/mcp/nimux-mcp
nimble build -y
```
Exemplo de configuração do 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"
}
}
}
}
```
O wrapper suporta JSON-RPC enquadrado com `Content-Length` do MCP, testes locais de JSON-RPC delimitados por nova linha, verificações de política, portões de aprovação, redação, notificações de progresso e metadados de pivot SOCKS.
Leia mais:
https://docs.nimux.wiki/mcp-integration
# Instalação
## Nimble
O Nimble compila o nimux a partir do código-fonte, portanto as bibliotecas nativas de desenvolvimento devem ser instaladas primeiro. No Kali, Debian ou Ubuntu:
```bash
sudo apt update
sudo apt install -y build-essential ca-certificates git libssl-dev libkrb5-dev
nimble install nimux
```
Não execute o Nimble com `sudo`. Se o Nimble relatar um erro de certificado SSL,
atualize o armazenamento de CAs do sistema antes de tentar novamente:
```bash
sudo apt install --reinstall ca-certificates
sudo update-ca-certificates
nimble refresh
```
O MinGW-w64 é opcional para a instalação base, mas é exigido por
caminhos de execução que compilam binários auxiliares do Windows:
```bash
sudo apt install -y mingw-w64
```
## Baixar Release
Os assets de release pré-compilados estão disponíveis no GitHub:
https://github.com/blue0x1/nimux/releases
Baixe o binário Linux mais recente ou o pacote Debian na página de releases.
Instale o pacote Debian:
```bash
sudo dpkg -i nimux_*_amd64.deb
sudo apt --fix-broken install
```
Use o binário Linux autónomo:
```bash
chmod +x nimux
./nimux --help
./nimux --version
```
## Docker
A imagem pública do container está disponível no GitHub Container Registry:
```bash
docker run --rm -it --network host ghcr.io/blue0x1/nimux:latest --help
```
Execute um scan:
```bash
docker run --rm -it --network host ghcr.io/blue0x1/nimux:latest \
scan 10.10.10.0/24 --port 445,389,5985 --open
```
Execute a descoberta web leve:
```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
```
Execute o spidering SMB somente leitura:
```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
```
Execute o wrapper MCP:
```bash
docker run --rm -i --network host --entrypoint nimux_mcp \
ghcr.io/blue0x1/nimux:latest
```
## Arch Linux AUR
nimux está disponível no AUR:
https://aur.archlinux.org/packages/nimux
Instale com um auxiliar de AUR:
```bash
yay -S nimux
```
Ou compile manualmente:
```bash
git clone https://aur.archlinux.org/nimux.git
cd nimux
makepkg -si
```
## BlackArch
nimux está disponível no BlackArch:
```bash
sudo pacman -S nimux
```
## Compilar a Partir do Código-Fonte
```bash
git clone https://github.com/blue0x1/nimux
cd nimux
nimble build -y
```
Requisitos:
- Nim 1.6.10 ou mais recente
- Bibliotecas de desenvolvimento OpenSSL
- Bibliotecas Kerberos
- MinGW-w64 para builds auxiliares do Windows usados por alguns caminhos de execução
## Pacote Debian
Crie um pacote Debian local a partir do código-fonte:
```bash
dpkg-buildpackage -us -uc -b
sudo apt install ../nimux_*.deb
```
## Inspeção offline do BloodHound
`bh` lê arquivos ZIP do BloodHound salvos localmente. Ele fornece inventário, cobertura de coleta, pesquisa de objetos e inspeção de associação de grupo direta/aninhada:
```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` destaca objetos críticos, contas privilegiadas, exceções de política de senha, atividade obsoleta e lacunas de coleta. `--high-value` mostra objetos sinalizados ou classificados como de alto valor por SIDs de domínio conhecidos.
### Saída de grafo
Adicione `--graph` para imprimir um grafo de relacionamentos direcionado no terminal. Não é necessário navegador, banco de dados ou conexão de rede. A saída permanece no scrollback normal do terminal e pode ser redirecionada.
```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]'
```
Restrinja a um único objeto com `--user`, `--computer` ou `--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 suportada: ZIP de volume único, não criptografado, com esquema JSON do BloodHound v5 ou v6. Nenhuma ferramenta externa é necessária; a análise é executada inteiramente em processo.
Verificações do desenvolvedor:
```bash
nim c -r tests/test_bloodhound.nim
nim c -r tests/check_bloodhound_archives.nim /path/to/collection.zip
```
# Exemplos 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
```
Exemplos de política de ADCS e fluxo de trabalho de certificados:
```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
```
Ouvinte 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
```
# Recursos
- Varredura TCP e UDP com sondas cientes do protocolo
- Descoberta leve de diretórios/arquivos/vhosts HTTP e descoberta de subdomínios DNS
- Autenticação SMB, enumeração, spidering de compartilhamentos somente leitura, operações de arquivos, coerção e fluxos de captura de tickets
- Enumeração de LDAP e Active Directory, gravações, caminhos de ACL, roasting, RBCD, credenciais shadow e suporte a ADCS
- Modo de exportação LDAP compatível com BloodHound Legacy 4.x
- Fluxos de trabalho com Kerberos TGT, TGS, S4U, ccache, kirbi, renovação, purge e forja de tickets
- Modos de execução WinRM, WMI, SCM, DCOM, tarefa agendada e serviço auxiliar
- Clientes MSSQL, PostgreSQL, MySQL, HTTP, HTTPS, WebDAV, FTP, SSH, RDP, VNC, NFS e AFP
- SAM, LSA, credenciais em cache, material DPAPI e operações nativas de DCSync
- Fluxos de trabalho de descoberta, backup, operações de arquivos, vinculação e modificação de políticas de GPO
- Implantação de helper SOCKS e roteamento global SOCKS5 com `--proxy`
- Saída JSON para automação
# Famílias de Comandos
| Comando | Finalidade |
| --- | --- |
| `scan` | Descoberta de serviços TCP e UDP |
| `smb` | Enumeração SMB, verificação de autenticação, operações de arquivos e coerção |
| `ldap` | Consultas AD, gravações, roasting, ACLs, RBCD, credenciais shadow, ADCS |
| `http`, `https`, `dns` | Descoberta leve de web e DNS |
| `kerberos` | TGT, TGS, S4U, conversão de tickets, renovação, purge, forge |
| `winrm` | Execução de comandos WinRM, shell e helpers de arquivos |
| `scm`, `bin`, `cim`, `tsch`, `mmc` | Transportes de execução remota |
| `mssql`, `postgres`, `mysql` | Clientes de protocolo de banco de dados |
| `secrets`, `dcsync` | Material de credenciais e fluxos de replicação |
| `socks` | Implantação de helper SOCKS |
| `put`, `get`, `ls`, `mkdir`, `rm` | Operações de arquivos SMB |
# Desenvolvimento
Compilar localmente:
```bash
nimble build -y
```
Executar ajuda do 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>
# Licença
nimux é distribuído sob a GNU Affero General Public License v3.0. Consulte [LICENSE](https://github.com/blue0x1/nimux/blob/main/LICENSE).