voidsec-proxy

 ██╗   ██╗ ██████╗ ██╗██████╗ ███████╗███████╗ ██████╗
 ██║   ██║██╔═══██╗██║██╔══██╗██╔════╝██╔════╝██╔════╝
 ██║   ██║██║   ██║██║██║  ██║███████╗█████╗  ██║     
 ╚██╗ ██╔╝██║   ██║██║██║  ██║╚════██║██╔══╝  ██║     
  ╚████╔╝ ╚██████╔╝██║██████╔╝███████║███████╗╚██████╗
   ╚═══╝   ╚═════╝ ╚═╝╚═════╝ ╚══════╝╚══════╝ ╚═════╝

v3.0.0 | 18 modules | 50+ commands | zero dependencies

Not another script kiddie tool. This one actually does something.

---

Table of Contents

• Installation
• Quick Start
• Commands Reference
  • proxy — SOCKS5 chain rotation
  • scan — port scanner
  • dns — DNS toolkit
  • crack — hash cracking
  • password — password generator
  • mutate — wordlist mutator
  • recon — network reconnaissance
  • web — web fingerprinting
  • exfil — covert channels & encoding
  • encrypt — AES-GCM file encryption
  • shred — secure file deletion
  • stego — steganography
  • shell — reverse shell generator
  • forensic — file analysis
  • anon — anonymization
  • plugin — plugin management
  • config — configuration
• Proxies File Format
• Plugin API
• License

---

Installation

# Clone the repository
git clone https://github.com/VoidSecSoftwares/voidsec-proxy.git

# Enter the directory
cd voidsec-proxy

# Install (basic)
pip install -e .

# Install with crypto support (AES-GCM, ChaCha20, steganography)
pip install -e ".[crypto]"

Requirements: Python 3.8+ | Zero mandatory dependencies

---

Quick Start

# Start a SOCKS5 proxy chain
voidsec-proxy proxy -f proxies.txt

# Scan a target
voidsec-proxy scan -t 10.0.0.1

# Resolve DNS
voidsec-proxy dns example.com

# Generate a password
voidsec-proxy password -l 20 -c 5

# Full recon on a target
voidsec-proxy recon -t 10.0.0.1

---

Commands Reference

proxy

SOCKS5 proxy chain with automatic rotation.

# Basic usage
voidsec-proxy proxy -f proxies.txt

# Custom listen address and port
voidsec-proxy proxy -f proxies.txt -l 0.0.0.0 -p 1080

# Shuffle proxy order on start
voidsec-proxy proxy -f proxies.txt -s

Flag	Description	Default
-f, --file	Proxies file (required)	—
-l, --listen	Listen address	127.0.0.1
-p, --port	Listen port	9050
-s, --shuffle	Shuffle proxy order	false

scan

Multi-threaded TCP port scanner with banner grabbing.

# Scan common ports
voidsec-proxy scan -t 10.0.0.1

# Scan specific ports
voidsec-proxy scan -t 10.0.0.1 -p 22,80,443,3389

# Scan port range, export to JSON
voidsec-proxy scan -t 10.0.0.1 -r 1-1000 -o results.json -f json

Flag	Description	Default
-t, --target	Target host (required)	—
-p, --ports	Comma-separated ports	common ports
-r, --port-range	Port range (e.g., 1-1000)	—
-o, --output	Output file	stdout
-f, --format	Output format (text, json, csv)	text

dns

DNS resolution, reverse lookups, and subdomain enumeration.

# Resolve A records
voidsec-proxy dns example.com

# Multiple record types
voidsec-proxy dns example.com -t A -t MX -t TXT

# Reverse DNS lookup
voidsec-proxy dns 8.8.8.8 -r

# Subdomain enumeration
voidsec-proxy dns example.com -e -w wordlist.txt

Flag	Description	Default
domain	Target domain (required)	—
-t, --type	Record type (repeatable)	A
-r, --reverse	Reverse DNS lookup	false
-e, --enumerate	Subdomain enumeration	false
-w, --wordlist	Wordlist for enumeration	—

crack

Hash cracking with wordlist support.

# Crack MD5 hash
voidsec-proxy crack --hash 5f4dcc3b5aa765d61d8327deb882cf99 -t md5 -w rockyou.txt

# Hash text with SHA256
voidsec-proxy crack --hash-text "hello" -t sha256

# Hash file
voidsec-proxy crack --hash-file secret.bin -t sha512

Flag	Description	Default
--hash	Hash to crack	—
--hash-text	Text to hash	—
--hash-file	File to hash	—
-t, --type	Hash type (md5, sha1, sha256, sha512)	md5
-w, --wordlist	Wordlist for cracking	—

password

Password generator with strength auditing.

# Generate 5 passwords, 20 chars each
voidsec-proxy password -l 20 -c 5

# Audit a password
voidsec-proxy password -a "MyP@ssw0rd"

# Generate 6-word passphrase
voidsec-proxy password --passphrase -l 6

Flag	Description	Default
-l, --length	Password length / word count	16
-c, --count	Number of passwords to generate	5
-a, --audit	Audit password strength	—
--passphrase	Generate passphrase instead	false
--separator	Passphrase word separator	-
--no-upper	Exclude uppercase	false
--no-lower	Exclude lowercase	false
--no-digits	Exclude digits	false
--no-symbols	Exclude symbols	false

mutate

Wordlist mutation engine.

# Apply all mutations
voidsec-proxy mutate -w wordlist.txt -o mutated.txt -m leet,upper,append_num,dups

# Leet speak + numbers
voidsec-proxy mutate -w wordlist.txt -o out.txt -m leet,append_num

Flag	Description	Default
-w, --wordlist	Input wordlist (required)	—
-o, --output	Output file (required)	—
-m, --mutations	Comma-separated: leet, upper, append_num, prepend_num, dups, reverse, append_sym	all

recon

Full network reconnaissance.

# Full recon (IP, geo, ASN, open ports)
voidsec-proxy recon -t 10.0.0.1

# WHOIS lookup
voidsec-proxy recon --whois example.com

# IP geolocation
voidsec-proxy recon --geo 8.8.8.8

# ASN lookup
voidsec-proxy recon --asn 8.8.8.8

# Traceroute
voidsec-proxy recon --traceroute 8.8.8.8

Flag	Description
-t, --target	Target host for full recon
--whois	WHOIS lookup
--geo	IP geolocation
--asn	ASN lookup
--traceroute	Traceroute to target

web

Web application fingerprinting and directory brute-force.

# Full fingerprint
voidsec-proxy web -u https://target.com

# Header analysis
voidsec-proxy web --headers https://target.com

# Directory brute-force
voidsec-proxy web --dirbust https://target.com -w wordlist.txt

Flag	Description
-u, --url	Target URL
--headers	Fetch and analyze headers
--fingerprint	Technology fingerprint
--dirbust	Directory brute-force
-w, --wordlist	Wordlist for brute-force

exfil

Covert channels and data encoding.

# Encode data
voidsec-proxy exfil --encode "secret data" -m base64
voidsec-proxy exfil --encode "secret data" -m morse
voidsec-proxy exfil --encode "secret data" -m dns

# Decode data
voidsec-proxy exfil --decode "dGVzdA==" -m base64

# Vigenere cipher
voidsec-proxy exfil --vigenere "encrypted" --key "secret"