How arch3rpro/pentest-windows works
Project Type and Purpose
• Type: Pre-configured VM image & tooling distribution for Windows penetration testing.
• Purpose: Provide a ready-to-use Windows 11 environment (x64 & ARM) with 400+ pentest tools, managed via Scoop and a custom launcher (Maye).
File Structure
• Top‐level:
• README.md / README-ZH.md – documentation
• img/ – screenshots for docs
• No code directories; this project is a VM image distribution with configuration and docs only.
README for Insights
• VM targets: VMware, Fusion, Parallels, Hyper-V, KVM.
• Inside VM: Windows 11 OS, Scoop package manager, Maye Lite launcher, Windows Terminal, Oh-My-Posh, bundled tools (script/GUI).
• External integrations: Internet (to download/update tools), optional VPN/proxy, WSL Kali (optional).
Main Components & Their Relationships
A. Host Layer
• Physical Machine (Mac M1/M2 or Intel)
• Host OS (macOS or Windows)
• Virtualization Software:
– VMware / Fusion / Parallels / KVM / Hyper-V / Ventoy
• VM Image Artifact (7z / qcow2 / OVF)
B. Guest Layer (Windows 11 VM)
• Base OS (Windows 11)
• Configuration Tools & Package Manager:
– Scoop (D:/Base/apps/scoop)
– Windows Terminal / Oh-My-Posh
– QEMU/VMware/Parallels drivers (QGA, VirtualIO)
• Tool Categories (400+):
– Info Gathering, Scanning, Exploitation, Proxy, Persistence, C2, etc.
– Each tool installed via Scoop or portable binaries
• Offline Knowledge Base (PDF/Markdown)
• Networking:
– Internet access for online tools/updates
– VPN / Proxy connectivity (OpenVPN, WireGuard, Tailscale)
– WSL Kali integration (optional, removed in v3.x)
• Remote Access:
– RDP recommended
– SSH/SFTP clients (OpenSSH, WinSCP, MobaXterm)
C. External Services
• GitHub / Scoop Buckets (tool repos & updates)
• Online pentest services (Shodan, Censys, Pentest-Tools.com)
• Cloud storage for VM downloads (Mega)
Architectural Patterns & Design Principles
• Layered architecture:
1. Host & Hypervisor
2. VM OS Platform
3. Package management & launcher
4. Tool categories
5. External services
• Separation of concerns:
• Hypervisor abstraction keeps VM portable
• Scoop isolates tool installs in D:/Base/apps
• Maye launcher decouples UI from tool execution
• Extensibility:
• New tools added via Scoop buckets
• VM versions for multiple architectures (x64, ARM)