
🪅 Эмулятор пользовательского пространства для Windows, Linux и macOS
Sogen запускает программы для Windows, Linux и macOS без реальной операционной системы: он позволяет видеть и контролировать всё, что они делают.
Вместо того чтобы заново реализовывать тысячи API операционной системы, Sogen эмулирует бинарные файлы на уровне CPU и системных вызовов и запускает настоящие системные DLL, поэтому поведение близко соответствует реальной ОС.
Каждую инструкцию, обращение к памяти и вызов API можно перехватить, исследовать или переписать, запуски полностью детерминированы, а всё состояние эмулятора можно сохранить в снимок и восстановить.
Написан на C++ и работает на выбранном вами бэкенде CPU:
Попробуйте: sogen.dev
Присоединяйтесь к сообществу: Discord
Отлаживайте с помощью знакомых инструментов, таких как IDA Pro или GDB, по протоколу GDB, или используйте встроенный отладчик в браузере.
Отладчик работает на уровне эмулятора, вне процесса, поэтому остаётся невидимым для проверок на отладку.
Работают нативные GUI-приложения с рабочими окнами, диалогами и элементами управления.
Паравиртуализация GPU обеспечивает 3D-ускорение на вашем реальном GPU, а бэкенд Hyper-V выполняет код нативно на вашем CPU. Достаточно быстро для игр.
Игры на Direct3D 8/9/10/11 запускаются через DXVK, который транслирует Direct3D в Vulkan поверх моста GPU.
Нажмите здесь, чтобы посмотреть слайды.
Установка:
pip install sogen
Привязки Python требуют корня эмуляции. Вы можете скачать готовый корень здесь или создать свой собственный, следуя инструкциям в wiki.
Пример:
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 доступны в отдельном репозитории.
[!TIP]
Ознакомьтесь с Wiki для получения более подробной информации о том, как собрать и запустить эмулятор в Windows, Linux, macOS, ...
1. Получите код:
git clone --recurse-submodules https://github.com/momo5502/sogen.git
2. Выполните следующую команду в x64 Development Command Prompt в клонированном каталоге:
cmake --preset=vs2022
3. Соберите решение, созданное в build/vs2022/sogen.sln
4. Создайте дамп реестра, запустив grab-registry.bat от имени администратора, и поместите его в папку artifacts рядом с analyzer.exe
5. Запустите программу на ваш выбор:
analyzer.exe C:\example.exe
По умолчанию гость не имеет доступа к сети хоста. Сокеты гостя используют внутрипроцессный loopback, DNS-запросы не разрешаются ни в какие адреса, а мост Steam отключён. Чтобы предоставить гостю доступ к сети хоста, добавьте --network live:
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.
Исполняемые файлы Windows ARM64 запускаются так же — из корня эмуляции, созданного с помощью create-root.bat на машине с Windows ARM64. Они работают на WHP в Windows ARM64, на Hypervisor.framework на Apple Silicon и на Unicorn в остальных случаях.
--backend переопределяет выбор на основе переменных окружения. Вне Windows ARM64, где бэкенд ARM64 для Unicorn не собран, EMULATOR_UNICORN=1 запускает гостей ARM64 на Unicorn вместо гипервизора.
Поддержка macOS находится на ранней стадии. Sogen запускает x86-64 командные программы macOS через настоящий dyld и системный общий кэш dyld, чего достаточно для простых инструментов вроде echo. Большинство других программ по-прежнему останавливаются на нереализованном системном вызове.
1. Соберите корень эмуляции на Mac, система которого всё ещё содержит x86-64-срезы. Скрипт копирует dyld, /bin/echo и общий кэш x86-64:
src/tools/create-macos-root.sh /tmp/macos-root
Лицензия macOS не допускает распространения root или его запуска на не-Apple оборудовании, поэтому он недоступен для скачивания и должен оставаться на Mac, на котором был собран.