# Telegram · त्वरित आरंभ

Canonical page: https://phishdestroy.io/tgwitness/hi/docs/reference/quickstart/

TgWitness को इंस्टॉल और लॉन्च करने के सभी तरीके: विंडोज़ पैकेज, पाइथन, डॉकर और सिंथेटिक डेमो, साथ ही प्रारंभिक जांचें।

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/hi/llms.txt)

TgWitness को इंस्टॉल और लॉन्च करने के सभी तरीके: विंडोज़ पैकेज, पाइथन, डॉकर और सिंथेटिक डेमो, साथ ही प्रारंभिक जांचें।

[टीजीविटनेस](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [दस्तावेज़ीकरण](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![शुरुआत करना](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2)

**अंग्रेज़ी** · [रूसी](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/QUICKSTART.md) · [यूक्रेनी](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/QUICKSTART.md) · [स्पेनिश](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/QUICKSTART.md) · [पुर्तगाली (ब्राज़ील)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/QUICKSTART.md) · [तुर्की](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/QUICKSTART.md) · [अरबी](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/QUICKSTART.md) · [फ़ारसी](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/QUICKSTART.md) · [उर्दू](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/QUICKSTART.md) · [हिंदी](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/QUICKSTART.md) · [बाहासा इंडोनेशिया](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/QUICKSTART.md) · [वियतनामी](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/QUICKSTART.md) · [सरलीकृत चीनी](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/QUICKSTART.md)

TgWitness टेलीग्राम समूहों और चैनलों को देखने के लिए एक स्टैंडअलोन एप्लिकेशन है, जिन्हें आपके खाते एक्सेस कर सकते हैं। यह अपनी स्वयं की डेटा निर्देशिका के साथ स्थानीय रूप से चलता है।

**पहली बार आ रहे हैं?** कोई खाता कनेक्ट करने से पहले [डेमो देखें](https://phishdestroy.io/tgwitness/hi/docs/reference/quickstart/#explore-the-interface)। प्रॉक्सी, विटनेस, एक्सपोर्ट या सर्वर सेटअप के लिए [एक गाइड चुनें](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)। [GitHub Actions कैप्चर](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) (प्रीव्यू) एक स्थानीय इंस्टॉलेशन के बजाय आपके अपने GitHub फोर्क में एक कैप्चर चलाता है।

## इंस्टॉल करें और शुरू करें

गाइडेड इंस्टॉलर में अपना स्वयं का पाइथन शामिल होता है और यह इंस्टॉल करने से पहले पैकेज हैश और रिलीज़ सिग्नेचर की जांच करता है। इसे दोबारा चलाने पर मौजूदा इंस्टॉलेशन अपडेट हो जाता है।

**लिनक्स / मैकओएस:**

```
curl -fsSL https://get.destroy.tools/install.sh | bash
```

**विंडोज (पावरशेल या कमांड प्रॉम्प्ट):**

```
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
```

उबंटू सर्वर पर, बैकग्राउंड सेवा इंस्टॉल करने के लिए रूट के रूप में चलाएँ; डेस्कटॉप पर, अपने सामान्य उपयोगकर्ता के रूप में चलाएँ। उबंटू पर इंस्टॉलर पैनल पता और एक्सेस कुंजी प्रिंट करता है; macOS और विंडोज पर आपका ब्राउज़र स्थानीय पैनल खोलता है। नीचे दिए गए **कनेक्ट टेलीग्राम** पर जारी रखें। [इंस्टॉल, सत्यापित और अपडेट](https://phishdestroy.io/tgwitness/hi/docs/reference/installation/) में सर्वर एक्सेस विकल्प, स्क्रिप्ट को चलाने से पहले उसकी जाँच, अपडेट और हटाना शामिल है।

### अन्य विधियाँ

GitHub रिलीज़, सोर्स और Docker इंस्टॉलर के विकल्प हैं। एक रिलीज़ बिल्ड प्रकाशित होने के बाद पोर्टेबल डाउनलोड उपलब्ध हो जाते हैं:

| होस्ट | कुछ भी स्थापित नहीं | स्रोत: पाइथन 3.11+ | Docker: इंजन/डेस्कटॉप कम्पोज़ 2.20+ के साथ |
| --- | --- | --- | --- |
| विंडोज | GitHub रिलीज़ से `TgWitness-<version>-windows-amd64-portable.zip` निकालें, `TgWitness.cmd` पर डबल-क्लिक करें | `Start.cmd` पर डबल-क्लिक करें | `scripts\Docker.cmd` पर डबल-क्लिक करें |
| लिनक्स / मैकओएस | — | `sh start.sh` | `sh scripts/docker-start.sh` |

सोर्स तरीकों के लिए, [वर्तमान `main` को डाउनलोड और एक्सट्रैक्ट करें](https://github.com/phishdestroy/TgWitness/archive/refs/heads/main.zip) या रिपॉज़िटरी को क्लोन करें:

```
git clone https://github.com/phishdestroy/TgWitness.git
cd TgWitness
```

यदि कोई उपयुक्त Python नहीं मिलता है, तो `Start.cmd` आपके Windows उपयोगकर्ता के लिए Python 3.12 इंस्टॉल करने की पेशकश करता है (winget, या हस्ताक्षरित python.org इंस्टॉलर)। यदि Python मौजूद नहीं है, तो `start.sh` आपके Linux डिस्ट्रीब्यूशन या macOS के लिए सटीक इंस्टॉल कमांड प्रिंट करता है। पहला सोर्स लॉन्च अपने आप `.venv` बनाता है और डिपेंडेंसी इंस्टॉल करता है।

Docker एप्लिकेशन का निर्माण करता है और इसे पृष्ठभूमि में शुरू करता है; होस्ट Python अनावश्यक है। `scripts\Docker.cmd` और `scripts/docker-start.sh` कंटेनर स्वस्थ होने पर पैनल का पता और टोकन प्रिंट करते हैं। प्रत्येक समर्थित होस्ट पर समकक्ष Docker कमांड हैं:

```
docker compose up -d --build --wait
docker compose exec tgwitness cat /data/panel-token.txt
```

http://127.0.0.1:8787 खोलें। Docker हेल्पर या दूसरी Docker कमांड द्वारा प्रिंट किए गए टोकन का उपयोग करें, या पोर्टेबल या सोर्स इंस्टॉलेशन के लिए **data/live/panel-token.txt** पढ़ें। नीचे **'टेलीग्राम कनेक्ट करें**' पर जारी रखें। नेटिव और डॉकर इंस्टॉलेशन अलग-अलग स्टोरेज का उपयोग करते हैं; डॉकर शुरू करने पर मौजूदा नेटिव जर्नल आयात नहीं होता है।

एक सर्वर के लिए, [डिप्लॉयमेंट](https://phishdestroy.io/tgwitness/hi/docs/reference/deployment/) में स्वचालित HTTPS, रीस्टार्ट, प्रकाशित छवियाँ, अपडेट और बैकअप शामिल हैं।

## इंटरफ़ेस का अन्वेषण करें

1. पोर्टेबल पैकेज में **TgWitness-Demo.cmd** , विंडोज स्रोत फ़ोल्डर में **scripts\Demo.cmd** , या लिनक्स/मैकओएस पर `sh start.sh --demo` चलाएँ। एक स्रोत लॉन्च पहले `.venv` बनाता है और निर्भरताएँ इंस्टॉल करता है।
2. **http://127.0.0.1:8787** खोलें।
3. स्थानीय डेमो स्वचालित रूप से नमूना जर्नल खोलता है। सीधे स्थानीय पहुँच के लिए टोकन कॉपी की आवश्यकता नहीं है।

डेमो संदेश काल्पनिक हैं। डेमो मोड वास्तविक टेलीग्राम खाते से कनेक्ट नहीं कर सकता।

## टेलीग्राम कनेक्ट करें

> [!चेतावनी] **समर्पित खातों का उपयोग करें।** टेलीग्राम अनुरोधों की उस मात्रा के लिए खातों को प्रतिबंधित या स्थायी रूप से प्रतिबंधित कर सकता है जिसे वह अत्यधिक मानता है, चाहे क्लाइंट कोई भी हो। व्यक्तिगत या मूल्यवान खातों के बजाय अवलोकन के लिए तैयार किए गए खातों को कनेक्ट करें, और एक समर्पित खाते पर एक API ID / हैश बनाएँ।

1. यदि नेटिव डेमो चल रहा है, तो उसे रोकें और **Start.cmd** या `sh start.sh` चलाएँ। अन्यथा, ऊपर चल रही लाइव इंस्टॉलेशन को चालू ही रखें।
2. साइन इन करने के लिए पैनल टोकन का उपयोग करें। एक नया वर्कस्पेस खुलता है, [पहले सेटअप करें](https://phishdestroy.io/tgwitness/hi/docs/reference/settings/)। **केवल डाउनलोड** करें, **चैट फॉलो करें** या **किसी मामले के लिए सबूत** चुनें।
3. कनेक्शन जांच की समीक्षा करें। यदि आवश्यक हो तो अपना स्वयं का प्रॉक्सी कॉन्फ़िगर करें; कनेक्शन सेटिंग्स सेटअप के बाद भी उपलब्ध रहती हैं।
4. **कनेक्ट टेलीग्राम** पर, एक फोन नंबर, एक QR कोड, खाता फ़ाइलें (TData, `.session`, StringSession, account JSON) या एक पूर्ण प्राधिकरण कुंजी चुनें। अनुरोध किए जाने पर टेलीग्राम पुष्टि, कोड और दो-चरणीय पासवर्ड पूरा करें।
5. प्रदर्शित खाते की जाँच करें, चैट चुनें और अपनी सेटिंग्स की समीक्षा करें। अंतिम स्क्रीन से समाप्त करें। **केवल डाउनलोड** के लिए, **'स्टार्ट एक्सपोर्ट'** एक बार का एक्सपोर्ट शुरू करता है और इसकी प्रगति दिखाने के लिए 'एक्सपोर्ट्स' खोलता है; यह निरंतर अवलोकन को सक्षम नहीं करता है।

सेटअप के बाद, **चैट्स → चूज़** चयनित चैट्स को बदलता है। **सेटिंग्स** संग्रह और फ़ाइलों को नियंत्रित करती है; **अधिक उपकरण → स्रोत** मानक या विशेषज्ञ स्तर पर विस्तृत स्रोत सूची प्रदान करता है। [पैनल गाइड](https://phishdestroy.io/tgwitness/hi/docs/reference/panel/) छह मुख्य अनुभागों और उनके संदर्भगत नियंत्रणों का वर्णन करती है।

**एपीआई आईडी + हैश** वैकल्पिक है: वर्कस्पेस अपनी सहेजी गई या आयात की गई जोड़ी, या अंतर्निहित पूल से एक कार्यशील जोड़ी का उपयोग करता है। अपना स्वयं का ऐप उपयोग करने के लिए, एक `API ID:API Hash` जोड़ी को API ID में पेस्ट करें। **Auth कुंजी** के लिए, सभी 512 हेक्साडेसिमल वर्णों को पेस्ट करें और प्रदान की गई DC ID का चयन करें। उपयोगकर्ता आईडी वैकल्पिक है और दर्ज करने पर जाँची जाती है।

एपीआई क्रेडेंशियल आपके एप्लिकेशन की पहचान करते हैं; वे स्वयं खाते को अधिकृत नहीं करते हैं। निजी समूहों को सार्वजनिक उपयोगकर्ता नाम की आवश्यकता नहीं होती है, लेकिन आपके खाते को एक्सेस होना चाहिए।

मौजूदा खातों के लिए, [खाते और सत्र प्रारूप](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/) देखें: पैनल Telethon StringSession, Telethon/Pyrogram SQLite, एकल-खाते TData ZIP, और समर्थित खाता JSON स्वीकार करता है। एक सत्र और उसके साथी JSON को एक साथ चुनें, **'फ़ाइलें जांचें**' दबाएँ, फिर **'खाता कनेक्ट करें**'। QR लॉगिन भी समान वैकल्पिक API सेटिंग्स के साथ उपलब्ध है। TDLib, बॉट सेशन और CSV/JSON खाता इन्वेंट्री का समर्थन नहीं किया जाता है।

कई खातों के लिए, **खाते → खातों को आयात करें** का उपयोग करें और उनकी समर्थित सेशन फ़ाइलें चुनें। साथ की JSON फ़ाइलों को बेसनेम द्वारा जोड़ा जाता है; प्रत्येक आयातित खाते को अपना खुद का वर्कस्पेस मिलता है। [बल्क इम्पोर्ट और अकाउंट ग्रुप](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#bulk-import-and-account-groups) देखें।

एक और खाता जोड़ने के लिए, खाता चयनकर्ता के बगल में **+** दबाएँ या **खाते → खाता जोड़ें का** उपयोग करें। वर्कस्पेस के अलग-अलग सत्र, जर्नल, कुंजी, स्रोत और कतारें होती हैं। दृश्य बदलने पर अन्य कलेक्टर चलते रहते हैं। इस इंस्टॉलेशन में एक ही टेलीग्राम खाते को दो वर्कस्पेस में नहीं सौंपा जा सकता है। वर्कस्पेस की कोई निश्चित संख्या नहीं है; वे एक ही प्रक्रिया साझा करते हैं, इसलिए क्षमता मशीन पर निर्भर करती है।

लाइव पैनल टोकन आपके टेलीग्राम अधिकृतकरणों और सहेजी गई सामग्री तक पहुंच की सुरक्षा करता है; यह टेलीग्राम एपीआई क्रेडेंशियल्स से अलग है। केवल एक स्पष्ट रूप से शुरू किया गया, सीधे एक्सेस किया गया स्थानीय डेमो ही स्वचालित रूप से प्रवेश पाता है। एक रिमोट/प्रॉक्सी वाला डेमो अभी भी `data/demo/panel-token.txt` का उपयोग करता है।

## समीक्षा और निर्यात

- **जर्नल:** स्रोत और घटना प्रकार के अनुसार अवलोकनों को खोजें और फ़िल्टर करें।
- किसी घटना का चयन करें ताकि उसके मूल रिकॉर्ड, श्रेय और सहेजे गए संस्करणों का निरीक्षण किया जा सके।
- संपादन विवरण उपलब्ध पहले/बाद की सामग्री दिखाते हैं। मिटान विवरण दिखाते हैं अंतिम कैप्चर की गई सामग्री, यदि कोई हो; एक अज्ञात कर्ता अज्ञात बना रहता है।
- निर्यात: हस्ताक्षरित ZIP, JSONL, CSV और ऑफ़लाइन HTML।
- **पूरी चैट एक्सपोर्ट** (**Chats → Export chat**, या **Exports → Capture or export one chat**): एक चैट का पूरा दृश्यमान इतिहास एक हस्ताक्षरित बंडल के रूप में डाउनलोड करें जिसमें `chat.json` (Telegram-export शैली) और एक पठनीय `chat.html` शामिल है। निजी चैट तब काम करती हैं जब खाता एक सदस्य होता है। यह एक वर्तमान स्नैपशॉट है, न कि हटाए गए या पहले से संपादित संदेशों का पुनर्निर्माण। एक प्रतिलिपि को `python verify.py chat-export.zip --fingerprint TRUSTED_SHA256` के साथ सत्यापित करें।
- **चेकपॉइंट सहेजें:** हस्ताक्षरित जर्नल की सीमा कलेक्टर के बाहर रखें।
- **हस्ताक्षरित रन रसीद डाउनलोड करें:** कलेक्टर के प्रोग्राम/संस्करण रिकॉर्ड को संरक्षित करें।
- **टाइमस्टैम्प अनुरोध तैयार करें:** टाइमस्टैम्प प्राधिकरण के लिए एक ऑफ़लाइन अनुरोध तैयार करें; प्रतिक्रिया प्राप्त करने और सत्यापित करने के लिए [TIMESTAMP.md](https://phishdestroy.io/tgwitness/hi/docs/reference/timestamp/) का पालन करें।
- **जर्नल सत्यापित करें:** इवेंट हस्ताक्षरों और चेन लिंक की जाँच करें। ZIP एक्सपोर्ट मीडिया की भी जाँच करता है।

समर्थित ब्राउज़र बड़ी एक्सपोर्ट्स को सीधे एक चुनी हुई फ़ाइल में सेव करते हैं। अन्य ब्राउज़र अधिकतम 128 MiB तक बफ़र करते हैं। जब सर्वर चल रहा हो, तो स्ट्रीमिंग CLI पूरे रिस्पॉन्स को बफ़र किए बिना बड़े डाउनलोड्स को सपोर्ट करता है:

```
python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip
```

किसी अन्य वर्कस्पेस के लिए, **एक्सपोर्ट्स → वर्कस्पेस आईडी** का उपयोग करके `--profile ID` जोड़ें। किसी रिमोट सर्वर के लिए, `--url https://your-server` जोड़ें। डिफ़ॉल्ट ट्रांसफर सीमा 5 जीआईबी है; `--max-mib` इसे बदलता है। हस्ताक्षरित ज़िप सामग्री की डिफ़ॉल्ट रूप से एक अलग 4 जीबी की बिना-संपीड़ित सत्यापन सीमा होती है (**अधिक उपकरण → पैरामीटर** इसे बढ़ाते हैं; ऐसे आर्काइव को `verify.py --max-gib N` के साथ सत्यापित करें)। आर्काइव को वेरिफायर की एक विश्वसनीय प्रति, स्वतंत्र रूप से रखी गई कुंजी फिंगरप्रिंट और, सबूत के लिए न्यूनतम रूप से, टाइमस्टैम्प प्राधिकरण के रूट प्रमाणपत्र (`--tsa-ca`) का उपयोग करके सत्यापित करें।

## स्थापना की जाँच करें

```
python start.py --setup-only
python start.py --check
python start.py --check --json
```

`--check` स्थानीय निर्भरताएँ, हस्ताक्षर समर्थन, भंडारण, कुंजी कॉन्फ़िगरेशन और लिसनिंग एड्रेस की जाँच करता है। यह कुछ भी इंस्टॉल नहीं करता है या टेलीग्राम से कनेक्ट नहीं होता है। एक व्यस्त पोर्ट का मतलब हो सकता है कि कोई दूसरा इंस्टेंस चल रहा है। एक अलग `--port` का उपयोग करें या पहले इसे बंद कर दें।

लॉन्चर `.venv` में इंस्टॉल होता है। सहायक `python -m tgwitness...` कमांड्स को विंडोज पर `.venv\Scripts\python.exe` या लिनक्स/मैकओएस पर `.venv/bin/python` का उपयोग करना चाहिए, जब तक कि वह वातावरण पहले से सक्रिय न हो।

## सत्र, सुरक्षा और संचालन

एक बंद, सुसंगत टेलीथॉन SQLite `.session` को स्थानीय रूप से `python -m tgwitness.sessions account.session --out account.tgwitness-session` के साथ परिवर्तित किया जा सकता है, फिर इसे **More tools → Account → Files** में लोड किया जा सकता है। डायरेक्ट फ़ाइल इम्पोर्ट और QR लॉगिन भी उपलब्ध हैं। लॉगिन फ़ॉर्मेट, SOCKS5, HTTP CONNECT, MTProxy और बाहरी मास्टर कुंजियों के लिए [CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/hi/docs/reference/connection/) देखें।

**अवलोकन रोकें** संग्रहण रोकता है। **लॉक करें** केवल ब्राउज़र से पहुँच बंद करता है। टैब बंद करने पर संग्रहण प्रक्रिया चलती रहती है। प्रक्रिया रोकने से संग्रहण रुक जाता है; इतिहास का स्नैपशॉट सभी छूटे हुए संपादनों या हटाए गए संदेशों को पुनः प्राप्त नहीं कर सकता। इवेंट नीतियों, अटैचमेंट कतारों, खातों के पृथक्करण और दोबारा शुरू करने के व्यवहार के लिए [संग्रहण कैसे काम करता है](https://phishdestroy.io/tgwitness/hi/docs/reference/collection/) देखें।

सत्र और रहस्य एन्क्रिप्ट किए जाते हैं। संदेश सामग्री, मीडिया और एक्सपोर्ट के लिए एक एन्क्रिप्टेड डिस्क या वॉल्यूम की आवश्यकता होती है। जर्नल हस्ताक्षरों को एक विश्वसनीय कुंजी के खिलाफ सत्यापित करें और चेकपॉइंट को अलग से रखें। चयनित संग्रह मोड के लिए कैप्चर रिकॉर्ड, बाहरी समय रसीदें और पर्यावरण प्रमाणीकरण की समीक्षा करें।

बैकअप/रिस्टोर के लिए [OPERATIONS.md](https://phishdestroy.io/tgwitness/hi/docs/reference/operations/), होस्टिंग के लिए [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/hi/docs/reference/deployment/), और सेवा उदाहरणों के लिए [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) पढ़ें। इंस्टॉल किए गए पैनल में `/guide.html` पर एक ऑफ़लाइन सेटअप गाइड भी शामिल है।

वास्तविक सत्यापन और शेष सीमाएँ [VERIFICATION.md](https://phishdestroy.io/tgwitness/hi/docs/reference/verification/) और [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md) में दर्ज हैं।
