
🪅 Emulador de espacio de usuario para Windows, Linux y macOS
Descubre las herramientas más usadas por nuestra comunidad.
Explora todas las herramientas
Explora nuestra colección de herramientas
Ver todas las herramientas →<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 ejecuta programas de Windows, Linux y [macOS](#macos-programs-rudimentary), sin un sistema operativo real: te permite ver y controlar todo lo que hacen.
En lugar de reimplementar miles de API del sistema operativo, Sogen emula binarios a nivel de CPU y syscall y ejecuta las **DLLs reales del sistema**, por lo que el comportamiento se aproxima mucho al del sistema operativo real.
Cada instrucción, acceso a memoria y llamada a la API puede ser interceptada, inspeccionada o reescrita, las ejecuciones son totalmente deterministas, y todo el estado del emulador puede capturarse en snapshots y restaurarse.
Construido en C++ e impulsado por el backend de CPU que elijas:
- [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)
Pruébalo: <a href="https://sogen.dev">sogen.dev</a>
Únete a la comunidad: <a href="https://discord.sogen.dev">Discord</a>
## CaracterÃsticas principales
- **DLLs reales del sistema**: ejecuta las auténticas ntdll, kernel32 y user32, no stubs reimplementados
- **Interceptar y reescribir**: intercepta y modifica memoria, instrucciones, syscalls y llamadas a la API
- **Interioridades de Windows fieles**: carga de PE (relocations, TLS), tipos de memoria de Windows, SEH, threading, el registro, el sistema de archivos y la red
- **Snapshot y restauración**: serialización completa del estado, snapshots rápidos en memoria y carga de minidumps
- **Se ejecuta en todas partes**: Windows, Linux, macOS, Android, iOS y el navegador, en x86-64 y arm64
- **Determinista**: cada ejecución es reproducible, hasta el nivel de instrucción
## Vista previa
<img src="https://momo5502.com/sogen/preview.svg" width="650" alt="Preview" />
## Depuración indetectable
Depura con las herramientas que ya conoces, como IDA Pro o GDB, mediante el protocolo GDB, o usa el depurador integrado en el navegador.
El depurador se ejecuta a nivel del emulador, fuera del proceso, por lo que permanece invisible ante las comprobaciones anti-debug.
<img src="https://assets.kitploit.com/production/public/readmes/48935/a18ec942ce8aa95c626bb55f02dc76c6e61dd781f80b1099f2c1c39bfffa41fe.png" width="650" alt="Debugging a process running in Sogen from an IDA Pro remote GDB session" />
## Ejecuta juegos en un sandbox
Las aplicaciones GUI nativas se ejecutan, con ventanas, diálogos y controles funcionales.
La paravirtualización de GPU habilita la aceleración 3D en tu GPU real, mientras que el backend de Hyper-V ejecuta el código de forma nativa en tu CPU. Lo suficientemente rápido para juegos.
Los tÃtulos de Direct3D 8/9/10/11 se ejecutan a través de [DXVK](https://github.com/doitsujin/dxvk), que traduce Direct3D a Vulkan sobre el puente de GPU.
<img src="https://assets.kitploit.com/production/public/readmes/48935/11eb76db68f76b9fd16886f6cdf31477646ced84c4f7509b7c0df31c967a017f.png" width="650" alt="A game running inside the Sogen emulator" />
## Descripción general del proyecto
<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>
Haz clic <a href="https://docs.google.com/presentation/d/1pha4tFfDMpVzJ_ehJJ21SA_HAWkufQBVYQvh1IFhVls/edit">aquÃ</a> para ver las diapositivas.
## Bindings de Python
Instala con:
```bash
pip install sogen
```
Los bindings de Python requieren un root de emulación. Puedes descargar un root ya preparado [aquÃ](https://sogen.dev/root.zip), o crear el tuyo propio siguiendo las instrucciones de la [wiki](https://github.com/momo5502/sogen/wiki/Run-The-Emulator#emulation-root-environment).
Ejemplo:
```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)
```
Consulta `examples/python/README.md` para obtener detalles de configuración y un ejemplo más amplio.
## Enlaces no oficiales
Los [enlaces de Dart](https://github.com/Wdestroier/sogen_dart) están disponibles en un repositorio separado.
## Inicio rápido (Windows + Visual Studio)
> [!TIP]
> Consulta la [Wiki](https://github.com/momo5502/sogen/wiki) para obtener más detalles sobre cómo compilar y ejecutar el emulador en Windows, Linux, macOS, ...
1\. Descarga el código:
```bash
git clone --recurse-submodules https://github.com/momo5502/sogen.git
```
2\. Ejecute el siguiente comando en un SÃmbolo del sistema para desarrolladores x64 en el directorio clonado:
```bash
cmake --preset=vs2022
```
3\. Compila la solución que se generó en `build/vs2022/sogen.sln`
4\. Crea un volcado del registro ejecutando [grab-registry.bat](https://github.com/momo5502/sogen/blob/main/src/tools/grab-registry.bat) como administrador y colócalo en la carpeta de artefactos junto a `analyzer.exe`
5\. Ejecuta el programa que prefieras:
```bash
analyzer.exe C:\example.exe
```
Por defecto, el invitado no tiene acceso a la red del host. Los sockets del invitado usan un loopback en proceso, las consultas DNS no resuelven a ninguna dirección y el puente de Steam está deshabilitado. Para dar al invitado acceso a la red del host, añade `--network live`:
```bash
analyzer.exe --network live C:\example.exe
```
El sistema de archivos invitado es de solo lectura por defecto, y las escrituras del invitado fallan con `STATUS_ACCESS_DENIED`. Use
`--root-mode rw` para permitir que el invitado modifique la raÃz de emulación, o el host controla cuando no se establece una raÃz. Use
`--mount HOST:GUEST[:MODE]` para añadir un archivo o directorio del host en una ruta del invitado, por ejemplo
`--mount .\out:C:\out:rw`. Consulte [docs/filesystem.md](https://github.com/momo5502/sogen/blob/main/docs/filesystem.md) para obtener los detalles de los montajes y modos.
Los ejecutables de Windows ARM64 se ejecutan de la misma manera, desde una raÃz de emulación creada con [create-root.bat](https://github.com/momo5502/sogen/blob/main/src/tools/create-root.bat) en una máquina Windows ARM64. Se ejecutan en WHP en Windows ARM64, en Hypervisor.framework en Apple Silicon y en Unicorn en otros entornos.
`--backend` anula la selección basada en el entorno. Fuera de Windows ARM64, donde el backend ARM64 de Unicorn no está compilado, `EMULATOR_UNICORN=1` ejecuta invitados ARM64 en Unicorn en lugar del hipervisor.
## Programas de macOS (rudimentario)
El soporte de macOS está en una etapa temprana. Sogen ejecuta programas de lÃnea de comandos de macOS x86-64 a través del dyld real y la caché compartida de dyld del sistema, lo cual es suficiente para herramientas simples como `echo`. La mayorÃa de los demás programas todavÃa se detienen en una llamada al sistema no implementada.
1\. Compile una raÃz de emulación en un Mac cuyo sistema todavÃa incluya slices x86-64. El script copia dyld, `/bin/echo` y la caché compartida x86-64:
```bash
src/tools/create-macos-root.sh /tmp/macos-root
```
La licencia de macOS no permite redistribuir el root ni ejecutarlo en hardware que no sea de Apple, por lo que no está disponible para su descarga y debe permanecer en el Mac que lo compiló.
2\. Ejecutar un programa desde el root estableciendo `EMULATOR_MACOS=1`:
```bash
EMULATOR_MACOS=1 build/release/artifacts/analyzer --root /tmp/macos-root /tmp/macos-root/bin/echo hello
```