
🪅 Userspace emulator for Windows, Linux & macOS
Sogenは、実際のオペレーティングシステムなしでWindows、Linux、macOSのプログラムを実行します。プログラムが行うすべてのことを見て、制御することができます。
何千ものOS APIを再実装する代わりに、SogenはバイナリをCPUおよびシステムコールレベルでエミュレートし、実際のシステムDLLを実行するため、その動作は実際のOSに近いものになります。
すべての命令、メモリアクセス、API呼び出しをフック、検査、書き換えすることができ、実行は完全に決定論的で、エミュレータの状態全体をスナップショットとして保存し、復元することができます。
C++で構築され、お好みのCPUバックエンドによって動作します:
試してみる: sogen.dev
コミュニティに参加する: Discord
IDA ProやGDBなど、すでに使い慣れたツールを使ってGDBプロトコル経由でデバッグするか、内蔵のブラウザ内デバッガを使用できます。
デバッガはプロセスの外側、エミュレータレベルで動作するため、アンチデバッグチェックから見えません。
ネイティブGUIアプリが動作し、ウィンドウ、ダイアログ、コントロールが機能します。
GPU準仮想化により実際のGPUで3Dアクセラレーションが可能になり、Hyper-VバックエンドはコードをCPU上でネイティブに実行します。ゲームに十分な速度です。
Direct3D 8/9/10/11のタイトルはDXVKを通じて動作し、GPUブリッジ上でDirect3DをVulkanに変換します。
スライドはこちらをクリックしてください。
インストール方法:
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]
Windows、Linux、macOS などでエミュレータをビルドおよび実行する方法の詳細については、Wiki を確認してください。
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 を実行してレジストリダンプを作成し、analyzer.exe の隣の artifacts フォルダに配置します
5. 任意のプログラムを実行します:
analyzer.exe C:\example.exe
デフォルトでは、ゲストはホストネットワークにアクセスできません。ゲストのソケットはプロセス内ループバックを使用し、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 の実行ファイルも同様に、Windows ARM64 マシン上で create-root.bat を使って作成したエミュレーションルートから実行されます。これらは Windows ARM64 では WHP 上で、Apple Silicon では Hypervisor.framework 上で、それ以外では Unicorn 上で動作します。
--backend は環境変数による選択を上書きします。Unicorn の ARM64 バックエンドがビルドされていない Windows ARM64 以外では、EMULATOR_UNICORN=1 を指定すると ARM64 ゲストがハイパーバイザーではなく Unicorn 上で実行されます。
macOS のサポートは初期段階です。Sogen は実際の dyld とシステムの dyld 共有キャッシュを通じて x86-64 macOS コマンドラインプログラムを実行し、echo のような単純なツールには十分です。その他のほとんどのプログラムは、未実装のシステムコールで停止します。
1. システムがまだ x86-64 スライスを同梱している Mac 上でエミュレーションルートをビルドします。このスクリプトは dyld、/bin/echo、および x86-64 共有キャッシュをコピーします:
src/tools/create-macos-root.sh /tmp/macos-root
macOS のライセンスでは root の再配布や非 Apple ハードウェア上での実行が許可されていないため、ダウンロード用には提供されず、ビルドした Mac 上に留めておく必要があります。
2. EMULATOR_MACOS=1 を設定して、root からプログラムを実行します:
EMULATOR_MACOS=1 build/release/artifacts/analyzer --root /tmp/macos-root /tmp/macos-root/bin/echo hello