
Erstelle einen Anti-Erkennungs-Frida-Server aus dem Quellcode. ~90 Patches, die 16 Erkennungsvektoren abdecken, wöchentliche automatische Builds mit zufälligen Namen.
# phantom-frida `phantom-frida` baut Android Frida Server und Gadget aus dem Quellcode und ändert dabei eine gezielte Menge beobachtbarer Laufzeit-Identifikatoren. Es ist eine Build- und Verifikationsumgebung, keine Zusage, dass jede anwendungsspezifische Erkennungsmethode umgangen wird. Das aktuelle Kompatibilitätsziel ist **Frida 17.16.4** unter Android. Andere Frida-Versionen werden bewusst als unverifiziert behandelt, bis ihre Quellcode-Verträge, der vollständige Build und die Abnahme auf einem gerooteten Gerät wiederholt wurden. Verwende dieses Projekt nur bei Anwendungen und Geräten, die dir gehören oder deren Test du autorisiert bist. ## Was verifiziert ist Das Repository unterscheidet drei Arten von Nachweisen: 1. Unit- und Fixture-Tests validieren die Eingabeverarbeitung, die exakten Quellcode-Patch-Verträge von Frida 17.16.4, den DEX-Neuaufbau, die Artefakt-Promotion, Metadaten, Workflows und das Fehlerverhalten. 2. `build.py --verify` erfordert sowohl Server als auch Gadget, entfernt die Symbole aus dem bereitgestellten Gadget und weist dann bekannte verbotene Laufzeit-Marker zurück, bevor eines der beiden Artefakte veröffentlicht wird. 3. `scripts/android_smoke.py` testet ein gebautes Artefakt auf einem gerooteten Gerät: authentifizierter abstrakter UNIX-Transport, RPC mit dem Standard-Client, Spawn, Attach, Java-Bridge-Assertions, `/proc`-Prüfungen, ein externer Root-Speicherscan und ein separat geladenes Gadget. Ein bestandener Quellcode-Test oder Byte-Scan ist nicht gleichbedeutend mit Laufzeit-Tarnung. Aussagen über das Android-Verhalten sollten den erzeugten, redigierten Smoke-Test-Bericht enthalten. ## Build mit GitHub Actions Führe **Build Custom Frida** über den Actions-Tab aus. Der wiederverwendbare Build-Workflow: - validiert jede benutzergesteuerte Build-Eingabe; - lädt Android NDK r29 von Google herunter und prüft dessen veröffentlichte Prüfsumme; - klont einen frischen Upstream-Quellbaum, anstatt gepatchten Quellcode zwischenzuspeichern; - entfernt Gadget-Symbole und lädt erst hoch, nachdem die harten Artefakt- und Marker-Gates bestanden sind; - enthält `build-info.json` und `SHA256SUMS` in einem Build-Artefakt. Der wöchentliche Workflow ermittelt die neueste Version über die authentifizierte GitHub-API, ruft denselben schreibgeschützten Build-Workflow auf, verifiziert das heruntergeladene Artefakt, attestiert es und erteilt Schreibberechtigung für Releases nur dem abschließenden Job. ## Lokaler Build Voraussetzungen: - Ubuntu 22.04 oder neuer (WSL wird unterstützt); - Python 3.10 oder neuer; - Git, curl, unzip, eine C/C++-Toolchain, JDK 17 und Node.js 18 oder neuer (CI verwendet Node.js 24.13.1); - Android SDK Platform und Build-Tools mit `android.jar` und D8; - etwa 20 GB freier Speicherplatz. Wenn `--ndk-path` weggelassen wird, lädt der Builder Android NDK r29 unter `build/` herunter. Ein verifizierter arm64-Build mit festgelegten Eingaben ist: ```bash export ANDROID_SDK_ROOT=/path/to/Android/Sdk python3 build.py \ --version 17.16.4 \ --name oemcodec \ --arch android-arm64 \ --port 27142 \ --extended \ --strict-wx \ --verify ``` Nützliche Optionen: ```text --version, -v Exact Frida semantic version (required) --name, -n Lowercase replacement name, 3-20 characters --arch, -a One or more supported Android architectures --port, -p Listening port; omitted keeps 27042 --extended, -e Apply the optional extended identifier transformations --strict-wx Harden Frida-owned persistent anonymous RWX mappings on Android --temp-fixes Apply opt-in, device-specific stability changes --verify Reject known forbidden markers in final artifacts --skip-build Patch source without compiling --skip-clone Use an existing source tree in the work directory --ndk-path Use an existing Android NDK r29 directory ``` ## Ausgaben und Herkunftsnachweis Für das obige Beispiel enthält `output/`: ```text oemcodec-server-17.16.4-android-arm64 oemcodec-server-17.16.4-android-arm64.gz oemcodec-gadget-17.16.4-android-arm64.so oemcodec-gadget-17.16.4-android-arm64.so.gz build-info.json SHA256SUMS ``` `build-info.json` zeichnet die exakten Builder-, Frida- und frida-core-Commits, die NDK-Version, die UTC-Build-Zeit, die Architekturen, den Namen, den Port, den strikten W^X-Code-Pool-Modus und die Workflow-URL auf, wenn in Actions gebaut wurde. Überprüfen Sie heruntergeladene Binärdateien vor der Verwendung: ```bash cd output sha256sum --check SHA256SUMS python3 -m json.tool build-info.json >/dev/null ``` Öffentliche wöchentliche Releases erhalten außerdem eine GitHub-Build-Provenance-Attestierung. `SHA256SUMS` identifiziert einen Ausgabesatz; es wird nicht erwartet, dass Binär-Hashes über verschiedene Build-Hosts hinweg übereinstimmen. ## Kompatibilität mit Stock-Clients Der Builder bewahrt die D-Bus-Protokollschnittstellen unter `re.frida.*`, den Pfad `/re/frida/GadgetSession`, öffentliche `Frida`-JavaScript-API-Strings mit Großbuchstaben und generierte C-ABI-Symbole, die von Stock-Clients benötigt werden. Das Umbenennen dieser Werte würde den normalen Frida-Client/Server-Vertrag brechen. Der D-Bus-Dienstbezeichner, das Helper-JNI-Paket, das Zymbiote-Socket-Präfix, ausgewählte Prozess-/Bibliotheks-/Pfad-Bezeichner, ausgewählte Thread-Namen und ein optionaler benutzerdefinierter Port sind separate Implementierungsdetails, die der Builder transformieren kann. Der Ausgabe-Verifier lehnt diesen expliziten Marker-Satz ab: ```text frida\0 frida-zymbiote re/frida/HelperBackend frida-server frida-helper frida-agent frida-gadget frida-eternal-agent frida-generate-certificate frida-main-loop frida:rpc FridaScriptEngine GLib-GIO GDBusProxy GumScript Frida/ gum-js-loop gmain\0 gdbus\0 pool-frida pool-spawner jit-cache\0 ``` Der exakte öffentliche API-String `Frida\0` und die auf der Allowlist stehenden `re.frida.*`-Protokollbezeichner bleiben absichtlich erhalten. Das HTTP/Inspector-Präfix `Frida/` ist ein Verifier-Fehler und wird unabhängig davon umbenannt. ## Abnahme auf gerootetem Android Installiere die exakte Python-Bindung, die in `build-info.json` aufgezeichnet ist, installiere die gepinnte Java-Bridge-Abhängigkeit und verbinde genau ein gerootetes Android-Gerät: ```bash python3 -m pip install "frida==17.16.4" frida-tools npm ci --ignore-scripts python3 scripts/android_smoke.py \ --server output/oemcodec-server-17.16.4-android-arm64 \ --gadget output/oemcodec-gadget-17.16.4-android-arm64.so \ --name oemcodec \ --port 27142 \ --package com.example.app \ --ndk build/android-ndk-r29 \ --report android-smoke-report.json ``` Das Paket muss eine installierte Java-Anwendung sein, für deren Test Sie autorisiert sind. Die Testumgebung kompiliert `test_comprehensive.js` mit der expliziten `frida-java-bridge`, die von Frida 17 benötigt wird. Server und Gadget lauschen jeweils auf einem zufälligen authentifizierten abstrakten UNIX-Socket; ihre Host-TCP-Ports existieren nur als ADB-Forwards, und es wird kein TCP-Listener auf dem Gerät bereitgestellt. Die Testumgebung kompiliert außerdem eine ABI-konforme Root-Probe, die die eingebundenen Agent- und Gadget-Images über `/proc/<pid>/mem` scannt, außerhalb der eigenen Prozesssicht von Frida. Sie räumt ihre Prozesse, Forwards und das entfernte Testverzeichnis beim Beenden auf. Das `/proc`-Gate weist außerdem veraltete `linjector`-Dateideskriptor-Namen und eine `TracerPid` ungleich null zurück. Die Frida-Gadget-Konfiguration muss neben der Bibliothek als `lib<name>-gadget.config.so` benannt werden; die Testumgebung generiert und deployt diese Datei. ## Entwicklungsprüfungen ```bash python -m pip install --requirement requirements-dev.txt npm ci --ignore-scripts python -m pytest ruff check . ruff format --check . mypy build.py patches.py namegen.py scripts node --check test_comprehensive.js bash -n build-wsl.sh go run github.com/rhysd/actionlint/cmd/[email protected] ``` Siehe [CONTRIBUTING.md](https://github.com/theqmaks/phantom-frida/blob/master/CONTRIBUTING.md) für die vollständigen Anforderungen an Nachweise. ## Repository-Struktur ```text build.py Clone, patch, compile, verify, and collect artifacts patches.py Source and same-length binary transformations namegen.py Seeded build-name and port generation scripts/android_smoke.py Rooted Android Server/Gadget acceptance harness test_comprehensive.js Structured Frida 17 Java bridge assertions tests/ Unit, contract, fixture, and workflow tests .github/workflows/ CI, CodeQL, reusable build, and release isolation ``` ## Bekannte Grenzen - Nur Frida 17.16.4 ist das aktuelle Verifikationsziel; die Unterstützung wird nicht für alle 17.x- oder 16.x-Versionen abgeleitet. - `--temp-fixes` ändert das Laufzeitverhalten und bleibt optional. - Das Fehlen von Markern beweist keine Resistenz gegen verhaltensbasierte, Integritäts-, Timing- oder anwendungsspezifische Erkennung. - Die Kompatibilität mit dem Stock-Client bewahrt das öffentliche ABI-/Protokollverhalten. Aktives Protokoll-Probing und Code-Integritätsprüfungen können Instrumentierung dennoch identifizieren. - Dieser Builder versteckt weder Root, automatisierten App-Start, Interceptor-Code- Änderungen, User-Script-Strings noch Fehler, die von Remote-Attestation gemeldet werden. - `--strict-wx` trennt den ausführbaren Code des Android-Injectors von beschreibbaren Daten- und Stack-Seiten, deaktiviert Gums persistente RWX-Code-Pools, platziert GumJS `NativeCallback`-Closure-Code auf dedizierten RX-Seiten, während der libffi- Speicher RW bleibt, und finalisiert neu generierten Code als RX. Wenn eine passende Remote- libc nicht verfügbar ist, schlägt der Android-Injector fail-closed fehl, anstatt seinen Upstream-RWX-Fallback zu verwenden. Er bewahrt Seiten, die bereits RWX waren, und lehnt eine explizite User-Script-Anfrage nach RWX-Speicher nicht ab. Eine Laufzeit-`/proc/maps`- Stichprobe beweist nicht, dass während des Patchings von ausführbarem Code keine vorübergehende RWX-Berechtigungsänderung auftritt. - Das externe Speicher-Gate scannt die gemappten Agent-/Gadget-Images nach seinem expliziten Marker-Set; es ist kein Allzweck-Scan jeder anonymen Heap-Seite. - Frida 17 Raw-Agents benötigen explizite Bridge-Imports oder Bundling. Das Harness verwendet `frida.Compiler`; die Frida REPL und der Tracer stellen ihre eigenen gebündelten Bridges bereit. ## Danksagungen und Lizenzierung - [Frida](https://frida.re/) von Ole André Ravnas und Mitwirkenden - [ajeossida](https://github.com/hackcatml/ajeossida) von hackcatml Der Builder-Code ist unter MIT lizenziert. Generierte Binärdateien behalten die Upstream-Lizenzierung; siehe [THIRD_PARTY_NOTICES.md](https://github.com/theqmaks/phantom-frida/blob/master/THIRD_PARTY_NOTICES.md).