انسٹال کریں، تصدیق کریں اور اپ ڈیٹ کریں

ٹی جی وٹنس / دستاویزات · شروع کرنا

پروجیکٹ · تیز آغاز · تیناری

اس صفحے پر

• ایک کمانڈ کے ساتھ انسٹال کریں
• جہاں سب کچھ چلتا ہے
• مکمل متن تلاش کی ترتیبات
• کمانڈ لائن تک رسائی
• چلانے سے پہلے تصدیق کریں
• موجودہ تنصیب کو اپ ڈیٹ کریں
• اوبنٹو پر روزمرہ کے احکامات
• TgWitness کو ہٹا دیں۔

ایک کمانڈ کے ساتھ انسٹال کریں#

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

لینکس / میک او ایس (بش):

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

Ubuntu سرور پر، پسِ منظر سروس انسٹال کرنے کے لیے بطور روٹ چلائیں۔ ڈیسک ٹاپ پر، بطور معمول صارف چلائیں۔

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

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

ونڈوز پر کسی منتظم کی ضرورت نہیں۔ ذیلی پاور شیل پراسیس آپ کے ٹرمینل کو نتیجے کے ساتھ کھلا چھوڑ دیتی ہے۔ پائتھن اور انحصار انسٹالیشن میں ہی رہتے ہیں۔

اوبنٹو پر، یہ کمپیوٹر، عارضی HTTPS لنک یا اپنا ڈومین منتخب کریں۔ انسٹالر پینل کا پتہ اور ایکسس کی پرنٹ کرتا ہے۔ عارضی لنک کے لیے، اس HTTPS پتے کو اپنے براؤزر میں کھولیں اور کی درج کریں۔ ریموٹ سرور پر مقامی رسائی کے لیے، اپنے کمپیوٹر سے SSH فارورڈ استعمال کریں (ssh -L 8787:127.0.0.1:8787 user@server) اور کھولیں http://127.0.0.1:8787۔ macOS اور Windows پر، مقامی پینل آپ کے براؤزر میں کھلتا ہے؛ اس کے ٹرمینل کو چلتا رکھیں۔

پینل میں ٹیلیگرام میں سائن ان کریں اور منتخب کریں کہ کیا جمع کرنا ہے۔ صرف انسٹالیشن سے ٹیلیگرام کا مجموعہ شروع نہیں ہوتا۔

جہاں سب کچھ چلتا ہے#

get.destroy.tools یہ ایک Cloudflare Worker جامد ڈاؤن لوڈز فراہم کر رہا ہے ہے۔ اس میں کوئی TgWitness پینل، ٹیلیگرام سیشن یا صارف ثبوت ڈیٹا بیس نہیں ہے۔ یہ کسی پروجیکٹ VPS پر ہدایت نہیں کیا جاتا۔ یہ ایپلیکیشن اُس مشین پر چلتی ہے جہاں آپ کمانڈ چلاتے ہیں۔

سیٹ TGWITNESS_INSTALL_DIR دوسرا فولڈر منتخب کرنے کے لیے۔ انسٹال شدہ ورژنز اور ڈیٹا الگ ہیں۔ انسٹالر آپ کے اکاؤنٹس، پیغامات یا کیز کو ڈاؤن لوڈ سائٹ پر اپ لوڈ نہیں کرتا۔ کلاؤڈ فلیئر ٹنل منتخب کرنے سے پینل ٹریفک کلاؤڈ فلیئر کے ذریعے بھیجی جاتی ہے؛ اپنا ڈومین استعمال کرنے سے یہ آپ کے اپنے سرور کی طرف اشارہ کرتا ہے۔

With TGWITNESS_TRUSTED_PROXIES, the panel accepts a single X-Forwarded-Proto: https from a trusted proxy to set Secure download cookies.

ہر انسٹالیشن میں START-HERE.html اور START-HERE.txt شامل ہوتے ہیں، جن میں مقامی راستے، کمانڈز اور ریپوزیٹری کے لنکس ہوتے ہیں۔ چلائیں tgwitness guide رہنما کھولنے کے لیے۔ ونڈوز پر، استعمال کریں & "$env:LOCALAPPDATA\TgWitness\bin\tgwitness.cmd" guide PowerShell میں استعمال کریں۔

مکمل متن تلاش کی ترتیبات#

مکمل متن تلاش (پریویو) کے لیے کسی سیٹ اپ کی ضرورت نہیں۔ اس کا انڈیکس اپ ڈیٹ کے بعد پسِ منظر میں بن جاتا ہے۔

انتظامیہ کا انتخاب Journal → Filters → Search index میں اس ورک اسپیس کے لیے متغیر کو اوور رائیڈ کرتا ہے۔ کمانڈز اس انسٹالیشن کی ڈیٹا ڈائریکٹری تلاش کرتے ہیں جو انہیں چلاتی ہے؛ دوسری جگہوں پر، شامل کریں --data-dir کے راستے کے ساتھ tgwitness paths. ایک مکمل یوکرینی لغت (GPL-3.0 ڈیٹا) کے لیے، انسٹال کریں pymorphy3-dicts-uk انسٹالیشن کے Python ماحول میں انسٹال کریں۔

کمانڈ لائن تک رسائی#

کمانڈ لائن (پریویو) اسکرپٹس اور ایجنٹس کے لیے آرکائیو پڑھتی ہے۔

چلانے سے پہلے تصدیق کریں#

ایک سطری کمانڈ اپنی ابتدائی اسکرپٹ کے لیے HTTPS پر بھروسہ کرتی ہے۔ یہ اسکرپٹ انسٹالیشن سے پہلے SHA-256 اور ایپلیکیشن اور پابندیوں پر پروجیکٹ کے RSA دستخط کی جانچ کرتی ہے۔ آپ ابتدائی اسکرپٹ کو پہلے ڈاؤن لوڈ کر کے اس کی تصدیق بھی کر سکتے ہیں۔

عوامی ریلیز کلید release-signing.pub ہے۔ اس کا SHA-256 ہے:

039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d

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

نیچے دیے گئے تصدیقی ڈاؤن لوڈز کے لیے ایک نئی، خالی ڈائریکٹری استعمال کریں۔

Linux / macOS — ایک نئی، خالی ڈاؤن لوڈ ڈائریکٹری میں چلائیں (curl اور OpenSSL درکار ہیں):

curl -fSLO https://get.destroy.tools/install.sh &&
curl -fSLO https://get.destroy.tools/install.sh.sig &&
curl -fSLO https://get.destroy.tools/release-signing.pub &&
test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \
  '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' &&
openssl dgst -sha256 -verify release-signing.pub -signature install.sh.sig install.sh &&
bash install.sh

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

ونڈوز — چلانے سے پہلے SHA-256 کا معائنہ کریں:

Invoke-WebRequest https://get.destroy.tools/install.ps1 -OutFile install.ps1 -UseBasicParsing
Get-FileHash .\install.ps1 -Algorithm SHA256
Invoke-RestMethod https://get.destroy.tools/SHA256SUMS.txt

ہیش کا موازنہ کے ساتھ کریں install.ps1 لائن کے ساتھ۔ ایک آزادانہ دستخطی جانچ کے لیے، OpenSSL استعمال کریں (مثال کے طور پر، Git Bash سے) اور اوپر دی گئی وہی پبلک-کی فنگر پرنٹ:

curl -fSLO https://get.destroy.tools/install.ps1 &&
curl -fSLO https://get.destroy.tools/install.ps1.sig &&
curl -fSLO https://get.destroy.tools/release-signing.pub &&
test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \
  '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' &&
openssl dgst -sha256 -verify release-signing.pub -signature install.ps1.sig install.ps1 &&
powershell.exe -NoProfile -ExecutionPolicy Bypass -File install.ps1

ونڈوز انسٹالیشن خود .NET کے ساتھ پیکیج سگنیچرز کی تصدیق کرتی ہے اور اسے OpenSSL کی ضرورت نہیں ہوتی۔ یہ Authenticode نہیں بلکہ علیحدہ RSA-3072 / SHA-256 سگنیچرز ہیں۔ مینفیسٹ میں سافٹ ویئر ورژن، عین Git کمٹ، ناقابلِ تبدیلی ریلیز آئی ڈی اور ہر آرٹیفیکٹ کا SHA-256 ریکارڈ کیا جاتا ہے۔ صفحہ متعلقہ ماخذ سے منسلک ہوتا ہے۔ مینفیسٹ اور چیک سم لسٹ میں بھی علیحدہ سگنیچرز ہوتے ہیں (manifest.json.sig اور SHA256SUMS.txt.sig).

موجودہ تنصیب کو اپ ڈیٹ کریں#

ایک نئی اشاعت ڈاؤن لوڈ سائٹ کو اپ ڈیٹ کرتی ہے؛ انسٹال شدہ پروگرامز آپ کے انسٹالر دوبارہ چلانے پر اپ ڈیٹ ہوتے ہیں۔ کوئی خودکار اپڈیٹر یا چلتی ہوئی کلیکشن کا خودکار ری اسٹارٹ موجود نہیں ہے۔ موجودہ انسٹالر چینل پیش نظارہ ہے؛ یہ شائع شدہ، چیک شدہ بلڈز کی پیروی کرتا ہے جو main، جس کا کمٹ آخری نمبر شدہ GitHub ریلیز سے نیا ہو سکتا ہے۔ صفحے کا ورژن سے آتا ہے۔ pyproject.toml؛ اس کا کمٹ اور بلڈ آئی ڈی ایک ہی پیش نظارہ ورژن کے اندر اپ ڈیٹس کو ممتاز کرتا ہے۔

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

پہلے کی طرح ایک ہی انسٹالیشن فولڈر اور OS صارف استعمال کریں۔ مکمل ڈیٹا ڈائریکٹری کا بیک اپ لیں جب کلیکشن رک گیا ہو؛ tgwitness paths اس کی شناخت کرتا ہے۔ ایک دستخط شدہ ایکسپورٹ مکمل انسٹالیشن بیک اپ نہیں ہے۔

اوبنٹو روٹ انسٹالیشن پر /opt/tgwitness:

curl -fsSL https://get.destroy.tools/install.sh | TGWITNESS_INSTALL_DIR=/opt/tgwitness bash -s -- --no-start

کامیاب تنصیب کے بعد:

/opt/tgwitness/bin/tgwitness restart
/opt/tgwitness/bin/tgwitness status
/opt/tgwitness/bin/tgwitness open

Linux/macOS صارف کی تنصیب کے لیے، اس کے اصل TGWITNESS_INSTALL_DIR یا ڈیفالٹ استعمال کریں اور پہلا انسٹالیشن کمانڈ دوبارہ چلائیں۔ اپ ڈیٹ کرنے سے پہلے ایک فرنٹیئم پینل کو بند کریں اور بعد میں اسے دوبارہ شروع کریں۔ ایک کنفیگر کیے گئے لینکس صارف سروس کے لیے، اس کا tgwitness restart کمانڈ چلائیں۔

ونڈوز: چلنے والا پینل بند کریں، ونڈوز انسٹالیشن کمانڈ دوبارہ چلائیں، پھر کھولیں bin\tgwitness.cmd اسی انسٹالیشن میں۔ انسٹالر ڈیٹا، سیشنز، رسائی کی ترتیبات اور دستخطی کلیدیں برقرار رکھتا ہے۔ یہ لانچر کو صرف اس کے بعد تبدیل کرتا ہے جب نیا ماحول اپنی جانچوں میں کامیاب ہو جاتا ہے؛ ناکام انسٹالیشن پچھلے لانچر کو اپنی جگہ برقرار رکھتی ہے۔ اسٹوریج فارمیٹ میں تبدیلیوں کے لیے پری-اپ گریڈ بیک اپ کو محفوظ رکھیں۔

اوبنٹو پر روزمرہ کے کمانڈز#

ساتھی ٹوکنز، سیشنز اور آئی پی پابندیوں کے لیے رسائی دیکھیں، اور GitHub-to-Cloudflare ریلیز ورک فلو کے لیے انسٹالر شائع کرنے کے عمل کو دیکھیں۔

TgWitness کو ہٹا دیں#

کوئی ان انسٹالر موجود نہیں ہے: آپ پینل کو روک کر اس کے فولڈرز حذف کر دیتے ہیں۔ ڈیٹا فولڈر کو حذف کرنے سے جرنلز، سگننگ کیز، ٹیلیگرام سیشنز اور محفوظ شدہ فائلیں ہمیشہ کے لیے ختم ہو جاتی ہیں۔ اس سے پہلے:

1. اپنی ضرورت کے مطابق برآمد کریں (Exports → Download signed ZIP) اور دستخطی کلید کے فنگر پرنٹ اور چیک پوائنٹس کو اس مشین سے باہر محفوظ رکھیں۔ ورک اسپیس کو برقرار رکھنے کے لیے، کلیکشن روک کر پورے ڈیٹا فولڈر کی کاپی کریں۔
2. Extras → Server 24/7 کے تحت آپ کے سرورز یا کے ساتھ بنائے گئے سرورز کو حذف کریں python -m tgwitness.cloud destroy؛ فراہم کنندہ انہیں حذف کیے جانے تک بل کرتا ہے۔
3. ہر اکاؤنٹ کے سیشن کو Telegram میں Settings → Devices کے تحت ختم کریں۔ فائلوں کو حذف کرنے سے Telegram کی جانب سے سیشن لاگ آؤٹ نہیں ہوتا۔

اوبنٹو روٹ انسٹالیشن۔ ڈیٹا فولڈر کو نوٹ کریں، سروس کو روکیں، پھر سروس، فولڈرز اور شارٹ کٹ کو ہٹا دیں:

/opt/tgwitness/bin/tgwitness paths
/opt/tgwitness/bin/tgwitness stop
systemctl list-unit-files 'tgwitness-*'
systemctl disable tgwitness-<ID>
rm /etc/systemd/system/tgwitness-<ID>.service
systemctl daemon-reload
rm -rf /opt/tgwitness /var/lib/tgwitness-<ID> /usr/local/bin/tgwitness

Linux یا macOS صارف کی تنصیب۔ پینل بند کریں۔ ایک ترتیب شدہ Linux صارف سروس کو روکا جاتا ہے systemctl --user disable --now tgwitness-<ID>؛ اس کی یونٹ میں ہے ~/.config/systemd/user/۔ پھر حذف کریں ~/.local/share/tgwitness (یا آپ کا TGWITNESS_INSTALL_DIR) اور ~/.local/bin/tgwitness شارٹ کٹ۔

Windows۔ پینل بند کریں اور حذف کریں %LOCALAPPDATA%\TgWitness (یا آپ کا TGWITNESS_INSTALL_DIR)۔ انسٹالر کوئی سروس، شیڈولڈ ٹاسک یا شارٹ کٹ شامل نہیں کرتا۔