
🪅 Emulador em espaço de usuário para 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>
O Sogen executa programas Windows, Linux e [macOS](#macos-programs-rudimentary), sem um sistema operacional real: ele permite que você veja e controle tudo o que eles fazem.
Em vez de reimplementar milhares de APIs do SO, o Sogen emula binários em nível de CPU e syscall e executa as **DLLs reais do sistema**, de modo que o comportamento se aproxima muito do SO real.
Cada instrução, acesso à memória e chamada de API pode ser interceptado, inspecionado ou reescrito, as execuções são totalmente determinísticas, e todo o estado do emulador pode ser capturado em snapshot e restaurado.
Construído em C++ e impulsionado pelo backend de CPU da sua escolha:
- [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)
Experimente: <a href="https://sogen.dev">sogen.dev</a>
Junte-se à comunidade: <a href="https://discord.sogen.dev">Discord</a>
## Principais Recursos
- **DLLs reais do sistema**: executa a ntdll, kernel32 e user32 reais, não stubs reimplementados
- **Interceptar e reescrever**: intercepte e altere memória, instruções, syscalls e chamadas de API
- **Internos fiéis do Windows**: carregamento de PE (relocações, TLS), tipos de memória do Windows, SEH, threading, o registro, sistema de arquivos e rede
- **Snapshot e restauração**: serialização completa do estado, snapshots rápidos em memória e carregamento de minidump
- **Executa em qualquer lugar**: Windows, Linux, macOS, Android, iOS e no navegador, em x86-64 e arm64
- **Determinístico**: cada execução é reproduzível, até a instrução
## Prévia
<img src="https://momo5502.com/sogen/preview.svg" width="650" alt="Prévia" />
## Depuração Indetectável
Depure com as ferramentas que você já conhece, como IDA Pro ou GDB, por meio do protocolo GDB, ou use o depurador integrado no navegador.
O depurador é executado no nível do emulador, fora do processo, portanto permanece invisível para verificações anti-debug.
<img src="https://assets.kitploit.com/production/public/readmes/48935/a18ec942ce8aa95c626bb55f02dc76c6e61dd781f80b1099f2c1c39bfffa41fe.png" width="650" alt="Depurando um processo em execução no Sogen a partir de uma sessão GDB remota do IDA Pro" />
## Execute Jogos em uma Sandbox
Aplicativos GUI nativos são executados, com janelas, diálogos e controles funcionais.
A paravirtualização de GPU permite aceleração 3D na sua GPU real, enquanto o backend Hyper-V executa o código nativamente na sua CPU. Rápido o suficiente para jogos.
Títulos Direct3D 8/9/10/11 são executados por meio do [DXVK](https://github.com/doitsujin/dxvk), que traduz Direct3D para Vulkan sobre a ponte de GPU.
<img src="https://assets.kitploit.com/production/public/readmes/48935/11eb76db68f76b9fd16886f6cdf31477646ced84c4f7509b7c0df31c967a017f.png" width="650" alt="Um jogo em execução dentro do emulador Sogen" />
## Visão Geral do Projeto
<a href="https://www.youtube.com/watch?v=wY9Q0DhodOQ" target="_blank">
<img src="https://assets.kitploit.com/production/public/readmes/48935/748dda1f1cc6eca0dfd951918f34dc4c5e15bd5c71a571fee6eaa606ab076cd2.png" alt="Vídeo do YouTube" width="600" />
</a>
Clique <a href="https://docs.google.com/presentation/d/1pha4tFfDMpVzJ_ehJJ21SA_HAWkufQBVYQvh1IFhVls/edit">aqui</a> para os slides.
## Bindings Python
Instale com:
```bash
pip install sogen
```
Os bindings Python exigem um root de emulação. Você pode baixar um root pronto [aqui](https://sogen.dev/root.zip), ou criar o seu próprio seguindo as instruções na [wiki](https://github.com/momo5502/sogen/wiki/Run-The-Emulator#emulation-root-environment).
Exemplo:
```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)
```
Consulte `examples/python/README.md` para detalhes de configuração e um exemplo maior.
## Bindings não oficiais
Os [bindings para Dart](https://github.com/Wdestroier/sogen_dart) estão disponíveis em um repositório separado.
## Início rápido (Windows + Visual Studio)
> [!TIP]
> Consulte a [Wiki](https://github.com/momo5502/sogen/wiki) para mais detalhes sobre como compilar e executar o emulador no Windows, Linux, macOS, ...
1\. Faça o checkout do código:
```bash
git clone --recurse-submodules https://github.com/momo5502/sogen.git
```
2\. Execute o seguinte comando em um Prompt de Comando de Desenvolvimento x64 no diretório clonado:
```bash
cmake --preset=vs2022
```
3\. Compile a solução que foi gerada em `build/vs2022/sogen.sln`
4\. Crie um dump do registro executando o [grab-registry.bat](https://github.com/momo5502/sogen/blob/main/src/tools/grab-registry.bat) como administrador e coloque-o na pasta de artefatos ao lado do `analyzer.exe`
5\. Execute o programa de sua escolha:
```bash
analyzer.exe C:\example.exe
```
Por padrão, o guest não tem acesso à rede do host. Os sockets do guest usam um loopback em processo, as consultas DNS não resolvem para nenhum endereço e a ponte do Steam está desativada. Para conceder ao guest acesso à rede do host, adicione `--network live`:
```bash
analyzer.exe --network live C:\example.exe
```
O sistema de arquivos do guest é somente leitura por padrão, e as gravações do guest falham com `STATUS_ACCESS_DENIED`. Use
`--root-mode rw` para permitir que o guest altere a raiz de emulação, ou o host controla quando nenhuma raiz está definida. Use
`--mount HOST:GUEST[:MODE]` para adicionar um arquivo ou diretório do host em um caminho do guest, por exemplo
`--mount .\out:C:\out:rw`. Consulte [docs/filesystem.md](https://github.com/momo5502/sogen/blob/main/docs/filesystem.md) para os detalhes de mounts e modos.
Executáveis Windows ARM64 são executados da mesma forma, a partir de uma raiz de emulação criada com [create-root.bat](https://github.com/momo5502/sogen/blob/main/src/tools/create-root.bat) em uma máquina Windows ARM64. Eles são executados no WHP no Windows ARM64, no Hypervisor.framework no Apple Silicon e no Unicorn em outros ambientes.
`--backend` substitui a seleção baseada em ambiente. Fora do Windows ARM64, onde o backend ARM64 do Unicorn não é compilado, `EMULATOR_UNICORN=1` executa guests ARM64 no Unicorn em vez do hypervisor.
## Programas macOS (Rudimentar)
O suporte a macOS está em estágio inicial. O Sogen executa programas de linha de comando x86-64 do macOS por meio do dyld real e do dyld shared cache do sistema, o que é suficiente para ferramentas simples como `echo`. A maioria dos outros programas ainda para em uma syscall não implementada.
1\. Crie uma raiz de emulação em um Mac cujo sistema ainda forneça slices x86-64. O script copia o dyld, `/bin/echo` e o shared cache x86-64:
```bash
src/tools/create-macos-root.sh /tmp/macos-root
```
A licença do macOS não permite redistribuir a root nem executá-la em hardware que não seja da Apple, portanto ela não está disponível para download e deve permanecer no Mac que a criou.
2\. Execute um programa a partir da root definindo `EMULATOR_MACOS=1`:
```bash
EMULATOR_MACOS=1 build/release/artifacts/analyzer --root /tmp/macos-root /tmp/macos-root/bin/echo hello
```