अपडेट पर वापस जाएँ
UpdatedAug 31, 2026

sogen — Updated!

🪅 Windows, Linux और macOS के लिए यूज़रस्पेस एमुलेटर

साझा करें


Sogen Windows, Linux और macOS प्रोग्राम चलाता है, बिना किसी वास्तविक ऑपरेटिंग सिस्टम के: यह आपको वह सब देखने और नियंत्रित करने देता है जो वे करते हैं।

हज़ारों OS APIs को फिर से लागू करने के बजाय, Sogen बाइनरीज़ को CPU और syscall स्तर पर एम्युलेट करता है और वास्तविक system DLLs चलाता है, इसलिए व्यवहार वास्तविक OS से बहुत मिलता है।

हर निर्देश, मेमोरी एक्सेस और API कॉल को हुक, निरीक्षण या पुनर्लेखित किया जा सकता है, रन पूरी तरह से नियतात्मक (deterministic) होते हैं, और पूरे एम्युलेटर की स्थिति को स्नैपशॉट और पुनर्स्थापित किया जा सकता है।

C++ में निर्मित और आपकी पसंद के CPU बैकएंड द्वारा संचालित:

इसे आज़माएँ: sogen.dev
समुदाय से जुड़ें: Discord
 

मुख्य विशेषताएँ

  • वास्तविक system DLLs: वास्तविक ntdll, kernel32 और user32 चलाता है, पुनर्लागू किए गए स्टब्स नहीं
  • हुक और पुनर्लेखन: मेमोरी, निर्देशों, syscalls और API कॉलों को इंटरसेप्ट और बदलें
  • वफ़ादार Windows आंतरिक तंत्र: PE लोडिंग (relocations, TLS), Windows मेमोरी प्रकार, SEH, थ्रेडिंग, रजिस्ट्री, फ़ाइलसिस्टम और नेटवर्किंग
  • स्नैपशॉट और पुनर्स्थापना: पूर्ण स्थिति सीरियलाइज़ेशन, तेज़ इन-मेमोरी स्नैपशॉट और minidump लोडिंग
  • हर जगह चलता है: Windows, Linux, macOS, Android, iOS और ब्राउज़र पर, x86-64 और arm64 पर
  • नियतात्मक: हर रन पुनरुत्पादनीय है, निर्देश स्तर तक
     

पूर्वावलोकन

Preview

अज्ञात (Undetectable) डिबगिंग

उन टूल्स से डिबग करें जिन्हें आप पहले से जानते हैं, जैसे IDA Pro या GDB, GDB प्रोटोकॉल के माध्यम से, या अंतर्निहित इन-ब्राउज़र डिबगर का उपयोग करें।
डिबगर एम्युलेटर स्तर पर, प्रक्रिया के बाहर चलता है, इसलिए यह anti-debug जाँचों के लिए अदृश्य रहता है।

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 बाइंडिंग्स के लिए एक एमुलेशन रूट आवश्यक है। आप एक तैयार रूट यहाँ डाउनलोड कर सकते हैं, या विकी में दिए गए निर्देशों का पालन करके अपना खुद का बना सकते हैं।

उदाहरण:

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 पर्यावरण-आधारित चयन को ओवरराइड करता है। Windows ARM64 के बाहर, जहाँ Unicorn का ARM64 बैकएंड नहीं बनाया जाता, EMULATOR_UNICORN=1 ARM64 गेस्ट को हाइपरवाइज़र के बजाय Unicorn पर चलाता है।

macOS प्रोग्राम (प्रारंभिक)

macOS समर्थन प्रारंभिक चरण में है। Sogen वास्तविक dyld और सिस्टम के dyld साझा कैश के माध्यम से x86-64 macOS कमांड-लाइन प्रोग्राम चलाता है, जो echo जैसे सरल टूल के लिए पर्याप्त है। अधिकांश अन्य प्रोग्राम अभी भी किसी अप्रयुक्त सिस्टम कॉल पर रुक जाते हैं।

1. ऐसे Mac पर एमुलेशन रूट बनाएँ जिसका सिस्टम अभी भी x86-64 स्लाइस के साथ आता है। स्क्रिप्ट dyld, /bin/echo और x86-64 साझा कैश की प्रतिलिपि बनाती है:

src/tools/create-macos-root.sh /tmp/macos-root

macOS लाइसेंस root को पुनर्वितरित करने या इसे गैर-Apple हार्डवेयर पर चलाने की अनुमति नहीं देता है, इसलिए यह डाउनलोड के लिए उपलब्ध नहीं है और इसे उसी Mac पर रहना होगा जिसने इसे बनाया है।

2. EMULATOR_MACOS=1 सेट करके root से एक प्रोग्राम चलाएँ:

श्रेणियाँ