
Чистый Nim-инструментарий для сетевой разведки и удалённого выполнения команд, предназначенный для авторизованных оценок безопасности. Поддерживает SMB, LDAP, Kerberos, WinRM, клиенты баз данных, сбор секретов, DCSync, операции с GPO и маршрутизацию через SOCKS.
<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 - Native Operator Toolkit
nimux — это нативный интерфейс команд для авторизованных оценок безопасности. Он объединяет перечисление сетевых ресурсов, облегчённое веб-исследование, проверку учётных данных, операции 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
# Интеграции с ИИ
Руководство для агентов и файлы интеграции MCP доступны в `SKILLS.md` и `integrations/`.
Основной бинарный файл `nimux` остаётся независимым. Интеграции с ИИ должны вызывать `nimux` как нативный движок выполнения, предпочитать `--json`, использовать `--dry-run` перед поддерживаемыми операциями записи и требовать явного одобрения для выполнения или изменений.
## Обёртка MCP
`nimux-mcp` — это отдельная обёртка 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"
}
}
}
}
```
Обёртка поддерживает JSON-RPC с фреймингом `Content-Length` в MCP, локальные тесты 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
```
Не запускайте Nimble с `sudo`. Если 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
```
Запустите облегчённое веб-обнаружение:
```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
- MinGW-w64 для сборки вспомогательных компонентов Windows, используемых в некоторых путях выполнения
## Пакет Debian
Соберите локальный пакет Debian из исходного кода:
```bash
dpkg-buildpackage -us -uc -b
sudo apt install ../nimux_*.deb
```
## Офлайн-инспекция BloodHound
`bh` читает сохранённые ZIP-архивы BloodHound локально. Он предоставляет инвентаризацию, покрытие
сбора, поиск объектов и инспекцию прямого/вложенного членства в группах:
```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
```
Поддерживаемый ввод: однoтомный, незашифрованный 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-каталогов/файлов/vhost и обнаружение DNS-поддоменов
- Аутентификация SMB, перечисление, обход общих ресурсов в режиме только чтения, файловые операции, принуждение и рабочие процессы захвата тикетов
- Перечисление LDAP и Active Directory, запись, пути ACL, roasting, RBCD, shadow credentials и поддержка ADCS
- Режим экспорта LDAP, совместимый с BloodHound Legacy 4.x
- Рабочие процессы 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 и глобальная маршрутизация SOCKS5 с помощью `--proxy`
- Вывод в формате JSON для автоматизации
# Семейства команд
| Команда | Назначение |
| --- | --- |
| `scan` | Обнаружение служб TCP и UDP |
| `smb` | Перечисление SMB, проверка аутентификации, файловые операции и принуждение |
| `ldap` | Запросы AD, запись, roasting, ACL, RBCD, shadow credentials, ADCS |
| `http`, `https`, `dns` | Лёгкое обнаружение веб-ресурсов и DNS |
| `kerberos` | TGT, TGS, S4U, преобразование тикетов, продление, очистка, подделка |
| `winrm` | Выполнение команд WinRM, оболочка и файловые помощники |
| `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 General Public License v3.0. См. [LICENSE](https://github.com/blue0x1/nimux/blob/main/LICENSE).