مرجع / الإعداد
Telegram · الاتصال، والوكلاء، وحماية البيانات
المصادقة، ومجموعات البروكسي التلقائية، وأنماط عناوين IP، وسياسة الحل البديل، والطلبات الخارجية، والتخزين السري.
TgWitness / التوثيق · النشر والاستعادة
يصف هذا المستند سلوك TgWitness0.9.3 وحدوده. المصادقة، والوصول إلى المصدر، والاتصال بالشبكة، واكتمال الالتقاط هي حالات منفصلة. للحصول على خطوات تسجيل الدخول، وتنسيقات الملفات، والحسابات المتعددة، ابدأ بـ الحسابات وتنسيقات الجلسات. بالنسبة لسياسات الأحداث وسلوك إعادة التشغيل، انظر كيف يعمل التجميع.
إعداد الاتصال الموجه#
في المزيد من الأدوات → الحساب → مسار الاتصال، يمكن للمسؤول اختيار هذا الحساب أو مجموعة حسابات أو جميع الحسابات، ثم تحديد مسار. تعرض قائمة مراجعة الاختيار الحسابات المتأثرة. تختبر خيار التحضير والتحقق المسار المقترح دون تغيير المسار المحفوظ. ويقوم خيار تطبيق الاتصال الذي تم التحقق منه بالتحقق من صحة المعاينة، وإيقاف المراقبة مؤقتًا إذا كان ذلك ضروريًا، وحفظ المسار، واستئناف المراقبة التي كانت قيد التشغيل بالفعل. ولا يبدأ أبدًا عملية التجميع في حساب كان خاملًا سابقًا. تظل عمليات تنزيل السجل موقوفة مؤقتًا ويمكن استئنافها بشكل منفصل. قم بإيقاف عمليات التصدير النشطة مؤقتًا قبل التبديل.
تحتفظ التغييرات الجماعية بالحسابات في مسارها الأصلي بشكل افتراضي. قم بإلغاء تحديد هذا الخيار فقط عندما تعرض المعاينة التغييرات التي تنوي إجراؤها. يقوم التطبيق بالإبلاغ عن نتيجة كل حساب على حدة؛ فهي ليست معاملة شاملة أو معدومة عبر قواعد البيانات. يؤدي التبديل الفاشل إلى استعادة الإعدادات السابقة لذلك الحساب. ويتم إظهار الفشل في الاستئناف بشكل صريح. تنتهي صلاحية المعاينات بعد عشر دقائق، وتتطلب التغييرات في إعدادات الاتصال أو عضوية المجموعة إجراء فحص جديد.
تقوم عملية «Apply» بإعادة استخدام نتيجة الفحص المسبق الناجحة لمدة تصل إلى 90 ثانية شريطة ألا يتغير مسارها، ووضعها، وسياستها. ويجب أن يظل النفق المُدار يعمل بنفس العملية الجارية. أما النتائج الأقدم، وعمليات الأنفاق التي تم تغييرها، ومسارات تجمع MTProxy التلقائية فيتم فحصها مرة أخرى. ويحتفظ سجل التطبيق الموقّع بوقت الفحص الأصلي ويسجل إعادة الاستخدام وعمره. ويقوم كل فحص مسبق بإغلاق عميله المؤقت غير المصادق عليه؛ بينما يتصل المجمع باستخدام جلسته المصرح بها الخاصة.
| الطريق | ما يديره TgWitness |
|---|---|
| مباشر | الاتصالات من المضيف؛ لم يتم الكشف عن شبكة VPN خارجية للمضيف أو فرضها. |
| VPN | ملف تعريف WireGuard بنظام النفق الكامل واحد لكل حساب، يتم تشغيله بواسطة عملية SOCKS5 محلية في مساحة المستخدم. لا يتم تثبيت أي واجهة مضيف أو برنامج تشغيل. |
| الوكيل الخاص بي | بيانات اعتماد SOCKS5 أو HTTP CONNECT أو MTProxy. يمكن إدخال عنوان URL في الحقول SOCKS5/HTTP. يؤدي اختيار عدة حسابات إلى مشاركة هذا الوكيل الذي تم إدخاله. |
| MTProto العام | يقوم المجمع الحالي بتعيين مسارات Telegram. يتم تعطيل الطلبات الخارجية حتى يتم تكوين وكيل مناسب منفصل في الإعدادات المتقدمة. |
| WARP | نفق محلي منفصل لكل حساب محدد، مع تسجيل WARP وملف تعريف WireGuard محفوظ في خزينة ذلك الحساب. |
تستخدم عملية التحقق من المسار الحالي قناة نقل جديدة غير مصدقة في Telegram، وليس
جلسة عمل الحساب. فهي تفتح اتصال نقل عبر المسار المؤدي إلى
مركز بيانات الحساب وتقوم برحلة ذهاب وإياب واحدة عبر بروتوكول MTProto غير مصدقة
(req_pq_multi)؛ ولا ينشئ أي مفتاح ترخيص ولا يستخدم أي حساب. ويمثل
زمن الوصول المبلغ عنه هو زمن الاتصال مضافًا إليه زمن الرحلة ذهابًا وإيابًا، ويقوم الفحص
بتسجيل كلا الجزأين بشكل منفصل. وبالنسبة للمسارات التي تدعم HTTP، فإنه يطلب أيضًا
تتبع HTTPS من Cloudflare عبر ذلك المسار ويعرض عنوان IP الخروج المبلغ عنه،
والبلد، وحالة WARP، ووقت الفحص. يفشل إعداد WARP ما لم يبلغ التتبع
أن WARP نشط. تبلغ عمليات الفحص المسبق هذه عن اتصال المسار و
نقطة الخروج الملحوظة. راجع السجلات الملتقطة من خلال نتائج الاستحواذ والتحقق
في الأرشيف. لا تعتبر العملية المحلية قيد التشغيل وحدها فحص خروج ناجحًا.
يحتفظ اللوحة بمتوسط متحرك لآخر خمس عمليات فحص. يُعتبر المسار بطيئًا عندما
يتجاوز المتوسط 5 ثوانٍ أو عندما تتجاوزه ثلاث عمليات فحص متتالية، ويُعتبر
غير متاح بعد فشل عمليتي فحص متتاليتين؛ network.slow_route و
network.route_recovered تسجل التغييرات. بالنسبة لمسار WARP بطيء، تعمل ميزة إعادة تشغيل WARP
على إعادة تشغيل نفق الحساب عبر نقاط نهاية Cloudflare WARP أخرى، وتحتفظ
بالأسرع وتسجل network.warp_rerolled مع الأوقات قبل وبعد ذلك؛
تقوم ميزة هوية WARP جديدة بتسجيل جهاز WARP جديد ولا تحتفظ به إلا إذا كان
أسرع. يظل عنوان الوكيل المحلي وحساب Telegram وجلسة العمل
كما هي؛ وتُعاد اتصالات Telegram عبر النفق الذي أُعيد تشغيله. يتم إعادة تشغيل مسار WARP
البطيء تلقائيًا مرة واحدة على الأكثر كل 30 دقيقة؛ وعندما لا
يفيد ذلك، تنتظر عمليات إعادة التشغيل الإضافية تدخل المشغل.
WARP وWireGuard القابلان للنقل#
هذا تكامل غير رسمي لـ WARP باستخدام wgcf 2.3.1 و wireproxy 1.1.3 . يقبل المسؤول صراحةً الإعداد قبل التنزيل الأول أو التسجيل في WARP. تؤدي تتجه اتصالات الإعداد هذه مباشرةً إلى GitHub وCloudflare وتكشف عن عنوان IP للجهاز. تحافظ حركة مرور الحساب العادية على مسارها الحالي حتى التطبيق. تختار Cloudflare عنوان الخروج والبلد؛ ويمكن للأنفاق المنفصلة مشاركة عنوان خروج واحد. لا توفر هذه الميزة اختيار البلد، والتناوب الدوري لعناوين IP، ومفتاح إيقاف تشغيل VPN على مستوى المضيف.
تنزيلات المساعدات المدعومة: Linux و macOS x86-64/ARM64، و Windows x86-64.
يتم فحص العناصر مقابل التجزئات SHA-256 المضمنة في المصدر الذي تمت مراجعته،
ويتم فحص الملفات التنفيذية المخزنة مؤقتًا مرة أخرى قبل التشغيل. لا تتم إضافة أي أداة مساعدة إلى
مسار PATH، ولا يتم تثبيتها كخدمة نظام، ولا يتم تزويدها بمستمع عام. توجد جميع الملفات
ضمن دليل portable-routes/ الخاص بمساحة العمل وداخل إدخالات الخزينة المشفرة.
يتطلب مستمع الارتداد SOCKS5 بيانات اعتماد تم إنشاؤها بشكل مستقل.
يتم تشفير الملفات الشخصية الخاصة وبيانات اعتماد حساب WARP باستخدام خزنة مساحة العمل الحالية. أثناء التشغيل، يحتاج المساعد إلى ملف تكوين بنص عادي مخصص للمالك فقط؛ ويتم إزالته عند الإيقاف العادي. قد يؤدي تعطل المضيف إلى ترك هذا الملف في مجلد البيانات المخصص للمالك فقط. وهذا لا يؤدي إلى تشفير القرص أو الحماية من المسؤول. يقوم المشرف بإغلاق النفق إذا اختفى الأنبوب الأصلي للوحة . لا يتيح النفق الفاشل أبدًا اللجوء المباشر إلى خطة بديلة. تؤدي إعادة تشغيل اللوحة إلى استعادة النفق المحدد؛ أما عمليات التشغيل الفاشلة فتُعاد المحاولة مع تأخير محدد. إيقاف النفق يوقف المراقبة مؤقتًا ويحافظ على حالة الإيقاف. بدء النفق يبدأ النفق؛ استأنف المراقبة بشكل منفصل عند الاستعداد.
يجب أن تحتوي ملفات تعريف WireGuard التي تم تحميلها على واجهة واحدة ونظير واحد، ومسارات IPv4 وIPv6 كاملة، وألا تحتوي على أي هوكات أو تضمينات أو استبدالات بيئية أو مستمعين إضافيين. يتم تحليل عناوين النقاط النهائية العامة وتثبيتها قبل بدء التشغيل. استخدم شبكة VPN خارجية أو بوابة SOCKS5 لـ OpenVPN/IPsec والنقاط النهائية الخاصة.
طرق المصادقة#
يُعرّف معرّف واجهة برمجة التطبيقات (API ID) وتجزئة واجهة برمجة التطبيقات (API hash) التطبيق؛ ولا يحلان محل تسجيل الدخول إلى الحساب. وهما اختياريان في TgWitness. ترتيب الأولوية: الزوج الذي يتم إدخاله في النموذج، ثم الزوج من ملف JSON المستورد للحساب، ثم الزوج المحفوظ في مساحة العمل، ثم المجموعة المدمجة المكونة من 50 من الأزواج العامة، التي يتم تجربتها بترتيب عشوائي مع التناوب التلقائي عندما يرفض Telegram أحدها. يتم إرسال زوج Telegram Desktop (2040) فقط مع وصف مطابق لعميل Telegram Desktop. يمكن استخدام الزوج الخاص بك من أدوات تطوير واجهة برمجة التطبيقات (API) على my.telegram.org مع جميع حساباتك؛ ولا يزال لكل حساب تفويضه الخاص.
| الطريقة | المتطلبات | دعم TgWitness |
|---|---|---|
| رقم الهاتف، رمز التحقق، المصادقة الثنائية (2FA) اختيارية | الوصول إلى الحساب؛ زوج واجهة برمجة التطبيقات (API) اختياري | تسجيل الدخول إلى لوحة التحكم |
| مفتاح المصادقة HEX + معرّف DC | مفتاح كامل مكون من 512 حرفًا وDC 1–5 | علامة التبويب «مفتاح المصادقة المباشر»؛ يتم التحقق من معرّف المستخدم الاختياري قبل حفظ المصادقة |
| Telethon StringSession | سلسلة جلسة صالحة | تسجيل الدخول إلى لوحة التحكم |
Telethon SQLite .session |
نص مغلق ومتسق | استيراد مباشر لمخططات اللوحات 7/8؛ واجهة سطر الأوامر (CLI) اختيارية للعمل دون اتصال بالإنترنت |
Pyrogram SQLite .session |
جلسة مستخدم إنتاجية مغلقة | الاستيراد المباشر لمخططات اللوحات 2/3 |
| Telegram Desktop TData ZIP | حساب واحد حديث؛ رمز مرور محلي في حالة الحماية | تحويل داخل الذاكرة مع فحوصات المجموع الاختباري وفك التشفير |
| حساب JSON | الحقول المدعومة لواجهة برمجة التطبيقات (API)/الجلسة/المفتاح | تملأ البيانات الوصفية وحدها بيانات اعتماد واجهة برمجة التطبيقات (API)؛ ولا يزال من الضروري تسجيل الدخول باستخدام جلسة عمل/مفتاح أو رقم هاتف/رمز QR |
| تسجيل الدخول عبر رمز الاستجابة السريعة (QR) | تأكيد من تطبيق Telegram المعتمد | إنشاء رموز QR محليًّا، وتحديد تاريخ انتهاء الصلاحية/إعادة المحاولة، والتوثيق الثنائي (2FA) اختياريًّا |
| TDLib / Pyrogram StringSession | تنسيقات أخرى خاصة بالمكتبات | غير مدعوم |
| رمز البوت | روبوت له نموذج الوصول/التحديث الخاص به | لا يستخدمها هذا المجمع |
يختار Telegram طريقة تسليم الرموز، بما في ذلك ما إذا كان سيتم إرسال رسائل SMS أم لا. لا يمكن لتجزئة واجهة برمجة التطبيقات (API) إصلاح جلسة عمل تم إلغاؤها أو استبدال كلمة مرور المصادقة الثنائية (2FA) المنسية. لا يقوم TgWitness بحفظ رموز تسجيل الدخول أو كلمة مرور المصادقة الثنائية (2FA) الخاصة بـ Telegram على القرص.
بالنسبة للمصدر الخاص، يجب أن يكون للحساب حق الوصول بالفعل. اسم مستخدم المجموعة غير ضروري. لا يمنح الوكيل أو استيراد الجلسة عضويةً ولا حقوق إدارية. تحدد إعدادات الدردشة ما إذا كان الأعضاء سيرون السجل قبل انضمامهم أم لا.
استيراد ملف جلسة Telethon#
يستخدم كل من Telethon SQLite وPyrogram SQLite وTelegram Desktop TData تنسيقات مختلفة. تقوم اللوحة باكتشاف الهياكل المدعومة وتحويلها؛ ولا يُعد تغيير اسم الملف تحويلًا. حدد جلسة واحدة وملف JSON المرتبط بها ضمن الملفات، ثم اضغط على التحقق من الملفات، ثم ربط الحساب. يُسمح بما يصل إلى أربعة ملفات متطابقة و إجمالي 8 ميغابايت. انظر حدود التنسيقات للحصول على تفاصيل TData/JSON. لا توجد ميزة استعادة رمز المرور. يؤدي تسجيل الدخول عبر الهاتف/التوثيق الثنائي (2FA) أو رمز الاستجابة السريعة (QR) إلى إنشاء تفويض منفصل.
لا يزال مسار سطر الأوامر الاختياري المخصص لـ Telethon متاحًا:
- أوقف تشغيل العميل الذي يستخدم الجلسة الأصلية وقم بعمل نسخة متسقة. يقوم المحول برفض الملفات التي تحتوي على سجل WAL/journal غير مكتمل. أغلق العميل الأصلي بشكل صحيح بدلاً من حذف تلك الملفات لتجاوز الفحص.
- من بيئة TgWitness، قم بتشغيل:
python -m tgwitness.sessions account.session --out account.tgwitness-session
- ضمن «إضافة حساب» → «ملفات»، قم بتحميل النتيجة أو الصق سلسلة النص الخاصة بها، ثم تابع.
- تحقق من رقم معرّف الحساب المعروض، واختر المصادر وابدأ المراقبة.
الملف المحول هو سر وصول غير مشفر للحساب. احتفظ به في مكان تخزين محمي ولا تقم أبدًا بتثبيته أو إرساله إلى خدمة تحويل تابعة لطرف ثالث. يقوم TgWitness بحفظ الجلسة المصرح بها في خزينته المشفرة. لا يؤدي نسخ الجلسة إلى إنشاء تفويض منفصل: لا تقم بتشغيل عملاء متزامنين باستخدام مفاتيح مصادقة مستنسخة وافترض أن التحديثات يتم توصيلها بشكل مستقل.
ينقل التحويل التفويض، وليس الرسائل الأصلية، أو ذاكرة التخزين المؤقتة للكيان، أو مؤشر التحديث الدائم. ولا يعمل على إصلاح استعادة التحديثات عبر عمليات إعادة تشغيل العملية.
MTProto وTelethon والوكلاء#
MTProto هو بروتوكول Telegram. Telethon هي مكتبة عميل لغة Python التي تستخدمها TgWitness. MTProxy هو وكيل نقل Telegram؛ ويوفر كل من SOCKS5 وHTTP CONNECT أنفاقًا عامة. ولا يحل أي منها محل مصادقة الحساب.
احفظ المسار لكل مساحة عمل في المزيد من الأدوات → الحساب → الإعدادات → إعدادات الاتصال → تغيير مسار الاتصال قبل تسجيل الدخول. يتم تعيين MTProxy التلقائي كإعداد افتراضي لمساحات العمل الجديدة · القوائم العامة مع خيار إخفاء العنوان. تحتفظ مساحات العمل الحالية التي استخدمت Direct صراحةً بوضع يسمح بذلك.
تُقرأ الملفات عبر اتصالات منفصلة عن تلك المستخدمة لقراءة الرسائل، كما تفعل التطبيقات الرسمية. في مركز البيانات الخاص بالحساب، يتم إعادة استخدام مفتاح ترخيص الحساب مع جلسة MTProto جديدة؛ أما بالنسبة لمركز البيانات الآخر، فيتم إنشاء مفتاح واحد وترخيصه أثناء اتصال الحساب، ويتم الاحتفاظ به في الذاكرة فقط. يستخدم كل اتصال ملفًا نفس المسار الذي يستخدمه الحساب. ويُحدد عددهم لكل مركز بيانات من خلال المعلمات → الأداء → اتصالات الملفات لكل مركز بيانات Telegram؛ حيث يقرأ الرقم 0 الملفات عبر الاتصال الرئيسي للحساب فقط. يتم إعداد خمس اتصالات Telegram كحد أقصى في وقت واحد عبر جميع الحسابات التابعة للتثبيت.
أوضاع IP#
يختار المسار نوع الاتصال. ويحدد وضع IP، أو حماية IP في قسم «الحساب» باللوحة، متى يمكن الكشف عن عنوان الخادم. ولا تؤدي عناصر التحكم هذه إلى تثبيت شبكة افتراضية خاصة (VPN) أو توجيه كل حركة مرور الجهاز.
| الوضع | Telegram | الطلبات الخارجية |
|---|---|---|
إخفاء العنوان (hide) |
استخدم بروكسيًّا؛ وانتظر إذا لم يعمل أي منها. لا يوجد حل بديل مباشر. | يتطلب SOCKS5/HTTP؛ ويرفض الطلبات التي لا تستخدم بروكسيًّا مناسبًا. |
الاتصال المباشر كملاذ أخير (fallback) |
قد يستخدم MTProxy التلقائي خيار «Direct» بعد انقضاء فترة التأخير المحددة، ثم يعود إلى استخدام الوكيل العامل. | يفضل استخدام بروكسي خارجي مُهيأ أو مسار SOCKS5/HTTP الخاص بالحساب؛ وإلا يُسمح باستخدام «Direct». |
خادم خلف نفق أو شبكة VPN (tunnel) |
يُسمح بالمسارات المباشرة واللجوء الفوري إلى المجمع التلقائي. | يُسمح بالاتصال المباشر في حالة عدم تكوين أي وكيل مناسب. |
يفترض وضع النفق أو وضع VPN أنك تدير تلك الشبكة بشكل منفصل. وبدون نفق فعال، يمكن للوجهات رؤية عنوان الخادم نفسه. حدد الوضع وفقًا لشبكتك الفعلية، وليس وفقًا لاسم الخيار.
اختر مسارًا#
| الطريق | الإعدادات | الحدود |
|---|---|---|
| MTProxy التلقائي | قوائم مدمجة أو كتالوج للمشغلات | يحافظ على مسار Telegram فعال؛ ويعتمد البديل المباشر على وضع IP |
| مباشر | وضع النفق أو وضع VPN | يستخدم Telethon مسار شبكة المضيف |
| SOCKS5 | المضيف، المنفذ، اسم المستخدم/كلمة المرور (اختياري) | python-socks، مع تمكين DNS للوجهة البعيدة |
| HTTP CONNECT | المضيف، المنفذ، اسم المستخدم/كلمة المرور (اختياري) | اتصال HTTP عادي؛ لم يتم تطبيق بروتوكول TLS مع الوكيل نفسه |
| MTProxy | المضيف، المنفذ، السر | نظام نقل تجريبي لـ Telethon؛ 32 رقمًا سداسيًا عشريًّا أو dd + 32 رقمًا سداسيًّا عشريًّا |
يتم رفض أسرار TLS المزيفة من نوع ee. يمكن لعملية التطبيع في Telethon 1.45 إزالة البادئة
والنطاق، لكن ذلك لا ينفذ ميزة Fake TLS. الصق tg://proxy?server=…&port=…&secret=…
أو https://t.me/proxy?server=…&port=…&secret=… واختر «ملء الحقول من الرابط».
يؤدي هذا إلى التحقق من صحة الحقول وملؤها دون الاتصال أو الحفظ؛ راجع المسار واحفظه
بشكل منفصل. تظل الحقول اليدوية متاحة. انظر روابط بروكسي Telegram.
الوكلاء العامون الذين يوفرهم نظامك#
تضم القائمة المدمجة سبعة مصادر: SoliSpirit/mtproto، zakky8/mtproto-proxy-pro، kort0881/telegram-proxy-collector، 3yed-61/MTP-Collector، Therealwh/MTPproxyLIST، KhodeJav/telegram-proxy-collector و tgmtproxy/telegram-mtproto-proxy-list. تحتوي اللقطة المجمعة على معلومات عن نقاط النهاية، ومصدرها، وتواريخ التنزيل. القوائم هي مدخلات؛ وتحدد اختبارات الاتصال أدناه البروكسيات التي سيتم استخدامها.
يقوم MTProxy تلقائيًا بفحص اتصال نقل Telegram، ويحافظ على وكيل فعال ويتحول إلى وكيل آخر عند فشله. تفضل مساحات العمل وكلاء مختلفين عندما تتوفر إدخالات فعالة كافية؛ ويمكن للوكلاء مشاركة عنوان خروج واحد. أما الوكلاء الفاشلون فيستريحون قبل محاولة أخرى. إذا لم ينجح أي منها، يحدد وضع IP ما إذا كان التجميع يجب أن ينتظر أم يمكنه استخدام اتصال مباشر. تغيير الوكلاء لا يغير الحساب ولا يمحو سجله. يتم تسجيل خيارات المسار والتغييرات في السجل الموقّع.
أثناء تفعيل المسارات التلقائية، يتم تحديث القوائم كل ساعة، وتُجرى عمليات التحقق من النقل كل عشر دقائق بشكل افتراضي. هذه الفواصل الزمنية قابلة للتعديل. يتطلب تحديث القوائم العامة إجراء عملية تحديث؛ ولا يؤدي مجرد عرض القائمة إلى تغيير المسار اليدوي المحفوظ.
تستخدم حركة مرور Telegram وطلبات HTTPS مسارات مختلفة. تستخدم عمليات تنزيل القوائم
اتصال HTTPS منفصل ومسار الطلب الخارجي المقدم.
يقوم TGWITNESS_PROXY_FEED_PROXY بتجاوز هذا المسار صراحةً باستخدام وكيل HTTP/SOCKS5؛
ويقوم كلا متغيري أداة التجميع Compose بإعادة توجيهه. يتبع تجمع الخلفية مساحة العمل الرئيسية.
لا يتم إرسال أي جلسة Telegram أو بيانات اعتماد API أو رمز لوحة التحكم أو رمز الروبوت إلى مزودي البيانات.
تظهر أسماء المزودين وتواريخ اللقطات ومسار التنزيل تحت عنوان «من أين تأتي القائمة».
يحمل MTProxy حركة Telegram فقط. تستخدم عمليات HTTP الخاصة بمساحة العمل، مثل الطوابع الزمنية، والإشعارات، والنسخ خارج الموقع، والتحقق من المصدر، وكيل SOCKS5/HTTP منفصلاً عند تكوينه، ثم مسار SOCKS5/HTTP الخاص بالحساب. وفي حالة عدم وجود أي منهما، ترفض ميزة «إخفاء العنوان» الطلب؛ بينما تسمح الأوضاع الأخرى بالاتصال المباشر. يمكن تعطيل الطلبات الخارجية. ويظل وكيل تنزيل الخلاصة الذي تم تكوينه صراحةً خيارًا منفصلاً يمكن للمشغل تجاوزه. تحتفظ خدمة الشاهد المستقلة بمسارها الخاص.
بالنسبة للخدمات الخاصة التي يديرها المشغل، فإن الإعداد الحالي لبيئة الخادم
TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1 يسمح بالوجهات الخاصة ويحافظ على
تحليل اسم المضيف من جانب الوكيل. لا يمكن تمكينه من اللوحة. يرفض الوضع «عام فقط»
الوجهات .onion قبل الاستعلام عن المحلل العام؛ تتطلب خدمات Tor onion
هذا الإعداد الصريح للوجهة الخاصة ووكيلًا مناسبًا.
ينطبق سلوك DNS هذا على عمليات HTTP الخارجية، وليس على نقل Telegram.
توثق Cloudflare نقطة نهاية DNS بتنسيق JSON.
معلمات التجميع التلقائي
ضمن المزيد من الأدوات → المعلمات → MTProxy التلقائي، قم بتكوين عتبة الفشل، وفترة التهدئة، والتناوب المخطط، ومشاركة الوكيل، وتأخير اللجوء البديل المسموح به.
| التحكم | الافتراضي |
|---|---|
| يتم قطع الاتصال قبل الاستبدال | 3 خلال 10 دقيقة |
| عدد الوكلاء الذين تم تجربتهم في كل محاولة اتصال | 3 |
| الراحة الأولى / القصوى بعد الفشل | 10 دقيقة / 6 ساعة |
| التناوب المخطط له | معطل؛ قم بتشغيله في حالة الفشل |
| عدد الحسابات لكل وكيل | 0: يُفضل إنشاء مدخلات منفصلة، ومشاركتها عند الحاجة. اضبط 1 على الانتظار حتى يتم إنشاء مدخل حصري. |
| الفترة الزمنية المسموح بها قبل اللجوء المباشر إلى الخطة البديلة | محضر اجتماع 10؛ لا يزال إخفاء العنوان يرفض Direct |
| تحديث الخلاصة / فحوصات النقل | محاضر 60/10؛ تنطبق قيم مساحة العمل الرئيسية على المجمع المشترك |
يمكن لوكلاء مختلفين مشاركة عنوان خروج واحد. تنطبق قيود Telegram على كل مسار.
لاستبدال القائمة العامة بكتالوج المشغل الخاص بك، قم بتكوين التجاوز أدناه.
يؤدي ذلك إلى تعطيل الاشتراكات الخارجية تمامًا، بما في ذلك عندما تكون مصفوفة proxies فارغة.
انسخ الكتالوج الفارغ
إلى proxy-config/proxies.json
وأضف نقاط النهاية العامة التي قمت بنشرها:
{"format": "tgwitness-proxy-catalog-v1", "proxies": [
{"id": "project-eu", "label": "Project EU",
"link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"}
]}
يجب استبدال القيم الواردة في المثال. يُسمح بما يصل إلى 32 إدخالًا مختلفًا. تعرض القائمة المصادق عليها التسميات/المضيفات/المنافذ دون أسرار مشتركة؛ وعند اختيار أحدها يتم حفظ بيانات اعتمادها في خزينة مساحة العمل. تظل التوافرية غير مختبرة حتى إجراء اختبار نقل صريح. في حالة وجود كتالوج غير صحيح، يظل التكوين اليدوي متاحًا.
التشغيل المحلي: اضبط TGWITNESS_PROXY_CATALOG على مسار JSON المحلي. Docker:
docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build
يتم تثبيت الطبقة الفوقية proxy-config على وضع القراءة فقط؛ ويجب أن تكون الملفات قابلة للقراءة بواسطة معرّف الحاوية (UID) 10001.
يتم استبعاد هذا الدليل من Git، وسياق بناء Docker، وأرشيفات المصدر. يقوم هذا
الكتالوج بتكوين حسابات التجميع؛ ويستخدم روبوت الشاهد مساره الخاص
HTTP/SOCKS5، وليس MTProxy.
يخضع البديل المباشر لوضع IP المذكور أعلاه. قم بإيقاف المراقبة مؤقتًا قبل تغيير المسار. يؤدي الحفظ إلى قطع اتصال العملاء القدامى وإلغاء عمليات تسجيل الدخول غير المكتملة؛ ويستخدم العميل الجديد المسار المحفوظ. ويبقى ربط السجل/الجلسة الخاص بالحساب ساريًا. تحل الإعدادات محل المسار السابق: أعد إدخال بيانات اعتماد الوكيل عند تعديله.
يتم تشفير بيانات الاعتماد باستخدام خوارزمية network.enc. لا تعرض واجهة برمجة التطبيقات (API) اسم المستخدم،
أو كلمة المرور، أو السر. تحتوي السجلات الموقعة على نوع المسار وما إذا كانت بيانات الاعتماد
موجودة أم لا، باستثناء نقطة النهاية والأسرار. يمكن للمشغل رؤية نقطة النهاية
في اللوحة. يتم مسح الحقول السرية بعد الحفظ أو القفل أو التبديل بين مساحات العمل.
اختبار اتصال Telegram، المتاح أيضًا قبل تسجيل الدخول، يفتح ويغلق اتصالًا مؤقتًا غير مصرح به بـ Telegram عبر المسار. ولا يتصل بموقع إلكتروني للتحقق من عنوان IP. يؤكد النجاح اتصال الشبكة، وليس الوصول إلى المجموعات، أو التسليم الكامل، أو إخفاء الهوية.
ينطبق الوكيل على اتصالات عميل Telegram، بما في ذلك تنزيلات الوسائط من خوادم توزيع Telegram (DC)
. أما المتصفح وpip وSSH وأدوات TSA التي يتم تشغيلها يدويًّا، فلها مسارات منفصلة.
يمكن تحليل اسم مضيف الوكيل محليًّا. يؤثر rdns على أسماء مضيفات الوجهة؛
وغالبًا ما يوفر Telegram عناوين IP رقمية لخوادم التوزيع (DC).
لا يقوم كل من SOCKS5 وHTTP CONNECT العادي بحد ذاتهما بتشفير بيانات اعتماد الوكيل أو النفق بين العميل والوكيل. يحمي MTProto حركة مرور Telegram بشكل منفصل. استخدم قناة آمنة مناسبة للاتصال بالوكيل على شبكة غير موثوق بها. المجموعات الخاصة هي محادثات سحابية محمية بواسطة MTProto أثناء النقل؛ أما المحادثات السرية من طرف إلى طرف فهي نوع منفصل من المحادثات ، يتم تسجيلها بواسطة وحدة المحادثة السرية.
التشفير والتوقيعات#
| الطبقة | تم التنفيذ | مسؤولية المشغل |
|---|---|---|
| حركة مرور Telegram | Telethon MTProto | ثقة المنصة ومسارها وتوافرها |
| لوحة الويب | رمز حامل، إعدادات الارتجاع الافتراضية، حدود الطلبات | نفق HTTPS أو SSH للوصول عن بُعد |
| أسرار | Fernet لبيانات اعتماد واجهة برمجة التطبيقات (API)، والجلسة، وبيانات اعتماد الوكيل، ومفتاح التوقيع الخاص | حماية مفتاح فك التشفير والمضيف الذي يعمل عليه البرنامج |
| مفتاح الخزنة | مفتاح محلي، أو مفتاح رئيسي خارجي للتثبيت الجديد | تخزين منفصل محمي ونسخ احتياطي للمفاتيح |
| الرسائل والمرفقات | تخزين التطبيق بنص عادي | قرص/وحدة تخزين مشفرة |
| ZIP/JSONL/CSV/HTML | فحوصات النزاهة، لا يوجد تشفير للمحتوى | حماية النسخ المصدرة وعمليات النقل |
| المصدر والوقت | سجل موقّع، إيصال عملية، أدوات RFC 3161 | مفتاح موثوق به، ونقاط تفتيش مستقلة/TSA، وإجراءات الحفظ |
تُظهر «حماية التخزين» في «الحساب» هذه الحالات. رمز اللوحة هو سر وصول، وليس كلمة مرور تشفير. يمنح حق الوصول للمسؤول؛ ويمكن تقييد نطاق الرموز الصادرة لتقتصر على الحسابات والدردشات. تشارك مساحات العمل العملية المضيفة وليست مستأجرين معزولين.
يمكن لـ BitLocker أو LUKS أو FileVault أو وحدة التخزين المشفرة المُدارة حماية مساحة التخزين في إطار نماذج التهديدات الخاصة بكل منها. لا يزال بإمكان مسؤول نظام يعمل دون قفل قراءة البيانات. قم بتضمين SQLite WAL/SHM، والوسائط، والتصدير المؤقت، ومساحة التبادل، والنسخ الاحتياطية وتنزيلات المتصفح في تخطيط التخزين. لا يتم تشفير وحدة تخزين Docker لمجرد كونها وحدة تخزين.
مفتاح رئيسي خارجي#
للتثبيت الجديد، ضع المفتاح الرئيسي خارج دليل البيانات. لا يؤدي هذا إلى ترحيل خزينة المفاتيح المحلية الموجودة تلقائيًا. قم بإعداد دليل مفاتيح لا يمكن الوصول إليه إلا من خلال هوية الخدمة، ثم قم بتشغيل:
python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key
export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key
python -m tgwitness --data-dir /private/observations/new-case
PowerShell، باستخدام بيئة المشروع المثبتة:
python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key
$env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key'
python -m tgwitness --data-dir E:\PrivateData\new-case
في Docker، قم بتركيب الملف للقراءة فقط خارج /data، على سبيل المثال في
/run/secrets/tgwitness-master.key، وقم بتعيين متغير البيئة إلى ذلك المسار.
يجب أن يكون معرّف المستخدم الفريد (UID) للخدمة قادرًا على قراءته. قم بتمرير المسار، وليس بايتات المفتاح، عبر
ملفات البيئة/التكوين.
تتلقى كل مساحة عمل «سولت» (salt) عامًا عشوائيًا ومفتاح Fernet خاص بها مشتق عبر
HKDF-SHA256. يقوم vault.external.json بتخزين بيانات تعريف الاشتقاق، وليس المفتاح الرئيسي.
يؤدي فقدان المفتاح أو وجود مفتاح خاطئ إلى فشل عملية التشغيل دون استبداله بصمت. احتفظ بكل من
بيانات تعريف «السولت» والمفتاح الرئيسي لأغراض الاستعادة.
تستمد جميع مساحات العمل من نفس المفتاح الرئيسي؛ ويؤثر اختراقه على التثبيت بأكمله. يمكن للعملية قيد التشغيل فك تشفير الأسرار. هذه ليست وحدة HSM أو KDF لكلمة المرور. لا تُقبل كلمات المرور البشرية العشوائية بدلاً من المفتاح العشوائي.
احتفظ بالمفتاح الحالي للتثبيتات الموجودة حتى يتم تنفيذ عملية ترحيل مدروسة
والتحقق منها. قد يؤدي حذف vault.key أو استبدال المفتاح الرئيسي إلى تعطيل
الوصول إلى الجلسات/مفاتيح التوقيع. احتفظ بالنسخ الاحتياطية المشفرة والمفاتيح بشكل منفصل و
اختبر عملية الاستعادة في بيئة معزولة.