سير العمل والعمليات

للاتصال لأول مرة، استخدم الحسابات وتنسيقات الجلسات. للحصول على شرح حول الإصدارات المحفوظة وسياسات الأحداث والفجوات، راجع كيفية عمل عملية التجميع. يغطي هذا الدليل التشغيل اليومي والاستعادة.

سير عمل المشغل#

الرسم التخطيطي كنص

1. اختر سعة التخزين وحماية المفتاح → افتح اللوحة باستخدام الرمز الخاص بها
2. افتح اللوحة باستخدام الرمز الخاص بها → اختر مساحة عمل
3. اختر مساحة عمل → تكوين المسار المباشر أو عبر الوكيل
4. تكوين المسار المباشر أو عبر الوكيل → أدخل رقم الهاتف أو اختر الملفات / رمز الاستجابة السريعة (QR)
5. أدخل رقم الهاتف أو اختر الملفات / رمز الاستجابة السريعة (QR) → تحقق من هوية الحساب واختر المجموعات التي يمكنك الوصول إليها
6. تحقق من هوية الحساب واختر المجموعات التي يمكنك الوصول إليها → احفظ سياسات الأحداث والمرفقات، ثم ابدأ المراقبة
7. احفظ سياسات الأحداث والمرفقات، ثم ابدأ المراقبة → مراقبة الأخطاء، والوصول، وقوائم الانتظار، والقرص
8. مراقبة الأخطاء، والوصول، وقوائم الانتظار، والقرص → الاحتفاظ بنقاط تفتيش مستقلة
9. الاحتفاظ بنقاط تفتيش مستقلة → تصدير المواد والتحقق منها

تعد التفويض، واتصال الشبكة، والوصول إلى المجموعة، واكتمال التسليم خصائص مختلفة. ولا تعني حالة الاتصال باللون الأخضر أن جميع الأحداث قد تم تسجيلها.

مشاركة العمل دون مشاركة المفتاح الرئيسي#

الوصول المفتوح لمنح المراجع أو المحلل رمزه الخاص. اختر الحسابات والمحادثات التي يمكنهم فتحها، ثم اسمح لهم بالعرض أو التصدير أو تنفيذ الإجراءات التشغيلية. يحتاج المشغل الذي يبدأ/يوقف عملية التجميع إلى وصول كامل إلى مساحة العمل؛ أما المراجع فيمكن أن يقتصر وصوله على محادثة واحدة. وتكون حدود الجلسات، وتاريخ انتهاء الصلاحية، وقواعد عناوين IP منفصلة عن تفويض حساب Telegram. انظر الوصول والأذونات.

استخدم «الجلسات المفتوحة» لإنهاء اتصال ما أو إلغاء حق الوصول لإنهاء جميع جلساته. تجمع وحدة التحكم الخاصة بالمسؤول أنشطة العمليات الحالية عبر مساحات العمل. يؤدي إغلاق الجلسة إلى استمرار عملية التجميع.

أوضاع التشغيل#

يتم فتح الوصول إلى النسخة التجريبية المحلية تلقائيًا دون الحاجة إلى إدخال رمز مصادقة يدويًّا. ويستخدم إمكانية صالحة طوال مدة العملية، وهي صالحة فقط للوصول المباشر عبر حلقة الارتداد (loopback) إلى نسخة تجريبية اصطناعية معزولة؛ ولا يتم الكشف عن رمز المصادقة الخاص باللوحة الرئيسية. أما مساحات العمل الحقيقية والوصول إلى النسخة التجريبية عن بُعد أو عبر وكيل، فتحتفظ بمصادقة الرمز. ولا يمنح الدخول إلى النسخة التجريبية أي تفويض على Telegram.

فئات المراقبة#

في «المصادر» → «إعدادات التسجيل» → «اختيار التغييرات المراد الاحتفاظ بها»، حدد الرسائل الجديدة، والتعديلات، وإشعارات الحذف، وتحديثات ردود الفعل، وأحداث العضوية بشكل مستقل. الإعداد الافتراضي يحتفظ بجميع الفئات. تحافظ خيار «الرسائل والتعديلات والحذف» على السياق الأصلي مع تعطيل تحديثات ردود الفعل/الأعضاء المنفصلة. تستعيد «جميع الأنشطة المرئية» الخمسة جميعًا. تغير الإعدادات المسبقة الشكل؛ اضغط على «حفظ إعدادات المراقبة» للتطبيق.

تنطبق السياسة المحفوظة على جميع المصادر المحددة في مساحة العمل تلك. أما مساحات العمل الأخرى فتحتفظ بإعداداتها الخاصة. يسجل كل تغيير فعلي القيم الموقعة قبل/بعد التغيير؛ كما يتم تضمين السياسة الحالية في إيصالات العملية وسجلات بدء المراقبة. لا يؤدي تعطيل فئة ما إلى حذف الملاحظات السابقة. كما أن إعادة التفعيل لا تستعيد التغييرات الفائتة. لا يوجد تجاوز للفئات لكل مجموعة في هذا الإصدار.

حافظ على تمكين الرسائل الجديدة عندما يكون المحتوى السابق مهمًا: لا يمكن لإشعار الحذف استعادة النص الذي لم يتم التقاطه مطلقًا. يتم الاحتفاظ دائمًا بسجلات العمليات/التغطية وأحداث خدمة المجموعة الأخرى. لقطات السجل الصريحة منفصلة عن اختيار الفئة المباشرة وقد تتضمن رسائل الخدمة. لا تؤدي هذه الإعدادات إلى حجب بيانات التعليقات/الأعضاء المضمنة في كائن Telegram الذي تم تسجيله بخلاف ذلك.

قد تضع لقطة السجل المرفقات في قائمة الانتظار أثناء الإيقاف المؤقت. ابدأ المراقبة لمعالجتها. وجود الملف في قائمة الانتظار لا يعني أنه تم تنزيله. لا يتم استبدال الملف الأصلي غير المتاح بنسخة محدثة؛ بل يتم تسجيل النتائج بشكل منفصل.

يؤدي القفل إلى مسح الوصول عبر المتصفح والحقول السرية، لكنه يترك عملية التجميع قيد التشغيل. كما أن إغلاق علامة التبويب يترك العملية قيد التشغيل. يؤدي إيقاف عملية Python أو الخدمة إلى إيقاف عملية التجميع بغض النظر عن حالة المتصفح.

يؤدي حذف مساحة عمل إضافية إلى إيقاف أداة التجميع الخاصة بها وإزالة بياناتها المحلية. إذا أدى ملف مقفل أو خطأ في نظام الملفات إلى مقاطعة عملية الإزالة، فإن اللوحة تبلغ عن الفشل وتبقي مساحة العمل مدرجة على أنها غير متاحة (DeletionPending). أغلق البرامج التي تحتفظ بملفاتها وأعد محاولة الحذف. إعادة تشغيل TgWitness يترك مساحة العمل تلك متوقفة ولا يعيد إنشاء السجل أو المفاتيح التي تمت إزالتها جزئيًا. يتم تسجيل الحذف الناجح فقط بعد إزالة الدليل؛ وتبقى النسخ التي تم تصديرها أو نسخها احتياطيًا بشكل منفصل خاضعة لسياسة الاحتفاظ الخاصة بها.

الإشعارات#

افتح «المصادر» → «الإشعارات» → «التنبيهات» و«الملخص اليومي». يستخدم TgWitness Apprise لإرسال التنبيهات إلى Matrix وTelegram وDiscord وSlack وntfy والبريد الإلكتروني وغيرها من الخدمات المدعومة. يمكنك إضافة عدة وجهات إلى مساحة عمل واحدة.

1. أدخل عنوان URL واحد لوجهة Apprise في كل سطر. استخدم كتالوج الخدمات وتنسيقات عناوين URL الخاصة بخدمتك.
2. قم بتشغيل «إرسال الإشعارات»، ثم اختر تنبيهات المشكلات، والتغييرات في الدردشات التي تمت مراقبتها، والملخص اليومي. تستخدم ساعة الملخص توقيت الخادم.
3. قم بتشغيل خيار «تضمين مقتطفات قصيرة» إذا كنت تريد تضمين النص المحفوظ من الرسائل المحذوفة والمعدلة في التنبيهات.
4. اضغط على «حفظ الإشعارات»، ثم «إرسال اختبار» للتحقق من التسليم.

بالنسبة للمستقبل الخاص بك، استخدم webhook JSON الخاص بـ Apprise. على سبيل المثال، jsons://notify.example.org/tgwitness يرسل JSON عبر HTTPS إلى تلك نقطة النهاية. هذا مثال خيالي؛ استبدله بوجهتك الخاصة.

تنتمي الوجهات والإعدادات إلى مساحة العمل المحددة. تغطي إشعارات التغيير المصادر التي تتم مراقبتها، بما في ذلك الدردشات المضافة حديثًا. كما يعرض الجرس الموجود في الشريط العلوي قائمة بالمشكلات الأخيرة وتغييرات الدردشة.

في العرض التوضيحي، تظهر عناصر التحكم في الإشعارات ولكن الإرسال معطل. قم بتكوين التسليم في مساحة عمل حقيقية. تستخدم الإشعارات مسار Direct أو SOCKS5 أو HTTP الخاص بمساحة العمل تلك؛ ولا يمكن لـ MTProxy نقلها. تتطلب الوجهات غير HTTP مثل SMTP مسارًا مباشرًا.

تصميم لوحة العرض#

يعرض السجل الملاحظات وعمليات البحث والفلاتر. يؤدي التعديل إلى فتح النسخ المسجلة؛ ويؤدي الحذف إلى فتح المحتوى السابق إن كان متاحًا. تظل المصادر المجهولة واضحة. تتوفر الأرقام الإحصائية ضمن «نظرة عامة»؛ بينما تظل تفاصيل الحصول على البيانات في الدليل المحلي.

افتح رسالة معدّلة لمقارنة نسخها باستخدام الفروق داخل النص أو جنبًا إلى جنب؛ وتعرض البيانات الخام الحقول المحفوظة. تظهر التغييرات في الروابط المخفية وأزرار البوت بشكل منفصل. افتح معاينة المرفقات لفحص الصور أو المقاطع الصوتية أو مقاطع الفيديو المحفوظة؛ ويبقي زر التنزيل النسخة الأصلية المحفوظة متاحة.

يعمل وضع Live على تحديث السجل والمحادثات فور وصول السجلات. أوقفه مؤقتًا أثناء المراجعة، أو استخدم زر الأحداث الجديدة عندما تكون مستعدًا؛ بينما يستمر الجمع في الخلفية. يعثر اختصار Ctrl/Cmd+K على إجراءات اللوحة ويبحث في السجل.

تحتوي «المصادر» على نطاق المراقبة (المحادثات المختارة، أو مجلد Telegram، أو الحساب بأكمله )، والمحادثات المتاحة من جميع الأنواع، والمصادر المختارة ذات النجوم التي تشير إلى الأولوية، وإعدادات المرفقات وإعادة الفحص، ولقطات السجل. يتم اختيار المصادر الخاصة عن طريق الحوار/المعرف دون رابط عام. تصف «حالة الوصول» آخر عملية فحص، وليس الأذونات الدائمة.

صفِّ المصادر، وحدد مربعات الاختيار الخاصة بها، ثم قم بتمكينها أو إيقافها مؤقتًا أو تمييزها كأولوية معًا. في قائمة المحادثات المتاحة، يستخدم خيار إضافة المحدد العناصر التي حددتها؛ بينما يستخدم خيار إضافة جميع النتائج المطابقة عامل تصفية البحث والنوع الحالي.

الدردشات → «الأشخاص» يسرد جميع الأشخاص الذين تم حفظ رسائلهم؛ وعند تفعيل ملفات تعريف الأشخاص في الدردشة، يؤدي النقر إلى فتح ملف تعريف ذلك الشخص مع روابط إلى سجلات السجل.

تقوم «Witness» بإنشاء رموز «شاهد» للقراءة فقط، وتُظهر آخر مرة قام فيها كل «شاهد» بالتحقق، وتوفر الأوامر والخيارات لتشغيل «شاهد» واحد (مستقل).

تحتوي المعلمات على كل الحدود والسرعات الخاصة بمساحة العمل التي لا توجد في صفحة أخرى: عدد المحادثات التي تمت قراءتها، وتكرار إعادة قراءة قائمة الدردشات، وفترات النبض ونقاط الفحص ، ومخزن مؤقت بدء التشغيل، وكيفية توزيع طلبات إعادة الفحص (التأخير الأول، وعدد الدردشات لكل مرور، والتوقف المؤقت بين المحادثات، والرسائل المستردة والمطلوبة مجددًا)، واحتياطي القرص، ومهلات الانتظار و محاولات إعادة التنزيل، وما تبحث عنه ملفات تعريف الأشخاص (بما في ذلك تعبيراتك النمطية الخاصة)، وحجم الإشعارات وتواترها، وحدود اللقطات وملفات ZIP والتنزيل عبر المتصفح، ومهلات الانتظار ومحاولات إعادة التنزيل الخاصة بعميل Telegram. يُظهر كل حقل نطاقه والقيمة الافتراضية؛ ويتم تمييز الحقول التي تم تغييرها ويمكن استعادتها واحدة تلو الأخرى أو جميعها معًا. يتم تسجيل كل تغيير على أنه parameters.changed مع القيم قبل وبعد التغيير، وتسجل سجلات بدء المراقبة القيم السارية. تسري القيم اعتبارًا من أول استخدام لها؛ أما مهلة العميل ومحاولات إعادة التنزيل فتسري اعتبارًا من الاتصال التالي. تظل فترات إعادة الفحص وأنواع المرفقات وأحجامها وفترات الاحتفاظ بالأدلة والنسخ خارج الموقع في صفحاتها الخاصة وتقبل أي قيمة ضمن نطاقها، وليس فقط القيم المحددة مسبقًا.

تُدرج الأيقونة على شكل جرس في الشريط العلوي المشكلات والتغييرات الأخيرة في الدردشات المراقبة؛ ويتم حساب الرسائل غير المقروءة حتى يتم وضع علامة «مقروءة» عليها. يتم تجميع التغييرات حسب الدردشة والساعة («12 محذوفة، 1 معدلة، 0 لم يتم العثور عليها»)، وتبقى المشكلات مثل تسجيل الخروج أو امتلاء القرص في القائمة مهما كانت الدردشات مزدحمة.

يبدأ إنشاء الحساب في حقل رقم الهاتف. يؤدي النقر على «متابعة» مباشرةً إلى إدخال الرمز، ولا يُطلب إدخال بيانات اعتماد واجهة برمجة التطبيقات (API) إلا في حالة عدم وجودها. ويُعد كل من رمز الاستجابة السريعة (QR) واستيراد الملفات علامات تبويب بديلة. ولا يُعاد استخدام بيانات اعتماد واجهة برمجة التطبيقات (API) المحفوظة إلا داخل مساحة العمل الخاصة بها. لا تحتوي شاشة الإدخال على شريط جانبي أو إحصائيات أو فقرات إعداد. تفتح أيقونة «الإعدادات» عناصر التحكم في واجهة برمجة التطبيقات (API) والوكيل والتخزين والحسابات الإضافية. تبدأ عمليات التثبيت الجديدة من هنا؛ أما الحسابات المتصلة التي لا تحتوي على مصادر محددة فتبدأ من «اختيار الدردشات». يتطلب تغيير المسار إيقاف المراقبة مؤقتًا ويؤدي إلى إلغاء عملية تسجيل الدخول غير المكتملة. لا يمكن إعادة ربط سجل موجود بحساب Telegram مختلف دون إشعار.

تقوم عملية التصدير بالتحقق من سلامة السجل وإنتاج ملفات قابلة للنقل. يمكن تمرير معرّف مساحة العمل إلى واجهة سطر الأوامر (CLI) الخاصة بالتنزيل. كل عملية تصدير تثبت بادئة السجل الكاملة؛ أما الأحداث اللاحقة فتدخل في عملية تصدير لاحقة. لا تغير عوامل تصفية البحث نطاق الحزمة. توجد معلومات تفصيلية عن التوقيع والتغطية تحت قسم «التحقق والقيود».

تعرض اللوحة حالة المجمع، والملفات المتوسطة الموضوعة في قائمة الانتظار أو التي فشلت، وأقدم الملفات المتوسطة المعلقة، ومساحة القرص المتوفرة، وعمليات إيقاف الطلبات مؤقتًا، والمصادر التي لم يتم تأكيد الوصول إليها ضمن حالة صحة المجمع. يتم طي هذه التفاصيل مبدئيًا وإخفاؤها في قسم «الحساب». تُظهر بطاقة الإعداد الخطوة التالية: ربط حساب، أو اختيار المصادر، أو بدء المراقبة. قائمة الحسابات هي لقطة لحظة التحميل؛ يتم تحديث مساحة العمل المحددة بشكل دوري. هذه ليست أداة مراقبة SLA متعددة العمليات.

تستخدم واجهة المستخدم موارد محلية وعرضًا نصيًا للمحتوى الأصلي. تم اختبار تخطيطات سطح المكتب وتخطيطات Chromium الضيقة. هذه ليست شهادة كاملة لإمكانية الوصول؛ فالتقييم الخاص بقارئ الشاشة وسهولة الاستخدام البشري لا يزالان عملين منفصلين.

بيئات النشر#

قابلية النقل تعني عدم وجود خدمة سحابية إلزامية أو بناء واجهة مستخدم. لا يزال كل هدف يحتاج إلى تبعيات Python/تشفير متوافقة، وقرص محلي، ووصول إلى الشبكة. انظر ملف DEPLOYMENT.md وقوالب الخدمة.

تتشارك مساحات العمل في وحدة المعالجة المركزية (CPU) والذاكرة وحلقة الأحداث. لعزل العمليات، استخدم مثيلات ومنافذ وأدلة بيانات وتفويضات حسابات منفصلة. لا توجد لوحة تحكم موحدة عبر المثيلات المنفصلة. لا توجه أبدًا عدة عمال إلى قاعدة بيانات واحدة.

عمليات التحقق والتصدير الخاصة بالشركات الناشئة#

قم بتشغيل python start.py --check قبل بدء تشغيل بيئة مُعدة مسبقًا. أضف --json لإجراء فحوصات قابلة للقراءة آليًّا أو مرر القيم المقصودة --data-dir و--host و--port. يقوم الأمر بالتحقق من المتطلبات الأساسية دون الحاجة إلى تسجيل الدخول إلى Telegram أو إنشاء سجل. ولا يقوم بالتحقق من السجل أو إثبات جاهزية التسجيل؛ حيث يتم إجراء التحقق من السجل أثناء بدء تشغيل التطبيق. قد يكون المنفذ المشغول مجرد مثيل موجود بالفعل.

تقوم المتصفحات التي تدعم واجهة برمجة تطبيقات الوصول إلى نظام الملفات (File System Access API) بحفظ عمليات التصدير عبر دفق قابل للكتابة. أما المتصفحات الأخرى فتخزن مؤقتًا 128 ميغابايت كحد أقصى. استخدم واجهة سطر الأوامر (CLI) الخاصة بالدفق لعمليات التصدير الأكبر حجمًا أو للمتصفحات التي لا تدعم دفق الملفات:

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

أضف --profile ID من «Exports» لإنشاء مساحة عمل فرعية. استخدم --url https://server للوصول عن بُعد. يُقبل بروتوكول HTTP العادي فقط للوجهات ذاتية الارتداد. يتم قراءة الرمز المميز من ملف وإرساله في رأس الرسالة، ولا يُطبع أو يُدرج في عنوان URL. يتم رفض عمليات إعادة التوجيه. لا يتم الكتابة فوق الوجهات الموجودة. تقوم عمليات النقل الفاشلة بإزالة ملفها الجزئي المؤقت. يُعد SHA-256 المُبلغ عنه مجموعًا اختباريًّا للنقل؛ تحقق من ملف ZIP الموقّع بشكل منفصل باستخدام بصمة/نقطة تفتيش موثوقة.

النسخ الاحتياطي والاستعادة والانقطاعات#

1. إيقاف المراقبة وإنهاء العملية بشكل نظيف.
2. انسخ دليل البيانات بالكامل: قواعد البيانات، وملفات WAL/SHM إن وجدت، والملفات الوسائطية، و credentials.enc، وsigning.enc، وnetwork.enc، ومفاتيح الخزنة/البيانات الوصفية، والرمز المميز، ونقاط الفحص، وكل دليل profiles/.
3. بالنسبة لوضع المفتاح الخارجي، يجب الحفاظ على المفتاح الرئيسي بشكل منفصل والاحتفاظ بكل مفتاح vault.external.json. لا يمكن استعادة الأسرار القديمة من خلال إنشاء مفتاح جديد.
4. استعادة البيانات أثناء توقف الوجهة؛ تكوين المفتاح الأصلي، وتقييد الوصول، والتحقق من سلامة البيانات قبل الاستئناف.
5. تسجيل فترات التعطل ونتائج التحقق. لا يمكن لمقتطف من السجل أن يثبت عدم حدوث أي عمليات حذف أثناء فترة الانقطاع.

ملفات ZIP الخاصة بالأدلة لا تتضمن الجلسات/المفاتيح الخاصة، وهي ليست نسخًا احتياطية كاملة للخدمة. هناك أربعة عناصر يتم حمايتها بطرق مختلفة:

النسخ الاحتياطي الكامل للخدمة هو دليل البيانات الموقوف الموصوف أعلاه، وليس عملية تصدير. استخدم التخزين المحمي وآلية نقل مدروسة لكليهما. تُخزّن عمليات التصدير المؤقتة من الخادم في مجلد « temporary-exports/» الخاص بكل مساحة عمل؛ ويتم مسح الاستجابات المكتملة، وإزالة ملفات التصدير المتوقفة عند التشغيل التالي أثناء استمرار قفل مثيل مساحة العمل تلك.

لا يضمن استعادة الاتصال استعادة التغييرات التي تمت في الفترة الفاصلة. تستمر مهام الوسائط الدائمة وموضع تحديث Telegram بعد إعادة التشغيل؛ انظر تنسيق الأدلة.

السعة والاحتفاظ بالبيانات#

الحدود الافتراضية، وجميعها قابلة للتعديل ضمن «المعلمات»: أول 1,000 حوار، و500 رسالة لكل لقطة، و4 جيجابايت من محتوى ZIP موقّع غير مضغوط (تحتاج الأرشيفات الأكبر حجمًا إلى verify.py --max-gib N)، و128 ميغابايت كخيار احتياطي للمتصفح. تشغل المرفقات مساحة تتراوح بين 1 و2,000 ميغابايت لكل نوع ضمن «المصادر» → «المرفقات». يبلغ الحد الافتراضي لـ CLI للتنزيل 5 جيجابايت من البيانات المنقولة. قد تكون المساحة المتوفرة على القرص حدًا أدنى. احجز مساحة للسجلات والوسائط وWAL وعمليات التصدير المؤقتة والنسخ الاحتياطية. تستخدم عمليات التصدير حجم البيانات بدلاً من 512 ميغابايت (/tmp) الخاص بـ Compose.

قياس الأحداث في الثانية، وعمر قائمة الانتظار، وبايتات الوسائط، وزمن استجابة القرص بدلاً من حساب المجموعات وحدها. لا تضمن المعايير المحلية الاصطناعية تسليم رسائل Telegram. لا يوجد حذف تلقائي للبيانات المحتفظ بها. تؤدي إزالة الجزء الأخير من السجل إلى إبطال علاقته بنقاط التحقق المحتفظ بها.

توجد عمليات إعادة فحص ذات أولوية بالفعل: يتم إعادة فحص المصادر المُعلَّمة بنجمة كل 15 دقيقة بشكل افتراضي، والمصادر الأخرى كل 6 ساعات (انظر مستويات إعادة الفحص). تتوفر عمليات التصدير المحمية بكلمة مرور كما هو موضح أعلاه. يظل قبول Telegram/البروكسي المباشر، وإعادة التشغيل الدائمة، وسجل الإدارة واستطلاع ردود الفعل، والعاملين المعزولين، وتشفير السجل المحلي والوسائط بواسطة TgWitness نفسها، والمراجعة المستقلة، أعمالًا منفصلة. الوصول المحدد النطاق موثق في قسم الوصول والأذونات. انظر READINESS.md و LIVE_ACCEPTANCE.md و VERIFICATION.md.