
Pure-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 - 네이티브 운영자 툴킷
nimux는 승인된 보안 평가를 위한 네이티브 명령 인터페이스입니다. 네트워크 열거, 경량 웹 탐색, 자격 증명 검증, Active Directory 작업, Kerberos 워크플로, 원격 실행, 파일 이동, 시크릿 수집, DCSync, GPO 작업, 데이터베이스 클라이언트, SOCKS 라우팅을 하나의 Pure-Nim 툴킷으로 결합합니다.
현재 릴리스: `v1.0.7`
현재 nimux의 공식 공개 저장소를 보고 계십니다.
- 웹사이트: https://nimux.wiki
- 문서: https://docs.nimux.wiki
- 소스: https://github.com/blue0x1/nimux
## 공지
nimux는 승인된 테스트 전용으로 제작되었습니다. 서면 허가 없이 제3자 시스템에 사용하지 마십시오. 개발자는 오용, 손해 또는 법적 결과에 대해 책임지지 않습니다.
# 문서
사용 예시, 명령 참조, 워크플로 노트는 문서에서 관리됩니다:
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
```
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 라이브러리
- 일부 실행 경로에서 사용되는 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 스키마 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 인증, 열거, 읽기 전용 공유 스파이더링, 파일 작업, 강제(coercion), 티켓 캡처 워크플로
- 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 열거, 인증 확인, 파일 작업, 강제(coercion) |
| `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)를 참조하세요.