حوالہ / سیٹ اپ
Telegram · نفاذ
TgWitness کو Windows، Linux، macOS یا Docker پر ایک سروس کے طور پر HTTPS کے پیچھے، بیک اپ اور اپ ڈیٹس کے ساتھ چلائیں۔
انگریزی · روسی · یوکرینی · اسپینش · پرتگالی (برازیل) · ترکی · عربی · فارسی · اردو · ہندی · انڈونیشیائی زبان · ویتنام زبان · سادہ چینی
انسٹالیشن منتخب کریں#
پورٹیبل پیکیج کے لیے، GitHub Releases سے TgWitness-<version>-windows-amd64-portable.zip نکالیں۔ دوسرے طریقوں کے لیے، ماخذ ZIP ڈاؤن لوڈ اور نکالیں یا ریپوزیٹری کلون کریں، پھر پروجیکٹ ڈائریکٹری سے مندرجہ ذیل کمانڈ چلائیں:
| تنصیب | شروع کریں | کیا یہ پس منظر میں چلتا ہے؟ |
|---|---|---|
| ونڈوز پورٹیبل پیکیج | TgWitness.cmd |
نہیں؛ ونڈو کھلی رکھیں۔ |
| اصلی ونڈوز | Start.cmd |
نہیں؛ پس منظر میں استعمال کے لیے اختیاری لاگ آن ٹاسک استعمال کریں۔ |
| مقامی لینکس/میک او ایس | sh start.sh |
نہیں؛ پسِ منظر میں استعمال کے لیے systemd/launchd استعمال کریں۔ |
| کسی بھی سپورٹڈ ہوسٹ پر ڈوکر | docker compose up -d --build --wait |
جی ہاں، جب Docker ڈیمن چل رہا ہو۔ |
| ونڈوز پر ڈاکر ہیلپر | scripts\Docker.cmd |
جی ہاں؛ مددگار ویب سرور کی صحت کا انتظار کرتا ہے۔ |
| Linux/macOS پر ڈاکر ہیلپر | sh scripts/docker-start.sh |
جی ہاں؛ مددگار ویب سرور کی صحت کا انتظار کرتا ہے۔ |
ایک کلاؤڈ سرور کے لیے جسے تیسری پارٹی چیک کر سکے — فراہم کنندہ کے API کے ذریعے تخلیق شدہ، SSH کے بغیر، صرف Cloudflare Tunnel کے ذریعے قابلِ رسائی — اعلیٰ یقین دہانی والی تعیناتی دیکھیں۔
نیٹیو اسٹارٹ اپ ایک نجی .venv بناتا ہے اور پن کی گئی ڈیپنڈنسیز انسٹال کرتا ہے۔
ڈوکر انہیں ہوسٹ پائتھن کی ضرورت کے بغیر امیج کے اندر بناتا ہے۔ پہلی بار سیٹ اپ کے لیے انٹرنیٹ کنکشن درکار ہے۔ جب کوئی Python 3.11+ نہیں ملتا، تو Start.cmd موجودہ ونڈوز صارف کے لیے Python 3.12 انسٹال کرنے سے پہلے پوچھتا ہے (winget، ورنہ python.org انسٹالر اس کے Python Software Foundation سگنیچر کی جانچ کرنے کے بعد)؛ یہ کبھی بھی ایڈمنسٹریٹر کی اجازت نہیں مانگتا۔ Docker اور OS سروسز پہلے سے ضروری رہتی ہیں۔
نیٹیو اور پورٹیبل انسٹالیشنز اپنے فولڈر کے اندر data/live استعمال کرتی ہیں۔ ڈاکر tgwitness-data نامی والیوم کو /data پر استعمال کرتا ہے۔ یہ الگ الگ انسٹالیشنز ہیں جب تک کہ آپ جان بوجھ کر مکمل ڈیٹا ڈائریکٹری کو منتقل نہ کریں۔ ایک نئے ڈاکر کنٹینر سے توقع نہ کریں کہ وہ نیٹیو اکاؤنٹس کو خودکار طور پر دریافت کر لے گا۔
تنصیب کی ضروریات#
مقامی تنصیب کے لیے Python 3.11 یا اس کے بعد کا ورژن، venv اور ensurepip درکار ہیں، پہلی ڈیپنڈنسی کی تنصیب کے لیے انٹرنیٹ کنکشن، اور
.venv کے لیے لکھنے کے قابل پروجیکٹ ڈائریکٹری۔ بنڈل شدہ پینل کے لیے Node.js یا فرنٹ اینڈ بلڈ کی ضرورت نہیں ہے۔ لانچر کو اپنے معمول کے OS اکاؤنٹ سے چلائیں؛ TgWitness کو ایڈمنسٹریٹر/روٹ حقوق کی ضرورت نہیں ہے۔
- ونڈوز:
Start.cmdپہلےpy -3چیک کرتا ہے، پھرpython، اور بعد ازاں ڈیفالٹ پر-یوزر اور پروگرام فائلز انسٹال فولڈرز، اور اسے ورژن 3.11 یا اس کے بعد کی ضرورت ہے۔ اگر ان میں سے کوئی کام نہ کرے تو یہ اوپر بیان کردہ خودکار پر-یوزر انسٹالیشن پیش کرتا ہے۔py -3 start.pyبھی کام کرتا ہے۔ پورٹیبل پیکج کو بالکل بھی پائتھن کی ضرورت نہیں۔ - Linux:
start.shpython3.13,python3.12,python3.11,python3اورpythonکو آزمائیں، اور جب کوئی موزوں نہ ہو تو apt، dnf، pacman، zypper، apk یا Homebrew کے لیے انسٹال کمانڈ پرنٹ کریں۔ Debian/Ubuntu تنصیبات کے لیے منتخب کردہ انٹرپریٹر سے مطابقت رکھنے والاpython3-venvپیکیج درکار ہو سکتا ہے۔ ڈسٹری بیوشن کے پرانے ڈیفالٹ پائتھن کو پائتھن 3.11+ سے تبدیل یا اس کے ساتھ ضمیمہ کرنا ضروری ہے۔ - macOS: موجودہ Python 3.11+ کی تقسیم انسٹال کریں؛ یہ فرض نہ کریں کہ OS فراہم کردہ انٹرپریٹر اس شرط کو پورا کرتا ہے۔ پروجیکٹ ڈائریکٹری سے
python3 start.pyاستعمال کریں۔ - Docker: Compose v2.20 یا اس سے نئے کے ساتھ Docker Engine/Desktop استعمال کریں۔ Docker Desktop کو Windows پر Linux کنٹینرز استعمال کرنا ضروری ہے۔ کنٹینر اپنی Python ڈیپنڈنسیز انسٹال کرتا ہے؛ ہوسٹ کو الگ Python انسٹالیشن کی ضرورت نہیں۔
مقامی کمپیوٹر#
Start.cmd استعمال کریں ونڈوز پر یا sh start.sh لینکس/macOS پر۔ scripts\Setup.cmd یا sh start.sh --setup-only ماحول تیار کرتا ہے۔ لانچر پہلی بار استعمال پر انحصارات انسٹال کرتا ہے؛ بعد کے لانچ ماحول کو دوبارہ استعمال کرتے ہیں۔ سیٹ اپ اور ٹیلیگرام کلیکشن کے لیے انٹرنیٹ کنکشن ضروری ہے، لیکن موجودہ ریکارڈز براؤز کرنا اور ایکسپورٹس بنانا آف لائن کام کرتا ہے۔
سیٹ اپ کے بعد python start.py --check چلائیں تاکہ مقامی انحصار، Ed25519، اسٹوریج، کلید کی تشکیلات اور سننے کے پتے کا معائنہ کیا جا سکے، بغیر کسی کلیکٹر کو شروع کیے۔
ساختہ آؤٹ پٹ کے لیے --json استعمال کریں۔ مطلوبہ --data-dir، --host اور --port پاس کریں۔ یہ چیک پیکیجز انسٹال نہیں کرتا، جرنل نہیں بناتا یا ٹیلیگرام سے کنیکٹ نہیں کرتا؛ یہ سالمیت یا کوریج کی اہلیت نہیں ہے۔ اسٹارٹ اپ علیحدہ طور پر موجودہ جرنلز کی تصدیق کرتا ہے۔ python start.py --help بھی انسٹالیشن سے گریز کرتا ہے۔
start.py استعمال کرنے کے بعد، Windows پر .venv\Scripts\python.exe یا Linux/macOS پر .venv/bin/python کے ساتھ ضمنی کمانڈز چلائیں، یا پہلے اس ماحول کو فعال کریں۔
نیچے دیے گئے python -m ... کے مثالیں اس بات کا مفروضہ کرتی ہیں کہ ماحول فعال ہے۔
python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787
ماحولیاتی متغیرات: TGWITNESS_DATA, TGWITNESS_HOST, TGWITNESS_PORT, TGWITNESS_TOKEN. TGWITNESS_VAULT_KEY_FILE نئی تنصیب کے لیے بیرونی-کلیدی موڈ کا انتخاب کرتا ہے؛ بیرونی ماسٹر کلید دیکھیں۔ TGWITNESS_TOKEN، اگر فراہم کیا جائے، تو اس میں کم از کم 24 حروف ہونے چاہئیں؛ ایک کرپٹوگرافک طور پر بے ترتیب قدر استعمال کریں۔ اس کے بغیر، ایپ panel-token.txt میں ایک 256-بٹ رینڈم ٹوکن بناتی ہے۔ ماحول کی اووررائیڈ اس فائل کو دوبارہ نہیں لکھتی۔ کریڈنشلز کو تبدیل کرنے کے لیے دوبارہ شروع کریں۔
بالکل ایک ہی عمل ڈیٹا ڈائریکٹری کا مالک ہو سکتا ہے۔ ایک کراس پلیٹ فارم آپریٹنگ سسٹم فائل لاک غیر ارادی متوازی لکھنے والوں کو روکتا ہے۔ ایک Uvicorn ورکر استعمال کریں۔ پینل کسی بھی تعداد میں ورک اسپیسز کا انتظام کر سکتا ہے، اضافی ورک اسپیس ڈائریکٹریز profiles/<id>/ کے تحت۔ الگ سروس انسٹنسز کے لیے، الگ ڈائریکٹریاں اور پورٹس استعمال کریں۔ SQLite WAL فائلیں مقامی مستقل اسٹوریج پر ہونی چاہئیں، نیٹ ورک فائل سسٹم پر نہیں۔ ایک والیوم کو ریپلیکا کے درمیان شیئر نہ کریں۔
ونڈوز پورٹیبل پیکیج#
ہر GitHub ریلیز میں TgWitness-<version>-windows-amd64-portable.zip اور اس کا .sha256 شامل ہوتا ہے۔ اس میں python.org کا سرکاری ایمبیڈ ایبل Python 3.12 رن ٹائم (چیک سم tools/build_portable.py میں پن کی گئی)، TgWitness اور اس کی پن کی گئی ڈیپنڈنسیز، اور تین لانچرز شامل ہیں:
| فائل | مقصد |
|---|---|
TgWitness.cmd |
پینل شروع کریں؛ اضافی اختیارات منتقل کیے جاتے ہیں، مثلاً TgWitness.cmd --port 8790 |
TgWitness-Demo.cmd |
data\demo میں مصنوعی ڈیمو شروع کریں۔ |
TgWitness-Check.cmd |
بغیر شروع کیے تیاری کی جانچ چلائیں |
پِن کی گئی روسی مورفولوجی ڈکشنری اور PDF رنگین پروفائلز آف لائن استعمال کے لیے بنڈل کی گئی ہیں۔ پیکجنگ صرف ان کے معلوم فائل راستوں کو dependency
data ڈائریکٹریز کے اندر اجازت دیتی ہے؛ ان ڈائریکٹریز میں غیر متوقع فائلیں بلڈ کو ناکام کر دیتی ہیں۔
پورے آرکائیو کو کسی لکھنے کے قابل فولڈر میں نکالیں، جیسے Documents\TgWitness؛ اسے ZIP کے اندر یا Program Files سے نہ چلائیں۔ رن ٹائم ایک الگ موڈیول پاتھ استعمال کرتا ہے، لہٰذا دیگر Python تنصیبات اور PYTHONPATH اس پر اثر نہیں ڈالتیں۔ ڈیٹا پیکج کے فولڈر data میں محفوظ رہتا ہے۔ اپ ڈیٹ کرنے کے لیے، TgWitness کو روک دیں، نیا ورژن ایک نئے فولڈر میں نکالیں اور فولڈر data کو منتقل کر دیں۔
Python 3.12 کے ساتھ 64-بٹ ونڈوز پر خود بنائیں:
python tools/build_portable.py
کنٹینر#
docker compose up -d --build --wait
یہ /data کے لیے ایک نامزد مستقل والیوم بناتا ہے۔
ویب پورٹ کو 127.0.0.1:8787 پر میپ کیا گیا ہے۔ یہ عمل UID 10001 کے طور پر چلتا ہے، جس کی صلاحیتیں محدود ہیں، ایک صرف-پڑھنے والا روٹ فائل سسٹم، اور لکھنے کے قابل /data اور /tmp کے ساتھ۔
--wait واپس کرنے سے پہلے ویب سرور کی صحت چیک کرتا ہے؛ ٹیلیگرام کی اجازت اور ترسیل پینل میں ظاہر ہوتی ہیں۔ فراہم کردہ ہیلپرز بلڈنگ کے بعد 180 سیکنڈ کا تیاری کا ٹائم آؤٹ استعمال کرتے ہیں۔ ابتدائی انحصار کی ڈاؤن لوڈنگ میں اس سے زیادہ وقت لگ سکتا ہے۔
دونوں بیس کمپوز فائلیں پروجیکٹ کا نام tgwitness استعمال کرتی ہیں، لہٰذا کسی دوسری ڈائریکٹری میں نیا ریلیز نکالنے سے خاموشی سے نیا ڈیٹا والیوم منتخب نہیں ہوتا۔ اس پروجیکٹ کے لیے صرف ایک تعیناتی فعال رکھیں۔ آزاد تنصیبات کے لیے، ایک منفرد
docker compose -p NAME ... اور مختلف ہوسٹ پورٹ استعمال کریں، اور اپ ڈیٹس کے دوران دونوں کو برقرار رکھیں۔
کسی پرانے ڈپلائمنٹ کے لیے جو مختلف پروجیکٹ نام استعمال کر رہا ہو، اس کے اصل نام کے ساتھ -p کا استعمال جاری رکھیں؛ docker compose ls موجودہ پروجیکٹس کی فہرست دیتا ہے۔
deploy/env.example کی کاپی .env میں کریں اور TGWITNESS_PORT کو مختلف لوپ بیک پورٹ استعمال کرنے کے لیے تبدیل کریں۔ مثال کے طور پر، TGWITNESS_PORT=8788 پینل کو http://127.0.0.1:8788 پر ظاہر کرتا ہے؛ کنٹینر اب بھی 8787 پر سنتا ہے۔ .env کو Git نے نظر انداز کیا ہے۔
ابتدائی ٹوکن حاصل کریں:
docker compose exec tgwitness cat /data/panel-token.txt
مفید کمانڈز:
docker compose ps
docker compose logs --tail 100 -f
docker compose stop
docker compose up -d --wait
restart: unless-stopped کریش یا Docker ڈیمون کے دوبارہ شروع ہونے کے بعد کلیکٹر کو دوبارہ شروع کرتا ہے۔ لینکس سرور پر، اپنے ڈسٹری بیوشن کے سروس مینیجر (عام طور پر sudo systemctl enable --now docker) کا استعمال کرتے ہوئے بوٹ پر Docker کو فعال کریں۔ Windows/macOS پر، Docker Desktop کی 'start-at-sign-in' سیٹنگ کو فعال کریں۔ ڈیسک ٹاپ کے سائن آؤٹ، سلیپ، یا ایک روکے ہوئے
Docker daemon کلیکشن کو روک سکتا ہے۔ ایک واضح طور پر روکا گیا کنٹینر اسی حالت میں رہتا ہے جب تک آپ اسے دوبارہ شروع نہ کریں۔
مثال کے کنفیگریشن میں /tmp والیوم کو 512 MiB تک محدود کیا گیا ہے۔ اس کی بجائے، ایکسپورٹ کنسٹرکشن ہر ورک اسپیس کے مستقل /data پر موجود temporary-exports/ کا استعمال کرتا ہے۔ ایک ساتھ ایکسپورٹس، جرنل/WAL کی ترقی، میڈیا اور بیک اپ کے لیے وہاں جگہ محفوظ کریں۔ لانچر اہل رن ٹائم ڈیپنڈنسی ورژنز کو پن کرنے کے لیے deploy/constraints.txt استعمال کرتا ہے۔
Docker اور ہائی-ایشورنس سرورز deploy/requirements.lock اور deploy/build.lock سے pip --require-hashes کے ساتھ انسٹال ہوتے ہیں: ہر پیکج فائل کو commit میں ریکارڈ شدہ SHA-256 سے میل کھانا چاہیے، اس لیے PyPI یا کسی mirror پر تبدیل کی گئی فائل کو مسترد کر دیا جاتا ہے۔ وہ پیکیجز جو صرف سورس کے ساتھ آتے ہیں (jieba, pyaes) لانچر، ونڈوز پورٹیبل بلڈر اور Dockerfile کے ذریعے deploy/build.lock میں پن کیے گئے setuptools (--no-build-isolation) کے ساتھ بنائے جاتے ہیں، اس لیے pip ایک الگ، غیر پن شدہ بلڈ ماحول کو حل نہیں کرتا۔ Python بیس امیج اور آپریٹنگ سسٹم پیکجز کو اب بھی آزادانہ ریلیز کی اہلیت کی ضرورت ہوتی ہے۔
جب تک آپ جرنل اور کیز کو تباہ کرنے کا ارادہ نہ رکھتے ہوں، docker compose down -v استعمال نہ کریں۔ کنٹینر ہیلتھ رپورٹس ویب سرور کی دستیابی، نہ کہ کامیاب ٹیلیگرام کیپچر۔ پینل کے کلیکٹر کی حالت، ہارٹ بیٹ، غلطیاں، اور کورِیج ایونٹس کا معائنہ کریں۔
آزاد شاہد کا پروفائل#
اختیاری witness سروس ایک آزاد وِٹنس کو اپنے کنٹینر میں چلاتی ہے، اپنی مخصوص کلید اور جرنل کے ساتھ witness-data والیوم میں، اور کلیکٹر کے لیے صرف ریڈ-اونلی وِٹنس ٹوکن فراہم کرتی ہے۔ پینل میں More tools → Extras → Independent witness کے تحت ٹوکن بنائیں، اسے ایک بوٹ ٹوکن اور چینل کے ساتھ .env میں شامل کریں، پھر پروفائل شروع کریں:
docker compose --profile witness up -d # deploy/compose/compose.image.yaml: same flag
docker compose logs witness # witness key fingerprint
یہ سروس Compose نیٹ ورک کے اندر جمع کرنے والے تک http://tgwitness:8787
پر پہنچتی ہے (TGWITNESS_WITNESS_COLLECTOR
اسے اوور رائیڈ کرتا ہے، مثال کے طور پر کسی دوسرے ورک اسپیس کے لیے /profiles/<workspace ID>
)۔ کسی الگ سرور پر چلنے والے ویٹنس کے لیے، جو کسی اور کے زیرِ انتظام ہو، وہاں deploy/compose/compose.witness.yaml
استعمال کریں اور TGWITNESS_WITNESS_COLLECTOR
کو جمع کرنے والے کے HTTPS ایڈریس پر سیٹ کریں؛ اس فائل میں صرف ویٹنس شامل ہوتی ہے۔
شائع شدہ تصویر انسٹال کریں#
deploy/env.example کی کاپی .env میں کریں۔ TGWITNESS_IMAGE کو شائع شدہ ورژن پر سیٹ کریں، چھوٹے حروف کے ریپوزیٹری راستے کا استعمال کرتے ہوئے، مثال کے طور پر:
TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3
TGWITNESS_PORT=8787
compose.yaml کے بجائے اس فائل کو اکیلے چلائیں:
docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait
docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt
ہوسٹ پر کسی سورس بلڈ، پائتھن، یا کمپائلر کی ضرورت نہیں ہے۔ ریلیز ورک فلو لینکس AMD64 اور ARM64 کنٹینرز کو ہدف بناتا ہے، بشمول ڈاکر ڈیسک ٹاپ کے لینکس VM۔
ورک فلو کے خلاصے سے ورژن ٹیگ یا ghcr.io/owner/repository@sha256:... استعمال کریں۔
کوئی latest ٹیگ کی منتقلی یا بغیر نگرانی کے ایپلیکیشن اپ گریڈ ترتیب نہیں دیا گیا ہے۔
جب ان کے پروجیکٹ کے نام مماثل ہوں تو امیج اور ماخذ کے ورژن ایک ہی ڈیٹا والیوم استعمال کرتے ہیں۔
سرور پر خودکار HTTPS#
ایک سرور استعمال کریں جس میں ڈوکر، ایک ایسا ڈومین جو آپ کے کنٹرول میں ہو، اور مستقل مقامی اسٹوریج ہو۔ ڈومین کے A/AAAA ریکارڈز کو سرور کی طرف پوائنٹ کریں؛ AAAA کو صرف اسی صورت میں شائع کریں جب IPv6 اسے حاصل کر لے۔ سرٹیفیکیٹ جاری کرنے کے لیے اندر آنے والی TCP 80 اور 443 اور باہر جانے والی DNS/HTTPS کی اجازت دیں۔ دیگر سروسز پہلے سے ان پورٹس پر موجود نہیں ہونی چاہئیں۔
deploy/env.example کی کاپی کریں اور اسے .env پر رکھیں، اور بغیر اسکیم یا راستے کے ہوسٹ نام سیٹ کریں:
TGWITNESS_DOMAIN=watch.your-domain.org
HTTPS اوورلے کے ساتھ سورس بلڈ شروع کریں:
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt
docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait
شائع شدہ تصویر کے لیے، اس کی بجائے پہلی فائل کے طور پر deploy/compose/compose.image.yaml استعمال کریں۔ دونوں -f آرگومنٹس کو بعد میں اسٹیٹس، لاگز، اپ ڈیٹ، اور اسٹاپ کمانڈز کے لیے برقرار رکھیں۔
کیڈی سرٹیفیکیٹ حاصل کرتا اور اسے تجدید کرتا ہے، HTTP کو HTTPS پر ری ڈائریکٹ کرتا ہے، اور نجی Compose نیٹ ورک پر کلیکٹر کو درخواستیں فارورڈ کرتا ہے۔ سرٹیفیکیٹ کی حالت کا اپنا مستقل والیوم ہوتا ہے۔ کلیکٹر کا براہ راست ہوسٹ پورٹ صرف لوپ بیک کے لیے ہی رہتا ہے۔ فراہم کردہ کیڈی کنفیگریشن میں ایکسس لاگنگ فعال نہیں ہوتی۔
https://watch.your-domain.org کھولیں اور پینل ٹوکن درج کریں۔ تیاری کی ترتیب کنٹینرز کا احاطہ کرتی ہے؛ سرٹیفیکیٹ جاری کرنا اور بیرونی رسائی DNS اور فائر وال پر منحصر ہے۔ اگر HTTPS تیار نہیں ہے، تو DNS، فائر وال کے قواعد، اور کا معائنہ کریں:
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy
دی گئی Caddy امیج اپنے '2-alpine' ٹیگ کی پیروی کرتی ہے۔ پُل کرنے سے وہ امیج ریفریش ہو جاتی ہے؛
اگر آپ کو فکسڈ انفراسٹرکچر ورژنز کی ضرورت ہو تو اپنی ڈیپلائمنٹ میں ایک ٹیسٹ شدہ ڈائجسٹ پن کریں۔
اپ ڈیٹس اور بیک اپس#
اپ ڈیٹس کے دوران Compose پروجیکٹ کا نام اور ڈیٹا والیوم محفوظ رکھیں۔ سب سے پہلے کلیکٹر کو روکیں اور مکمل بیک اپ بنائیں۔ ڈیفالٹ سورس پر مبنی تعیناتی کے لیے:
docker compose stop
docker compose cp tgwitness:/data ../tgwitness-backup-before-update
ہر بار ایک نئی بیک اپ منزل استعمال کریں، جو ریپوزیٹری کے باہر ہو، اور اسے اکاؤنٹ تک رسائی کے قابل مواد کے طور پر محفوظ رکھیں۔ مثال کے راستے کا ذکر صرف وضاحت کے لیے ہے؛ اپنی نجی بیک اپ جگہ استعمال کریں۔ پوری ڈائریکٹری کاپی کریں، بشمول پوشیدہ فائلیں، تمام ورک اسپیسز، کیز، جرنلز، اور میڈیا۔ اگر ترتیب دیا گیا ہو تو بیرونی والٹ ماسٹر کی (vault master key) کا الگ سے بیک اپ لیں۔ ایک ثبوت ZIP قابل بحالی ایپلیکیشن بیک اپ نہیں ہے۔ HTTPS کے لیے، اگر آپ کو اس کے سرٹیفیکیٹ/اکاؤنٹ کی حالت برقرار رکھنے کی ضرورت ہو تو Caddy والیومز کو بھی محفوظ کریں۔
ماخذ تعیناتی کے لیے، نئی ریلیز فائلیں حاصل کریں اور چلائیں:
docker compose up -d --build --wait
ایک امیج ڈیپلائمنٹ کے لیے، TGWITNESS_IMAGE کو مطلوبہ ورژن میں تبدیل کریں، پھر چلائیں:
docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait
پچھلی stop/copy کمانڈز کے لیے اپنی تنصیب کی Compose فائل(یں) بھی استعمال کریں۔
.env، کسٹم کنفیگریشن، اور اسی پروجیکٹ کے نام کو برقرار رکھیں۔ down نامزد والیومز کو برقرار رکھتا ہے؛ down -v انہیں حذف کر دیتا ہے۔ .venv کو آپریٹنگ سسٹمز یا پائتھن ورژنز کے درمیان کاپی نہ کریں۔ نیٹیو اپ ڈیٹس کے لیے، TgWitness کو روک دیں، اس کی مکمل ڈیٹا ڈائریکٹری کا بیک اپ بنائیں، ماخذ فائلوں کو تبدیل کریں، اور لانچ کرنے سے پہلے python start.py --setup-only چلائیں۔
اپ ڈیٹ کے بعد پینل تک رسائی، اکاؤنٹ کی شناخت، مشاہدے کی حالت، اور کوریج چیک کریں۔ دوبارہ شروع کرنے کے بعد TgWitness محفوظ شدہ ٹیلیگرام اپ ڈیٹ پوزیشن کو دوبارہ شروع کرتا ہے اور اپ ڈیٹ کے دوران رہ جانے والی اپ ڈیٹس کی درخواست کرتا ہے۔ اگر مستقبل کا کوئی ورژن اسٹوریج فارمیٹس تبدیل کرتا ہے تو رول بیک کے لیے پری-اپ ڈیٹ بیک اپ درکار ہو سکتا ہے۔
دور دراز سرور#
سروس کو لوپ بیک پر محدود رکھیں اور SSH ٹنل استعمال کریں، یا HTTPS کو ریورس پراکسی پر ختم کریں۔ بنیادی Compose فائل صرف مقامی ہے؛ اختیاری
deploy/compose/compose.https.yaml اوورلے ایک ترتیب شدہ ڈومین کے لیے Caddy فراہم کرتا ہے۔
بیئرر ٹوکن کو URLs اور پروکسی لاگز سے دور رکھیں۔ ایک ریورس پروکسی کو درخواست کے سائز اور کنکشن کی شرحوں کو محدود کرنا چاہیے۔ سادہ HTTP کو انٹرنیٹ پر ظاہر نہ کریں۔
systemd، ایک Windows logon ٹاسک، ایک macOS یوزر ایجنٹ اور Caddy کے لیے مثالیں deploy/ میں فراہم کی گئی ہیں۔ انسٹالیشن سے پہلے ان کے راستوں کا جائزہ لیں/انہیں ڈھالیں۔ یہ فراہم کردہ ٹیمپلیٹس ہیں، نہ کہ مقامی طور پر چلائی جانے والی پلیٹ فارم کی اہلیت۔ عام لانچر کے ذریعے کوئی بیک گراؤنڈ سروس یا ٹاسک رجسٹر نہیں ہوتا۔
ونڈوز پر، ایک بغیر ونڈو کے pythonw.exe لانچ، اسٹارٹ اپ/سرور کی تشخیص کو logs/server.log میں ڈیٹا ڈائریکٹری کے تحت محفوظ کرتا ہے (فی فائل 5 MiB، دو روٹیٹڈ بیک اپ)۔ کنسول لانچز کنسول لاگنگ کو برقرار رکھتی ہیں۔ HTTP ایکسس لاگنگ دونوں موڈز میں غیر فعال ہے۔ لاگز کو ڈیٹا ڈائریکٹری کے ساتھ محفوظ کریں اور شیئر کرنے سے پہلے ان کا جائزہ لیں۔
دوبارہ شروع اور وقفے#
آخری درخواست کردہ مشاہداتی حالت برقرار رکھی جاتی ہے۔ اگر مشاہدہ فعال تھا، تو آغاز میں منتخب ذرائع سے دوبارہ کنکشن قائم کرنے اور انہیں دوبارہ شروع کرنے کی کوشش کی جاتی ہے۔ دستی طور پر وقفہ دینے سے یہ ارادہ ختم ہو جاتا ہے۔ ناکام دوبارہ آغاز ریکارڈ کیا جاتا ہے اور پینل میں دکھایا جاتا ہے۔
TgWitness اکاؤنٹ اور ہر چینل کے لیے ٹیلیگرام کی اپ ڈیٹ پوزیشن (pts, qts, seq اور تاریخ) کو ورک اسپیس والٹ میں محفوظ کرتا ہے اور اگلی بار شروع ہونے پر اسے بحال کرتا ہے۔ اس کے بعد کلائنٹ اس دوران کے مس ہوئے اپ ڈیٹس کی درخواست کرتا ہے جب عمل رکا ہوا تھا، اور باقاعدہ دوبارہ چیک مس شدہ پیغامات کو بازیاب کرتا ہے اور ان ریکارڈ شدہ پیغامات کو محفوظ کرتا ہے جو ٹیلیگرام اب واپس نہیں کرتا۔ ڈائیلاگز شروع ہونے پر دوبارہ لوڈ کیے جاتے ہیں۔ ہر بار شروع ہونے پر پچھلا جرنل ہیڈ، آف لائن حد اور وہ اپ ڈیٹ پوزیشن ریکارڈ کی جاتی ہے جہاں سے یہ دوبارہ شروع ہوا۔ مانیٹر ہر 10 سیکنڈ بعد کنیکٹیویٹی چیک کرتا ہے اور ہر منٹ میں ایک ہارٹ بیٹ شامل کرتا ہے (مزید ٹولز → پیرامیٹرز → لائیوس ریکارڈ ہر)۔ کنکشن ٹوٹنے اور خاموش ادوار کو ان کی وجہ کے ساتھ کوریج کے خلا کے طور پر ریکارڈ کیا جاتا ہے۔ ہسٹری کے سنپ شاٹس لائیو ریکارڈز کے ساتھ الگ موجودہ-ہسٹری مشاہدات کے طور پر محفوظ کیے جاتے ہیں۔
میڈیا قطار ہر ورک اسپیس کے SQLite ڈیٹا بیس میں محفوظ ہوتی ہے۔ ایک پیغام اور اس کا کام ایٹمی طور پر محفوظ کیا جاتا ہے۔ منقطع شدہ چلنے والے کام دوبارہ شروع کرنے پر دوبارہ کوشش کے لیے بحال کیے جاتے ہیں۔ ہر ڈاؤن لوڈ میں ایک 120-سیکنڈ کا بنیادی ٹائم آؤٹ پلس وقت at 256 اس کے سائز کے لیے KiB/s، اور ایک 1–2,000 ہر اٹیچمنٹ کی قسم کے لیے MiB حد؛ ٹائم آؤٹ، رفتار اور دوبارہ کوششیں کے تحت ہیں۔ مزید ٹولز → پیرامیٹرز. کلیکٹر ان فائلوں کو چھوڑ دیتا ہے جن کا سائز نامعلوم ہو۔ روکنے سے قطار میں موجود کام برقرار رہتا ہے۔ ری ٹرائی اصل مشاہدہ شدہ فائل ڈسکرپٹر استعمال کرتا ہے، نہ کہ بعد میں ترمیم شدہ پیغام کے تازہ ترین ورژن کو۔ عارضی ناکامیوں میں محدود ری ٹرائیز ہوتے ہیں؛ میڈیا فلڈ ویٹ وقفے ری اسٹارٹ کے بعد بھی برقرار رہتے ہیں۔ میڈیا ریکوری، ٹیلیگرام اپ ڈیٹ ریکوری سے الگ ہے اور غائب شدہ فائلوں کو دوبارہ پیدا نہیں کر سکتی۔
بیک اپ، بحالی، اور گنجائش#
tgwitness backup FOLDER
ڈیٹا ڈائریکٹری کی کاپی کرتا ہے جبکہ پینل چلتا رہتا ہے: پہلے چیک پوائنٹس، پھر SQLite فائلیں آن لائن بیک اپ API کے ذریعے، پھر کیز، میڈیا اور پروفائلز، اس طرح کوئی بھی کاپی شدہ چیک پوائنٹ کاپی شدہ جرنل سے نیا نہیں ہوتا۔ backup-manifest.json
ہر فائل کا SHA-256 اور جرنل ہیڈز کی فہرست دیتا ہے۔ بحال کرنے کے لیے، TgWitness کو روکیں اور پوری ڈیٹا ڈائریکٹری کو اس فولڈر سے تبدیل کریں۔ اگلی شروعات میں ریکارڈ کیا جاتا ہے کہ جرنل کو پرانی کاپی سے بحال کیا گیا تھا۔ یہ ریکارڈ جرنل کا موازنہ
TGWITNESS_STATE_DIR
میں محفوظ ہیڈ سے کرتا ہے، جو ڈیٹا ڈائریکٹری کے باہر ایک فولڈر ہے: tgwitness-state
والیوم میں
Compose، systemd units میں /var/lib/tgwitness-state
، اور ورنہ صارف کے مقامی اسٹیٹ فولڈر میں۔ لکھنے کے قابل اسٹیٹ فولڈر کے بغیر بحالی کا پتہ نہیں چلتا اور لاگ ایک بار ایسا بتاتا ہے۔
بغیر کمانڈ کے، پورے ڈیٹا ڈائریکٹری کی کاپی کرنے سے پہلے عمل کو روک دیں، جس میں vault.key، signing.enc، credentials.enc، SQLite ڈیٹا بیس/WAL فائلیں، میڈیا، ٹوکن، چیک پوائنٹس، اور تمام پروفائلز/سب ڈائریکٹریاں شامل ہیں۔ جب منزل کی سروس بند ہو تو مکمل کاپی کو بحال کریں۔ گمشدہ والٹ کیز یا سائننگ-کی کی عدم مطابقت سے آغاز ناکام ہو جاتا ہے؛ زبردستی رسائی کے لیے کیز دوبارہ پیدا نہ کریں۔
خفیہ بیک اپ کو انکرپٹڈ اور رسائی کے کنٹرول کے ساتھ محفوظ رکھیں۔ ثبوت کے زپ قابلِ حمل ہوتے ہیں، یہ ایپلیکیشن بیک اپ یا ٹیلیگرام سیشن بیک اپ نہیں ہیں۔ خودکار طور پر برقرار رکھنے یا حذف کرنے کی کوئی سہولت نہیں ہے۔ تمام پیغامات، خام میٹا ڈیٹا، میڈیا، عارضی ایکسپورٹس، اور بیک اپ کے لیے ڈسک اسپیس کی منصوبہ بندی کریں۔
پورے جرنل کو لوڈ کرنے کے بجائے اسٹارٹ اپ کی تصدیق اور ایکسپورٹ اسٹریم ریکارڈز۔
ایک ایکسپورٹ ریڈ سنپ شاٹ کو پن کرتا ہے جبکہ نئی WAL لکھائی جاری رہ سکتی ہے؛ طویل چلنے والے ایکسپورٹس
WAL صفحات کو برقرار رکھ سکتے ہیں، لہٰذا ڈسک کی گنجائش اب بھی اہم ہے۔ زیپس (ZIPs) کی حد 4 GB تک ہے تاکہ آزاد تصدیق کنندہ کی ڈیفالٹ حد سے مطابقت ہو؛ مزید ٹولز → پیرامیٹرز → سب سے بڑی سائنڈ زیپ (Largest signed ZIP) کی حد بڑھاتا ہے، اور ایسے آرکائیوز کو verify.py --max-gib N کے ساتھ تصدیق کیا جاتا ہے۔ دیگر فارمیٹس میں ایونٹ کی تعداد کی کوئی حد نہیں ہوتی۔
مدد شدہ براؤزر صارف کے منتخب کردہ فائل میں جواب کے ٹکڑوں (chunks) کو اسٹریم کرتے ہیں۔ دیگر براؤزر زیادہ سے زیادہ 128 MiB کو بفر کرتے ہیں اور بڑے ٹرانسفرز کو تصدیق شدہ CLI کی طرف بھیجتے ہیں:
python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip
کسی دوسرے ورک اسپیس کے لیے Exports → Workspace ID سے --profile ID استعمال کریں،
ریموٹ سرور کے لیے --format zip|jsonl|csv|html، --url https://your-server، یا
5 GiB ٹرانسفر کی حد تبدیل کرنے کے لیے --max-mib استعمال کریں۔ سادہ HTTP صرف
لوپ بیک کے لیے اجازت ہے۔ ٹوکن ہیڈرز میں سفر کرتے ہیں، ری ڈائریکٹس مسترد کر دیے جاتے ہیں، موجودہ فائلیں
اوور رائٹ نہیں ہوتیں، اور نامکمل ڈاؤن لوڈز کو مکمل فائلوں کے طور پر شائع نہیں کیا جاتا۔
اگر TGWITNESS_TOKEN بنائے گئے ٹوکن کو اووررائڈ کرتا ہے، تو ایک علیحدہ محفوظ فائل استعمال کریں جس میں وہ فعال ویلیو موجود ہو: panel-token.txt اووررائیڈ کے ذریعے دوبارہ نہیں لکھا جاتا۔ کمانڈ کا SHA-256 صرف ایک ٹرانسفر چیک سم ہے؛ دستخط شدہ ZIP کی خود سے تصدیق کریں۔
پینل قطار میں لگی/ناکام میڈیا، سب سے پرانی زیرِ التواء میڈیا، خالی ڈسک، ٹیلیگرام کے زیرِ التواء درخواستوں، اور ان ذرائع کو دکھاتا ہے جن کی رسائی کی تصدیق نہیں ہوئی۔ یہ تشخیصی ٹولز ایک مکمل اینڈ ٹو اینڈ ڈیلیوری مانیٹر نہیں ہیں۔ ورک اسپیسز ایک ہی عمل کو شیئر کرتے ہیں؛ ایک شور کرنے والا اکاؤنٹ پھر بھی دوسروں کو متاثر کر سکتا ہے۔ الگ ورکر پراسیسز، ریٹینشن/روٹیشن، پائیدار اپ ڈیٹ ریکوری اور مکمل تعیناتی کی اہلیت برقرار رہتی ہے۔ اسکوپڈ پینل تک رسائی کا دستاویزی بیان رسائی اور اجازتوں میں موجود ہے؛ آزاد چیک پوائنٹس گواہ گائیڈ میں شامل ہیں۔
تفصیلی طریقہ کار: کنکشن/سیکیورٹی اور آپریٹنگ موڈز۔