
🪅 Emulatore userspace per Windows, Linux e macOS
Sogen esegue programmi Windows, Linux e macOS, 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:
Provalo: sogen.dev
Unisciti alla community: Discord
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.
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, che traduce Direct3D in Vulkan sopra il bridge GPU.
Clicca qui per le slide.
Installa con:
pip install sogen
I binding Python richiedono una root di emulazione. Puoi scaricare una root già pronta qui, oppure crearne una tua seguendo le istruzioni nella wiki.
Esempio:
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.
I binding Dart sono disponibili in un repository separato.
[!TIP]
Consulta la Wiki per maggiori dettagli su come compilare ed eseguire l'emulatore su Windows, Linux, macOS, ...
1. Scarica il codice:
git clone --recurse-submodules https://github.com/momo5502/sogen.git
2. Esegui il seguente comando in un x64 Development Command Prompt nella directory clonata:
cmake --preset=vs2022
3. Compila la soluzione generata in build/vs2022/sogen.sln
4. Crea un dump del registro eseguendo grab-registry.bat come amministratore e inseriscilo nella cartella degli artefatti accanto a analyzer.exe
5. Esegui il programma che preferisci:
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:
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 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 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.
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: