TgWitness / दस्तावेज़ीकरण

संदर्भ / एकत्र करें

कार्यप्रवाह और संचालन

पैनल का दैनिक संचालन: मोड, निगरानी श्रेणियाँ, पैरामीटर, सूचनाएं, निर्यात, बैकअप और क्षमता।

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

ऑपरेटर वर्कफ़्लो#

प्रवाह आरेखभंडारण और कुंजी सुरक्षा चुनें → उसके टोकन के साथ पैनल खोलें; उसके टोकन के साथ पैनल खोलें → एक कार्यक्षेत्र चुनें; एक कार्यक्षेत्र चुनें → प्रत्यक्ष या प्रॉक्सी मार्ग कॉन्फ़िगर करें; प्रत्यक्ष या प्रॉक्सी मार्ग कॉन्फ़िगर करें → फ़ोन दर्ज करें या फ़ाइलें / QR चुनें; फ़ोन दर्ज करें या फ़ाइलें / QR चुनें → खाते की पहचान जांचें और पहुँच योग्य समूह चुनें; खाते की पहचान जांचें और पहुँच योग्य समूह चुनें → घटना और संलग्नक नीतियाँ सहेजें, फिर अवलोकन शुरू करें; घटना और संलग्नक नीतियाँ सहेजें, फिर अवलोकन शुरू करें → त्रुटियों, पहुँच, कतारों और डिस्क की निगरानी करें; त्रुटियों, पहुँच, कतारों और डिस्क की निगरानी करें → स्वतंत्र जांच बिंदुओं को बनाए रखें; स्वतंत्र जांच बिंदुओं को बनाए रखें → सामग्री का निर्यात और सत्यापनभंडारण और कुंजीसुरक्षा चुनेंउसके टोकन के साथ पैनलखोलेंएक कार्यक्षेत्र चुनेंप्रत्यक्ष या प्रॉक्सीमार्ग कॉन्फ़िगर करेंफ़ोन दर्ज करें याफ़ाइलें / QR चुनेंखाते की पहचान जांचेंऔर पहुँच योग्य समूहचुनेंघटना और संलग्नकनीतियाँ सहेजें, फिरअवलोकन शुरू करेंत्रुटियों, पहुँच,कतारों और डिस्क कीनिगरानी करेंस्वतंत्र जांच बिंदुओंको बनाए रखेंसामग्री का निर्यात औरसत्यापन
चित्र को पाठ के रूप में
  1. भंडारण और कुंजी सुरक्षा चुनें → उसके टोकन के साथ पैनल खोलें
  2. उसके टोकन के साथ पैनल खोलें → एक कार्यक्षेत्र चुनें
  3. एक कार्यक्षेत्र चुनें → प्रत्यक्ष या प्रॉक्सी मार्ग कॉन्फ़िगर करें
  4. प्रत्यक्ष या प्रॉक्सी मार्ग कॉन्फ़िगर करें → फ़ोन दर्ज करें या फ़ाइलें / QR चुनें
  5. फ़ोन दर्ज करें या फ़ाइलें / QR चुनें → खाते की पहचान जांचें और पहुँच योग्य समूह चुनें
  6. खाते की पहचान जांचें और पहुँच योग्य समूह चुनें → घटना और संलग्नक नीतियाँ सहेजें, फिर अवलोकन शुरू करें
  7. घटना और संलग्नक नीतियाँ सहेजें, फिर अवलोकन शुरू करें → त्रुटियों, पहुँच, कतारों और डिस्क की निगरानी करें
  8. त्रुटियों, पहुँच, कतारों और डिस्क की निगरानी करें → स्वतंत्र जांच बिंदुओं को बनाए रखें
  9. स्वतंत्र जांच बिंदुओं को बनाए रखें → सामग्री का निर्यात और सत्यापन

अधिकृत करना, परिवहन कनेक्टिविटी, समूह तक पहुंच और डिलीवरी की पूर्णता अलग-अलग गुण हैं। हरा कनेक्शन स्टेटस यह संकेत नहीं देता कि सभी घटनाएँ कैप्चर हो गई हैं।

मुख्य कुंजी साझा किए बिना कार्य साझा करें#

समीक्षक या विश्लेषक को अपना टोकन देने के लिए ओपन एक्सेस। वे जिन खातों और चैट को खोल सकते हैं, उन्हें चुनें, फिर देखने, एक्सपोर्ट करने या परिचालन कार्यों की अनुमति दें। एक ऑपरेटर जिसे संग्रह शुरू/रोकना है, उसे पूरे कार्यक्षेत्र की पहुँच की आवश्यकता होती है; एक समीक्षक को एक ही चैट तक सीमित किया जा सकता है। सत्र सीमाएँ, समाप्ति और आईपी नियम टेलीग्राम खाते के प्राधिकरण से अलग हैं। पहुँच और अनुमतियाँ देखें।

कनेक्शन समाप्त करने के लिए Open sessions का उपयोग करें या इसकी सभी सत्रों को समाप्त करने के लिए एक्सेस रद्द करें। एडमिनिस्ट्रेटर कंसोल वर्कस्पेस के पार वर्तमान-प्रक्रिया गतिविधि को संयोजित करता है। सत्र समापन पर संग्रहण चलता रहता है।

रनटाइम मोड्स#

मोड कार्रवाई व्यवहार
डेमो scripts\Demo.cmd या --demo सिंथेटिक डेटा; वास्तविक खाता कनेक्शन अक्षम
निरीक्षण निरीक्षण शुरू करें चयनित स्रोतों के लिए प्रदान किए गए अपडेट्स का रिकॉर्ड
इतिहास का स्नैपशॉट स्रोत → इतिहास स्नैपशॉट वर्तमान संदेशों की संख्या 500 तक; सभी पिछले परिवर्तनों का पुनर्निर्माण नहीं
विराम प्रेक्षण विराम डेटा और कतारबद्ध कार्यों को बनाए रखते हुए संग्रहण रोकें
समीक्षा/हैंडऑफ़ निर्यात ZIP, JSONL/CSV/HTML, चेकपॉइंट, प्रक्रिया रसीद और टाइमस्टैम्प अनुरोध
कई खाते वर्कस्पेस या सबसे ऊपर का + बटन एक ही प्रक्रिया में किसी भी संख्या में अलग-अलग कार्यक्षेत्र

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

निगरानी श्रेणियाँ#

सिंथेटिक स्रोत डेटा के साथ प्रति-खाता निगरानी सेटिंग्स

स्रोत → कैप्चर सेटिंग्स → कौन से परिवर्तन सहेजे जाएँ, चुनें में, नए संदेश, संपादन, हटाने की सूचनाएं, प्रतिक्रिया अपडेट और सदस्यता घटनाओं को स्वतंत्र रूप से चुनें। डिफ़ॉल्ट सभी श्रेणियों को बरकरार रखता है। संदेश, संपादन और हटाने, अलग प्रतिक्रिया/सदस्य अपडेट को अक्षम करते हुए मूल संदर्भ को बरकरार रखता है। सभी दृश्यमान गतिविधि सभी पाँचों को पुनर्स्थापित करती है। प्रीसेट फॉर्म को बदलते हैं; लागू करने के लिए 'निगरानी सेटिंग्स सहेजें' दबाएँ।

सहेजी गई नीति उस वर्कस्पेस में सभी चयनित स्रोतों पर लागू होती है। अन्य वर्कस्पेस अपनी सेटिंग्स बनाए रखते हैं। प्रत्येक वास्तविक परिवर्तन हस्ताक्षरित पहले/बाद के मानों को रिकॉर्ड करता है; वर्तमान नीति प्रोसेस रसीदों और अवलोकन प्रारंभ रिकॉर्ड में भी शामिल होती है। किसी श्रेणी को अक्षम करने से पहले के अवलोकन मिटे नहीं हैं। पुनः सक्षम करने से छूटे हुए परिवर्तन वापस नहीं आते हैं। इस संस्करण में प्रति-समूह श्रेणी ओवरराइड नहीं है।

जब पिछली सामग्री महत्वपूर्ण हो तो नए संदेशों को सक्षम रखें: एक हटाने की सूचना उस टेक्स्ट को पुनर्प्राप्त नहीं कर सकती जो कभी कैप्चर ही नहीं किया गया था। परिचालन/कवरेज रिकॉर्ड और अन्य समूह सेवा घटनाएं हमेशा बनाए रखी जाती हैं। स्पष्ट इतिहास स्नैपशॉट, लाइव-श्रेणी चयन से अलग होते हैं और इनमें सेवा संदेश शामिल हो सकते हैं। ये स्विच, अन्यथा कैप्चर किए गए टेलीग्राम ऑब्जेक्ट में एम्बेड किए गए प्रतिक्रिया/सदस्य मेटाडेटा को संपादित नहीं करते हैं।

एक हिस्ट्री स्नैपशॉट विराम पर होने पर अटैचमेंट्स को कतार में लगा सकता है। उन्हें प्रोसेस करने के लिए अवलोकन शुरू करें। कतार में होने का मतलब डाउनलोड होना नहीं है। एक अनुपलब्ध मूल फ़ाइल को नए संपादित संस्करण से नहीं बदला जाता है; परिणाम अलग से रिकॉर्ड किए जाते हैं।

लॉक ब्राउज़र एक्सेस और गुप्त फ़ील्ड्स को बंद कर देता है लेकिन संग्रहण को चालू रखता है। टैब बंद करने पर भी प्रक्रिया चालू रहती है। पाइथन प्रक्रिया या सेवा को रोकने पर ब्राउज़र की स्थिति की परवाह किए बिना संग्रहण रुक जाता है।

एक अतिरिक्त वर्कस्पेस को हटाने से उसका कलेक्टर बंद हो जाता है और उसका स्थानीय डेटा हटा दिया जाता है। यदि कोई लॉक की हुई फ़ाइल या फ़ाइलसिस्टम त्रुटि हटाने में बाधा डालती है, तो पैनल विफलता की रिपोर्ट करता है और वर्कस्पेस को अनुपलब्ध (DeletionPending) के रूप में सूचीबद्ध रखता है। इसकी फ़ाइलों को रखने वाले प्रोग्रामों को बंद करें और हटाने का प्रयास दोबारा करें। TgWitness को फिर से शुरू करने पर वह वर्कस्पेस बंद रहता है और उसका आंशिक रूप से हटाया गया जर्नल या कुंजियाँ फिर से नहीं बनती हैं। एक सफल हटाने की प्रक्रिया केवल तब दर्ज की जाती है जब डायरेक्टरी हटा दी जाती है; अलग से निर्यात की गई या बैक-अप की गई प्रतियाँ अपनी स्वयं की प्रतिधारण नीति के अधीन रहती हैं।

सूचनाएं#

स्रोत → सूचनाएं → अलर्ट और एक दैनिक सारांश खोलें। TgWitness, Apprise का उपयोग करके Matrix, Telegram, Discord, Slack, ntfy, ईमेल और अन्य समर्थित सेवाओं पर अलर्ट भेजता है। आप एक वर्कस्पेस में कई गंतव्य जोड़ सकते हैं।

  1. प्रत्येक लाइन पर एक Apprise गंतव्य URL दर्ज करें। अपनी सेवा के लिए सेवा कैटलॉग और URL प्रारूपों का उपयोग करें।
  2. सूचनाएं भेजें चालू करें, फिर समस्या अलर्ट, देखी गई चैट में बदलाव और एक दैनिक सारांश चुनें। सारांश का समय सर्वर के समय का उपयोग करता है।
  3. यदि आप अलर्ट में हटाए गए और संपादित संदेशों से सहेजा गया टेक्स्ट चाहते हैं, तो 'संक्षिप्त अंश शामिल करें' चालू करें।
  4. संदेशों को सहेजें पर क्लिक करें, फिर डिलीवरी की जाँच करने के लिए परीक्षण भेजें पर क्लिक करें।

अपने स्वयं के रिसीवर के लिए, Apprise के JSON वेबहुक का उपयोग करें। उदाहरण के लिए, jsons://notify.example.org/tgwitness HTTPS पर उस एंडपॉइंट पर JSON भेजता है। यह एक काल्पनिक उदाहरण है; इसे अपनी खुद की मंज़िल से बदलें।

डेस्टिनेशन और सेटिंग्स चयनित वर्कस्पेस से संबंधित हैं। सूचनाएं अपने अवलोकित स्रोतों को कवर करती हैं, जिसमें हाल ही में जोड़ी गई चैट भी शामिल हैं। टॉप बार में घंटी हाल की समस्याओं और चैट परिवर्तनों को भी सूचीबद्ध करती है।

डेमो में, सूचना नियंत्रण दिखाई देते हैं लेकिन भेजना अक्षम है। एक वास्तविक वर्कस्पेस में डिलीवरी कॉन्फ़िगर करें। सूचनाएं उस वर्कस्पेस के डायरेक्ट, SOCKS5 या HTTP रूट का उपयोग करती हैं; MTProxy उन्हें ले जा नहीं सकता। SMTP जैसे गैर-HTTP गंतव्यों के लिए एक सीधे रूट की आवश्यकता होती है।

पैनल लेआउट#

संयोजित कार्यक्षेत्र कृत्रिम डेटा का उपयोग करते हुए

जर्नल अवलोकन, खोज और फ़िल्टर दिखाता है। एक संपादन कैप्चर किए गए संस्करणों को खोलता है; एक हटाना, यदि उपलब्ध हो, तो पिछली सामग्री को खोलता है। अज्ञात श्रेय स्पष्ट रहता है। ओवरव्यू के तहत गणनाएँ उपलब्ध हैं; अधिग्रहण का विवरण स्थानीय गाइड में बना रहता है।

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

जैसे ही रिकॉर्ड आते हैं, Live जर्नल और चैट को अपडेट करता है। समीक्षा करते समय इसे रोकें (पॉज़ करें), या तैयार होने पर नए-इवेंट बटन का उपयोग करें; संग्रह चलता रहता है। Ctrl/Cmd+K पैनल क्रियाओं को ढूंढता है और जर्नल को खोजता है।

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

सोर्स फ़िल्टर करें, उनके चेकबॉक्स चुनें, फिर उन्हें एक साथ सक्षम करें, रोकें या प्राथमिकता के रूप में चिह्नित करें। उपलब्ध-चैट सूची में, चुने हुए जोड़ें आपके चयन का उपयोग करता है; सभी मिलते-जुलते परिणाम जोड़ें वर्तमान खोज और प्रकार फ़िल्टर का उपयोग करता है।

चैट्स → लोग: उन सभी लोगों की सूची दिखाता है जिनके संदेश सहेजे गए हैं; चैट के लिए प्रोफ़ाइल चालू होने पर, एक क्लिक से उस व्यक्ति की प्रोफ़ाइल खुल जाती है जिसमें जर्नल रिकॉर्ड के लिंक होते हैं।

विटनेस केवल-पठन (read-only) विटनेस टोकन बनाता है, यह दिखाता है कि प्रत्येक विटनेस ने आखिरी बार कब जाँच की थी और एक (स्वतंत्र विटनेस) चलाने के लिए कमांड और विकल्प देता है।

पैरामीटर वर्कस्पेस की हर सीमा और गति को नियंत्रित करता है जो किसी अन्य पेज पर नहीं है: कितने डायलॉग पढ़े जाते हैं, चैट सूची कितनी बार फिर से पढ़ी जाती है, हार्टबीट और चेकपॉइंट अंतराल, स्टार्टअप बफ़र, रीचेक अपने अनुरोधों को कैसे फैलाते हैं (पहली देरी, प्रति पासवर्ड, चैट के बीच विराम, पुनः प्राप्त और पुनः अनुरोधित संदेश, डिस्क आरक्षण, डाउनलोड के टाइमआउट और पुनः प्रयास, लोग प्रोफ़ाइल में क्या खोजते हैं (आपके अपने नियमित अभिव्यक्तियों सहित), सूचनाओं का आकार और गति, स्नैपशॉट, ज़िप और ब्राउज़र-डाउनलोड सीमाएं, और टेलीग्राम क्लाइंट टाइमआउट और पुनः प्रयास। प्रत्येक फ़ील्ड अपनी रेंज और डिफ़ॉल्ट दिखाता है; बदले गए फ़ील्ड्स को चिह्नित किया जाता है और उन्हें एक-एक करके या सभी को एक साथ बहाल किया जा सकता है। हर बदलाव को पहले और बाद के मानों के साथ parameters.changed के रूप में दर्ज किया जाता है, और ऑब्ज़र्वेशन स्टार्ट रिकॉर्ड्स लागू मानों का नाम देते हैं। मूल्य उनके अगले उपयोग से लागू होते हैं; क्लाइंट टाइमआउट और पुनः प्रयास अगले कनेक्शन से। पुनः जाँच अंतराल, अटैचमेंट प्रकार और आकार, सबूत और ऑफ-साइट कॉपी अंतराल अपने स्वयं के पृष्ठों पर रहते हैं और केवल पूर्वनिर्धारित मान ही नहीं, बल्कि अपनी श्रेणी में कोई भी मान ले सकते हैं।

शीर्ष बार में घंटी देखी गई चैट्स में हाल की समस्याओं और परिवर्तनों को सूचीबद्ध करती है; अनपढ़ संदेशों को तब तक गिना जाता है जब तक उन्हें पढ़ा हुआ नहीं चिह्नित किया जाता। परिवर्तन प्रति चैट और घंटे के अनुसार समूहित किए जाते हैं ("12 हटाए गए, 1 संपादित, 0 नहीं मिले"), और साइन-आउट या डिस्क पूर्ण होने जैसी समस्याएं, चैट्स कितनी भी व्यस्त क्यों न हों, सूची में बनी रहती हैं।

खाता फ़ोन-नंबर फ़ील्ड पर शुरू होता है। जारी रखने पर सीधे कोड प्रविष्टि पर जाता है, और API क्रेडेंशियल केवल तभी मांगे जाते हैं जब वे अनुपस्थित हों। QR और फ़ाइल आयात वैकल्पिक टैब हैं। सहेजे गए API क्रेडेंशियल केवल अपने स्वयं के वर्कस्पेस के भीतर ही पुन: उपयोग किए जाते हैं। प्रविष्टि स्क्रीन पर कोई साइडबार, आँकड़े या सेटअप पैराग्राफ़ नहीं हैं। सेटिंग्स आइकन API, प्रॉक्सी, स्टोरेज, और अतिरिक्त-खाते नियंत्रण खोलता है। नए इंस्टॉलेशन यहाँ से शुरू होते हैं; बिना किसी चयनित स्रोत के जुड़े खाते 'चैट्स चुनें' पर शुरू होते हैं। मार्ग बदलने के लिए रुके हुए अवलोकन की आवश्यकता होती है और यह अधूरे लॉगिन को रद्द कर देता है। किसी मौजूदा जर्नल को चुपचाप किसी अलग टेलीग्राम खाते से फिर से बांधा नहीं जा सकता।

एक्सपोर्ट जर्नल की अखंडता की जाँच करता है और पोर्टेबल फ़ाइलें बनाता है। इसका वर्कस्पेस आईडी डाउनलोड CLI को पास किया जा सकता है। प्रत्येक एक्सपोर्ट एक पूरा जर्नल प्रीफ़िक्स पिन करता है; बाद की घटनाएँ अगले एक्सपोर्ट में दर्ज होती हैं। खोज फ़िल्टर पैकेज के दायरे को नहीं बदलते हैं। विस्तृत हस्ताक्षर और कवरेज जानकारी 'सत्यापन और सीमाएँ' के अंतर्गत है।

पैनल कलेक्टर हेल्थ के तहत कलेक्टर स्थिति, कतारबद्ध/असफल मीडिया, सबसे पुराना लंबित मीडिया, खाली डिस्क, अनुरोध विराम और उन स्रोतों की रिपोर्ट करता है जिनकी पहुंच की पुष्टि नहीं हुई है। ये विवरण शुरू में संकुचित होते हैं और अकाउंट पर छिपे होते हैं। एक सेटअप कार्ड अगला कदम दिखाता है: एक अकाउंट कनेक्ट करें, स्रोत चुनें, या अवलोकन शुरू करें। खाता सूची लोड-टाइम का एक स्नैपशॉट है; चयनित वर्कस्पेस समय-समय पर रिफ्रेश होता है। यह एक मल्टी-प्रोसेस SLA मॉनिटर नहीं है।

यूआई स्रोत सामग्री के लिए स्थानीय एसेट्स और टेक्स्ट रेंडरिंग का उपयोग करता है। डेस्कटॉप और संकीर्ण क्रोमियम लेआउट का परीक्षण किया गया है। यह एक पूर्ण सुलभता प्रमाणन नहीं है; स्क्रीन-रीडर और मानव उपयोगिता मूल्यांकन अलग कार्य बने हुए हैं।

तैनाती वातावरण#

पर्यावरण स्थापना सत्यापन स्थिति
विंडोज पीसी/सर्वर पाइथन 3.11+, scripts\Setup.cmd/Start.cmd, निजी डेटा निर्देशिका Windows/Python 3.12 पर स्थानीय रूप से जांचा गया
लिनक्स सर्वर/वीपीएस पाइथन वीएनवी, समर्पित सेवा उपयोगकर्ता, HTTPS/SSH कोड, CI और systemd का उदाहरण प्रदान किया गया; इस होस्ट पर निष्पादित नहीं किया गया
macOS पाइथन वेंव, अग्रभूमि प्रक्रिया या उपयोगकर्ता एजेंट launchd उदाहरण प्रदान किया गया; अलग इंस्टॉलेशन जांच आवश्यक है
Docker/Compose स्थायी वॉल्यूम, एक वर्कर परिभाषा और 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 को एक विश्वसनीय फ़िंगरप्रिंट/चेकपॉइंट के साथ अलग से सत्यापित करें।

बैकअप, पुनर्स्थापना और रुकावटें#

  1. निरीक्षण को रोकें और प्रक्रिया को स्वच्छ रूप से रोकें।
  2. पूरे डेटा निर्देशिका की प्रतिलिपि बनाएँ: डेटाबेस, यदि मौजूद हों तो WAL/SHM, मीडिया, credentials.enc, signing.enc, network.enc, वॉल्ट कुंजी/मेटाडेटा, टोकन, चेकपॉइंट्स और प्रत्येक profiles/ निर्देशिका।
  3. बाहरी-कुंजी मोड के लिए, मास्टर कुंजी को अलग से सुरक्षित रखें और प्रत्येक vault.external.json को बनाए रखें। नई कुंजी उत्पन्न करने से पुराने रहस्य पुनः प्राप्त नहीं किए जा सकते।
  4. गंतव्य रुका होने पर पुनर्स्थापित करें; मूल कुंजी कॉन्फ़िगर करें, पहुँच प्रतिबंधित करें, और फिर से शुरू करने से पहले अखंडता सत्यापित करें।
  5. डाउनटाइम और सत्यापन परिणामों को रिकॉर्ड करें। एक इतिहास स्नैपशॉट यह साबित नहीं कर सकता कि अवरोध के दौरान कोई हटाने की क्रिया नहीं हुई।

सबूत ज़िप (Evidence ZIPs) सत्र/निजी कुंजियों को बाहर रखते हैं और ये पूर्ण सेवा बैकअप नहीं हैं। चार चीज़ों को अलग तरह से सुरक्षित किया जाता है:

क्या सुरक्षा
बिना पासवर्ड वाली एक्सपोर्ट फ़ाइलें (डिफ़ॉल्ट) एन्क्रिप्ट नहीं किया गया। हस्ताक्षरित, इसलिए बदलावों का पता लगाया जा सकता है, लेकिन फ़ाइल रखने वाला कोई भी इसे पढ़ सकता है।
पासवर्ड वाली एक्सपोर्ट फ़ाइलें यदि आप पासवर्ड सेट करते हैं, तो तैयार एक्सपोर्ट बिना बदले एक WinZip AES-256 ZIP फ़ाइल में जाता है जिसे 7-Zip और WinRAR खोलते हैं; पासवर्ड संग्रहीत नहीं किया जाता (साक्ष्य प्रबंधन)
जर्नल डेटाबेस और डिस्क पर सहेजी गई संलग्नक TgWitness द्वारा एन्क्रिप्ट नहीं किया गया; एन्क्रिप्टेड डिस्क या वॉल्यूम का उपयोग करें
टेलीग्राम सत्र और हस्ताक्षर कुंजी डेटा निर्देशिका में एन्क्रिप्ट किया गया (credentials.enc, signing.enc, network.enc)

एक पूर्ण सेवा बैकअप ऊपर वर्णित रोकी गई डेटा निर्देशिका है, न कि एक एक्सपोर्ट। दोनों के लिए सुरक्षित भंडारण और एक जानबूझकर किया गया स्थानांतरण तंत्र उपयोग करें। अस्थायी सर्वर एक्सपोर्ट प्रत्येक वर्कस्पेस के temporary-exports/ में रहते हैं; पूर्ण प्रतिक्रियाओं को साफ कर दिया जाता है, और उस वर्कस्पेस के इंस्टेंस लॉक के धारण किए जाने तक अगले स्टार्टअप पर रुकी हुई एक्सपोर्ट फ़ाइलों को हटा दिया जाता है।

कनेक्शन बहाल होने पर मध्यवर्ती परिवर्तनों की पुनर्प्राप्ति की गारंटी नहीं होती। स्थायी मीडिया जॉब्स और टेलीग्राम अपडेट स्थिति रीस्टार्ट के बाद भी बनी रहती हैं; प्रमाण प्रारूप देखें।

क्षमता और प्रतिधारण#

डिफ़ॉल्ट सीमाएँ, सभी पैरामीटर के अंतर्गत परिवर्तनीय हैं: पहले 1,000 डायलॉग, प्रति स्नैपशॉट 500 संदेश, 4 जीबी बिना संपीड़ित हस्ताक्षरित ज़िप सामग्री (बड़े आर्काइव के लिए verify.py --max-gib N की आवश्यकता होती है) और 128 एमबी का ब्राउज़र फॉलबैक। स्रोत → अटैचमेंट्स के अंतर्गत अटैचमेंट्स के प्रत्येक प्रकार के लिए 1–2,000 MiB स्थान लगता है। डाउनलोड CLI का डिफ़ॉल्ट 5 GiB स्थानांतरित करने पर सेट है। उपलब्ध डिस्क एक निचली सीमा हो सकती है। जर्नल, मीडिया, WAL, अस्थायी एक्सपोर्ट और बैकअप के लिए स्थान आरक्षित करें। एक्सपोर्ट्स, कम्पोज़ के 512 MiB /tmp के बजाय डेटा वॉल्यूम का उपयोग करते हैं।

केवल समूहों की गिनती करने के बजाय प्रति-सेकंड घटनाओं, कतार की आयु, मीडिया बाइट्स और डिस्क विलंबता को मापें। सिंथेटिक स्थानीय बेंचमार्क टेलीग्राम डिलीवरी की गारंटी नहीं देते हैं। कोई स्वचालित प्रतिधारण हटाव नहीं है। जर्नल टेल को हटाने से उसके प्रतिधारित चेकपॉइंट्स के साथ उसका संबंध अमान्य हो जाता है।

पहले से ही प्राथमिकता पुनः जाँच मौजूद हैं: स्टार किए गए स्रोतों की डिफ़ॉल्ट रूप से हर 15 मिनट में पुनः जाँच की जाती है, अन्य की हर 6 घंटे में (पुनः जाँच स्तर देखें)। पासवर्ड-सुरक्षित एक्सपोर्ट्स जैसा कि ऊपर वर्णित है, मौजूद हैं। लाइव टेलीग्राम/प्रॉक्सी स्वीकृति, टिकाऊ रीप्ले, एडमिन-लॉग और रिएक्शन पोलिंग, पृथक वर्कर्स, TgWitness द्वारा स्थानीय जर्नल और मीडिया का एन्क्रिप्शन और स्वतंत्र समीक्षा अलग कार्य बने रहते हैं। स्कोप्ड एक्सेस को एक्सेस और परमिशन में प्रलेखित किया गया है। READINESS.md, LIVE_ACCEPTANCE.md और VERIFICATION.md देखें।