इस पृष्ठ के कुछ हिस्से अभी भी अंग्रेज़ी में हैं: अंग्रेज़ी मूल अनुवाद के बाद बदल दिया गया था।
संदर्भ / एकत्र करें
Telegram · कार्यप्रवाह और संचालन
पैनल का दैनिक संचालन: मोड, निगरानी श्रेणियाँ, पैरामीटर, सूचनाएं, निर्यात, बैकअप और क्षमता।
टीजीविटनेस / दस्तावेज़ीकरण · तैनाती और पुनर्प्राप्ति
अपने पहले कनेक्शन के लिए, खातों और सत्र प्रारूपों का उपयोग करें। सहेजे गए संस्करणों, इवेंट नीतियों और अंतरालों की व्याख्या के लिए, देखें कि संग्रहण कैसे काम करता है। यह गाइड दैनिक संचालन और पुनर्प्राप्ति को कवर करती है।
एक प्रबंधित इंस्टॉलेशन में इसके लॉन्चर के बगल में START-HERE.html और START-HERE.txt शामिल होता है, जिसमें इसके इंस्टॉलेशन पथ के लिए अनुकूलित रिपॉजिटरी लिंक और कमांड होते हैं। वास्तविक डेटा डायरेक्टरी का पता लगाने के लिए tgwitness guide --print को SSH पर चलाएँ, या tgwitness paths चलाएँ। एक रूट systemd इंस्टॉल निजी स्थिति को /var/lib/tgwitness-… के तहत संग्रहीत करता है; /opt/tgwitness प्रोग्राम को होल्ड करता है।
एक प्रबंधित अस्थायी Cloudflare टनल के लिए, tgwitness tunnel off सार्वजनिक पहुँच बंद कर देता है जबकि स्थानीय पैनल और संग्रहण चलते रहते हैं। tgwitness tunnel on इसे सक्षम करता है; tgwitness tunnel restart एक नया टनल कनेक्शन बनाता है। इसका वर्तमान पता देखने के लिए tgwitness open का उपयोग करें। एक स्पष्ट बंद सेटिंग सेवा के पुनरारंभ के बाद भी बनी रहती है। tgwitness stop पैनल और संग्रहण दोनों को रोकता है।
इस पृष्ठ पर
ऑपरेटर वर्कफ़्लो#
चित्र को पाठ के रूप में
- भंडारण और कुंजी सुरक्षा चुनें → उसके टोकन के साथ पैनल खोलें
- उसके टोकन के साथ पैनल खोलें → एक कार्यक्षेत्र चुनें
- एक कार्यक्षेत्र चुनें → प्रत्यक्ष या प्रॉक्सी मार्ग कॉन्फ़िगर करें
- प्रत्यक्ष या प्रॉक्सी मार्ग कॉन्फ़िगर करें → फ़ोन दर्ज करें या फ़ाइलें / QR चुनें
- फ़ोन दर्ज करें या फ़ाइलें / QR चुनें → खाते की पहचान जांचें और पहुँच योग्य समूह चुनें
- खाते की पहचान जांचें और पहुँच योग्य समूह चुनें → घटना और संलग्नक नीतियाँ सहेजें, फिर अवलोकन शुरू करें
- घटना और संलग्नक नीतियाँ सहेजें, फिर अवलोकन शुरू करें → त्रुटियों, पहुँच, कतारों और डिस्क की निगरानी करें
- त्रुटियों, पहुँच, कतारों और डिस्क की निगरानी करें → स्वतंत्र जांच बिंदुओं को बनाए रखें
- स्वतंत्र जांच बिंदुओं को बनाए रखें → सामग्री का निर्यात और सत्यापन
अधिकृत करना, परिवहन कनेक्टिविटी, समूह तक पहुंच और डिलीवरी की पूर्णता अलग-अलग गुण हैं। हरा कनेक्शन स्टेटस यह संकेत नहीं देता कि सभी घटनाएँ कैप्चर हो गई हैं।
मुख्य कुंजी साझा किए बिना कार्य साझा करें#
अधिक उपकरण खोलें → समीक्षक या विश्लेषक को अपना टोकन देने के लिए एक्सेस चुनें। वे खाते और चैट चुनें जिन्हें वे खोल सकते हैं, फिर देखने, एक्सपोर्ट या संचालन संबंधी क्रियाओं की अनुमति दें। एक ऑपरेटर जिसे संग्रह शुरू/रोकना है, उसे पूरे वर्कस्पेस का एक्सेस चाहिए; एक समीक्षक को एक ही चैट तक सीमित किया जा सकता है। सत्र सीमाएं, समाप्ति और आईपी नियम टेलीग्राम खाते के प्राधिकरण से अलग हैं। एक्सेस और अनुमतियां देखें।
कनेक्शन समाप्त करने के लिए Open sessions का उपयोग करें या इसकी सभी सत्रों को समाप्त करने के लिए एक्सेस रद्द करें। एडमिनिस्ट्रेटर कंसोल वर्कस्पेस के पार वर्तमान-प्रक्रिया गतिविधि को संयोजित करता है। सत्र समापन पर संग्रहण चलता रहता है।
रनटाइम मोड्स#
| मोड | कार्रवाई | व्यवहार |
|---|---|---|
| डेमो | scripts\Demo.cmd या --demo |
सिंथेटिक डेटा; वास्तविक खाता कनेक्शन अक्षम |
| निरीक्षण | निरीक्षण शुरू करें | चयनित स्रोतों के लिए प्रदान किए गए अपडेट्स का रिकॉर्ड |
| इतिहास का स्नैपशॉट | चैट्स → चैट क्रियाएँ → इतिहास लोड करें | वर्तमान संदेशों की संख्या 500 तक; सभी पिछले परिवर्तनों का पुनर्निर्माण नहीं |
| विराम | प्रेक्षण विराम | डेटा और कतारबद्ध कार्यों को बनाए रखते हुए संग्रहण रोकें |
| समीक्षा/हैंडऑफ़ | निर्यात | ZIP, JSONL/CSV/HTML, चेकपॉइंट, प्रक्रिया रसीद और टाइमस्टैम्प अनुरोध |
| कई खाते | वर्कस्पेस या सबसे ऊपर का + बटन | एक ही प्रक्रिया में किसी भी संख्या में अलग-अलग कार्यक्षेत्र |
स्थानीय डेमो एक्सेस मैन्युअल टोकन प्रविष्टि के बिना स्वचालित रूप से खुल जाता है। यह एक अलग सिंथेटिक डेमो तक सीधे लूपबैक एक्सेस के लिए ही मान्य, प्रोसेस-लाइफटाइम क्षमता का उपयोग करता है; मुख्य पैनल टोकन प्रकट नहीं किया जाता है। वास्तविक वर्कस्पेस और रिमोट या प्रॉक्सी डेमो एक्सेस टोकन प्रमाणीकरण बनाए रखते हैं। डेमो एंट्री टेलीग्राम का कोई प्राधिकरण नहीं देती है।
निगरानी श्रेणियाँ#

अधिक उपकरण → स्रोत → रिकॉर्डिंग → कौन से बदलाव सहेजे जाएँ चुनें में, नए संदेश, संपादन, हटाने की सूचनाएं, प्रतिक्रिया अपडेट और सदस्यता घटनाओं को स्वतंत्र रूप से चुनें। डिफ़ॉल्ट सभी श्रेणियों को बनाए रखता है। संदेश, संपादन और हटाना मूल संदर्भ को बनाए रखता है जबकि अलग प्रतिक्रिया/सदस्य अपडेट को अक्षम कर देता है। सभी दृश्यमान गतिविधि सभी पाँचों को बहाल करती है। प्रीसेट फॉर्म को बदलते हैं; लागू करने के लिए 'रिकॉर्डिंग सेटिंग्स सहेजें' दबाएँ।
सहेजी गई नीति उस वर्कस्पेस में सभी चयनित स्रोतों पर लागू होती है। अन्य वर्कस्पेस अपनी सेटिंग्स बनाए रखते हैं। प्रत्येक वास्तविक परिवर्तन हस्ताक्षरित पहले/बाद के मानों को रिकॉर्ड करता है; वर्तमान नीति प्रोसेस रसीदों और अवलोकन प्रारंभ रिकॉर्ड में भी शामिल होती है। किसी श्रेणी को अक्षम करने से पहले के अवलोकन मिटे नहीं हैं। पुनः सक्षम करने से छूटे हुए परिवर्तन वापस नहीं आते हैं। इस संस्करण में प्रति-समूह श्रेणी ओवरराइड नहीं है।
जब पिछली सामग्री महत्वपूर्ण हो तो नए संदेशों को सक्षम रखें: एक हटाने की सूचना उस टेक्स्ट को पुनर्प्राप्त नहीं कर सकती जो कभी कैप्चर ही नहीं किया गया था। परिचालन/कवरेज रिकॉर्ड और अन्य समूह सेवा घटनाएं हमेशा बनाए रखी जाती हैं। स्पष्ट इतिहास स्नैपशॉट, लाइव-श्रेणी चयन से अलग होते हैं और इनमें सेवा संदेश शामिल हो सकते हैं। ये स्विच, अन्यथा कैप्चर किए गए टेलीग्राम ऑब्जेक्ट में एम्बेड किए गए प्रतिक्रिया/सदस्य मेटाडेटा को संपादित नहीं करते हैं।
एक हिस्ट्री स्नैपशॉट विराम पर होने पर अटैचमेंट्स को कतार में लगा सकता है। उन्हें प्रोसेस करने के लिए अवलोकन शुरू करें। कतार में होने का मतलब डाउनलोड होना नहीं है। एक अनुपलब्ध मूल फ़ाइल को नए संपादित संस्करण से नहीं बदला जाता है; परिणाम अलग से रिकॉर्ड किए जाते हैं।
लॉक ब्राउज़र एक्सेस और गुप्त फ़ील्ड्स को बंद कर देता है लेकिन संग्रहण को चालू रखता है। टैब बंद करने पर भी प्रक्रिया चालू रहती है। पाइथन प्रक्रिया या सेवा को रोकने पर ब्राउज़र की स्थिति की परवाह किए बिना संग्रहण रुक जाता है।
एक अतिरिक्त वर्कस्पेस तब हटाया जा सकता है, जब उसके जर्नल और केस बोर्ड नोट्स को कवर करने वाला एक साइन किया हुआ ZIP या ASiC-E कंटेनर पूरी तरह से डाउनलोड हो जाए। आर्काइव तैयार करना ही काफी नहीं है: सेटअप इवेंट्स के बाहर का कोई रिकॉर्ड या डाउनलोड के बाद जोड़ा गया कोई नोट, 'डिलीट' विकल्प को अनुपलब्ध रखता है।
जब पैनल को फ़ाइल स्वयं प्राप्त होती है, तो यह हर बाइट प्राप्त करने के बाद ही एक्सपोर्ट की गिनती करता है, और फिर आकार की रिपोर्ट POST /api/exports/{id}/received पर भेजता है; अधूरी रह गई डाउनलोड की गिनती नहीं की जाती है। ब्राउज़र सेव पिकर (फ़ाइल सिस्टम एक्सेस) के साथ, पैनल फ़ाइल के लिखे जाने और बंद होने के बाद इसकी रिपोर्ट करता है। इसके बिना, पैनल प्राप्त फ़ाइल को ब्राउज़र के डाउनलोड्स में भेज देता है और यह नहीं देख सकता कि ब्राउज़र ने इसे रखा है या नहीं, उदाहरण के लिए जब इसके सेव डायलॉग को रद्द कर दिया जाता है; तब पैनल यह कहता है कि डाउनलोड शुरू हुआ था, न कि फ़ाइल सहेजी गई थी। एक फ़ाइल जिसे ब्राउज़र अपने आप डाउनलोड करता है (पैनल के ब्राउज़र बफ़र से बड़ी एक एक्सपोर्ट) और किसी दूसरे HTTP क्लाइंट द्वारा किया गया डाउनलोड तब गिना जाता है जब सर्वर ने पूरा जवाब भेज दिया हो। ऑपरेटिंग सिस्टम और एक रिवर्स प्रॉक्सी बफ़र कई मेगाबाइट का जवाब, इसलिए इन डाउनलोडों के लिए सर्वर अंत के पास रुकावट नहीं देख सकता। जब तक पैनल यह न कहे कि फ़ाइल सहेजी गई है, हटाने से पहले डाउनलोड की गई फ़ाइल की जाँच करें। एक ग्रुप एक्सपोर्ट अपने खातों के लिए तब गिना जाता है जब इसे तैयार होने के ठीक बाद डाउनलोड किया जाता है; 'तैयार एक्सपोर्ट्स' से इसे फिर से डाउनलोड करने पर नहीं गिना जाता।
Before deleting, the panel shows the format, size, preparation time and SHA-256 of the last downloaded
signed archive and asks to confirm that this archive is saved outside the workspace. The server refuses
DELETE /api/profiles/{id} without kept_copy set to that SHA-256 (or to confirmed for an archive
downloaded before the fingerprint was recorded).
एक अतिरिक्त वर्कस्पेस को हटाने से उसका कलेक्टर बंद हो जाता है और उसका स्थानीय डेटा हटा दिया जाता है। यदि कोई लॉक की हुई फ़ाइल या फ़ाइलसिस्टम त्रुटि हटाने में बाधा डालती है, तो पैनल विफलता की रिपोर्ट करता है और वर्कस्पेस को अनुपलब्ध (DeletionPending) के रूप में सूचीबद्ध रखता है। इसकी फ़ाइलों को रखने वाले प्रोग्रामों को बंद करें और हटाने का प्रयास दोबारा करें। TgWitness को फिर से शुरू करने पर वह वर्कस्पेस बंद रहता है और उसका आंशिक रूप से हटाया गया जर्नल या कुंजियाँ फिर से नहीं बनती हैं। एक सफल हटाने की प्रक्रिया केवल तब दर्ज की जाती है जब डायरेक्टरी हटा दी जाती है; अलग से निर्यात की गई या बैक-अप की गई प्रतियाँ अपनी स्वयं की प्रतिधारण नीति के अधीन रहती हैं।
सूचनाएं#
सेटिंग्स → सूचनाएं और ऑफ-साइट कॉपी → सूचना गंतव्य, या अधिक उपकरण → अतिरिक्त → सूचनाएं → कॉन्फ़िगर करें। TgWitness मैट्रिक्स, टेलीग्राम, डिस्कोर्ड, स्लैक, ntfy, ईमेल और अन्य समर्थित सेवाओं पर अलर्ट भेजने के लिए Apprise का उपयोग करता है। आप एक वर्कस्पेस में कई गंतव्य जोड़ सकते हैं।
- प्रत्येक लाइन पर एक Apprise गंतव्य URL दर्ज करें। अपनी सेवा के लिए सेवा कैटलॉग और URL प्रारूपों का उपयोग करें।
- सूचनाएं भेजें चालू करें, फिर समस्या अलर्ट, देखी गई चैट में बदलाव और एक दैनिक सारांश चुनें। सारांश का समय सर्वर के समय का उपयोग करता है।
- यदि आप अलर्ट में हटाए गए और संपादित संदेशों से सहेजा गया टेक्स्ट चाहते हैं, तो 'संक्षिप्त अंश शामिल करें' चालू करें।
- संदेशों को सहेजें पर क्लिक करें, फिर डिलीवरी की जाँच करने के लिए परीक्षण भेजें पर क्लिक करें।
अपने स्वयं के रिसीवर के लिए, Apprise के JSON वेबहुक का उपयोग करें।
उदाहरण के लिए, jsons://notify.example.org/tgwitness HTTPS पर उस एंडपॉइंट पर JSON भेजता है। यह एक काल्पनिक उदाहरण है; इसे अपनी खुद की मंज़िल से बदलें।
डेस्टिनेशन और सेटिंग्स चयनित वर्कस्पेस से संबंधित हैं। सूचनाएं अपने अवलोकित स्रोतों को कवर करती हैं, जिसमें हाल ही में जोड़ी गई चैट भी शामिल हैं। टॉप बार में घंटी हाल की समस्याओं और चैट परिवर्तनों को भी सूचीबद्ध करती है।
डेमो में, सूचना नियंत्रण दिखाई देते हैं लेकिन भेजना अक्षम है। एक वास्तविक वर्कस्पेस में डिलीवरी कॉन्फ़िगर करें। सूचनाएं उस वर्कस्पेस के डायरेक्ट, SOCKS5 या HTTP रूट का उपयोग करती हैं; MTProxy उन्हें ले जा नहीं सकता। SMTP जैसे गैर-HTTP गंतव्यों के लिए एक सीधे रूट की आवश्यकता होती है।
पैनल लेआउट#

जर्नल अवलोकन, खोज और फ़िल्टर दिखाता है। एक संपादन कैप्चर किए गए संस्करणों को खोलता है; एक हटाना, यदि उपलब्ध हो, तो पिछली सामग्री को खोलता है। अज्ञात श्रेय स्पष्ट रहता है। ओवरव्यू के तहत गणनाएँ उपलब्ध हैं; अधिग्रहण का विवरण स्थानीय गाइड में बना रहता है।
किसी संपादित संदेश के संस्करणों की तुलना पाठ में बदलाव या साथ-साथ के साथ करने के लिए उसे खोलें; मूल डेटा सहेजे गए फ़ील्ड दिखाता है। छिपे हुए लिंक और बॉट बटन में बदलाव अलग से दिखाई देते हैं। सहेजे गए चित्र, ऑडियो या वीडियो की जांच करने के लिए अटैचमेंट प्रीव्यू खोलें; डाउनलोड बटन संरक्षित मूल फ़ाइल को उपलब्ध रखता है।
जैसे ही रिकॉर्ड आते हैं, Live जर्नल और चैट को अपडेट करता है। समीक्षा करते समय इसे रोकें (पॉज़ करें), या तैयार होने पर नए-इवेंट बटन का उपयोग करें; संग्रह चलता रहता है। Ctrl/Cmd+K पैनल क्रियाओं को ढूंढता है और जर्नल को खोजता है।
अधिक उपकरण → स्रोत अवलोकन दायरा (चुनी हुई चैट, एक टेलीग्राम फ़ोल्डर या पूरा खाता), हर प्रकार की सुलभ चैट, प्राथमिकता सितारों वाले चयनित स्रोत, अटैचमेंट और पुनः जाँच सेटिंग्स और इतिहास स्नैपशॉट्स शामिल हैं। निजी स्रोत डायलॉग/आईडी द्वारा एक सार्वजनिक लिंक के बिना चुने जाते हैं। पहुँच स्थिति सबसे हालिया जाँच का वर्णन करती है, स्थायी अनुमतियों का नहीं।
सोर्स फ़िल्टर करें, उनके चेकबॉक्स चुनें, फिर उन्हें एक साथ सक्षम करें, रोकें या प्राथमिकता के रूप में चिह्नित करें। उपलब्ध-चैट सूची में, चुने हुए जोड़ें आपके चयन का उपयोग करता है; सभी मिलते-जुलते परिणाम जोड़ें वर्तमान खोज और प्रकार फ़िल्टर का उपयोग करता है।
चैट्स → लोग: उन सभी लोगों की सूची दिखाता है जिनके संदेश सहेजे गए हैं; चैट के लिए प्रोफ़ाइल चालू होने पर, एक क्लिक से उस व्यक्ति की प्रोफ़ाइल खुल जाती है जिसमें जर्नल रिकॉर्ड के लिंक होते हैं।
अधिक उपकरण → अतिरिक्त → स्वतंत्र गवाह रीड-ओनली गवाह टोकन बनाता है, दिखाता है कि प्रत्येक गवाह ने आखिरी बार कब जाँच की और एक (स्वतंत्र गवाह) चलाने के लिए कमांड और विकल्प देता है।
अधिक उपकरण → पैरामीटर वर्कस्पेस की हर सीमा और गति को धारण करता है जो किसी अन्य पेज पर नहीं है:
कितने डायलॉग पढ़े गए हैं, चैट सूची कितनी बार फिर से पढ़ी जाती है, हार्टबीट और चेकपॉइंट अंतराल, स्टार्टअप बफर, पुन: जाँच अपने अनुरोध कैसे फैलाते हैं (पहली देरी, प्रति
पास, चैट के बीच विराम, पुनः प्राप्त संदेश और पुनः अनुरोधित संदेश), डिस्क आरक्षण, डाउनलोड के टाइमआउट और पुनः प्रयास, लोग प्रोफ़ाइल में क्या खोजते हैं (आपके अपने नियमित अभिव्यक्तियों सहित), सूचनाओं का आकार और गति, स्नैपशॉट, ज़िप और ब्राउज़र-डाउनलोड सीमाएं, और टेलीग्राम क्लाइंट टाइमआउट और पुनः प्रयास। प्रत्येक फ़ील्ड अपनी सीमा और डिफ़ॉल्ट दिखाता है; बदले गए फ़ील्ड्स को चिह्नित किया जाता है और उन्हें एक-एक करके या सभी को एक साथ बहाल किया जा सकता है। हर बदलाव को पहले और बाद के मानों के साथ parameters.changed के रूप में दर्ज किया जाता है, और ऑब्ज़र्वेशन स्टार्ट रिकॉर्ड्स लागू मानों का नाम बताते हैं। मान उनके अगले उपयोग से लागू होते हैं; क्लाइंट टाइमआउट और रिट्री अगले कनेक्शन से। रीचेक अंतराल, अटैचमेंट प्रकार और आकार, सबूत और ऑफ-साइट कॉपी अंतराल अपने स्वयं के पृष्ठों पर रहते हैं और अपनी रेंज में कोई भी मान लेते हैं, केवल प्रीसेट ही नहीं।
शीर्ष बार में घंटी देखी गई चैट्स में हाल की समस्याओं और परिवर्तनों को सूचीबद्ध करती है; अनपढ़ संदेशों को तब तक गिना जाता है जब तक उन्हें पढ़ा हुआ नहीं चिह्नित किया जाता। परिवर्तन प्रति चैट और घंटे के अनुसार समूहित किए जाते हैं ("12 हटाए गए, 1 संपादित, 0 नहीं मिले"), और साइन-आउट या डिस्क पूर्ण होने जैसी समस्याएं, चैट्स कितनी भी व्यस्त क्यों न हों, सूची में बनी रहती हैं।
अधिक उपकरण → खाता फ़ोन-नंबर फ़ील्ड से शुरू होता है। जारी रखने पर सीधे कोड प्रविष्टि की ओर जाता है, और केवल API क्रेडेंशियल गायब होने पर ही उनकी मांग करता है। QR और फ़ाइल आयात वैकल्पिक टैब हैं। सहेजे गए API क्रेडेंशियल केवल अपने स्वयं के वर्कस्पेस के भीतर ही पुन: उपयोग किए जाते हैं। एंट्री स्क्रीन पर कोई साइडबार, आँकड़े, या सेटअप पैराग्राफ नहीं हैं। सेटिंग्स आइकन API, प्रॉक्सी, स्टोरेज, और अतिरिक्त-खाते नियंत्रण खोलता है। एक नया वर्कस्पेस पहला सेटअप खोलता है; साइन-इन के बाद, सहेजे गए स्रोतों और रिकॉर्ड वाले वर्कस्पेस में चैट्स खुलती हैं। रूट बदलने के लिए रुके हुए अवलोकन की आवश्यकता होती है और यह अधूरे लॉगिन को रद्द कर देता है। किसी मौजूदा जर्नल को चुपचाप किसी अलग टेलीग्राम खाते से फिर से बांधा नहीं जा सकता।
एक्सपोर्ट्स जर्नल की अखंडता की जाँच करता है और पोर्टेबल फ़ाइलें बनाता है। इसका वर्कस्पेस आईडी डाउनलोड CLI को पास किया जा सकता है। हर एक्सपोर्ट एक पूरा जर्नल प्रीफ़िक्स पिन करता है; बाद की घटनाएँ अगले एक्सपोर्ट में दर्ज होती हैं। सर्च फ़िल्टर पैकेज के दायरे को नहीं बदलते हैं। विस्तृत साइनिंग और कवरेज जानकारी वेरिफिकेशन और सबूत के अंतर्गत है।
पैनल कलेक्टर हेल्थ के तहत कलेक्टर स्थिति, कतारबद्ध/असफल मीडिया, सबसे पुराना लंबित मीडिया, खाली डिस्क, अनुरोध विराम और उन स्रोतों की रिपोर्ट करता है जिनकी पहुंच की पुष्टि नहीं हुई है। ये विवरण शुरू में संकुचित होते हैं और अकाउंट पर छिपे होते हैं। एक सेटअप कार्ड अगला कदम दिखाता है: एक अकाउंट कनेक्ट करें, स्रोत चुनें, या अवलोकन शुरू करें। खाता सूची लोड-टाइम का एक स्नैपशॉट है; चयनित वर्कस्पेस समय-समय पर रिफ्रेश होता है। यह एक मल्टी-प्रोसेस SLA मॉनिटर नहीं है।
इंटरफ़ेस स्रोत सामग्री के लिए स्थानीय एसेट और टेक्स्ट रेंडरिंग का उपयोग करता है। Chromium में डेस्कटॉप और संकरे लेआउट का परीक्षण किया गया है।
तैनाती वातावरण#
| पर्यावरण | स्थापना | सत्यापन स्थिति |
|---|---|---|
| विंडोज पीसी/सर्वर | पाइथन 3.11+, scripts\Setup.cmd/Start.cmd, निजी डेटा निर्देशिका | Windows/Python 3.12 पर स्थानीय रूप से जांचा गया |
| लिनक्स सर्वर/वीपीएस | पाइथन वीएनवी, समर्पित सेवा उपयोगकर्ता, HTTPS/SSH | कोड, CI और systemd का उदाहरण प्रदान किया गया; इस होस्ट पर निष्पादित नहीं किया गया |
| macOS | पाइथन वेंव, अग्रभूमि प्रक्रिया या उपयोगकर्ता एजेंट | launchd उदाहरण प्रदान किया गया; अलग इंस्टॉलेशन जांच आवश्यक है |
| डॉकर/कंपोज | स्थायी वॉल्यूम, एक वर्कर | परिभाषा और CI रनटाइम जाँच प्रदान की गई; स्थानीय रूप से Docker उपलब्ध नहीं है |
| फ़ोन ब्राउज़र | चला रहे सर्वर पर सुरक्षित पैनल से कनेक्ट करें | संकीर्ण क्रोमियम लेआउट का परीक्षण किया गया; कलेक्टर iOS/Android पर नहीं चलता |
पोर्टेबिलिटी का मतलब है कि कोई अनिवार्य क्लाउड सेवा या फ्रंटएंड बिल्ड नहीं है। प्रत्येक लक्ष्य को अभी भी संगत पाइथन/क्रिप्टो निर्भरताओं, स्थानीय डिस्क और नेटवर्क एक्सेस की आवश्यकता है। DEPLOYMENT.md और सेवा टेम्प्लेट देखें।
वर्कस्पेस सीपीयू, मेमोरी और एक इवेंट लूप साझा करते हैं। प्रक्रिया पृथक्करण के लिए, अलग-अलग इंस्टेंस, पोर्ट, डेटा डायरेक्टरी और खाता प्राधिकरण का उपयोग करें। अलग-अलग इंस्टेंस के लिए कोई एकीकृत पैनल नहीं है। कभी भी कई वर्कर्स को एक डेटाबेस पर न लगाएं।
स्टार्टअप जाँच और निर्यात#
तैयार वातावरण शुरू करने से पहले python start.py --check चलाएँ। मशीन-पठनीय जाँच के लिए --json जोड़ें या इच्छित --data-dir, --host और --port पास करें।
यह कमांड टेलीग्राम लॉगिन या जर्नल बनाने के बिना पूर्वापेक्षाओं की जाँच करती है।
एप्लिकेशन शुरू होने के दौरान जर्नल सत्यापन चलता है, और कैप्चर की तत्परता पैनल में दिखाई देती है।
एक व्यस्त पोर्ट बस एक मौजूदा इंस्टेंस हो सकता है।
फ़ाइल सिस्टम एक्सेस API का समर्थन करने वाले ब्राउज़र एक लिखने योग्य स्ट्रीम के माध्यम से एक्सपोर्ट्स को सेव करते हैं। अन्य ब्राउज़र अधिकतम 128 MiB तक बफ़र करते हैं। बड़े एक्सपोर्ट्स या फ़ाइल स्ट्रीमिंग के बिना ब्राउज़रों के लिए स्ट्रीमिंग CLI का उपयोग करें:
python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip
चाइल्ड वर्कस्पेस के लिए एक्सपोर्ट्स से --profile ID
जोड़ें। रिमोट एक्सेस के लिए --url https://server
का उपयोग करें। प्लेन HTTP केवल लूपबैक डेस्टिनेशन्स के लिए स्वीकार किया जाता है। टोकन को एक फ़ाइल से पढ़ा जाता है और एक हेडर में भेजा जाता है, इसे प्रिंट नहीं किया जाता या URL में नहीं डाला जाता। रीडायरेक्ट्स को अस्वीकार कर दिया जाता है। मौजूदा डेस्टिनेशन्स को ओवरराइट नहीं किया जाता है। असफल ट्रांसफर अपनी अस्थायी पार्ट फ़ाइल को हटा देते हैं। रिपोर्ट किया गया SHA-256 एक ट्रांसफर चेक्सम है; हस्ताक्षरित ZIP को एक विश्वसनीय फ़िंगरप्रिंट/चेकपॉइंट के साथ अलग से सत्यापित करें।
बैकअप, पुनर्स्थापना और रुकावटें#
- निरीक्षण को रोकें और प्रक्रिया को स्वच्छ रूप से रोकें।
- पूरे डेटा निर्देशिका की प्रतिलिपि बनाएँ: डेटाबेस, यदि मौजूद हों तो WAL/SHM, मीडिया,
credentials.enc,signing.enc,network.enc, वॉल्ट कुंजी/मेटाडेटा, टोकन, चेकपॉइंट्स और प्रत्येकprofiles/निर्देशिका। - बाहरी-कुंजी मोड के लिए, मास्टर कुंजी को अलग से सुरक्षित रखें और प्रत्येक
vault.external.jsonको बनाए रखें। नई कुंजी उत्पन्न करने से पुराने रहस्य पुनः प्राप्त नहीं किए जा सकते। - गंतव्य रुका होने पर पुनर्स्थापित करें; मूल कुंजी कॉन्फ़िगर करें, पहुँच प्रतिबंधित करें, और फिर से शुरू करने से पहले अखंडता सत्यापित करें।
- डाउनटाइम और सत्यापन परिणामों को रिकॉर्ड करें। डाउनटाइम एक रिकॉर्ड किया गया अंतराल बना रहता है; एक इतिहास स्नैपशॉट इसके बाद की स्थिति को जोड़ता है।
Evidence ZIPs exclude sessions/private keys and are not full service backups.
tgwitness backup FOLDER makes the same copy while the panel keeps running and leaves out the
search index, which rebuilds itself; see Updates and backups.
Four things are protected differently:
| क्या | सुरक्षा |
|---|---|
| बिना पासवर्ड वाली एक्सपोर्ट फ़ाइलें (डिफ़ॉल्ट) | हस्ताक्षरित, इसलिए बदलावों का पता लगाया जा सकता है; एक्सपोर्ट को एन्क्रिप्ट करने के लिए पासवर्ड सेट करें |
| पासवर्ड वाली एक्सपोर्ट फ़ाइलें | यदि आप पासवर्ड सेट करते हैं, तो तैयार एक्सपोर्ट बिना बदले एक WinZip AES-256 ZIP फ़ाइल में जाता है जिसे 7-Zip और WinRAR खोलते हैं; पासवर्ड संग्रहीत नहीं किया जाता (साक्ष्य प्रबंधन) |
| जर्नल डेटाबेस और डिस्क पर सहेजी गई संलग्नक | एन्क्रिप्टेड डिस्क या वॉल्यूम और फ़ोल्डर अनुमतियाँ |
| टेलीग्राम सत्र और हस्ताक्षर कुंजी | डेटा निर्देशिका में एन्क्रिप्ट किया गया (credentials.enc, signing.enc, network.enc) |
एक पूर्ण सेवा बैकअप ऊपर वर्णित रोकी गई डेटा निर्देशिका है, न कि एक एक्सपोर्ट।
दोनों के लिए सुरक्षित भंडारण और एक जानबूझकर किया गया स्थानांतरण तंत्र उपयोग करें। अस्थायी सर्वर एक्सपोर्ट प्रत्येक वर्कस्पेस के
temporary-exports/ में रहते हैं; पूर्ण प्रतिक्रियाओं को साफ कर दिया जाता है, और उस वर्कस्पेस के इंस्टेंस लॉक के धारण किए जाने तक अगले स्टार्टअप पर रुकी हुई एक्सपोर्ट फ़ाइलों को हटा दिया जाता है।
कनेक्शन-बहाल होने की घटना के बाद, कलेक्टर सहेजी गई अपडेट स्थिति से छूटे हुए अपडेट का अनुरोध करता है। स्थायी मीडिया जॉब्स और टेलीग्राम अपडेट स्थिति रीस्टार्ट के बाद भी बनी रहती हैं; साक्ष्य प्रारूप देखें।
क्षमता और प्रतिधारण#
डिफ़ॉल्ट सीमाएँ, सभी 'अधिक उपकरण → पैरामीटर' के तहत बदले जा सकते हैं: पहले 1,000 डायलॉग, प्रति स्नैपशॉट 500 संदेश, 4 जीआईबी बिना संपीड़ित साइन किए गए ज़िप सामग्री (बड़े आर्काइव के लिए verify.py --max-gib N की आवश्यकता होती है) और एक 128 एमआईबी ब्राउज़र फ़ॉलबैक। अटैचमेंट 'अधिक उपकरण → स्रोत → रिकॉर्डिंग → अटैचमेंट्स' के तहत प्रति प्रकार 1–2,000 एमआईबी लेते हैं। डाउनलोड CLI डिफ़ॉल्ट रूप से 5 जीआईबी स्थानांतरित करने के लिए सेट है। उपलब्ध डिस्क एक निचली सीमा हो सकती है। जर्नल, मीडिया, WAL, अस्थायी एक्सपोर्ट और बैकअप के लिए जगह आरक्षित करें। एक्सपोर्ट Compose के 512 MiB /tmp का उपयोग करने के बजाय डेटा वॉल्यूम का उपयोग करते हैं।
केवल समूहों को गिनने के बजाय प्रति सेकंड घटनाओं, कतार की आयु, मीडिया बाइट्स और डिस्क विलंबता को मापें। लाइव डिलीवरी चल रहे कलेक्टर पर मापी जाती है। कोई स्वचालित प्रतिधारण हटाना नहीं है। जर्नल टेल को हटाने से उसके प्रतिधारित चेकपॉइंट्स के साथ उसका संबंध अमान्य हो जाता है।
प्राथमिकता वाली पुनः जाँच पहले से मौजूद है: तारांकित स्रोतों की डिफ़ॉल्ट रूप से हर 15 मिनट में और बाकी की हर 6 घंटे में पुनः जाँच होती है (देखें पुनः जाँच स्तर)। पासवर्ड-सुरक्षित निर्यात ऊपर बताए अनुसार काम करते हैं। सीमित पहुँच का विवरण पहुँच और अनुमतियाँ में है। देखें READINESS.md, LIVE_ACCEPTANCE.md और VERIFICATION.md।