
🪅 Userspace-Emulator für Windows, Linux & macOS
<h1 align="center">
<a href="https://github.com/momo5502/sogen"><img src="https://momo5502.com/sogen/sogen.svg" height="200" /></a>
<br>
<a href="https://discord.sogen.dev"><img src="https://img.shields.io/badge/discord-come%20chat-00B0F8?logo=discord&logoColor=white"/></a>
<a href="https://github.com/momo5502/sogen/actions"><img src="https://img.shields.io/github/actions/workflow/status/momo5502/sogen/build.yml?branch=main&label=build"/></a>
<a href="https://github.com/momo5502/sogen/issues"><img src="https://img.shields.io/github/issues/momo5502/sogen?color=F8B000"/></a>
<img src="https://img.shields.io/github/commit-activity/m/momo5502/sogen?color=FF3131"/>
</h1>
Sogen führt Windows-, Linux- und [macOS](#macos-programs-rudimentary)-Programme ohne ein echtes Betriebssystem aus: Es ermöglicht dir, alles zu sehen und zu steuern, was sie tun.
Anstatt Tausende von Betriebssystem-APIs neu zu implementieren, emuliert Sogen Binärdateien auf CPU- und Syscall-Ebene und führt die **echten System-DLLs** aus, sodass das Verhalten eng mit dem echten Betriebssystem übereinstimmt.
Jede Anweisung, jeder Speicherzugriff und jeder API-Aufruf kann abgefangen, inspiziert oder umgeschrieben werden, Ausführungen sind vollständig deterministisch, und der gesamte Emulatorzustand kann als Snapshot gesichert und wiederhergestellt werden.
In C++ entwickelt und angetrieben vom CPU-Backend deiner Wahl:
- [Unicorn Engine](https://github.com/unicorn-engine/unicorn)
- [icicle-emu](https://github.com/icicle-emu/icicle-emu)
- [Hyper-V (WHP)](https://learn.microsoft.com/en-us/virtualization/api/hypervisor-platform/hypervisor-platform)
- [KVM](https://www.kernel.org/doc/html/latest/virt/kvm/api.html)
- [FEX](https://fex-emu.com)
Probiere es aus: <a href="https://sogen.dev">sogen.dev</a>
Tritt der Community bei: <a href="https://discord.sogen.dev">Discord</a>
## Hauptfunktionen
- **Echte System-DLLs**: führt die tatsächlichen ntdll, kernel32 und user32 aus, keine neu implementierten Stubs
- **Hooks & Umschreiben**: Speicher, Anweisungen, Syscalls und API-Aufrufe abfangen und verändern
- **Getreue Windows-Interna**: PE-Laden (Relocations, TLS), Windows-Speichertypen, SEH, Threading, die Registry, Dateisystem und Netzwerk
- **Snapshot & Wiederherstellung**: vollständige Zustandsserialisierung, schnelle In-Memory-Snapshots und Minidump-Laden
- **Läuft überall**: Windows, Linux, macOS, Android, iOS und im Browser, auf x86-64 und arm64
- **Deterministisch**: jede Ausführung ist reproduzierbar, bis hin zur einzelnen Anweisung
## Vorschau
<img src="https://momo5502.com/sogen/preview.svg" width="650" alt="Vorschau" />
## Nicht erkennbares Debugging
Debugge mit den Tools, die du bereits kennst, wie IDA Pro oder GDB, über das GDB-Protokoll, oder nutze den integrierten In-Browser-Debugger.
Der Debugger läuft auf Emulator-Ebene, außerhalb des Prozesses, und bleibt daher für Anti-Debug-Prüfungen unsichtbar.
<img src="https://assets.kitploit.com/production/public/readmes/48935/a18ec942ce8aa95c626bb55f02dc76c6e61dd781f80b1099f2c1c39bfffa41fe.png" width="650" alt="Debuggen eines in Sogen laufenden Prozesses aus einer IDA Pro Remote-GDB-Sitzung" />
## Spiele in einer Sandbox ausführen
Native GUI-Anwendungen laufen, mit funktionierenden Fenstern, Dialogen und Steuerelementen.
GPU-Paravirtualisierung ermöglicht 3D-Beschleunigung auf deiner echten GPU, während das Hyper-V-Backend den Code nativ auf deiner CPU ausführt. Schnell genug für Spiele.
Direct3D-8/9/10/11-Titel laufen über [DXVK](https://github.com/doitsujin/dxvk), das Direct3D auf Vulkan über die GPU-Bridge übersetzt.
<img src="https://assets.kitploit.com/production/public/readmes/48935/11eb76db68f76b9fd16886f6cdf31477646ced84c4f7509b7c0df31c967a017f.png" width="650" alt="Ein im Sogen-Emulator laufendes Spiel" />
## Projektübersicht
<a href="https://www.youtube.com/watch?v=wY9Q0DhodOQ" target="_blank">
<img src="https://assets.kitploit.com/production/public/readmes/48935/748dda1f1cc6eca0dfd951918f34dc4c5e15bd5c71a571fee6eaa606ab076cd2.png" alt="YouTube-Video" width="600" />
</a>
Klicke <a href="https://docs.google.com/presentation/d/1pha4tFfDMpVzJ_ehJJ21SA_HAWkufQBVYQvh1IFhVls/edit">hier</a> für die Folien.
## Python-Bindings
Installation mit:
```bash
pip install sogen
```
Python-Bindings erfordern ein Emulations-Root. Du kannst ein fertiges Root [hier](https://sogen.dev/root.zip) herunterladen oder dein eigenes erstellen, indem du den Anweisungen im [Wiki](https://github.com/momo5502/sogen/wiki/Run-The-Emulator#emulation-root-environment) folgst.
Beispiel:
```python
import sogen
emu = sogen.windows.create_application("c:/test-sample.exe", emulation_root="./root")
def on_module_load(module):
if module.name.lower() == "test-sample.exe":
emu.hooks.memory_execution_at(module.entry_point, lambda address: print(f"hit entry point: 0x{address:x}"))
emu.callbacks.on_module_load = on_module_load
emu.start()
print(emu.process.exit_status)
```
Siehe `examples/python/README.md` für Einrichtungsdetails und ein größeres Beispiel.
## Inoffizielle Bindings
[Dart-Bindings](https://github.com/Wdestroier/sogen_dart) sind in einem separaten Repository verfügbar.
## Schnellstart (Windows + Visual Studio)
> [!TIP]
> Weitere Details zum Erstellen und Ausführen des Emulators unter Windows, Linux, macOS, ... finden Sie im [Wiki](https://github.com/momo5502/sogen/wiki).
1\. Code auschecken:
```bash
git clone --recurse-submodules https://github.com/momo5502/sogen.git
```
2\. Führen Sie den folgenden Befehl in einer x64-Entwicklereingabeaufforderung im geklonten Verzeichnis aus:
```bash
cmake --preset=vs2022
```
3\. Erstellen Sie die Lösung, die unter `build/vs2022/sogen.sln` generiert wurde
4\. Erstellen Sie einen Registry-Dump, indem Sie [grab-registry.bat](https://github.com/momo5502/sogen/blob/main/src/tools/grab-registry.bat) als Administrator ausführen, und legen Sie ihn im Artefaktordner neben der `analyzer.exe` ab
5\. Führen Sie das Programm Ihrer Wahl aus:
```bash
analyzer.exe C:\example.exe
```
Standardmäßig hat der Gast keinen Zugriff auf das Host-Netzwerk. Gast-Sockets verwenden ein In-Process-Loopback, DNS-Abfragen werden zu keinen Adressen aufgelöst, und die Steam-Bridge ist deaktiviert. Um dem Gast Zugriff auf das Host-Netzwerk zu gewähren, fügen Sie `--network live` hinzu:
```bash
analyzer.exe --network live C:\example.exe
```
Das Gastdateisystem ist standardmäßig schreibgeschützt, und Schreibzugriffe des Gasts schlagen mit `STATUS_ACCESS_DENIED` fehl. Verwenden Sie
`--root-mode rw`, damit der Gast das Emulations-Root ändern kann, oder der Host steuert, wenn kein Root festgelegt ist. Verwenden Sie
`--mount HOST:GUEST[:MODE]`, um eine Host-Datei oder ein Host-Verzeichnis an einem Gastpfad hinzuzufügen, zum Beispiel
`--mount .\out:C:\out:rw`. Details zu Mounts und Modi finden Sie in [docs/filesystem.md](https://github.com/momo5502/sogen/blob/main/docs/filesystem.md).
Windows-ARM64-Executables werden auf dieselbe Weise ausgeführt, und zwar aus einem Emulations-Root, das mit [create-root.bat](https://github.com/momo5502/sogen/blob/main/src/tools/create-root.bat) auf einer Windows-ARM64-Maschine erstellt wurde. Sie laufen unter WHP unter Windows ARM64, unter Hypervisor.framework auf Apple Silicon und andernorts unter Unicorn.
`--backend` überschreibt die umgebungsbasierte Auswahl. Außerhalb von Windows ARM64, wo Unicorns ARM64-Backend nicht gebaut wird, führt `EMULATOR_UNICORN=1` ARM64-Gäste stattdessen unter Unicorn statt unter dem Hypervisor aus.
## macOS-Programme (rudimentär)
Die macOS-Unterstützung befindet sich in einem frühen Stadium. Sogen führt x86-64-macOS-Kommandozeilenprogramme über den echten dyld und den dyld-Shared-Cache des Systems aus, was für einfache Werkzeuge wie `echo` ausreicht. Die meisten anderen Programme bleiben noch bei einem nicht implementierten Systemaufruf stehen.
1\. Erstellen Sie ein Emulations-Root auf einem Mac, dessen System noch x86-64-Slices mitliefert. Das Skript kopiert dyld, `/bin/echo` und den x86-64-Shared-Cache:
```bash
src/tools/create-macos-root.sh /tmp/macos-root
```
Die macOS-Lizenz erlaubt es nicht, den Root weiterzuverbreiten oder ihn auf Nicht-Apple-Hardware auszuführen, daher steht er nicht zum Download zur Verfügung und muss auf dem Mac verbleiben, auf dem er erstellt wurde.
2\. Führen Sie ein Programm aus dem Root aus, indem Sie `EMULATOR_MACOS=1` setzen:
```bash
EMULATOR_MACOS=1 build/release/artifacts/analyzer --root /tmp/macos-root /tmp/macos-root/bin/echo hello
```