
🪅 Windows, Linux और macOS के लिए यूज़रस्पेस एमुलेटर
<h1 align="center">
<a href="https://github.com/momo5502/sogen"><img src="https://momo5502.com/sogen/sogen.svg" height="200" /></a>
<br>
<a href="https://discord.sogen.dev"><img src="https://img.shields.io/badge/discord-come%20chat-00B0F8?logo=discord&logoColor=white"/></a>
<a href="https://github.com/momo5502/sogen/actions"><img src="https://img.shields.io/github/actions/workflow/status/momo5502/sogen/build.yml?branch=main&label=build"/></a>
<a href="https://github.com/momo5502/sogen/issues"><img src="https://img.shields.io/github/issues/momo5502/sogen?color=F8B000"/></a>
<img src="https://img.shields.io/github/commit-activity/m/momo5502/sogen?color=FF3131"/>
</h1>
Sogen Windows, Linux और [macOS](#macos-programs-rudimentary) प्रोग्राम चलाता है, बिना किसी वास्तविक ऑपरेटिंग सिस्टम के: यह आपको वह सब देखने और नियंत्रित करने देता है जो वे करते हैं।
हज़ारों OS APIs को फिर से लागू करने के बजाय, Sogen बाइनरीज़ को CPU और syscall स्तर पर एम्युलेट करता है और **वास्तविक system DLLs** चलाता है, इसलिए व्यवहार वास्तविक OS से बहुत मिलता है।
हर निर्देश, मेमोरी एक्सेस और API कॉल को हुक, निरीक्षण या पुनर्लेखित किया जा सकता है, रन पूरी तरह से नियतात्मक (deterministic) होते हैं, और पूरे एम्युलेटर की स्थिति को स्नैपशॉट और पुनर्स्थापित किया जा सकता है।
C++ में निर्मित और आपकी पसंद के CPU बैकएंड द्वारा संचालित:
- [Unicorn Engine](https://github.com/unicorn-engine/unicorn)
- [icicle-emu](https://github.com/icicle-emu/icicle-emu)
- [Hyper-V (WHP)](https://learn.microsoft.com/en-us/virtualization/api/hypervisor-platform/hypervisor-platform)
- [KVM](https://www.kernel.org/doc/html/latest/virt/kvm/api.html)
- [FEX](https://fex-emu.com)
इसे आज़माएँ: <a href="https://sogen.dev">sogen.dev</a>
समुदाय से जुड़ें: <a href="https://discord.sogen.dev">Discord</a>
## मुख्य विशेषताएँ
- **वास्तविक system DLLs**: वास्तविक ntdll, kernel32 और user32 चलाता है, पुनर्लागू किए गए स्टब्स नहीं
- **हुक और पुनर्लेखन**: मेमोरी, निर्देशों, syscalls और API कॉलों को इंटरसेप्ट और बदलें
- **वफ़ादार Windows आंतरिक तंत्र**: PE लोडिंग (relocations, TLS), Windows मेमोरी प्रकार, SEH, थ्रेडिंग, रजिस्ट्री, फ़ाइलसिस्टम और नेटवर्किंग
- **स्नैपशॉट और पुनर्स्थापना**: पूर्ण स्थिति सीरियलाइज़ेशन, तेज़ इन-मेमोरी स्नैपशॉट और minidump लोडिंग
- **हर जगह चलता है**: Windows, Linux, macOS, Android, iOS और ब्राउज़र पर, x86-64 और arm64 पर
- **नियतात्मक**: हर रन पुनरुत्पादनीय है, निर्देश स्तर तक
## पूर्वावलोकन
<img src="https://momo5502.com/sogen/preview.svg" width="650" alt="Preview" />
## अज्ञात (Undetectable) डिबगिंग
उन टूल्स से डिबग करें जिन्हें आप पहले से जानते हैं, जैसे IDA Pro या GDB, GDB प्रोटोकॉल के माध्यम से, या अंतर्निहित इन-ब्राउज़र डिबगर का उपयोग करें।
डिबगर एम्युलेटर स्तर पर, प्रक्रिया के बाहर चलता है, इसलिए यह anti-debug जाँचों के लिए अदृश्य रहता है।
<img src="https://assets.kitploit.com/production/public/readmes/48935/a18ec942ce8aa95c626bb55f02dc76c6e61dd781f80b1099f2c1c39bfffa41fe.png" width="650" alt="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](https://github.com/doitsujin/dxvk) के माध्यम से चलते हैं, जो GPU ब्रिज के ऊपर Direct3D को Vulkan में अनुवादित करता है।
<img src="https://assets.kitploit.com/production/public/readmes/48935/11eb76db68f76b9fd16886f6cdf31477646ced84c4f7509b7c0df31c967a017f.png" width="650" alt="A game running inside the Sogen emulator" />
## परियोजना अवलोकन
<a href="https://www.youtube.com/watch?v=wY9Q0DhodOQ" target="_blank">
<img src="https://assets.kitploit.com/production/public/readmes/48935/748dda1f1cc6eca0dfd951918f34dc4c5e15bd5c71a571fee6eaa606ab076cd2.png" alt="YouTube Video" width="600" />
</a>
स्लाइड्स के लिए <a href="https://docs.google.com/presentation/d/1pha4tFfDMpVzJ_ehJJ21SA_HAWkufQBVYQvh1IFhVls/edit">यहाँ</a> क्लिक करें।
## Python बाइंडिंग्स
इसके साथ इंस्टॉल करें:
```bash
pip install sogen
```
Python बाइंडिंग्स के लिए एक एमुलेशन रूट आवश्यक है। आप एक तैयार रूट [यहाँ](https://sogen.dev/root.zip) डाउनलोड कर सकते हैं, या [विकी](https://github.com/momo5502/sogen/wiki/Run-The-Emulator#emulation-root-environment) में दिए गए निर्देशों का पालन करके अपना खुद का बना सकते हैं।
उदाहरण:
```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 बाइंडिंग्स](https://github.com/Wdestroier/sogen_dart) एक अलग रिपॉजिटरी में उपलब्ध हैं।
## त्वरित शुरुआत (Windows + Visual Studio)
> [!TIP]
> Windows, Linux, macOS, ... पर एमुलेटर को बिल्ड और रन करने के तरीके के बारे में अधिक जानकारी के लिए [Wiki](https://github.com/momo5502/sogen/wiki) देखें।
1\. कोड चेकआउट करें:
```bash
git clone --recurse-submodules https://github.com/momo5502/sogen.git
```
2\. क्लोन की गई डायरेक्टरी में एक x64 Development Command Prompt में निम्नलिखित कमांड चलाएँ:
```bash
cmake --preset=vs2022
```
3\. `build/vs2022/sogen.sln` पर जेनरेट किया गया सॉल्यूशन बनाएं
4\. एडमिनिस्ट्रेटर के रूप में [grab-registry.bat](https://github.com/momo5502/sogen/blob/main/src/tools/grab-registry.bat) चलाकर एक रजिस्ट्री डंप बनाएं और इसे `analyzer.exe` के बगल में artifacts फ़ोल्डर में रखें
5\. अपनी पसंद का प्रोग्राम चलाएं:
```bash
analyzer.exe C:\example.exe
```
डिफ़ॉल्ट रूप से, अतिथि के पास होस्ट नेटवर्क तक कोई पहुँच नहीं होती है। अतिथि सॉकेट एक इन-प्रोसेस लूपबैक का उपयोग करते हैं, DNS क्वेरीज़ किसी भी पते पर रिज़ॉल्व नहीं होती हैं, और Steam ब्रिज अक्षम रहता है। अतिथि को होस्ट नेटवर्क तक पहुँच देने के लिए, `--network live` जोड़ें:
```bash
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](https://github.com/momo5502/sogen/blob/main/docs/filesystem.md) देखें।
Windows ARM64 निष्पादन योग्य फ़ाइलें उसी तरह चलती हैं, Windows ARM64 मशीन पर [create-root.bat](https://github.com/momo5502/sogen/blob/main/src/tools/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 साझा कैश की प्रतिलिपि बनाती है:
```bash
src/tools/create-macos-root.sh /tmp/macos-root
```
macOS लाइसेंस root को पुनर्वितरित करने या इसे गैर-Apple हार्डवेयर पर चलाने की अनुमति नहीं देता है, इसलिए यह डाउनलोड के लिए उपलब्ध नहीं है और इसे उसी Mac पर रहना होगा जिसने इसे बनाया है।
2\. `EMULATOR_MACOS=1` सेट करके root से एक प्रोग्राम चलाएँ:
```bash
EMULATOR_MACOS=1 build/release/artifacts/analyzer --root /tmp/macos-root /tmp/macos-root/bin/echo hello
```