TgWitness / دستاویزات

کیا جانچا گیا ہے ←

حوالہ / سیٹ اپ

Telegram · تیزی سے آغاز

TgWitness کو انسٹال اور لانچ کرنے کے تمام طریقے: ونڈوز پیکیج، پائتھن، ڈاکر اور مصنوعی ڈیمو، ابتدائی جانچ کے ساتھ۔

ٹی جی وٹنس / دستاویزات

شروع کرنا

انگریزی · روسی · یوکرینی · اسپینش · پرتگالی (برازیل) · ترکی · عربی · فارسی · اردو · ہندی · انڈونیشیائی زبان · ویتنام زبان · سادہ چینی

TgWitness ایک خود مختار ایپلیکیشن ہے جو آپ کے اکاؤنٹس تک رسائی والے ٹیلیگرام گروپس اور چینلز کا مشاہدہ کرتی ہے۔ یہ مقامی طور پر اپنی ڈیٹا ڈائریکٹری کے ساتھ چلتی ہے۔

پہلی بار آئے ہیں؟ اکاؤنٹ منسلک کرنے سے پہلے ڈیمو دیکھیں۔ پراکسیز، گواہوں، ایکسپورٹس یا سرور سیٹ اپ کے لیے ایک گائیڈ منتخب کریں۔ GitHub Actions کیپچر (پریویو) ایک مقامی انسٹالیشن کے بجائے آپ کے اپنے GitHub فورک میں ایک کیپچر چلاتا ہے۔

انسٹال کریں اور شروع کریں#

گائیڈڈ انسٹالر میں اپنا Python شامل ہوتا ہے اور یہ انسٹال کرنے سے پہلے پیکج ہیشز اور ریلیز سگنیچرز کی جانچ کرتا ہے۔ اسے دوبارہ چلانے سے موجودہ انسٹالیشن اپ ڈیٹ ہو جاتی ہے۔

لینکس / میک او ایس:

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

ونڈوز (پاور شیل یا کمانڈ پرامپٹ):

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

اوبنٹو سرور پر، بیک گراؤنڈ سروس انسٹال کرنے کے لیے روٹ کے طور پر چلائیں؛ ڈیسک ٹاپ پر، اپنے معمول کے صارف کے طور پر چلائیں۔ اوبنٹو پر انسٹالر پینل کا پتہ اور رسائی کی کلید دکھاتا ہے؛ macOS اور ونڈوز پر مقامی پینل آپ کے براؤزر میں کھلتا ہے۔ نیچے 'ٹیلیگرام سے کنیکٹ کریں' پر جاری رکھیں۔ انسٹال، تصدیق اور اپ ڈیٹ میں سرور تک رسائی کے اختیارات، اسکرپٹ کو چلانے سے پہلے چیک کرنا، اپ ڈیٹس اور ہٹانا شامل ہے۔

دیگر طریقے#

GitHub ریلیزز، سورس اور Docker انسٹالر کے متبادل ہیں۔ پورٹیبل ڈاؤن لوڈز ریلیز بلڈ شائع ہونے کے بعد دستیاب ہوتے ہیں:

میزبان کچھ بھی انسٹال نہیں ماخذ سے: پائتھن 3.11+ Docker: Engine/Desktop Compose 2.20+ کے ساتھ
ونڈوز TgWitness-<version>-windows-amd64-portable.zip کو GitHub Releases سے نکالیں، TgWitness.cmd پر ڈبل کلک کریں۔ Start.cmd پر ڈبل کلک کریں scripts\Docker.cmd پر ڈبل کلک کریں
لینکس / میک او ایس — sh start.sh sh scripts/docker-start.sh

سورس کوڈ کے طریقوں کے لیے، موجودہ main برانچ ڈاؤن لوڈ اور ایکسٹریکٹ کریں یا ریپوزٹری کو کلون کریں:

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 ایپلیکیشن کو بلڈ کرتا ہے اور اسے پسِ منظر میں چلاتا ہے؛ ہوسٹ پائتھن غیر ضروری ہے۔ 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، ری اسٹارٹ، شائع شدہ تصاویر، اپ ڈیٹس، اور بیک اپ شامل ہیں۔

انٹرفیس دریافت کریں#

  1. پورٹیبل پیکیج میں TgWitness-Demo.cmd چلائیں، ونڈوز سورس فولڈر میں scripts\Demo.cmd ، یا لینکس/macOS پر sh start.sh --demo ۔ سورس لانچ پہلے .venv بناتا ہے اور انحصارات انسٹال کرتا ہے۔
  2. http://127.0.0.1:8787 کھولیں۔
  3. مقامی ڈیمو نمونہ جرنل خود بخود کھولتا ہے۔ براہِ راست مقامی رسائی کے لیے ٹوکن کی کاپی کی ضرورت نہیں۔

ڈیمو پیغامات خیالی ہیں۔ ڈیمو موڈ حقیقی ٹیلیگرام اکاؤنٹ سے منسلک نہیں ہو سکتا۔

ٹیلیگرام سے کنیکٹ کریں#

[!انتباہ] مخصوص اکاؤنٹس استعمال کریں۔ ٹیلیگرام درخواستوں کے حجم کو محدود یا مستقل طور پر بلاک کر سکتا ہے جنہیں وہ ضرورت سے زیادہ سمجھتا ہے، چاہے کلائنٹ کوئی بھی ہو۔ ذاتی یا قیمتی اکاؤنٹس کے بجائے مشاہدے کے لیے تیار کردہ اکاؤنٹس استعمال کریں، اور ایک مخصوص اکاؤنٹ پر API ID / ہیش بنائیں۔

  1. اگر مقامی ڈیمو چل رہا ہے تو اسے روک دیں اور Start.cmd یا sh start.sh چلائیں۔ ورنہ اوپر چلتی ہوئی لائیو تنصیب کو چلتا رہنے دیں۔
  2. پینل ٹوکن استعمال کرکے سائن ان کریں۔ ایک نیا ورک اسپیس کھلتا ہے، پہلے سیٹ اپ کریں۔ صرف ڈاؤن لوڈ کریں، چیٹس کی پیروی کریں یا کسی کیس کے لیے شواہد منتخب کریں۔
  3. کنکشن چیک کا جائزہ لیں۔ اگر ضرورت ہو تو اپنا پروکسی ترتیب دیں؛ کنکشن کی ترتیبات سیٹ اپ کے بعد بھی دستیاب رہتی ہیں۔
  4. Connect Telegram میں، ایک فون نمبر، ایک QR کوڈ، اکاؤنٹ فائلیں (TData, .session، StringSession، اکاؤنٹ JSON) یا مکمل اجازت نامہ کلید۔ جب طلب کیا جائے تو ٹیلیگرام کی تصدیق، کوڈ اور دو مرحلوں والا پاس ورڈ مکمل کریں۔
  5. دکھائے گئے اکاؤنٹ کی تصدیق کریں، چیٹس کا انتخاب کریں اور اپنی ترتیبات کا جائزہ لیں۔ آخری اسکرین سے ختم کریں۔ صرف ڈاؤن لوڈ کے لیے، 'ایکسپورٹ شروع کریں' ایک یک بار ایکسپورٹ شروع کرتا ہے اور اپنی پیش رفت دکھانے کے لیے 'ایکسپورٹس' کھولتا ہے؛ یہ مسلسل نگرانی کو فعال نہیں کرتا۔

سیٹ اپ کے بعد، چیٹس → تبدیلیاں منتخب کردہ چیٹس کو تبدیل کرتی ہیں۔ ترتیبات کلیکشن اور فائلوں کو کنٹرول کرتی ہیں؛ مزید ٹولز → ذرائع معیاری یا ماہر سطح پر تفصیلی ماخذ کی فہرست فراہم کرتا ہے۔ پینل گائیڈ چھ اہم حصوں اور ان کے سیاق و سباق کے مطابق کنٹرولز کی وضاحت کرتی ہے۔

API ID + ہیش اختیاری ہے: ورک اسپیس اپنی محفوظ شدہ یا درآمد شدہ جوڑی استعمال کرتا ہے، یا بلٹ ان پول سے ایک فعال جوڑی۔ اپنی ایپ استعمال کرنے کے لیے، ایک API ID:API Hash جوڑی کو API ID میں پیسٹ کریں۔ Auth کلید کے لیے، تمام 512 ہیکساڈیسمل اعداد و شمار پیسٹ کریں اور فراہم کردہ DC ID منتخب کریں۔ صارف شناختی نمبر اختیاری ہے اور درج کرنے پر چیک کیا جاتا ہے۔

API کی اسناد آپ کی ایپلیکیشن کی شناخت کرتی ہیں؛ یہ بذاتِ خود کسی اکاؤنٹ کو مجاز نہیں بناتیں۔ نجی گروپس کو عوامی صارف نام کی ضرورت نہیں ہوتی، لیکن آپ کے اکاؤنٹ کو رسائی حاصل ہونی چاہیے۔

موجودہ اکاؤنٹس کے لیے، اکاؤنٹس اور سیشن فارمیٹس دیکھیں: پینل Telethon StringSession، Telethon/Pyrogram SQLite، سنگل اکاؤنٹ TData ZIP، اور سپورٹڈ اکاؤنٹ JSON قبول کرتا ہے۔ ایک سیشن اور اس کے ساتھ والا JSON ایک ساتھ منتخب کریں، 'فائلز چیک کریں' دبائیں، پھر 'اکاؤنٹ کنیکٹ کریں'۔ QR لاگ ان بھی اسی اختیاری API سیٹنگز کے ساتھ دستیاب ہے۔ TDLib، بوٹ سیشنز اور CSV/JSON اکاؤنٹ انوینٹریز کی حمایت نہیں کی جاتی۔

متعدد اکاؤنٹس کے لیے اکاؤنٹس → اکاؤنٹس درآمد کریں استعمال کریں اور ان کی معاونت یافتہ سیشن فائلیں منتخب کریں۔ ساتھی JSON فائلوں کو بنیادی نام (basename) کے ذریعے جوڑا جاتا ہے؛ ہر درآمد شدہ اکاؤنٹ کو اپنا الگ ورک اسپیس ملتا ہے۔ بلک امپورٹ اور اکاؤنٹ گروپس دیکھیں۔

ایک اور اکاؤنٹ شامل کرنے کے لیے، اکاؤنٹ منتخب کرنے والے کے پاس + دبائیں یا استعمال کریں اکاؤنٹس → اکاؤنٹ شامل کریں۔ ورک اسپیسز کے الگ الگ سیشنز، جرنلز، کیز، سورسز اور قطاریں ہوتی ہیں۔ ویوز تبدیل کرنے سے دوسرے کلیکٹرز چلتے رہتے ہیں۔ اس انسٹالیشن میں ایک ہی ٹیلیگرام اکاؤنٹ دو ورک اسپیسز کو تفویض نہیں کیا جا سکتا۔ ورک اسپیسز کی کوئی مقررہ تعداد نہیں ہے؛ وہ ایک ہی پراسیس شیئر کرتے ہیں، لہٰذا گنجائش مشین پر منحصر ہوتی ہے۔

لائو پینل ٹوکن آپ کی ٹیلیگرام اجازتوں اور محفوظ شدہ مواد تک رسائی کو محفوظ کرتا ہے؛ یہ ٹیلیگرام API کی شناختی معلومات سے الگ ہے۔ صرف ایک واضح طور پر شروع کیا گیا، براہِ راست رسائی والا مقامی ڈیمو خودکار طور پر داخل ہوتا ہے۔ ایک دور دراز/پراکسی شدہ ڈیمو اب بھی 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 کی پیروی کریں۔
  • جرنل کی تصدیق کریں: ایونٹ سگنیچرز اور چین لنکس چیک کریں۔ زپ ایکسپورٹ میڈیا بھی چیک کرتا ہے۔

مدد یافتہ براؤزرز بڑے ایکسپورٹس کو براہِ راست منتخب کردہ فائل میں محفوظ کرتے ہیں۔ دیگر براؤزرز زیادہ سے زیادہ 128 MiB تک بفر کرتے ہیں۔ جب سرور چل رہا ہو، تو اسٹریمنگ CLI پورے جواب کو بفر کیے بغیر بڑے ڈاؤن لوڈز کی حمایت کرتا ہے:

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

کسی اور ورک اسپیس کے لیے، Exports → Workspace ID کا استعمال کرتے ہوئے --profile ID شامل کریں۔ دور دراز سرور کے لیے، --url https://your-server شامل کریں۔ ڈیفالٹ ٹرانسفر حد 5 GiB ہے؛ --max-mib اسے تبدیل کرتا ہے۔ سائن شدہ ZIP مواد کی ڈیفالٹ 4 GiB غیر کمپریسڈ تصدیقی حد ہوتی ہے (مزید ٹولز → پیرامیٹرز اسے بڑھاتا ہے؛ ایسے آرکائیوز کو 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 کے ساتھ تبدیل کیا جا سکتا ہے، پھر اسے مزید ٹولز → اکاؤنٹ → فائلز میں لوڈ کیا جا سکتا ہے۔ براہِ راست فائل امپورٹ اور QR لاگ ان بھی دستیاب ہیں۔ لاگ ان فارمیٹس، SOCKS5، HTTP CONNECT، MTProxy اور بیرونی ماسٹر کیز کے لیے CONNECTION-SECURITY.md دیکھیں۔

وقف کرنے سے مشاہدہ رک جاتا ہے۔ لاک صرف براؤزر کی رسائی کو بند کرتا ہے۔ ٹیب بند کرنے سے کلیکٹر کا عمل چلتا رہتا ہے۔ عمل کو روکنے سے جمع کرنا رک جاتا ہے؛ ہسٹری کا ایک اسنیپ شاٹ تمام رہ جانے والی ترامیم یا حذف شدہ چیزوں کی بحالی نہیں کر سکتا۔ دیکھیں کہ ایونٹ پالیسیاں، منسلکات کی قطاریں، اکاؤنٹ کی علیحدگی، اور دوبارہ شروع کرنے کے رویے کے لیے جمع کیسے کام کرتا ہے۔

سیشنز اور سیکرٹس انکرپٹڈ ہیں۔ پیغام کے مواد، میڈیا اور ایکسپورٹس کے لیے ایک انکرپٹڈ ڈسک یا والیوم درکار ہے۔ جرنل کے سگنیچرز کو ایک قابلِ اعتماد کلید کے خلاف تصدیق کریں اور چیک پوائنٹس کو علیحدہ طور پر محفوظ رکھیں۔ منتخب کردہ کلیکشن موڈ کے لیے کیپچر ریکارڈز، بیرونی ٹائم رسیدیں اور ماحول کی تصدیق ناموں کا جائزہ لیں۔

بیک اپ/ری اسٹور کے لیے OPERATIONS.md، ہوسٹنگ کے لیے DEPLOYMENT.md اور سروس کی مثالوں کے لیے deploy/ پڑھیں۔ انسٹال شدہ پینل میں آف لائن سیٹ اپ گائیڈ بھی شامل ہے: /guide.html۔

حقیقی توثیق اور باقی حدود VERIFICATION.md اور READINESS.md میں درج ہیں۔