voidsec-proxy

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

v3.0.0 | 18개 모듈 | 50개 이상의 명령어 | 의존성 제로

또 하나의 스크립트 키디 도구가 아니다. 이건 실제로 뭔가를 한다.

---

목차

• 설치
• 빠른 시작
• 명령어 레퍼런스
  • proxy — SOCKS5 체인 로테이션
  • scan — 포트 스캐너
  • dns — DNS 툴킷
  • crack — 해시 크래킹
  • password — 비밀번호 생성기
  • mutate — 워드리스트 변형기
  • recon — 네트워크 정찰
  • web — 웹 핑거프린팅
  • exfil — 은닉 채널 및 인코딩
  • encrypt — AES-GCM 파일 암호화
  • shred — 안전한 파일 삭제
  • stego — 스테가노그래피
  • shell — 리버스 셸 생성기
  • forensic — 파일 분석
  • anon — 익명화
  • plugin — 플러그인 관리
  • config — 설정
• 프록시 파일 형식
• 플러그인 API
• 라이선스

---

설치

# 저장소 복제
git clone https://github.com/VoidSecSoftwares/voidsec-proxy.git

# 디렉토리로 이동
cd voidsec-proxy

# 설치 (기본)
pip install -e .

# 암호화 지원과 함께 설치 (AES-GCM, ChaCha20, 스테가노그래피)
pip install -e ".[crypto]"

요구사항: Python 3.8+ | 필수 의존성 없음

---

빠른 시작

# SOCKS5 프록시 체인 시작
voidsec-proxy proxy -f proxies.txt

# 대상 스캔
voidsec-proxy scan -t 10.0.0.1

# DNS 확인
voidsec-proxy dns example.com

# 비밀번호 생성
voidsec-proxy password -l 20 -c 5

# 대상에 대한 전체 정찰
voidsec-proxy recon -t 10.0.0.1

---

명령어 레퍼런스

proxy

자동 로테이션이 적용된 SOCKS5 프록시 체인.

# 기본 사용법
voidsec-proxy proxy -f proxies.txt

# 사용자 지정 수신 주소 및 포트
voidsec-proxy proxy -f proxies.txt -l 0.0.0.0 -p 1080

# 시작 시 프록시 순서 섞기
voidsec-proxy proxy -f proxies.txt -s

플래그	설명	기본값
-f, --file	프록시 파일 (필수)	—
-l, --listen	수신 주소	127.0.0.1
-p, --port	수신 포트	9050
-s, --shuffle	프록시 순서 섞기	false

scan

배너 그래빙을 지원하는 멀티스레드 TCP 포트 스캐너.

# 일반 포트 스캔
voidsec-proxy scan -t 10.0.0.1

# 특정 포트 스캔
voidsec-proxy scan -t 10.0.0.1 -p 22,80,443,3389

# 포트 범위 스캔, JSON으로 내보내기
voidsec-proxy scan -t 10.0.0.1 -r 1-1000 -o results.json -f json

플래그	설명	기본값
-t, --target	대상 호스트 (필수)	—
-p, --ports	쉼표로 구분된 포트	일반 포트
-r, --port-range	포트 범위 (예: 1-1000)	—
-o, --output	출력 파일	stdout
-f, --format	출력 형식 (text, json, csv)	text

dns

DNS 확인, 역방향 조회, 서브도메인 열거.

# A 레코드 확인
voidsec-proxy dns example.com

# 여러 레코드 유형
voidsec-proxy dns example.com -t A -t MX -t TXT

# 역방향 DNS 조회
voidsec-proxy dns 8.8.8.8 -r

# 서브도메인 열거
voidsec-proxy dns example.com -e -w wordlist.txt

플래그	설명	기본값
domain	대상 도메인 (필수)	—
-t, --type	레코드 유형 (반복 가능)	A
-r, --reverse	역방향 DNS 조회	false
-e, --enumerate	서브도메인 열거	false
-w, --wordlist	열거용 워드리스트	—

crack

워드리스트를 지원하는 해시 크래킹.

# MD5 해시 크래킹
voidsec-proxy crack --hash 5f4dcc3b5aa765d61d8327deb882cf99 -t md5 -w rockyou.txt

# SHA256으로 텍스트 해싱
voidsec-proxy crack --hash-text "hello" -t sha256

# 파일 해싱
voidsec-proxy crack --hash-file secret.bin -t sha512

플래그	설명	기본값
--hash	크래킹할 해시	—
--hash-text	해싱할 텍스트	—
--hash-file	해싱할 파일	—
-t, --type	해시 유형 (md5, sha1, sha256, sha512)	md5
-w, --wordlist	크래킹용 워드리스트	—

password

강도 감사를 지원하는 비밀번호 생성기.

# 각 20자 비밀번호 5개 생성
voidsec-proxy password -l 20 -c 5

# 비밀번호 감사
voidsec-proxy password -a "MyP@ssw0rd"

# 6단어 패스프레이즈 생성
voidsec-proxy password --passphrase -l 6

플래그	설명	기본값
-l, --length	비밀번호 길이 / 단어 수	16
-c, --count	생성할 비밀번호 개수	5
-a, --audit	비밀번호 강도 감사	—
--passphrase	대신 패스프레이즈 생성	false
--separator	패스프레이즈 단어 구분자	-
--no-upper	대문자 제외	false
--no-lower	소문자 제외	false
--no-digits	숫자 제외	false
--no-symbols	기호 제외	false

mutate

워드리스트 변형 엔진.

# 모든 변형 적용
voidsec-proxy mutate -w wordlist.txt -o mutated.txt -m leet,upper,append_num,dups

# 리트 스피크 + 숫자
voidsec-proxy mutate -w wordlist.txt -o out.txt -m leet,append_num

플래그	설명	기본값
-w, --wordlist	입력 워드리스트 (필수)	—
-o, --output	출력 파일 (필수)	—
-m, --mutations	쉼표로 구분: leet, upper, append_num, prepend_num, dups, reverse, append_sym	전체

recon

전체 네트워크 정찰.

# 전체 정찰 (IP, 지리, ASN, 열린 포트)
voidsec-proxy recon -t 10.0.0.1

# WHOIS 조회
voidsec-proxy recon --whois example.com

# IP 지리적 위치
voidsec-proxy recon --geo 8.8.8.8

# ASN 조회
voidsec-proxy recon --asn 8.8.8.8

# Traceroute
voidsec-proxy recon --traceroute 8.8.8.8

플래그	설명
-t, --target	전체 정찰 대상 호스트
--whois	WHOIS 조회
--geo	IP 지리적 위치
--asn	ASN 조회
--traceroute	대상까지의 Traceroute

web

웹 애플리케이션 핑거프린팅 및 디렉토리 브루트포스.

# 전체 핑거프린트
voidsec-proxy web -u https://target.com

# 헤더 분석
voidsec-proxy web --headers https://target.com

# 디렉토리 브루트포스
voidsec-proxy web --dirbust https://target.com -w wordlist.txt

플래그	설명
-u, --url	대상 URL
--headers	헤더 가져오기 및 분석
--fingerprint	기술 핑거프린트
--dirbust	디렉토리 브루트포스
-w, --wordlist	브루트포스용 워드리스트

exfil

은닉 채널 및 데이터 인코딩.

# 데이터 인코딩
voidsec-proxy exfil --encode "secret data" -m base64
voidsec-proxy exfil --encode "secret data" -m morse
voidsec-proxy exfil --encode "secret data" -m dns

# 데이터 디코딩
voidsec-proxy exfil --decode "dGVzdA==" -m base64

# 비즈네르 암호
voidsec-proxy exfil --vigenere "encrypted" --key "secret"

플래그	설명
--encode	인코딩할 텍스트
--decode	디코딩할 텍스트
-m, --method	base32, base64, hex, morse, binary, rot13, caesar, dns
-s, --shift	카이사르 암호 시프트
--vigenere	비즈네르 암호 텍스트
--key	암호 키
--decrypt	암호화 대신 복호화

encrypt

AES-GCM 파일 암호화.

# 파일 암호화
voidsec-proxy encrypt -i secret.txt -o secret.enc -p "mypassword"

# 파일 복호화
voidsec-proxy encrypt -i secret.enc -o secret.txt -p "mypassword" -d

플래그	설명
-i, --input	입력 파일 (필수)
-o, --output	출력 파일 (필수)
-p, --password	암호화 비밀번호 (필수)
-d, --decrypt	암호화 대신 복호화

shred

여러 번 덮어쓰기를 통한 안전한 파일 삭제.

# 5회 덮어쓰기로 파일 삭제
voidsec-proxy shred -f file.txt -n 5

플래그	설명	기본값
-f, --file	삭제할 파일 (필수)	—
-n, --passes	덮어쓰기 횟수	3

stego

PNG 스테가노그래피 — 이미지에 데이터 숨기기 및 추출.

# 이미지에 데이터 숨기기
voidsec-proxy stego -i image.png -f secret.txt -o stego.png

# 숨겨진 데이터 추출
voidsec-proxy stego -i stego.png -e -o extracted.txt

플래그	설명
-i, --image	PNG 이미지 파일
-f, --secret	숨길 비밀 파일
-o, --output	출력 파일
-e, --extract	숨기기 대신 추출

shell

페이로드 인코딩을 지원하는 리버스 셸 생성기.

# Python 리버스 셸
voidsec-proxy shell --lhost 10.0.0.1 --lport 4444 -t python

# base64 인코딩을 사용한 Bash
voidsec-proxy shell --lhost 10.0.0.1 --lport 4444 -t bash -e base64

# PowerShell 리버스 셸
voidsec-proxy shell --lhost 10.0.0.1 --lport 4444 -t powershell