Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
Aquadecomp — JADX, CFR, Procyon 및 Vineflower를 오케스트레이션하여 Android APK/AAB/XAPK/APKS 파일을 디컴파일하며, 숨겨진 DEX 추출, 난독화 해제, 서명된 APK 재빌드, ELF 분석 및 로컬 REST API를 제공합니다. | Kitploit
도구/GitLabGitLab/droncito/aquadecomp
Android SecurityStatic AnalysisDynamic Code Analysis (DAST)Mobile App PentestingReverse EngineeringMalware AnalysisCryptographyUtilities & FrameworksBinary AnalysisAPI Security
GitLab
1일 전아직 검토되지 않음
공유
droncito/aquadecomp

Aquadecomp

JADX, CFR, Procyon 및 Vineflower를 오케스트레이션하여 Android APK/AAB/XAPK/APKS 파일을 디컴파일하며, 숨겨진 DEX 추출, 난독화 해제, 서명된 APK 재빌드, ELF 분석 및 로컬 REST API를 제공합니다.

저장소 보기

Aquadecomp - 다중 도구 디컴파일 오케스트레이터

CI

Aquadecomp는 여러 디컴파일러를 폴백 체인으로 통합하여 난독화된 앱에서도 디컴파일된 코드의 커버리지를 극대화하는 Android 애플리케이션 디컴파일 플랫폼입니다.

주요 기능

워크플로

decompile은 모든 단계가 연결된 단일 흐름을 실행합니다:

  1. 입력 정규화 - 형식(APK/AAB/XAPK/APKS)을 검증하고 지원되지 않는 파일을 거부합니다
  2. APK 검사 - ZIP 구조, DEX, 네이티브 라이브러리, 패커
  3. 매니페스트 디코딩 - 패키지, 버전, 권한, 주요 액티비티
  4. JAVA로 디컴파일 - JADX를 주 엔진으로 사용하고, CFR, Procyon, Vineflower를 통해 누락된 클래스를 복구합니다
  5. 코드 복구 - 상수 문자열 복호화, 클래스 및 메타데이터 분석, 샘플에 대한 javac 구문 검증
  6. 신뢰도 점수 산정 - 클래스별 0-100 점수와 등급(우수/양호/보통/미흡/신뢰 불가)
  7. 효과성 계산 - 4개 차원의 종합 점수와 JSON + Markdown 보고서

복구 엔진 (recovery 패키지)

  • StringDecryptionEngine: 나머지 코드를 변경하지 않고 상수 리터럴(new String(new byte[]{...}), new String(Base64.decode("...")))을 읽을 수 있는 문자열로 변환합니다
  • ClassRecoveryEngine: 소스 코드에서 내부 클래스, 익명 클래스, 빈 클래스를 감지합니다
  • MetadataExtractor: Kotlin 메타데이터, 어노테이션, 소스 파일을 감지합니다
  • RealCompilationVerifier: 실제 javac로 파일 샘플을 검증하여 구문 오류와 의존성 해석 오류를 구분합니다
  • RecoveryPipeline: sources/의 모든 파일에 대해 엔진을 오케스트레이션합니다. 수정된 파일은 .bak 사본을 유지합니다

디컴파일러 체인

단일 도구에 의존하는 대신, Aquadecomp는 다중 엔진 체인을 사용합니다:

  1. JADX - 주 엔진으로, DEX에서 직접 읽을 수 있는 Java 코드를 생성합니다
  2. CFR - JADX가 생성하지 못한 클래스를 복구합니다
  3. Procyon - 현대 Java에 특화된 두 번째 복구 엔진
  4. Vineflower - Fernflower의 유지 관리 포크인 세 번째 복구 엔진

복구 엔진은 dex2jar로 JAR로 변환된 APK를 받아 sources/에서 누락된 클래스만 처리하므로, 작업을 반복하지 않고 커버리지를 향상시킵니다.

결과: JADX 단독보다 더 많은 클래스를 복구하면서, 주 엔진이 나머지 코드의 품질을 유지합니다.

기존 도구 오케스트레이션

Aquadecomp는 디컴파일러를 재구현하지 않습니다: 기존 도구 (JADX, CFR, Procyon, Vineflower, dex2jar, baksmali/smali, d8, apksig)를 중단 기준, 폴백, 분석, 검증과 함께 단일 체인으로 통합합니다. 프로젝트의 가치는 이 오케스트레이션에 있습니다: 누락된 클래스 복구, 결과 분석, 서명 검증, APK 재구성.

보고서는 각 파일을 생성한 엔진을 나타냅니다: confidence.classes[].decompiler는 파일별 레이블을 저장하고 confidence.decompilerStats는 각 엔진이 생성한 파일 수를 요약합니다. 레이블은 메타데이터이며 점수 계산에는 포함되지 않습니다.

효과성 보고서

주 흐름은 4개 차원으로 0-100 효과성 점수를 계산합니다:

  • 커버리지 (40%): 전체 대비 코드가 있는 클래스
  • 무결성 (25%): 디컴파일 오류 및 경고
  • 식별자 (25%): 난독화로 인한 이름 손실
  • 리소스 (10%): 디코딩된 리소스 및 매니페스트

세부 내용은 aquedecomp-report.json(effectiveness)과 Markdown 보고서에 출력됩니다.

verification 패키지는 또한 등급(우수/양호/보통/미흡/신뢰 불가)과 함께 클래스별 점수를 계산하며, 이는 confidence 아래 보고서에 포함됩니다.

다중 형식 지원

  • .APK - 표준 Android 패키지
  • .AAB - Android App Bundles: base/dex/의 DEX를 읽고, 바이너리 매니페스트가 없으면 JADX로 디코딩된 XML을 사용합니다
  • .XAPK - 확장 패키지: 내부 APK(base.apk)를 추출하여 검사, 매니페스트 및 복구에 사용합니다
  • .APKS - APK 분할: base-master.apk에 대해서도 동일하게 처리합니다

네 가지 형식 모두 정규화 단계에서 검증됩니다. 유효한 ZIP이 아니거나, Android 콘텐츠를 포함하지 않거나, 알 수 없는 확장자를 가진 파일은 명확한 메시지와 함께 거부되며, 오류 보고서도 함께 생성됩니다.

전체 분석

  • 매니페스트 검사
  • 프로텍터/패커 탐지
  • 난독화 분석
  • 디컴파일 통계 (클래스, 오류, 줄 수)
  • 공개된 방법론을 포함한 효과성 보고서

2.0.0: 분석 및 확장성

  • rebuild - 디컴파일된 소스를 재컴파일하고 변경 사항이 적용된 서명된 APK를 생성합니다 (자체 인증서로 v1+v2+v3 서명: 설치하려면 기존 앱을 제거해야 함); aquedecomp-mapping.txt를 감지하여 classpath를 복원하고 dex를 원래 이름으로 변경합니다 (docs/REBUILD.md 참조)
  • --mapping - 디컴파일 시 ProGuard/R8 매핑을 적용하여 클래스와 멤버를 원래 이름으로 복원합니다 (docs/REBUILD.md 참조)
  • serve - 디컴파일, 검사, 숨겨진 DEX 추출, 재컴파일, 네이티브 분석 및 HTTP를 통한 이름 추론을 위한 JSON 기반 로컬 REST API (docs/API.md 참조)
  • natives - 패키지의 .so 파일에 대한 실제 ELF 분석 (섹션, exports, imports, 종속성) 및 Ghidra가 설치된 경우 선택적 Ghidra 디스어셈블리 (docs/NATIVES.md 참조)
  • 암호화 플러그인 - 키가 리터럴로 임베드된 경우 AES/RC4/XOR 복호화, 복호화할 수 없을 때는 솔직한 설명 포함 (docs/CRYPTO_PLUGINS.md 참조)
  • nombres - 난독화된 식별자에 대한 휴리스틱 이름 제안, 보고서만 제공하며 코드는 수정하지 않음 (docs/NAME_INFERENCE.md 참조)
  • unpack - 정적 분석을 통해 패키징된 APK에서 숨겨진 DEX를 추출하고 (assets, libs 및 ZIP/zlib 페이로드) 루트에 이들을 포함하여 APK를 재패키징합니다; 루트에 DEX가 없으면 decompile이 자동으로 실행합니다

외부 도구

  • apkid - APKiD로 패커, 프로텍터 및 컴파일러를 식별합니다 (APK의 각 파일에 대한 YARA 규칙)
  • bundle - bundletool을 사용하여 AAB를 유니버설 모드의 APKS 파일로 변환합니다
  • simplify - Simplify로 APK를 디오브푸스케이션합니다: smali 가상 머신에서 dex를 실행하고 메서드를 재작성합니다
  • deobfuscator - java-deobfuscator로 APK를 디오브푸스케이션합니다: 난독화 도구(Zelix, Stringer, Allatori, DashO…)를 탐지하고, 격리된 샌드박스에서 문자열을 복호화하고, 서명된 APK를 재패키징합니다
  • merge - APKEditor로 분할 APK를 단일 APK로 병합합니다 (폴더, .apks, .xapk 및 .apkm 허용)

bundletool, Simplify, java-deobfuscator 및 APKEditor의 jar는 SHA-256 검증과 함께 ~/.aquadecomp에 한 번만 다운로드되며, AQUADECOMP_BUNDLETOOL, AQUADECOMP_SIMPLIFY, AQUADECOMP_DEOBFUSCATOR 및 AQUADECOMP_APKEDITOR 변수로 대체할 수 있습니다; APKiD는 PATH에서 찾거나 AQUADECOMP_APKID로 지정합니다. 자세한 내용은 docs/USAGE.md를 참조하세요.

설치

요구 사항

  • Java 21+
  • RAM 최소 4GB (대형 APK의 경우 6GB+ 권장)

다운로드

GitLab 파이프라인은 main에 푸시할 때마다 aquedecomp.jar를 체크섬 aquedecomp.jar.sha256과 함께 빌드합니다. 둘 다 마지막 성공한 파이프라인에서 다운로드됩니다:

curl -LO 'https://gitlab.com/droncito/aquadecomp/-/jobs/artifacts/main/raw/build/libs/aquedecomp.jar?job=jar'
curl -LO 'https://gitlab.com/droncito/aquadecomp/-/jobs/artifacts/main/raw/build/libs/aquedecomp.jar.sha256?job=jar'

사용하기 전에 무결성을 확인하세요:

# Linux / macOS
sha256sum -c aquedecomp.jar.sha256

# Windows (PowerShell)
certutil -hashfile aquedecomp.jar SHA256

.sha256 파일에 게시된 해시는 certutil의 결과와 일치해야 합니다. 그런 다음:

java -jar aquedecomp.jar --version

소스에서 컴파일하기

gradle jar

JAR은 build/libs/aquedecomp.jar에 생성됩니다.

래퍼도 존재합니다(Windows에서는 gradlew.bat build, Linux/macOS에서는 ./gradlew build).

테스트

gradle test

La suite (JUnit 5)는 네 가지 형식의 정규화, 손상된 입력, 세 가지 엔진을 사용한 복구 체인, 엔진별 출처, 디코딩된 매니페스트, 효과성 계산 및 보고서 작성을 다룹니다. 형식별 픽스처는 작은 APK로부터 scripts/make-fixtures.ps1을 사용하여 재생성됩니다.

실행 파일

java -jar build/libs/aquedecomp.jar [opciones] <APK_file> -o <output_dir>

사용법

CLI

java -jar aquedecomp.jar decompile signal.apk -o ./output

# Con opciones avanzadas
java -jar aquedecomp.jar decompile signal.apk \
  -o ./output \
  --threads 8 \
  --no-md \
  --no-json

# Solo inspeccionar el APK (sin descompilar)
java -jar aquedecomp.jar inspect signal.apk

# Descompilar aplicando un mapping de ProGuard/R8
java -jar aquedecomp.jar decompile signal.apk -o ./output --mapping mapping.txt

# Recompilar las fuentes editadas en un APK firmado
java -jar aquedecomp.jar rebuild ./output -o ./output-modificado.apk

# Analizar bibliotecas nativas (.so)
java -jar aquedecomp.jar natives signal.apk --so libsignal

# Sugerir nombres para identificadores ofuscados
java -jar aquedecomp.jar nombres ./output/sources --out ./output/nombres.json

# Extraer los DEX ocultos de un APK empaquetado (análisis estático)
java -jar aquedecomp.jar unpack signal.apk

# API REST local
java -jar aquedecomp.jar serve --port 8080

GUI

java -jar aquedecomp.jar --gui

# Equivalente (aparece en aquedecomp --help)
java -jar aquedecomp.jar gui

이 창은 CLI의 기능을 탭으로 제공합니다: 디컴파일, 분석(inspect), 재컴파일, 네이티브 라이브러리 분석, 이름 제안, 그리고 외부 도구(APKiD, bundletool, Simplify, APKEditor, unpack) 실행. 결과는 Reporte 및 Registro 탭에 표시됩니다.

프로젝트 구조

도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

아직 인기 데이터가 없습니다.

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →