Назад к обновлениям
UpdatedAug 31, 2026

sogen — Updated!

🪅 Эмулятор пользовательского пространства для Windows, Linux и macOS

Поделиться


Sogen запускает программы для Windows, Linux и macOS без реальной операционной системы: он позволяет видеть и контролировать всё, что они делают.

Вместо того чтобы заново реализовывать тысячи API операционной системы, Sogen эмулирует бинарные файлы на уровне CPU и системных вызовов и запускает настоящие системные DLL, поэтому поведение близко соответствует реальной ОС.

Каждую инструкцию, обращение к памяти и вызов API можно перехватить, исследовать или переписать, запуски полностью детерминированы, а всё состояние эмулятора можно сохранить в снимок и восстановить.

Написан на C++ и работает на выбранном вами бэкенде CPU:

Попробуйте: sogen.dev
Присоединяйтесь к сообществу: Discord
 

Ключевые возможности

  • Настоящие системные DLL: запускает реальные ntdll, kernel32 и user32, а не переписанные заглушки
  • Перехват и переписывание: перехватывайте и изменяйте память, инструкции, системные вызовы и вызовы API
  • Достоверная внутренняя реализация Windows: загрузка PE (релокации, TLS), типы памяти Windows, SEH, потоки, реестр, файловая система и сеть
  • Снимки и восстановление: полная сериализация состояния, быстрые снимки в памяти и загрузка minidump
  • Работает везде: Windows, Linux, macOS, Android, iOS и браузер, на x86-64 и arm64
  • Детерминированность: каждый запуск воспроизводим вплоть до инструкции
     

Предпросмотр

Preview

Незаметная отладка

Отлаживайте с помощью знакомых инструментов, таких как IDA Pro или GDB, по протоколу GDB, или используйте встроенный отладчик в браузере.
Отладчик работает на уровне эмулятора, вне процесса, поэтому остаётся невидимым для проверок на отладку.

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, который транслирует Direct3D в Vulkan поверх моста GPU.

A game running inside the Sogen emulator  

Обзор проекта

YouTube Video

Нажмите здесь, чтобы посмотреть слайды.
 

Привязки для Python

Установка:

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 доступны в отдельном репозитории.
 

Быстрый старт (Windows + Visual Studio)

[!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 (базовый уровень)

Поддержка 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, на котором был собран.

Категории