
🪅 Emulatore userspace per Windows, Linux e 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 esegue programmi Windows, Linux e [macOS](#macos-programs-rudimentary), senza un vero sistema operativo: ti permette di vedere e controllare tutto ciò che fanno.
Invece di reimplementare migliaia di API del sistema operativo, Sogen emula i binari a livello di CPU e syscall ed esegue le **vere DLL di sistema**, così il comportamento è molto vicino a quello del sistema operativo reale.
Ogni istruzione, accesso alla memoria e chiamata API può essere intercettato, ispezionato o riscritto, le esecuzioni sono completamente deterministiche e l'intero stato dell'emulatore può essere salvato in snapshot e ripristinato.
Scritto in C++ e basato sul backend CPU che preferisci:
- [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)
Provalo: <a href="https://sogen.dev">sogen.dev</a>
Unisciti alla community: <a href="https://discord.sogen.dev">Discord</a>
## Caratteristiche principali
- **Vere DLL di sistema**: esegue le effettive ntdll, kernel32 e user32, non stub reimplementati
- **Hook e riscrittura**: intercetta e modifica memoria, istruzioni, syscall e chiamate API
- **Internals di Windows fedeli**: caricamento PE (rilocazioni, TLS), tipi di memoria di Windows, SEH, threading, registro, filesystem e networking
- **Snapshot e ripristino**: serializzazione completa dello stato, snapshot veloci in memoria e caricamento di minidump
- **Funziona ovunque**: Windows, Linux, macOS, Android, iOS e nel browser, su x86-64 e arm64
- **Deterministico**: ogni esecuzione è riproducibile, fino alla singola istruzione
## Anteprima
<img src="https://momo5502.com/sogen/preview.svg" width="650" alt="Anteprima" />
## Debugging non rilevabile
Esegui il debug con gli strumenti che già conosci, come IDA Pro o GDB, tramite il protocollo GDB, oppure usa il debugger integrato nel browser.
Il debugger opera a livello dell'emulatore, al di fuori del processo, quindi resta invisibile ai controlli anti-debug.
<img src="https://assets.kitploit.com/production/public/readmes/48935/a18ec942ce8aa95c626bb55f02dc76c6e61dd781f80b1099f2c1c39bfffa41fe.png" width="650" alt="Debug di un processo in esecuzione in Sogen da una sessione GDB remota di IDA Pro" />
## Esegui giochi in una sandbox
Le app GUI native funzionano, con finestre, dialoghi e controlli operativi.
La paravirtualizzazione della GPU abilita l'accelerazione 3D sulla tua GPU reale, mentre il backend Hyper-V esegue il codice nativamente sulla tua CPU. Abbastanza veloce per i giochi.
I titoli Direct3D 8/9/10/11 funzionano tramite [DXVK](https://github.com/doitsujin/dxvk), che traduce Direct3D in Vulkan sopra il bridge GPU.
<img src="https://assets.kitploit.com/production/public/readmes/48935/11eb76db68f76b9fd16886f6cdf31477646ced84c4f7509b7c0df31c967a017f.png" width="650" alt="Un gioco in esecuzione all'interno dell'emulatore Sogen" />
## Panoramica del progetto
<a href="https://www.youtube.com/watch?v=wY9Q0DhodOQ" target="_blank">
<img src="https://assets.kitploit.com/production/public/readmes/48935/748dda1f1cc6eca0dfd951918f34dc4c5e15bd5c71a571fee6eaa606ab076cd2.png" alt="Video YouTube" width="600" />
</a>
Clicca <a href="https://docs.google.com/presentation/d/1pha4tFfDMpVzJ_ehJJ21SA_HAWkufQBVYQvh1IFhVls/edit">qui</a> per le slide.
## Binding Python
Installa con:
```bash
pip install sogen
```
I binding Python richiedono una root di emulazione. Puoi scaricare una root già pronta [qui](https://sogen.dev/root.zip), oppure crearne una tua seguendo le istruzioni nella [wiki](https://github.com/momo5502/sogen/wiki/Run-The-Emulator#emulation-root-environment).
Esempio:
```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)
```
Vedi `examples/python/README.md` per i dettagli di configurazione e un esempio più ampio.
## Binding non ufficiali
I [binding Dart](https://github.com/Wdestroier/sogen_dart) sono disponibili in un repository separato.
## Avvio rapido (Windows + Visual Studio)
> [!TIP]
> Consulta la [Wiki](https://github.com/momo5502/sogen/wiki) per maggiori dettagli su come compilare ed eseguire l'emulatore su Windows, Linux, macOS, ...
1\. Scarica il codice:
```bash
git clone --recurse-submodules https://github.com/momo5502/sogen.git
```
2\. Esegui il seguente comando in un x64 Development Command Prompt nella directory clonata:
```bash
cmake --preset=vs2022
```
3\. Compila la soluzione generata in `build/vs2022/sogen.sln`
4\. Crea un dump del registro eseguendo [grab-registry.bat](https://github.com/momo5502/sogen/blob/main/src/tools/grab-registry.bat) come amministratore e inseriscilo nella cartella degli artefatti accanto a `analyzer.exe`
5\. Esegui il programma che preferisci:
```bash
analyzer.exe C:\example.exe
```
Per impostazione predefinita, il guest non ha accesso alla rete dell'host. I socket del guest utilizzano un loopback in-process, le query DNS non risolvono ad alcun indirizzo e il bridge Steam è disabilitato. Per concedere al guest l'accesso alla rete dell'host, aggiungere `--network live`:
```bash
analyzer.exe --network live C:\example.exe
```
Il file system guest è di sola lettura per impostazione predefinita, e le scritture guest falliscono con `STATUS_ACCESS_DENIED`. Usa
`--root-mode rw` per consentire al guest di modificare la root di emulazione, oppure è l'host a gestirla quando non è impostata alcuna root. Usa
`--mount HOST:GUEST[:MODE]` per aggiungere un file o una directory dell'host in un percorso guest, ad esempio
`--mount .\out:C:\out:rw`. Consulta [docs/filesystem.md](https://github.com/momo5502/sogen/blob/main/docs/filesystem.md) per i dettagli su mount e modalità.
Gli eseguibili Windows ARM64 funzionano allo stesso modo, da una root di emulazione creata con [create-root.bat](https://github.com/momo5502/sogen/blob/main/src/tools/create-root.bat) su una macchina Windows ARM64. Vengono eseguiti su WHP su Windows ARM64, su Hypervisor.framework su Apple Silicon e su Unicorn altrove.
`--backend` sovrascrive la selezione basata sull'ambiente. Al di fuori di Windows ARM64, dove il backend ARM64 di Unicorn non è compilato, `EMULATOR_UNICORN=1` esegue i guest ARM64 su Unicorn invece che sull'hypervisor.
## Programmi macOS (rudimentali)
Il supporto macOS è in una fase iniziale. Sogen esegue programmi da riga di comando macOS x86-64 tramite il vero dyld e la dyld shared cache del sistema, il che è sufficiente per strumenti semplici come `echo`. La maggior parte degli altri programmi si ferma ancora a una syscall non implementata.
1\. Crea una root di emulazione su un Mac il cui sistema fornisce ancora le slice x86-64. Lo script copia dyld, `/bin/echo` e la shared cache x86-64:
```bash
src/tools/create-macos-root.sh /tmp/macos-root
```
La licenza macOS non consente la ridistribuzione della root né l'esecuzione su hardware non Apple, pertanto non è disponibile per il download e deve rimanere sul Mac che l'ha creata.
2\. Eseguire un programma dalla root impostando `EMULATOR_MACOS=1`:
```bash
EMULATOR_MACOS=1 build/release/artifacts/analyzer --root /tmp/macos-root /tmp/macos-root/bin/echo hello
```