مرجع / الإعداد
Telegram · البداية السريعة
جميع طرق تثبيت وتشغيل TgWitness: حزمة Windows، وPython، وDocker، والعرض التوضيحي المركب، مع الفحوصات الأولية.
اللغة الإنجليزية · Русский · الأوكرانية · Español · البرتغالية (البرازيل) · Türkçe · العربية · فارسي · الأردو · الهندية · اللغة الإندونيسية · الفيتنامية · الصينية المبسطة
TgWitness هو تطبيق مستقل لمراقبة مجموعات وقنوات Telegram التي يمكن لحساباتك الوصول إليها. يعمل التطبيق محليًّا باستخدام دليل بيانات خاص به.
هل هذه زيارتك الأولى؟ استكشف العرض التوضيحي قبل ربط حساب. اختر دليلاً للوكلاء أو الشهود أو عمليات التصدير أو إعداد الخادم. تقوم GitHub Actions capture (معاينة) بتشغيل عملية التقاط في فرع GitHub الخاص بك بدلاً من التثبيت المحلي.
التثبيت والبدء#
يتضمن المثبت الموجه لغة Python الخاصة به ويتحقق من تجزئات الحزم وتوقيعات الإصدار قبل التثبيت. يؤدي تشغيله مرة أخرى إلى تحديث التثبيت الحالي.
Linux / macOS:
curl -fsSL https://get.destroy.tools/install.sh | bash
Windows (PowerShell أو موجه الأوامر):
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
على خادم Ubuntu، قم بالتشغيل كجذر لتثبيت خدمة تعمل في الخلفية؛ وعلى سطح المكتب، قم بالتشغيل كمستخدم عادي. في Ubuntu، يعرض المثبت عنوان اللوحة ومفتاح الوصول؛ أما في macOS وWindows، فتفتح اللوحة المحلية في متصفحك. تابع من اتصال Telegram أدناه. تغطي خطوات التثبيت والتحقق والتحديث خيارات الوصول إلى الخادم، وفحص البرنامج النصي قبل تشغيله، والتحديثات، والإزالة.
طرق أخرى#
تعد إصدارات GitHub والمصدر وDocker بدائل للمثبت. تتوفر التنزيلات القابلة للنقل بعد نشر إصدار البناء:
| المضيف | لا يتطلب تثبيت أي برامج | من المصدر: Python 3.11+ | Docker: Engine/Desktop مع Compose 2.20+ |
|---|---|---|---|
| Windows | استخرج TgWitness-<version>-windows-amd64-portable.zip من إصدارات GitHub، وانقر نقرًا مزدوجًا على TgWitness.cmd |
انقر نقرًا مزدوجًا على Start.cmd |
انقر نقرًا مزدوجًا على scripts\Docker.cmd |
| Linux / macOS | — | sh start.sh |
sh scripts/docker-start.sh |
لطرق التشغيل من المصدر، نزّل واستخرج فرع main الحالي أو استنسخ المستودع:
git clone https://github.com/phishdestroy/TgWitness.git
cd TgWitness
يعرض Start.cmd تثبيت Python 3.12 لمستخدم Windows الخاص بك إذا لم يتم العثور على إصدار Python مناسب (عبر winget أو مثبّت python.org الموقّع). ويطبع start.sh أمر التثبيت الدقيق لتوزيعة Linux الخاصة بك أو نظام macOS إذا كان Python مفقودًا. عند التشغيل الأول من المصدر، يتم إنشاء بيئة .venv وتثبيت الاعتماديات تلقائيًا.
يقوم Docker بإنشاء التطبيق وتشغيله في الخلفية؛ ولا حاجة إلى مضيف Python.
تقوم 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. استخدم الرمز المميز (token) الذي طبعه مساعد Docker أو الأمر الثاني في Docker، أو اقرأ ملف data/live/panel-token.txt للتثبيت المحمول أو من المصدر. تابع من «ربط Telegram» أدناه. تستخدم التثبيتات الأصلية وتلك التي تعمل عبر Docker مساحة تخزين منفصلة؛ ولا يؤدي تشغيل Docker إلى استيراد سجل أصلي موجود مسبقًا.
بالنسبة للخادم، يشمل النشر HTTPS التلقائي، وإعادة التشغيل، والصور المنشورة، والتحديثات، والنسخ الاحتياطية.
استكشف الواجهة#
- قم بتشغيل ملف TgWitness-Demo.cmd
الموجود في الحزمة المحمولة، أو ملف scripts\Demo.cmd
الموجود في مجلد المصدر الخاص بنظام Windows
، أو ملف
sh start.sh --demoعلى أنظمة Linux/macOS. يؤدي تشغيل الملف الموجود في مجلد المصدر أولاً إلى إنشاء ملف.venvوتثبيت التبعيات. - افتح الرابط http://127.0.0.1:8787.
- يفتح العرض التوضيحي المحلي دفتر الأدلة النموذجي تلقائيًا. ولا حاجة إلى نسخة رمزية للوصول المباشر محليًّا.
الرسائل التوضيحية خيالية. لا يمكن لوضع العرض التوضيحي الاتصال بحساب Telegram حقيقي.
اتصل بـ Telegram#
[!تحذير] استخدم حسابات مخصصة. يمكن لـ Telegram تقييد أو حظر الحسابات بشكل دائم بسبب أحجام الطلبات التي تعتبرها مفرطة، بغض النظر عن العميل. قم بتوصيل الحسابات المعدة للمراقبة بدلاً من الحسابات الشخصية أو ذات القيمة، وأنشئ معرّف API / هاش على حساب مخصص.
- إذا كان العرض التوضيحي الأصلي قيد التشغيل، فقم بإيقافه وتشغيل Start.cmd أو
sh start.sh. وإلا، فاستمر في تشغيل التثبيت المباشر الذي بدأته أعلاه. - استخدم رمز اللوحة لتسجيل الدخول. تفتح مساحة عمل جديدة عند الإعداد الأولي. اختر التنزيل فقط أو متابعة الدردشات أو الأدلة لحالة معينة.
- راجع فحص الاتصال. قم بتكوين الوكيل الخاص بك إذا لزم الأمر؛ تظل إعدادات الاتصال متاحة بعد الإعداد.
- في Connect Telegram، اختر رقم هاتف، أو رمز QR، أو ملفات الحساب (TData،
.session، StringSession، ملف JSON للحساب) أو مفتاح تفويض كامل. أكمل تأكيد Telegram، والرمز، وكلمة المرور ذات الخطوتين عند الطلب. - تحقق من الحساب المعروض، واختر الدردشات وراجع إعداداتك. أكمل من الشاشة النهائية. بالنسبة لخيار التنزيل فقط، فإن بدء التصدير يبدأ عملية تصدير لمرة واحدة ويفتح التصدير لعرض تقدم العملية؛ ولا يؤدي إلى تمكين المراقبة المستمرة.
بعد الإعداد، يؤدي النقر على المحادثات → اختيار إلى تغيير المحادثات المحددة. تتحكم الإعدادات في عملية التجميع والملفات؛ بينما توفر المزيد من الأدوات → المصادر قائمة مفصلة بالمصادر على المستوى القياسي أو الخبير. يصف دليل اللوحة الأقسام الستة الرئيسية وعناصر التحكم السياقية الخاصة بها.
يُعد معرّف API + التجزئة اختياريين: تستخدم مساحة العمل الزوج المحفوظ أو المستورد،
أو زوجًا فعالًا من المجموعة المدمجة. لاستخدام تطبيقك الخاص، الصق زوجًا واحدًا
من API ID:API Hash في حقل معرّف API. بالنسبة لمفتاح المصادقة، الصق جميع الأحرف الـ512
السداسية العشرية واختر معرّف DC المقدم. يُعد معرّف المستخدم اختياريًا ويتم التحقق منه في حالة إدخاله.
بيانات اعتماد واجهة برمجة التطبيقات (API) تُعرّف تطبيقك؛ وهي لا تمنح صلاحية الدخول إلى الحساب بمفردها. لا تحتاج المجموعات الخاصة إلى اسم مستخدم عام، لكن يجب أن يتمتع حسابك بحق الوصول.
بالنسبة للحسابات الحالية، راجع تنسيقات الحسابات والجلسات: تقبل اللوحة Telethon StringSession، وTelethon/Pyrogram SQLite، وTData ZIP للحساب الفردي، وملفات JSON المدعومة للحسابات. حدد جلسة وملف JSON المرتبط بها معًا، ثم اضغط على التحقق من الملفات، ثم ربط الحساب. كما يتوفر تسجيل الدخول عبر رمز الاستجابة السريعة (QR) مع نفس إعدادات واجهة برمجة التطبيقات (API) الاختيارية. لا يتم دعم TDLib وجلسات الروبوت وقوائم الحسابات بتنسيقات CSV/JSON .
لعدة حسابات، استخدم الحسابات → استيراد الحسابات وحدد ملفات الجلسات المدعومة الخاصة بها. يتم إقران ملفات JSON المرافقة حسب الاسم الأساسي للملف؛ ويحصل كل حساب مستورد على مساحة عمل خاصة به. راجع الاستيراد الجماعي ومجموعات الحسابات.
لإضافة حساب آخر، اضغط على علامة + بجانب أداة اختيار الحساب أو استخدم الحسابات → إضافة حساب. تحتوي مساحات العمل على جلسات منفصلة، وسجلات، ومفاتيح، ومصادر، وقوائم انتظار. يؤدي التبديل بين طرق العرض إلى استمرار تشغيل المجمّعين الآخرين. لا يمكن تخصيص نفس حساب Telegram لمساحتين عمل في هذا التثبيت. لا يوجد عدد محدد لمساحات العمل؛ فهي تشترك في عملية واحدة، لذا تعتمد السعة على الجهاز.
يحمي رمز اللوحة المباشرة الوصول إلى أذونات Telegram الخاصة بك والمواد المحفوظة؛
وهو منفصل عن بيانات اعتماد واجهة برمجة تطبيقات Telegram. ولا يحصل على الدخول التلقائي سوى العرض التوضيحي المحلي الذي تم تشغيله صراحةً،
والذي يتم الوصول إليه مباشرةً. أما العرض التوضيحي عن بُعد أو عبر الوكيل، فيظل يستخدم الرمز
data/demo/panel-token.txt.
المراجعة والتصدير#
- السجل: البحث عن الملاحظات وتصفيتها حسب المصدر ونوع الحدث.
- اختر حدثًا لتفحص سجله الأصلي ومصدره والإصدارات المحفوظة منه.
- تُظهر تفاصيل التحرير المحتوى المتاح قبل التعديل وبعده. تُظهر تفاصيل الحذف آخر محتوى تم تسجيله، إن وجد؛ ويظل الفاعل المجهول مجهولاً.
- تنسيقات التصدير: ملفات ZIP موقعة، وJSONL، وCSV، وHTML قابلة للاستخدام دون اتصال بالإنترنت.
- التصدير الكامل للمحادثة (المحادثات → تصدير المحادثة، أو الصادرات → التقاط أو تصدير
محادثة واحدة): قم بتنزيل السجل المرئي الكامل لمحادثة واحدة
كحزمة موقعة تحتوي على
chat.json(نمط تصدير Telegram) وملف قابل للقراءةchat.html. تعمل المحادثات الخاصة عندما يكون الحساب عضوًا. إنها لقطة حالية، وليست إعادة بناء للرسائل المحذوفة أو التي تم تعديلها سابقًا. تحقق من النسخة باستخدامpython verify.py chat-export.zip --fingerprint TRUSTED_SHA256. - نقطة مراجعة: الحفاظ على حدود السجل الموقّع خارج نطاق أداة التجميع.
- تنزيل إيصال التشغيل الموقّع: الاحتفاظ بسجل البرنامج/الإصدار الخاص بالمجمع.
- إعداد طلب الطابع الزمني: قم بإعداد طلب غير متصل بالإنترنت للحصول على سلطة الطابع الزمني؛ اتبع ملف TIMESTAMP.md للحصول على الرد والتحقق منه.
- التحقق من السجل: تحقق من توقيعات الأحداث وروابط السلسلة. كما يتحقق التصدير بصيغة ZIP من الملفات الوسائطية.
تقوم المتصفحات المدعومة بحفظ الصادرات الكبيرة مباشرةً في ملف مختار. أما المتصفحات الأخرى فتقوم بتخزين ما يصل إلى 128 ميغابايت في ذاكرة التخزين المؤقت. وأثناء تشغيل الخادم، تدعم واجهة سطر الأوامر (CLI) للبث المباشر عمليات التنزيل الأكبر حجمًا دون تخزين الاستجابة بأكملها في ذاكرة التخزين المؤقت:
python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip
لمساحة عمل أخرى، أضف --profile ID باستخدام التصدير → معرف مساحة العمل.
للخادم البعيد، أضف --url https://your-server. الحد الافتراضي للنقل هو
5 جيجابايت؛ ويقوم --max-mib بتغييره. يحتوي محتوى ملف ZIP الموقّع على حد تحقق منفصل يبلغ 4 جيجابايت غير مضغوط
بشكل افتراضي (يتم رفعه من خلال المزيد من الأدوات → المعلمات؛ وتحقق من هذه الأرشيفات باستخدام
verify.py --max-gib N). تحقق من الأرشيف باستخدام نسخة موثوقة من أداة التحقق، و
بصمة مفتاح محفوظة بشكل مستقل، وكحد أدنى من الأدلة، الشهادة الجذرية لسلطة الطابع الزمني
(--tsa-ca).
تحقق من التثبيت#
python start.py --setup-only
python start.py --check
python start.py --check --json
يقوم --check بفحص التبعيات المحلية، ودعم التوقيع، والتخزين، وتكوين المفاتيح، و
عنوان الاستماع. ولا يقوم بتثبيت أي شيء أو الاتصال بـ Telegram. قد يعني
كون المنفذ مشغولًا أن هناك مثيلًا آخر قيد التشغيل. استخدم --port مختلفًا أو أوقفه أولاً.
يتم تثبيت المشغل في .venv. يجب أن تستخدم الأوامر المساعدة python -m tgwitness...
.venv\Scripts\python.exe على نظام Windows أو .venv/bin/python على أنظمة Linux/macOS،
ما لم تكن تلك البيئة قد تم تفعيلها بالفعل.
الجلسات والحماية والتشغيل#
يمكن تحويل ملف Telethon SQLite المغلق والمتسق .session محليًّا باستخدام
python -m tgwitness.sessions account.session --out account.tgwitness-session، ثم
تحميله في المزيد من الأدوات → الحساب → الملفات. يتوفر أيضًا الاستيراد المباشر للملفات وتسجيل الدخول عبر رمز الاستجابة السريعة (QR). راجع
CONNECTION-SECURITY.md للاطلاع على تنسيقات تسجيل الدخول، وSOCKS5،
وHTTP CONNECT، وMTProxy، والمفاتيح الرئيسية الخارجية.
تؤدي «إيقاف المراقبة» إلى إيقاف عملية التجميع. أما «القفل» فيغلق الوصول عبر المتصفح فقط. يؤدي إغلاق علامة التبويب إلى استمرار تشغيل عملية التجميع. أما إيقاف العملية فيؤدي إلى مقاطعة عملية التجميع؛ ولا يمكن لـ«لقطة السجل» إعادة بناء جميع عمليات التعديل أو الحذف التي فاتت. اطلع على كيفية عمل عملية التجميع فيما يتعلق بسياسات الأحداث، وقوائم انتظار المرفقات، وعزل الحسابات، وسلوك إعادة التشغيل.
يتم تشفير الجلسات والأسرار. يتطلب محتوى الرسائل والوسائط وعمليات التصدير قرصًا أو وحدة تخزين مشفرة. تحقق من توقيعات السجل باستخدام مفتاح موثوق واحتفظ بنقاط الفحص بشكل منفصل. راجع سجلات الالتقاط وإيصالات الوقت الخارجية وشهادات البيئة الخاصة بوضع التجميع المحدد.
اقرأ ملف OPERATIONS.md لمعرفة كيفية النسخ الاحتياطي/الاستعادة، وملف DEPLOYMENT.md
لمعرفة كيفية الاستضافة، و deploy/ للاطلاع على أمثلة الخدمة. تتضمن
اللوحة المثبتة أيضًا دليل إعداد في وضع عدم الاتصال على الرابط /guide.html.
يتم تسجيل عملية التحقق الفعلية والقيود المتبقية في ملفَي VERIFICATION.md وREADINESS.md.