
🪅 Эмулятор пользовательского пространства для Windows, Linux и 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 запускает программы для Windows, Linux и [macOS](#macos-programs-rudimentary) без реальной операционной системы: он позволяет видеть и контролировать всё, что они делают.
Вместо того чтобы заново реализовывать тысячи API операционной системы, Sogen эмулирует бинарные файлы на уровне CPU и системных вызовов и запускает **настоящие системные DLL**, поэтому поведение близко соответствует реальной ОС.
Каждую инструкцию, обращение к памяти и вызов API можно перехватить, исследовать или переписать, запуски полностью детерминированы, а всё состояние эмулятора можно сохранить в снимок и восстановить.
Написан на C++ и работает на выбранном вами бэкенде CPU:
- [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)
Попробуйте: <a href="https://sogen.dev">sogen.dev</a>
Присоединяйтесь к сообществу: <a href="https://discord.sogen.dev">Discord</a>
## Ключевые возможности
- **Настоящие системные DLL**: запускает реальные ntdll, kernel32 и user32, а не переписанные заглушки
- **Перехват и переписывание**: перехватывайте и изменяйте память, инструкции, системные вызовы и вызовы API
- **Достоверная внутренняя реализация Windows**: загрузка PE (релокации, TLS), типы памяти Windows, SEH, потоки, реестр, файловая система и сеть
- **Снимки и восстановление**: полная сериализация состояния, быстрые снимки в памяти и загрузка minidump
- **Работает везде**: Windows, Linux, macOS, Android, iOS и браузер, на x86-64 и arm64
- **Детерминированность**: каждый запуск воспроизводим вплоть до инструкции
## Предпросмотр
<img src="https://momo5502.com/sogen/preview.svg" width="650" alt="Preview" />
## Незаметная отладка
Отлаживайте с помощью знакомых инструментов, таких как IDA Pro или GDB, по протоколу GDB, или используйте встроенный отладчик в браузере.
Отладчик работает на уровне эмулятора, вне процесса, поэтому остаётся невидимым для проверок на отладку.
<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" />
## Запуск игр в песочнице
Работают нативные GUI-приложения с рабочими окнами, диалогами и элементами управления.
Паравиртуализация GPU обеспечивает 3D-ускорение на вашем реальном GPU, а бэкенд Hyper-V выполняет код нативно на вашем CPU. Достаточно быстро для игр.
Игры на Direct3D 8/9/10/11 запускаются через [DXVK](https://github.com/doitsujin/dxvk), который транслирует Direct3D в Vulkan поверх моста GPU.
<img src="https://assets.kitploit.com/production/public/readmes/48935/11eb76db68f76b9fd16886f6cdf31477646ced84c4f7509b7c0df31c967a017f.png" width="650" alt="A game running inside the Sogen emulator" />
## Обзор проекта
<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>
Нажмите <a href="https://docs.google.com/presentation/d/1pha4tFfDMpVzJ_ehJJ21SA_HAWkufQBVYQvh1IFhVls/edit">здесь</a>, чтобы посмотреть слайды.
## Привязки для Python
Установка:
```bash
pip install sogen
```
Привязки Python требуют корня эмуляции. Вы можете скачать готовый корень [здесь](https://sogen.dev/root.zip) или создать свой собственный, следуя инструкциям в [wiki](https://github.com/momo5502/sogen/wiki/Run-The-Emulator#emulation-root-environment).
Пример:
```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)
```
См. `examples/python/README.md` для деталей настройки и более крупного примера.
## Неофициальные привязки
[Привязки для Dart](https://github.com/Wdestroier/sogen_dart) доступны в отдельном репозитории.
## Быстрый старт (Windows + Visual Studio)
> [!TIP]
> Ознакомьтесь с [Wiki](https://github.com/momo5502/sogen/wiki) для получения более подробной информации о том, как собрать и запустить эмулятор в Windows, Linux, macOS, ...
1\. Получите код:
```bash
git clone --recurse-submodules https://github.com/momo5502/sogen.git
```
2\. Выполните следующую команду в x64 Development Command Prompt в клонированном каталоге:
```bash
cmake --preset=vs2022
```
3\. Соберите решение, созданное в `build/vs2022/sogen.sln`
4\. Создайте дамп реестра, запустив [grab-registry.bat](https://github.com/momo5502/sogen/blob/main/src/tools/grab-registry.bat) от имени администратора, и поместите его в папку artifacts рядом с `analyzer.exe`
5\. Запустите программу на ваш выбор:
```bash
analyzer.exe C:\example.exe
```
По умолчанию гость не имеет доступа к сети хоста. Сокеты гостя используют внутрипроцессный loopback, DNS-запросы не разрешаются ни в какие адреса, а мост Steam отключён. Чтобы предоставить гостю доступ к сети хоста, добавьте `--network live`:
```bash
analyzer.exe --network live C:\example.exe
```
Гостевая файловая система по умолчанию доступна только для чтения, и запись из гостя завершается ошибкой `STATUS_ACCESS_DENIED`. Используйте
`--root-mode rw`, чтобы разрешить гостю изменять корень эмуляции, или же хост управляет этим, когда корень не задан. Используйте
`--mount HOST:GUEST[:MODE]`, чтобы добавить файл или каталог хоста по пути гостя, например
`--mount .\out:C:\out:rw`. Подробности о монтированиях и режимах см. в [docs/filesystem.md](https://github.com/momo5502/sogen/blob/main/docs/filesystem.md).
Исполняемые файлы Windows ARM64 запускаются так же — из корня эмуляции, созданного с помощью [create-root.bat](https://github.com/momo5502/sogen/blob/main/src/tools/create-root.bat) на машине с Windows ARM64. Они работают на WHP в Windows ARM64, на Hypervisor.framework на Apple Silicon и на Unicorn в остальных случаях.
`--backend` переопределяет выбор на основе переменных окружения. Вне Windows ARM64, где бэкенд ARM64 для Unicorn не собран, `EMULATOR_UNICORN=1` запускает гостей ARM64 на Unicorn вместо гипервизора.
## Программы macOS (базовый уровень)
Поддержка macOS находится на ранней стадии. Sogen запускает x86-64 командные программы macOS через настоящий dyld и системный общий кэш dyld, чего достаточно для простых инструментов вроде `echo`. Большинство других программ по-прежнему останавливаются на нереализованном системном вызове.
1\. Соберите корень эмуляции на Mac, система которого всё ещё содержит x86-64-срезы. Скрипт копирует dyld, `/bin/echo` и общий кэш x86-64:
```bash
src/tools/create-macos-root.sh /tmp/macos-root
```
Лицензия macOS не допускает распространения root или его запуска на не-Apple оборудовании, поэтому он недоступен для скачивания и должен оставаться на Mac, на котором был собран.
2\. Запустите программу из root, установив `EMULATOR_MACOS=1`:
```bash
EMULATOR_MACOS=1 build/release/artifacts/analyzer --root /tmp/macos-root /tmp/macos-root/bin/echo hello
```