
🪅 Émulateur en espace utilisateur pour Windows, Linux et 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 exécute des programmes Windows, Linux et [macOS](#macos-programs-rudimentary), sans véritable système d'exploitation : il vous permet de voir et de contrôler tout ce qu'ils font.
Au lieu de réimplémenter des milliers d'API du système d'exploitation, Sogen émule les binaires au niveau du CPU et des appels système et exécute les **véritables DLL système**, de sorte que le comportement correspond étroitement à celui du système d'exploitation réel.
Chaque instruction, accès mémoire et appel d'API peut être intercepté, inspecté ou réécrit, les exécutions sont entièrement déterministes, et l'état complet de l'émulateur peut être sauvegardé et restauré.
Développé en C++ et propulsé par le backend CPU de votre choix :
- [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)
Essayez-le : <a href="https://sogen.dev">sogen.dev</a>
Rejoignez la communauté : <a href="https://discord.sogen.dev">Discord</a>
## Fonctionnalités clés
- **Véritables DLL système** : exécute les vrais ntdll, kernel32 et user32, et non des stubs réimplémentés
- **Interception et réécriture** : interceptez et modifiez la mémoire, les instructions, les appels système et les appels d'API
- **Internes Windows fidèles** : chargement PE (relocations, TLS), types de mémoire Windows, SEH, threading, registre, système de fichiers et réseau
- **Instantanés et restauration** : sérialisation complète de l'état, instantanés en mémoire rapides et chargement de minidumps
- **Fonctionne partout** : Windows, Linux, macOS, Android, iOS et le navigateur, sur x86-64 et arm64
- **Déterministe** : chaque exécution est reproductible, jusqu'à l'instruction près
## Aperçu
<img src="https://momo5502.com/sogen/preview.svg" width="650" alt="Aperçu" />
## Débogage indétectable
Déboguez avec les outils que vous connaissez déjà, comme IDA Pro ou GDB, via le protocole GDB, ou utilisez le débogueur intégré au navigateur.
Le débogueur s'exécute au niveau de l'émulateur, en dehors du processus, ce qui le rend invisible aux vérifications anti-débogage.
<img src="https://assets.kitploit.com/production/public/readmes/48935/a18ec942ce8aa95c626bb55f02dc76c6e61dd781f80b1099f2c1c39bfffa41fe.png" width="650" alt="Débogage d'un processus s'exécutant dans Sogen depuis une session GDB distante d'IDA Pro" />
## Exécuter des jeux dans un bac à sable
Les applications GUI natives s'exécutent, avec des fenêtres, boîtes de dialogue et contrôles fonctionnels.
La paravirtualisation GPU permet l'accélération 3D sur votre véritable GPU, tandis que le backend Hyper-V exécute le code nativement sur votre CPU. Assez rapide pour les jeux.
Les titres Direct3D 8/9/10/11 s'exécutent via [DXVK](https://github.com/doitsujin/dxvk), qui traduit Direct3D en Vulkan au-dessus du pont GPU.
<img src="https://assets.kitploit.com/production/public/readmes/48935/11eb76db68f76b9fd16886f6cdf31477646ced84c4f7509b7c0df31c967a017f.png" width="650" alt="Un jeu s'exécutant dans l'émulateur Sogen" />
## Aperçu du projet
<a href="https://www.youtube.com/watch?v=wY9Q0DhodOQ" target="_blank">
<img src="https://assets.kitploit.com/production/public/readmes/48935/748dda1f1cc6eca0dfd951918f34dc4c5e15bd5c71a571fee6eaa606ab076cd2.png" alt="Vidéo YouTube" width="600" />
</a>
Cliquez <a href="https://docs.google.com/presentation/d/1pha4tFfDMpVzJ_ehJJ21SA_HAWkufQBVYQvh1IFhVls/edit">ici</a> pour les diapositives.
## Bindings Python
Installez avec :
```bash
pip install sogen
```
Les bindings Python nécessitent une racine d'émulation. Vous pouvez télécharger une racine prête à l'emploi [ici](https://sogen.dev/root.zip), ou créer la vôtre en suivant les instructions du [wiki](https://github.com/momo5502/sogen/wiki/Run-The-Emulator#emulation-root-environment).
Exemple :
```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)
```
Voir `examples/python/README.md` pour les détails de configuration et un exemple plus complet.
## Bindings non officiels
Les [bindings Dart](https://github.com/Wdestroier/sogen_dart) sont disponibles dans un dépôt séparé.
## Démarrage rapide (Windows + Visual Studio)
> [!TIP]
> Consultez le [Wiki](https://github.com/momo5502/sogen/wiki) pour plus de détails sur la façon de compiler et d'exécuter l'émulateur sous Windows, Linux, macOS, ...
1\. Récupérez le code :
```bash
git clone --recurse-submodules https://github.com/momo5502/sogen.git
```
2\. Exécutez la commande suivante dans une invite de commandes de développement x64 dans le répertoire cloné :
```bash
cmake --preset=vs2022
```
3\. Compilez la solution qui a été générée dans `build/vs2022/sogen.sln`
4\. Créez un vidage du registre en exécutant [grab-registry.bat](https://github.com/momo5502/sogen/blob/main/src/tools/grab-registry.bat) en tant qu'administrateur et placez-le dans le dossier artifacts à côté de `analyzer.exe`
5\. Exécutez le programme de votre choix :
```bash
analyzer.exe C:\example.exe
```
Par défaut, l'invité n'a aucun accès au réseau de l'hôte. Les sockets de l'invité utilisent une boucle locale en cours de processus, les requêtes DNS ne résolvent vers aucune adresse et le pont Steam est désactivé. Pour donner à l'invité l'accès au réseau de l'hôte, ajoutez `--network live` :
```bash
analyzer.exe --network live C:\example.exe
```
Le système de fichiers invité est en lecture seule par défaut, et les écritures invitées échouent avec `STATUS_ACCESS_DENIED`. Utilisez
`--root-mode rw` pour permettre à l'invité de modifier la racine d'émulation, ou l'hôte pilote lorsqu'aucune racine n'est définie. Utilisez
`--mount HOST:GUEST[:MODE]` pour ajouter un fichier ou un répertoire hôte à un chemin invité, par exemple
`--mount .\out:C:\out:rw`. Consultez [docs/filesystem.md](https://github.com/momo5502/sogen/blob/main/docs/filesystem.md) pour les détails des montages et des modes.
Les exécutables Windows ARM64 s'exécutent de la même manière, à partir d'une racine d'émulation créée avec [create-root.bat](https://github.com/momo5502/sogen/blob/main/src/tools/create-root.bat) sur une machine Windows ARM64. Ils s'exécutent sur WHP sous Windows ARM64, sur Hypervisor.framework sur Apple Silicon et sur Unicorn ailleurs.
`--backend` remplace la sélection basée sur l'environnement. En dehors de Windows ARM64, où le backend ARM64 d'Unicorn n'est pas compilé, `EMULATOR_UNICORN=1` exécute les invités ARM64 sur Unicorn au lieu de l'hyperviseur.
## Programmes macOS (rudimentaire)
Le support de macOS en est à ses débuts. Sogen exécute des programmes en ligne de commande macOS x86-64 via le véritable dyld et le cache partagé dyld du système, ce qui suffit pour des outils simples comme `echo`. La plupart des autres programmes s'arrêtent encore sur un appel système non implémenté.
1\. Construisez une racine d'émulation sur un Mac dont le système fournit encore des tranches x86-64. Le script copie dyld, `/bin/echo` et le cache partagé x86-64 :
```bash
src/tools/create-macos-root.sh /tmp/macos-root
```
La licence macOS n'autorise pas la redistribution de la racine ni son exécution sur du matériel non-Apple ; elle n'est donc pas disponible au téléchargement et doit rester sur le Mac qui l'a construite.
2\. Exécutez un programme depuis la racine en définissant `EMULATOR_MACOS=1` :
```bash
EMULATOR_MACOS=1 build/release/artifacts/analyzer --root /tmp/macos-root /tmp/macos-root/bin/echo hello
```