حوالہ / جمع کریں
ورک فلو اور آپریشنز
پینل کے روزانہ آپریشن: موڈز، مانیٹرنگ کیٹیگریز، پیرامیٹرز، نوٹیفیکیشنز، ایکسپورٹس، بیک اپ اور گنجائش۔
اپنے پہلے کنکشن کے لیے اکاؤنٹس اور سیشن فارمیٹس استعمال کریں۔ محفوظ شدہ ورژنز، ایونٹ پالیسیاں، اور خلا کی وضاحت کے لیے دیکھیں کہ کلیکشن کیسے کام کرتی ہے۔ یہ گائیڈ روزانہ کے آپریشن اور بازیابی کا احاطہ کرتی ہے۔
آپریٹر کا کام کرنے کا بہاؤ#
ڈایاگرام بطور متن
- اسٹوریج اور کلید کی حفاظت کا انتخاب کریں → اپنے ٹوکن کے ساتھ پینل کھولیں
- اپنے ٹوکن کے ساتھ پینل کھولیں → ایک ورک اسپیس منتخب کریں
- ایک ورک اسپیس منتخب کریں → براہِ راست یا پروکسی راستہ ترتیب دیں
- براہِ راست یا پروکسی راستہ ترتیب دیں → فون نمبر درج کریں یا فائلیں/QR منتخب کریں
- فون نمبر درج کریں یا فائلیں/QR منتخب کریں → اکاؤنٹ کی شناخت چیک کریں اور قابل رسائی گروپس منتخب کریں
- اکاؤنٹ کی شناخت چیک کریں اور قابل رسائی گروپس منتخب کریں → ایونٹ اور منسلکات کی پالیسیاں محفوظ کریں، پھر مشاہدہ شروع کریں
- ایونٹ اور منسلکات کی پالیسیاں محفوظ کریں، پھر مشاہدہ شروع کریں → خطاؤں، رسائی، قطاروں اور ڈسک کی نگرانی کریں
- خطاؤں، رسائی، قطاروں اور ڈسک کی نگرانی کریں → آزادانہ چیک پوائنٹس برقرار رکھیں
- آزادانہ چیک پوائنٹس برقرار رکھیں → مواد کو برآمد اور تصدیق کریں
تصدیق، ٹرانسپورٹ کنیکٹیویٹی، گروپ تک رسائی اور ترسیل کی مکملیت مختلف خصوصیات ہیں۔ سبز کنکشن اسٹیٹس کا مطلب یہ نہیں کہ تمام واقعات ریکارڈ کیے گئے ہیں۔
بنیادی کلید شیئر کیے بغیر کام شیئر کریں#
نظرثانی کرنے والے یا تجزیہ کار کو اپنا ٹوکن دینے کے لیے اوپن ایکسیس۔ وہ اکاؤنٹس اور چیٹس منتخب کریں جو وہ کھول سکتے ہیں، پھر دیکھنے، ایکسپورٹ یا آپریشنل کارروائیوں کی اجازت دیں۔ ایک آپریٹر جسے ڈیٹا اکٹھا کرنا شروع یا بند کرنا ہو، اسے پورے ورک اسپیس تک رسائی کی ضرورت ہوتی ہے؛ ایک جائزہ لینے والا ایک واحد چیٹ تک محدود رہ سکتا ہے۔ سیشن کی حدیں، میعاد ختم ہونے اور آئی پی کے قواعد ٹیلیگرام اکاؤنٹ کی اجازت سے الگ ہیں۔ رسائی اور اجازت نامے دیکھیں۔
کشن ختم کرنے یا رسائی منسوخ کرنے کے لیے اوپن سیشنز استعمال کریں تاکہ اس کے تمام سیشنز ختم ہو جائیں۔ ایڈمنسٹریٹر کنسول مختلف ورک اسپیسز میں موجودہ عمل کی سرگرمیاں یکجا کرتا ہے۔ سیشن کے بند ہونے سے کلیکشن کا عمل جاری رہتا ہے۔
رن ٹائم موڈز#
| موڈ | عمل | رویے |
|---|---|---|
| ڈیمو | scripts\Demo.cmd یا --demo |
مصنوعی ڈیٹا؛ حقیقی اکاؤنٹ کنکشنز غیر فعال |
| مشاہدہ | مشاہدہ شروع کریں | منتخب ذرائع کے لیے فراہم کردہ اپ ڈیٹس ریکارڈ کریں |
| تاریخ کا فوری جائزہ | ماخذ → تاریخ کا خلاصہ | موجودہ 500 پیغامات تک؛ ماضی کی تمام تبدیلیوں کی دوبارہ تشکیل نہیں |
| وقفہ | مشاہدے کو روک دیں | جمعآوری کو روک دیں جبکہ ڈیٹا اور قطار میں موجود جابز کو برقرار رکھیں |
| نظرثانی/سپردگی | ایکسپورٹس | ZIP، JSONL/CSV/HTML، چیک پوائنٹ، عمل کی رسید اور ٹائم اسٹیمپ کی درخواست |
| متعدد اکاؤنٹس | ورک اسپیسز یا اوپر والا '+' بٹن | ایک ہی عمل میں کسی بھی تعداد میں الگ الگ ورک اسپیسز |
مقامی ڈیمو تک رسائی دستی ٹوکن درج کیے بغیر خودکار طور پر کھل جاتی ہے۔ یہ ایک ایسی صلاحیت استعمال کرتا ہے جو صرف الگ تھلگ مصنوعی ڈیمو کے براہِ راست لوپ بیک تک رسائی کے لیے عمل کی مدت کے دوران درست رہتی ہے؛ مرکزی پینل کا ٹوکن ظاہر نہیں کیا جاتا۔ حقیقی ورک اسپیسز اور دور دراز یا پروکسی شدہ ڈیمو تک رسائی میں ٹوکن کی توثیق برقرار رہتی ہے۔ ڈیمو میں داخلے سے ٹیلیگرام کی کوئی اجازت نہیں ملتی۔
نگرانی کی زمروں#

ماخذ → کیپچر سیٹنگز → کون سی تبدیلیاں محفوظ کی جائیں، میں نئے پیغامات، ترامیم، حذف کرنے کے نوٹس، ردعمل کی اپ ڈیٹس اور رکنیت کے واقعات کو الگ الگ منتخب کریں۔ ڈیفالٹ تمام زمروں کو برقرار رکھتا ہے۔ پیغامات، ترامیم اور حذف شدہ اشیاء اصل سیاق و سباق کو برقرار رکھتی ہیں جبکہ الگ ردعمل/رکن کی اپ ڈیٹس کو غیر فعال کر دیتی ہیں۔ تمام دکھائی دینے والی سرگرمیاں پانچوں کو بحال کرتی ہیں۔ پری سیٹ فارم کو تبدیل کرتے ہیں؛ لاگو کرنے کے لیے 'مانیٹرنگ سیٹنگز محفوظ کریں' پر کلک کریں۔
محفوظ شدہ پالیسی اس ورک اسپیس میں منتخب کردہ تمام ذرائع پر لاگو ہوتی ہے۔ دیگر ورک اسپیس اپنی ترتیبات برقرار رکھتے ہیں۔ ہر حقیقی تبدیلی دستخط شدہ قبل/بعد کی قدریں ریکارڈ کرتی ہے؛ موجودہ پالیسی کو عمل کے رسیدوں اور مشاہدے کے آغاز کے ریکارڈز میں بھی شامل کیا جاتا ہے۔ کسی زمرے کو غیر فعال کرنے سے پہلے کے مشاہدات حذف نہیں ہوتے۔ دوبارہ فعال کرنے سے رہ جانے والی تبدیلیاں بازیاب نہیں ہوتیں۔ اس ورژن میں فی گروپ کیٹیگری اوور رائیڈ کی کوئی سہولت نہیں ہے۔
جب پچھلی معلومات اہم ہوں تو نئے پیغامات کو فعال رکھیں: حذف کرنے کا نوٹس اس متن کو بحال نہیں کر سکتا جو کبھی ریکارڈ ہی نہ ہوا ہو۔ آپریشنل/کوریج ریکارڈز اور دیگر گروپ سروس ایونٹس ہمیشہ محفوظ رکھے جاتے ہیں۔ واضح ہسٹری کے سنپ شاٹس لائیو کیٹیگری کے انتخاب سے الگ ہوتے ہیں اور ان میں سروس پیغامات شامل ہو سکتے ہیں۔ یہ سوئچز کسی اور صورت میں حاصل کیے گئے ٹیلیگرام آبجیکٹ میں شامل ردعمل/ممبر کے میٹا ڈیٹا کو حذف نہیں کرتے۔
ایک ہسٹری سنپ شاٹ معطل حالت میں منسلکات کو قطار میں لگا سکتا ہے۔ انہیں پراسیس کرنے کے لیے مشاہدہ شروع کریں۔ قطار میں لگنے کا مطلب ڈاؤن لوڈ ہونا نہیں ہے۔ ایک غیر دستیاب اصل فائل کو نئے ترمیم شدہ ورژن سے تبدیل نہیں کیا جاتا؛ نتائج علیحدہ طور پر ریکارڈ کیے جاتے ہیں۔
لاک براؤزر کی رسائی اور خفیہ فیلڈز کو صاف کر دیتا ہے لیکن کلیکشن کو چلتا رہنے دیتا ہے۔ ٹیب بند کرنے سے بھی عمل چلتا رہتا ہے۔ پائتھن کے عمل یا سروس کو روکنے سے کلیکشن رک جاتی ہے، چاہے براؤزر کی حالت کچھ بھی ہو۔
ایک اضافی ورک اسپیس کو حذف کرنے سے اس کا کلیکٹر رک جاتا ہے اور اس کا مقامی ڈیٹا حذف ہو جاتا ہے۔ اگر کوئی لاک شدہ فائل یا فائل سسٹم کی خرابی ہٹانے کے عمل میں رکاوٹ ڈالے تو پینل اس ناکامی کی اطلاع دیتا ہے اور ورک اسپیس کو غیر دستیاب (DeletionPending) کے طور پر درج رکھتا ہے۔ اس کی فائلز پر قابض پروگرام بند کریں اور حذف کرنے کی دوبارہ کوشش کریں۔ TgWitness کو دوبارہ شروع کرنے سے وہ ورک اسپیس بند رہتا ہے اور اس کا جزوی طور پر ہٹایا گیا جرنل یا کیز دوبارہ نہیں بنائے جاتے۔ کامیاب حذف صرف اس وقت ریکارڈ کیا جاتا ہے جب ڈائریکٹری کو ہٹا دیا گیا ہو؛ علیحدہ سے برآمد یا بیک اپ کی گئی کاپیاں اپنی مخصوص برقرار رکھنے کی پالیسی کے تحت رہتی ہیں۔
اطلاعات#
سورسز → نوٹیفیکیشنز → الرٹس اور ایک روزانہ کا خلاصہ۔ TgWitness، Apprise استعمال کرتا ہے تاکہ Matrix، Telegram، Discord، Slack، ntfy، ای میل اور دیگر سپورٹڈ سروسز پر الرٹس بھیج سکے۔ آپ ایک ورک اسپیس میں متعدد منزلوں کو شامل کر سکتے ہیں۔
- ہر لائن میں ایک Apprise منزل URL درج کریں۔ اپنی سروس کے لیے سروس کیٹلاگ اور URL فارمیٹس استعمال کریں۔
- نوٹیفیکیشنز بھیجیں آن کریں، پھر مسئلے کے الرٹس، مشاہدہ شدہ چیٹس میں تبدیلیاں اور روزانہ کا خلاصہ منتخب کریں۔ خلاصے کا وقت سرور کے وقت کا استعمال کرتا ہے۔
- مختصر اقتباسات شامل کریں کو آن کریں اگر آپ نوٹیفیکیشنز میں حذف شدہ اور ترمیم شدہ پیغامات کا محفوظ شدہ متن شامل کرنا چاہتے ہیں۔
- نوٹیفیکیشنز محفوظ کریں پر کلک کریں، پھر ترسیل چیک کرنے کے لیے ٹیسٹ بھیجیں۔
اپنے وصول کنندہ کے لیے، Apprise کے JSON ویب ہُک کا استعمال کریں۔
مثال کے طور پر، jsons://notify.example.org/tgwitness HTTPS کے ذریعے JSON اس اینڈ پوائنٹ پر بھیجتا ہے۔ یہ ایک فرضی مثال ہے؛ اسے اپنی منزل کے ساتھ تبدیل کریں۔
مقصد اور ترتیبات منتخب کردہ ورک اسپیس سے تعلق رکھتے ہیں۔ نوٹیفیکیشنز میں تبدیلی اس کے زیرِ نگرانی ذرائع کا احاطہ کرتی ہے، بشمول نئی شامل کی گئی چیٹس۔ ٹاپ بار میں گھنٹی بھی حالیہ مسائل اور چیٹ میں تبدیلیوں کی فہرست دکھاتی ہے۔
ڈیمو میں، نوٹیفیکیشن کنٹرولز دکھائی دیتے ہیں لیکن بھیجنا غیر فعال ہے۔ ایک حقیقی ورک اسپیس میں ترسیل کو کنفیگر کریں۔ نوٹیفیکیشنز اس ورک اسپیس کے ڈائریکٹ، SOCKS5 یا HTTP راستے کا استعمال کرتی ہیں؛ MTProxy انہیں منتقل نہیں کر سکتا۔ غیر HTTP منزلوں جیسے SMTP کے لیے براہ راست راستے کی ضرورت ہوتی ہے۔
پینل کا لے آؤٹ#

جرنل مشاہدات، تلاش اور فلٹرز دکھاتا ہے۔ ترمیم سے حاصل شدہ ورژنز کھلتے ہیں؛ مٹانے سے اگر دستیاب ہو تو سابقہ مواد کھلتا ہے۔ نامعلوم منسوبہ واضح رہتا ہے۔ شماریات جائزہ (Overview) کے تحت دستیاب ہیں؛ حصول کی تفصیلات مقامی رہنما میں رہتی ہیں۔
کسی ترمیم شدہ پیغام کے ورژنز کا متن کے اندر فرق یا ساتھ ساتھ کے ذریعے موازنہ کرنے کے لیے اسے کھولیں؛ خام ڈیٹا محفوظ کردہ فیلڈز دکھاتا ہے۔ پوشیدہ لنکس اور بوٹ بٹنوں میں ہونے والی تبدیلیاں الگ سے ظاہر ہوتی ہیں۔ محفوظ کردہ تصاویر، آڈیو یا ویڈیو کا معائنہ کرنے کے لیے اٹیچمنٹ پریویو کھولیں؛ ڈاؤن لوڈ بٹن محفوظ شدہ اصل فائل کو دستیاب رکھتا ہے۔
Live ریکارڈز موصول ہوتے ہی جرنل اور چیٹس کو اپ ڈیٹ کرتا ہے۔ جائزہ لیتے وقت اسے موقوف (pause) کر دیں، یا تیار ہونے پر نئے ایونٹس کا بٹن استعمال کریں؛ ڈیٹا اکٹھا کرنے کا عمل چلتا رہتا ہے۔ Ctrl/Cmd+K پینل کے اقدامات تلاش کرتا ہے اور جرنل میں تلاش کرتا ہے۔
ماخذوں میں مشاہدے کا دائرہ شامل ہوتا ہے (منتخب چیٹس، ایک ٹیلیگرام فولڈر یا پورا اکاؤنٹ)، ہر قسم کی قابل رسائی چیٹس، ترجیحی ستاروں کے ساتھ منتخب ماخذ، منسلک اور دوبارہ جانچ کی ترتیبات اور ہسٹری کے اسنیپ شاٹس۔ نجی ماخذ ڈائیلاگ/ID کے ذریعے منتخب کیے جاتے ہیں، عوامی لنک کے بغیر۔ رسائی کی حیثیت تازہ ترین جانچ کو بیان کرتی ہے، مستقل اجازتوں کو نہیں۔
ذرائع کو فلٹر کریں، ان کے چیک باکسز منتخب کریں، پھر انہیں ایک ساتھ فعال کریں، موقوف کریں یا ترجیحی کے طور پر نشان زد کریں۔ دستیاب چیٹس کی فہرست میں، منتخب کردہ شامل کریں آپ کے انتخاب کا استعمال کرتا ہے؛ تمام مماثل نتائج شامل کریں موجودہ تلاش اور قسم کے فلٹر کا استعمال کرتا ہے۔
چیٹس → پیپل میں وہ تمام افراد دکھائے جاتے ہیں جن کے پیغامات محفوظ ہیں؛ اگر چیٹ کے لیے پروفائلز آن ہوں تو ایک کلک سے اس شخص کا پروفائل کھل جاتا ہے جس میں جرنل ریکارڈز کے لنکس ہوتے ہیں۔
ویٹنس ریڈ-اونلی ویٹنس ٹوکنز بناتا ہے، دکھاتا ہے کہ ہر ویٹنس نے آخری بار کب چیک کیا اور ایک (آزاد ویٹنس) چلانے کے لیے کمانڈز اور اختیارات فراہم کرتا ہے۔
پیرامیٹرز ورک اسپیس کی ہر حد اور رفتار کو برقرار رکھتے ہیں جو کسی دوسرے صفحے پر نہیں ہے:
کتنے ڈائیلاگز پڑھے گئے، چیٹ لسٹ کتنی بار دوبارہ پڑھی جاتی ہے، ہارٹ بیٹ اور چیک پوائنٹ وقفے، اسٹارٹ اپ بفر، ری چیکس اپنے درخواستیں کیسے تقسیم کرتے ہیں (پہلی تاخیر، فی
pass، چیٹس کے درمیان وقفہ، بازیافت شدہ اور دوبارہ درخواست کیے گئے پیغامات)، ڈسک ریزرو، ڈاؤن لوڈز کے ٹائم آؤٹس اور دوبارہ کوششیں، لوگ پروفائلز میں کیا تلاش کرتے ہیں (آپ کے اپنے ریگولر ایکسپریشنز سمیت)، نوٹیفیکیشنز کا سائز اور رفتار، سنیپ شاٹ، ZIP اور براؤزر ڈاؤن لوڈ کی حدیں، اور ٹیلیگرام کلائنٹ کے ٹائم آؤٹس اور دوبارہ کوششیں۔ ہر فیلڈ اپنی حد اور ڈیفالٹ دکھاتا ہے؛ تبدیل شدہ فیلڈز کو نشان زد کیا جاتا ہے اور انہیں ایک ایک کر کے یا سب کو ایک ساتھ بحال کیا جا سکتا ہے۔ ہر تبدیلی کو پہلے اور بعد کے اقدار کے ساتھ parameters.changed کے طور پر ریکارڈ کیا جاتا ہے، اور مشاہدے کے آغاز کے ریکارڈز نافذ العمل اقدار کا نام لیتے ہیں۔ ویلیوز ان کے اگلے استعمال سے لاگو ہوتے ہیں؛ کلائنٹ ٹائم آؤٹس اور ری ٹرائیز اگلے کنکشن سے۔ دوبارہ چیک کے وقفے، اٹیچمنٹ کی اقسام اور سائز، شواہد اور آف سائٹ کاپی کے وقفے اپنی الگ صفحات پر رہتے ہیں اور اپنی رینج میں کوئی بھی ویلیو لے سکتے ہیں، صرف پری سیٹس نہیں۔
اوپری بار میں موجود گھنٹی مشاہدہ شدہ چیٹس میں حالیہ مسائل اور تبدیلیوں کی فہرست دکھاتی ہے؛ غیر پڑھی گئی چیٹس کو پڑھا ہوا نشان زد ہونے تک گنا جاتا ہے۔ تبدیلیاں ہر چیٹ اور ہر گھنٹے کے حساب سے گروپ کی جاتی ہیں ("12 حذف شدہ، 1 ترمیم شدہ، 0 نہیں ملے")، اور مسائل جیسے سائن آؤٹ یا ڈسک بھر جانا، چاہے چیٹس کتنی ہی مصروف ہوں، فہرست میں برقرار رہتے ہیں۔
اکاؤنٹ فون نمبر کے فیلڈ سے شروع ہوتا ہے۔ جاری رکھیں براہِ راست کوڈ انٹری کی طرف جاتا ہے، اور API کی تفصیلات صرف ان کی غیر موجودگی میں مانگتا ہے۔ QR اور فائل امپورٹ متبادل ٹیبز ہیں۔ محفوظ شدہ API کی تفصیلات صرف اپنے ورک اسپیس کے اندر دوبارہ استعمال ہوتی ہیں۔ انٹری اسکرین پر کوئی سائیڈ بار، اعداد و شمار، یا سیٹ اپ کے پیراگراف نہیں ہیں۔ سیٹنگز کا آئیکن API، پروکسی، اسٹوریج، اور اضافی اکاؤنٹس کے کنٹرولز کھولتا ہے۔ نئی تنصیبات یہاں سے شروع ہوتی ہیں؛ بغیر منتخب ذرائع کے منسلک اکاؤنٹس 'چٹس کا انتخاب کریں' پر شروع ہوتے ہیں۔ راستہ تبدیل کرنے کے لیے معطل مشاہدے کی ضرورت ہوتی ہے اور یہ نامکمل لاگ ان کو منسوخ کر دیتا ہے۔ ایک موجودہ جرنل کو خاموشی سے کسی دوسرے ٹیلیگرام اکاؤنٹ سے منسلک نہیں کیا جا سکتا۔
ایکسپورٹس جرنل کی سالمیت کی جانچ کرتا ہے اور پورٹیبل فائلیں تیار کرتا ہے۔ اس کا ورک اسپیس آئی ڈی ڈاؤن لوڈ CLI کو بھیجا جا سکتا ہے۔ ہر ایکسپورٹ ایک مکمل جرنل پریفکس کو پن کرتا ہے؛ بعد کے واقعات اگلے ایکسپورٹ میں شامل ہوتے ہیں۔ سرچ فلٹرز پیکیج کے دائرہ کار کو تبدیل نہیں کرتے۔ دستخط اور کوریج کی تفصیلی معلومات Verification & limitations کے تحت ہیں۔
پینل کلیکٹر ہیلتھ کے تحت کلیکٹر کی حالت، قطار میں شامل/ناکام میڈیا، سب سے پرانا زیر التواء میڈیا، خالی ڈسک، درخواست کے وقفے اور ان ذرائع کی رپورٹ کرتا ہے جن کی رسائی غیر تصدیق شدہ ہے۔ یہ تفصیلات ابتدا میں بند ہوتی ہیں اور اکاؤنٹ پر پوشیدہ ہوتی ہیں۔ ایک سیٹ اپ کارڈ اگلا مرحلہ دکھاتا ہے: ایک اکاؤنٹ منسلک کریں، ذرائع منتخب کریں، یا مشاہدہ شروع کریں۔ اکاؤنٹ کی فہرست لوڈ ہونے کے وقت کا ایک لمحاتی منظر ہے؛ منتخب شدہ ورک اسپیس وقتاً فوقتاً تازہ کاری کرتا ہے۔ یہ ایک کثیر عمل SLA مانیٹر نہیں ہے۔
یو آئی مقامی اثاثوں اور متن کی رینڈرنگ کو ماخذ مواد کے لیے استعمال کرتی ہے۔ ڈیسک ٹاپ اور تنگ کرومیم لے آؤٹس آزمائے گئے ہیں۔ یہ مکمل رسائی کی تصدیق نہیں ہے؛ اسکرین ریڈر اور انسانی استعمال کے قابل ہونے کا جائزہ الگ کام ہیں۔
تینخیل کے ماحول#
| ماحول | تنصیب | تصدیقی حیثیت |
|---|---|---|
| ونڈوز پی سی/سرور | Python 3.11+، scripts\Setup.cmd/Start.cmd، نجی ڈیٹا ڈائریکٹری | Windows/Python 3.12 پر مقامی طور پر جانچا گیا |
| لینکس سرور/وی پی ایس | پائتھن وی این وی، وقف شدہ سروس صارف، HTTPS/SSH | کوڈ، CI اور systemd کی مثال فراہم کی گئی؛ اس ہوسٹ پر چلایا نہیں گیا |
| macOS | پائتھن کے مجازی ماحول (venv)، فرنٹ اینڈ عمل یا صارف ایجنٹ | launchd کی مثال فراہم کی گئی؛ الگ انسٹالیشن چیک درکار ہے۔ |
| ڈاکر/کامپوز | مسلسل حجم، ایک ورکر | تعریف اور CI رن ٹائم چیک فراہم کی گئی؛ ڈاکر مقامی طور پر دستیاب نہیں |
| فون براؤزر | چلتی ہوئی سرور پر محفوظ شدہ پینل سے جڑیں | کرومیم کے تنگ لے آؤٹ کا تجربہ کیا گیا؛ کلیکٹر 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 سیشنز/پرائیویٹ کیز کو خارج کرتے ہیں اور مکمل سروس بیک اپ نہیں ہیں۔ چار چیزیں مختلف طریقے سے محفوظ کی جاتی ہیں:
| کیا | حفاظت |
|---|---|
| پاس ورڈ کے بغیر برآمد شدہ فائلیں (ڈیفالٹ) | انکرپٹڈ نہیں۔ دستخط شدہ، تاکہ تبدیلیاں قابلِ شناخت ہوں، لیکن جو بھی فائل رکھتا ہے اسے پڑھ سکتا ہے۔ |
| پاس ورڈ والی برآمد شدہ فائلیں | اگر آپ پاس ورڈ سیٹ کرتے ہیں تو تیار شدہ ایکسپورٹ بغیر کسی تبدیلی کے ایک WinZip AES-256 ZIP فائل میں محفوظ ہوتی ہے جسے 7-Zip اور WinRAR کھول سکتے ہیں؛ پاس ورڈ محفوظ نہیں کیا جاتا (شواہد کے انتظام کے لیے) |
| جرنل کا ڈیٹا بیس اور ڈسک پر محفوظ شدہ منسلکات | TgWitness نے انکرپٹ نہیں کیا؛ انکرپٹ شدہ ڈسک یا والیوم استعمال کریں |
| ٹیلیگرام سیشنز اور دستخطی کلیدیں | ڈیٹا ڈائریکٹری میں خفیہ کردہ (credentials.enc, signing.enc, network.enc) |
مکمل سروس بیک اپ اوپر بیان کردہ روکی گئی ڈیٹا ڈائریکٹری ہے، نہ کہ کوئی ایکسپورٹ۔
دونوں کے لیے محفوظ اسٹوریج اور ایک سوچا سمجھا ٹرانسفر میکنزم استعمال کریں۔ عارضی سرور ایکسپورٹس ہر ورک اسپیس کے
temporary-exports/ میں موجود رہتی ہیں؛ مکمل شدہ جوابات صاف کر دیے جاتے ہیں، اور ادھوری ایکسپورٹ فائلیں اگلی شروعات پر ہٹا دی جاتی ہیں جب تک اس ورک اسپیس کا انسٹنس لاک برقرار رہتا ہے۔
ایک کنکشن بحال ہونے والا واقعہ عبوری تبدیلیوں کی بحالی کی ضمانت نہیں دیتا۔ دائمی میڈیا جابز اور ٹیلیگرام اپ ڈیٹ پوزیشن ری اسٹارٹ کے بعد بھی برقرار رہتی ہیں؛ ثبوت کے فارمیٹ کو دیکھیں۔
گنجائش اور برقرار رکھنا#
ڈیفالٹ حدود، تمام پیرامیٹرز کے تحت تبدیل کیے جا سکتے ہیں: پہلے 1,000 ڈائیلاگز، فی سنپ شاٹ 500 پیغامات، 4 جی بی غیر کمپریسڈ دستخط شدہ ZIP مواد (بڑے آرکائیوز کے لیے
verify.py --max-gib N درکار) اور 128 ایم بی براؤزر فال بیک۔ منسلکات Sources → Attachments کے تحت ہر قسم کے لیے 1,000 سے 2,000 MiB جگہ لیتے ہیں۔ ڈاؤن لوڈ CLI کا ڈیفالٹ 5 GiB منتقل کرنا ہے۔ دستیاب ڈسک کم حد ہو سکتی ہے۔ جرنلز، میڈیا، WAL، عارضی ایکسپورٹس اور بیک اپ کے لیے جگہ محفوظ کریں۔
ایکسپورٹس Compose کے 512 MiB /tmp کے بجائے ڈیٹا والیوم استعمال کرتے ہیں۔
صرف گروپس کی گنتی کرنے کے بجائے واقعات/سیکنڈ، قطار کی عمر، میڈیا بائٹس اور ڈسک کی تاخیر کو ناپیں۔ مصنوعی مقامی بینچ مارکس ٹیلیگرام کی ترسیل کی ضمانت نہیں دیتے۔ خودکار طور پر برقرار رکھنے یا حذف کرنے کی کوئی سہولت نہیں ہے۔ جرنل کے آخر کو ہٹانے سے اس کا برقرار رکھے گئے چیک پوائنٹس کے ساتھ تعلق باطل ہو جاتا ہے۔
ترجیحی دوبارہ چیک پہلے ہی موجود ہیں: اسٹار کیے گئے ذرائع ڈیفالٹ کے طور پر ہر 15 منٹ میں دوبارہ چیک کیے جاتے ہیں، جبکہ دیگر ہر 6 گھنٹے بعد (دوبارہ چیک کی سطحیں دیکھیں)۔ پاس ورڈ سے محفوظ شدہ ایکسپورٹس جیسا کہ اوپر بیان کیا گیا ہے، موجود ہیں۔ لائو ٹیلیگرام/پراکسی کی منظوری، پائیدار ری پلے، ایڈمن لاگ اور ردعمل پولنگ، الگ تھلگ ورکرز، ٹی جی وِٹنس کی جانب سے مقامی جریدے اور میڈیا کی انکرپشن اور آزادانہ جائزہ الگ الگ کام ہیں۔ محدود رسائی کا دستاویزی بیان 'access and permissions' میں موجود ہے۔ READINESS.md، LIVE_ACCEPTANCE.md اور VERIFICATION.md دیکھیں۔