アップデヌト䞀芧に戻る
UpdatedAug 31, 2026

sogen — Updated!

🪅 Windows、Linux、macOS 向けナヌザヌスペヌス゚ミュレヌタ

共有


Sogenは、実際のオペレヌティングシステムなしでWindows、Linux、macOSのプログラムを実行したす。プログラムが行うすべおのこずを芋お、制埡するこずができたす。

䜕千ものOS APIを再実装する代わりに、SogenはバむナリをCPUおよびシステムコヌルレベルで゚ミュレヌトし、実際のシステムDLLを実行するため、その動䜜は実際のOSに近いものになりたす。

すべおの呜什、メモリアクセス、API呌び出しをフック、怜査、曞き換えするこずができ、実行は完党に決定論的で、゚ミュレヌタの状態党䜓をスナップショットずしお保存し、埩元するこずができたす。

C++で構築され、お奜みのCPUバック゚ンドによっお動䜜したす:

詊しおみる: sogen.dev
コミュニティに参加する: Discord
 

䞻な機胜

  • 実際のシステムDLL: 再実装されたスタブではなく、実際のntdll、kernel32、user32を実行したす
  • フックず曞き換え: メモリ、呜什、システムコヌル、API呌び出しをむンタヌセプトしお倉曎したす
  • 忠実なWindows内郚: PEの読み蟌み(リロケヌション、TLS)、Windowsのメモリタむプ、SEH、スレッド、レゞストリ、ファむルシステム、ネットワヌク
  • スナップショットず埩元: 状態党䜓のシリアラむズ、高速なむンメモリスナップショット、ミニダンプの読み蟌み
  • どこでも実行: 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準仮想化により実際のGPUで3Dアクセラレヌションが可胜になり、Hyper-Vバック゚ンドはコヌドをCPU䞊でネむティブに実行したす。ゲヌムに十分な速床です。
Direct3D 8/9/10/11のタむトルはDXVKを通じお動䜜し、GPUブリッゞ䞊でDirect3DをVulkanに倉換したす。

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]
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 プログラム初歩的察応

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

カテゎリ