TgWitness / التوثيق

ما تم اختباره ←

لا تزال أجزاء من هذه الصفحة باللغة الإنجليزية: فقد تغير النص الأصلي باللغة الإنجليزية بعد ترجمته.

مرجع / الإعداد

Telegram · الحسابات وتنسيقات الجلسات

قم بتسجيل الدخول عبر الهاتف أو رمز الاستجابة السريعة (QR) أو مفتاح المصادقة، واستورد جلسات Telethon أو Pyrogram أو Telegram Desktop، وقم بتشغيل عدة حسابات.

TgWitness / التوثيق · البدء

البدء

تقوم TgWitness بتسجيل الدخول كحساب مستخدم Telegram (وليس كروبوت) عبر بروتوكول MTProto، باستخدام Telethon. ويوجد كل حساب في مساحة عمل خاصة به (تُسمى «مساحة العمل» في واجهة برمجة التطبيقات وأدوات سطر الأوامر) مع جلسة عمل ومصادر وسجل ومفتاح توقيع خاص به.

ملفات الجلسة وسلاسل الجلسة ومفاتيح المصادقة هي تفويضات للحساب: فمن يمتلك أيًا منها يمكنه التصرف بصفته صاحب ذلك الحساب. ولا تحتوي هذه العناصر على سجل الرسائل.

[!تحذير] استخدم حسابات مخصصة. يفرض Telegram قيودًا على الحسابات ويمكنه حظرها نهائيًا بسبب أحجام الطلبات التي يعتبرها مفرطة، بغض النظر عن العميل أو الغرض، ولا يوثق تلك الحدود إلا جزئيًا. قم بربط الحسابات المعدة للمراقبة بدلاً من الحسابات الشخصية أو تلك التي لها قيمة أخرى، وأنشئ معرّف API / تجزئة API على حساب مخصص.

لمحة عامة#

ما لديك علامة التبويب «إضافة حساب» ستحتاج أيضًا إلى
رقم الهاتف والوصول إلى رموز تسجيل الدخول الخاصة به الهاتف كلمة مرور المصادقة الثنائية (2FA) في حالة تفعيلها
Telegram مفتوح على جهاز آخر رمز الاستجابة السريعة (QR) كلمة مرور المصادقة الثنائية (2FA) في حالة تفعيلها
ملف .session (Telethon أو Pyrogram) الملفات ملف JSON مصاحب اختياري لإعدادات التطبيق
.session + .json يحملان الاسم نفسه الملفات (اختر كليهما) عادةً لا يوجد شيء آخر
مجلد «tdata» في تطبيق Telegram Desktop الملفات (بصيغة ZIP) رمز المرور المحلي لسطح المكتب، إن تم تعيينه
جلسة Telethon StringSession (نص، .txt، .tgwitness-session) الملفات لا حاجة إلى زوج منفصل من واجهات برمجة التطبيقات (API)
مفتاح المصادقة وDC في سطر واحد، <512 hex>:<1–5> الملفات (لصق أو ملف نصي) لا حاجة إلى زوج منفصل من واجهات برمجة التطبيقات (API)
.json مع جلسة أو مفتاح مصادقة الملفات لا حاجة إلى زوج منفصل من واجهات برمجة التطبيقات (API)
مفتاح التوثيق (512 حرفًا سداسي عشري) ورقم DC الخاص به مفتاح المصادقة معرف المستخدم اختياري

تتعرف TgWitness على الملفات من خلال محتوياتها، وليس من خلال أسمائها. ولا تؤدي إعادة تسمية الملف إلى تحويله أبدًا.

قبل البدء: معرّف واجهة برمجة التطبيقات (API ID) وتجزئة واجهة برمجة التطبيقات (API hash)#

يمكنك تسجيل الدخول دون إنشاء تطبيق Telegram API. وعندما لا يكون هناك زوج قد تم إدخاله، أو استيراده، أو تم حفظه مسبقًا في مساحة العمل، يقوم TgWitness باختيار زوج من مجموعته المدمجة المكونة من 50 زوجًا من أزواج API العامة (tgwitness/api_pool.py)، مع إعطاء الأولوية لتطبيق Telegram Desktop في حالة تسجيل الدخول الجديد والاحتفاظ بالزوج المحفوظ أولاً؛ ويتم خلط الزوجات المتبقية عشوائياً. إذا رفض Telegram زوجاً (API_ID_INVALID, API_ID_PUBLISHED_FLOOD, UPDATE_APP_TO_LOGIN)، يتم تجربة الزوج التالي، بحد أقصى ثمانية أزواج لكل عملية تسجيل دخول؛ ويتم تخطي الأزواج المرفوضة حتى إعادة التشغيل. يتم حفظ الزوج الذي تم تسجيل الدخول به مع الحساب وإعادة استخدامه له.

الأزواج المدمجة متاحة للجميع: فهي منشورة في الكود المفتوح لعملاء Telegram ومكتباته. ويقوم معرّف واجهة برمجة التطبيقات (API ID) وتجزئة واجهة برمجة التطبيقات (API hash) بتحديد هوية التطبيق لدى Telegram ولا يمنحان أي وصول إلى بيانات الحساب. ويستخدم تسجيل الدخول آلية المصادقة الخاصة بالحساب: رمز تسجيل الدخول وكلمة مرور المصادقة الثنائية (2FA)، أو جلسة عمل سبق أن أذن بها الحساب. ويُدرج كل observation.started يسرد الزوج المستخدم، لذا يتم توثيق الزوج المدمج لأغراض المحكمة بنفس الطريقة التي يتم بها توثيق زوجك الخاص. يمكنك إدخال زوجك الخاص من my.telegram.org بدلاً من ذلك. وفقًا لتجربة المشروع، يؤدي استخدام زوج شخصي جديد إلى تسجيل خروج معظم الحسابات، لذا استخدمه فقط عندما تتطلب الحالة استخدام تطبيقك الخاص: قم بإنشائه باستخدام حساب مخصص و أدخله قبل بدء عملية التجميع (الخطوات أدناه).

تستخدم حقول الاتصال المفقودة زوجًا حتميًا من الجهاز ونظام التشغيل من كتالوجات opentele2 2.0.0 المجمعة : Desktop 2040، Android 6، Android X 21724، iOS 10840، macOS 2834، وWeb 2496. كما يستخدم معرّف بناء المصدر في Android 4 كتالوج Android، كما هو محدد في BuildVars في Telegram Android . يتم تعيين الويب افتراضيًا على A؛ بينما تحدد لاحقة إصدار التطبيق المستوردة K أو حزمة اللغة macos K، ويحدد الإصدار 0.7.0 Webogram. تحتفظ معرّفات التطبيقات غير المعروفة بالإعدادات الافتراضية لمضيف Telethon. تكون الأولوية دائمًا للحقول المستوردة، بما في ذلك إصدار التطبيق الأقدم وحزمة اللغة الفارغة. لا يغير الكتالوج أبدًا معرّف/تجزئة واجهة برمجة التطبيقات (API). يتم مراجعة لقطة الإصدار الخاصة به بشكل صريح، ولا يتم استردادها أثناء تسجيل الدخول. يظل الملف الشخصي المحفوظ ثابتًا بعد التحديثات.

تُبلغ account.getAuthorizations عن بيانات التعريف الخاصة بالتفويضات المحفوظة في Telegram؛ وهي ليست مجرد تكرار لكل initConnection جديد. قارنها بالملف الشخصي الفعلي الذي تم إرساله. لا يؤدي ربط تفويض موجود إلى التحقق من صحة تجزئة API المرتبطة به: حيث تُرسل initConnection معرّف API، بينما تُستخدم التجزئة في طلبات تسجيل الدخول.

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

بالنسبة لـ tdesktop ، في حالة فقدان tz_offset ، يتم استخدام الإزاحة المحلية لـ UTC الخاصة بالخادم، مقربة إلى 900 ثانية باستخدام خوارزمية opentele2 (MIT؛ الترخيص في tgwitness/client_profiles.LICENSE ). يتم تحديثها عند كل اتصال بحيث تنعكس تغييرات التوقيت الصيفي. يُعطى الأولوية لـtz_offset المستورد على كل منصة ويتم الاحتفاظ به بالضبط، بما في ذلك الصفر. يتم الاحتفاظ بمدخلات initConnection.params الأخرى. يقبل نموذج تسجيل الدخول عبر HTTP المنطقة الزمنية الرقمية التي يتم إرجاعها عن طريق استيراد الملف؛ ويتم رفض القيم المنطقية والكسور والإزاحات خارج النطاق المدعوم.

تستخدم مسارات Direct وSOCKS5 وHTTP CONNECT بروتوكول ConnectionTcpObfuscated من Telethon (نسخة مختصرة ومشوشة من MTProto). يحتفظ HTTPS CONNECT ببروتوكول TLS إلى الوكيل ويستخدم نفس وسيلة النقل المشوشة داخل النفق. يحتفظ MTProxy بوسيلة النقل الوسيطة العشوائية المطلوبة ومعالجة السر. تطبق تبديلات المسارات نفس الخيارات. يؤدي التشويش إلى تغيير هيكل الحزم؛ ولا يخفي الحساب أو بيانات تعريف العميل الخاصة به عن Telegram ولا يعني الحصانة من القيود.

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

بعد تسجيل الدخول وعند كل اتصال جديد، يقوم TgWitness بقراءة إعداد المحتوى الحساس للحساب. عندما يكون هذا الإعداد معطلاً ويسمح Telegram بالتغيير، يقوم TgWitness بتشغيله بحيث يتم حفظ المحتوى الذي يصنفه Telegram على أنه حساس (18+)، ويسجل قيمة account.content_settings. ينتمي هذا الإعداد إلى الحساب ويسري في كل تطبيق Telegram. لا يؤثر هذا الإعداد على «الدردشات المختارة بدقة»؛ لذا قم بتشغيل هذه الميزة قبل تسجيل الدخول.

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

تحتفظ تشخيصات FloodWait بطريقة TL الفاشلة، وأي أغلفة Takeout/range، ووقت الانتظار المطلوب من الخادم، والموعد النهائي الفعلي في telegram.backoff. تُظهر تفاصيل الاتصال الطريقة والموعد النهائي أثناء تعليق الطلبات. يتضمن التشخيص عدادات استدعاءات العميل لكل طريقة منذ إنشاء ذلك العميل؛ وهي تحسب تحليل الأقران المتداخل بشكل منفصل، لكنها لا تحسب الحزم أو محاولات إعادة المحاولة الداخلية لـ Telethon. تتوفر العدادات الحالية أيضًا كـ collector.rpc_activity في واجهة برمجة تطبيقات الحالة. لا يتم تضمين أي معلمات طلب أو أسماء مستخدمين أو تجزئات الوصول أو نص الاستثناء. يستمر التشخيص الأخير والموعد النهائي الكامل بعد إعادة التشغيل. لا يمكن إرجاع عمليات الانتظار السابقة التي لا تحتوي على سجل طريقة إلى الوراء. انظر حدود تصدير و لمراجعة المصدر و التمييز بين الاكتشاف والحصول على السجل.

official_app=True أو False هي علامة التفويض الحالية في Telegram. ولا تحدد أي من هاتين القيمتين ما إذا كان الحساب مقيدًا أم موثوقًا به أم قيد المراقبة. تظل لقطات account.devices الحالية في وضع الأدلة سجلًا لجميع الأجهزة التي تم تسجيل الدخول منها؛ بينما تحتفظ تشخيصات الاتصال بوصف الجهاز الحالي فقط.

قبل الاتصال، تقارن الفحوصات الاستشارية منصة واجهة برمجة التطبيقات (API)، وحزمة اللغة، وتنسيقات الجهاز/نظام التشغيل وإصدار التطبيق، وإعدادات اللغة لنظام الهاتف المحمول، وطبقة المخطط الفعلية لـ Telethon مقابل خط الأساس للكتالوج الذي تمت مراجعته. تظهر التحذيرات في سجل الخادم وبيانات تعريف حالة الحساب؛ ولا تحل أبدًا محل القيم المستوردة أو تغير طبقة المخطط. وجود طبقة مختلفة هو إشارة لمراجعة التوافق؛ وتُظهر حالة الاتصال الخاصة بالحساب ما إذا كان يعمل أم لا. يقرر Telegram القيود من جانبه، بغض النظر عن ملف تعريف العميل المستخدم. تستخدم حالة الحساب غير المتصل ملف التعريف المحفوظ بدلاً من إنشاء وصف جهاز آخر.

لاستخدام تطبيقك الخاص بدلاً من ذلك:

  1. افتح my.telegram.org وقم بتسجيل الدخول باستخدام أي رقم هاتف تمتلكه. سيصل الرمز إلى تطبيق Telegram، وليس عبر رسالة SMS.
  2. اختر أدوات تطوير واجهة برمجة التطبيقات (API).
  3. إنشاء تطبيق: أي عنوان واسم مختصر (5–32 حرفًا)، منصة سطح المكتب. يمكن ترك حقل عنوان URL والوصف فارغين.
  4. انسخ معرّف التطبيق (api_id) (رقم) وتجزئة التطبيق (api_hash) (32 حرفًا سداسي عشري).

في اللوحة، يوجد «معرف API المفتوح + التجزئة» أسفل نموذج تسجيل الدخول. يمكنك لصق زوج واحد من api_id:api_hash في حقل «معرف API» ليتم ملء كلا الحقلين تلقائيًا. يمكن استخدام زوج واحد لجميع حساباتك. بعد تسجيل الدخول بنجاح، يتم حفظ البيانات مشفرة في مساحة العمل تلك فقط ولا يتم إرسالها أبدًا إلى المتصفح.

تتضمن هذه العملية ثلاثة أنواع مختلفة من بيانات الاعتماد:

سري يفتح مكان وجوده
رمز اللوحة لوحة التحكم على الويب الخاصة بـ TgWitness panel-token.txt في دليل البيانات، أو TGWITNESS_TOKEN
معرف واجهة برمجة التطبيقات (API) + التجزئة لا شيء بحد ذاته؛ يحدد هوية التطبيق إعدادات مدمجة، أو إعدادات مستوردة، أو تطبيقك الخاص على my.telegram.org
تفويض الحساب حساب Telegram يتم إنشاؤها عن طريق تسجيل الدخول عبر الهاتف أو رمز الاستجابة السريعة (QR) أو إضافتها كجلسة

إذا كان لا بد من الوصول إلى Telegram عبر وكيل، فقم بتعيينه أولاً من خلال المزيد من الأدوات → الحساب → الإعدادات → إعدادات الاتصال → تغيير مسار الاتصال.

رقم الهاتف#

  1. افتح المزيد من الأدوات → الحساب، ثم علامة التبويب الهاتف، وأدخل الرقم بالصيغة الدولية، على سبيل المثال +44 7700 900123. تتم إزالة المسافات والشرطات تلقائيًا.
  2. اضغط على «متابعة». يمكن ترك حقل «معرف API» و«التجزئة» فارغين.
  3. أدخل الرمز الذي يرسله Telegram، عادةً إلى تطبيق Telegram؛ ويقرر Telegram ما إذا كان سيُرسل رسالة SMS أم لا.
  4. إذا كان الحساب مزودًا بالتحقق بخطوتين، فأدخل كلمة المرور تلك. فهي ليست رمز اللوحة ولا رمز مرور الجهاز.
  5. تحقق من معرّف الحساب الذي يظهر بعد تسجيل الدخول، ثم اختر المصادر.

لا يتم أبدًا تسجيل رموز تسجيل الدخول وكلمة مرور المصادقة الثنائية (2FA) على القرص.

رمز الاستجابة السريعة (QR)#

استخدم هذه الميزة عندما يكون الحساب مسجلاً بالفعل على هاتف أو جهاز كمبيوتر آخر.

  1. انقر على رمز QR → اعرض رمز QR. يمكن ترك حقل معرّف API + التجزئة فارغًا.
  2. على الجهاز الذي قمت بتسجيل الدخول إليه: الإعدادات → الأجهزة → ربط جهاز سطح المكتب، امسح الرمز ضوئيًّا ثم قم بالتأكيد.
  3. أدخل كلمة مرور المصادقة الثنائية (2FA) في TgWitness إذا طلبها Telegram.

يتم إنشاء صورة رمز الاستجابة السريعة (QR) محليًّا. تنتهي صلاحية الرموز؛ اضغط على «إنشاء رمز QR آخر » لإعادة المحاولة. يؤدي قفل اللوحة أو التبديل بين مساحات العمل أو بدء عملية تسجيل دخول أخرى إلى إلغاء الرمز المعلق.

مفتاح المصادقة + معرّف DC#

مفتاح المصادقة (Auth Key) هو مفتاح المصادقة الخام المكون من 256 بايت الذي يقف وراء كل جلسة Telegram، ويُكتب على شكل 512 حرفًا سداسي عشريًّا، إلى جانب رقم مركز البيانات DC 1–5.

  1. مفتاح المصادقة في علامة التبويب. الصق المفتاح كاملاً؛ فالمفتاح المختصر الذي يحتوي على … لا يعمل.
  2. اختر معرّف DC المرفق مع المفتاح.
  3. يمكنك إدخال معرّف المستخدم اختياريًّا. عندئذٍ يرفض TgWitness الاتصال إذا أبلغ Telegram عن حساب مختلف.
  4. حساب Press Connect.

مفتاح المصادقة (512 حرفًا) ليس تجزئة واجهة برمجة التطبيقات (API) (32 حرفًا). يمكن أيضًا استيراد المفتاح نفسه بتنسيق JSON، انظر JSON الحساب.

ملفات الحسابات#

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

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

An attested deployment (Phala Cloud, Intel TDX) does not collect on an imported key. There, Files and Auth key connect only with Create an independent authorization selected; bulk import is refused. Phone and QR login work as usual.

  • يتم تحويل الملفات في الذاكرة على خادم TgWitness الخاص بك. لا يتم تخزين الملفات التي يتم تحميلها، ولا يتم استخراج ملفات ZIP إلى القرص، ولا يتم الاتصال بأي خدمة خارجية.
  • ثم يتم التحقق من الجلسة الناتجة مع Telegram. إذا كان الملف يحتوي على معرّف مستخدم، فيجب أن يتطابق مع الحساب الذي يبلغ عنه Telegram.
  • يتم رفض الملفات التي تصف حسابات مختلفة أو بيانات اعتماد API مختلفة بدلاً من اختيار واحدة منها.
  • يحتوي حقل رمز المرور أو نص الجلسة على حقل رمز المرور المحلي TData، ومربعًا للصق StringSession وقراءة الملفات دون تسجيل الدخول (يملأ النموذج دون الاتصال بـ Telegram). يؤدي لصق StringSession إلى مسح الملفات المحددة، واختيار الملفات يؤدي إلى مسح النص الملصق، لذا فإن عملية التحقق والاتصال تستخدمان الاختيار الأخير. بعد تغيير رمز المرور، اضغط على التحقق من الملفات مرة أخرى.

إنشاء ترخيص مستقل#

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

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

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

إذا طلب تطبيق Telegram المصادقة الثنائية (2FA)، فإن هذا الوضع يستخدم twoFA من ملف JSON المحدد إن وجد، أو يطلب كلمة المرور. وفي حالة رفض كلمة المرور المستوردة، يتم العودة إلى نموذج كلمة المرور. لا يتم حفظ كلمات المرور. يتم حفظ المفتاح المرشح مشفرًا في independent_login.enc، بما في ذلك التغييرات التي تطرأ أثناء عملية الترحيل بين مراكز البيانات. بعد حدوث انقطاع، حدد نفس المانح وهذا الخيار لاستئناف المفتاح المرشح المحفوظ. يتم التحقق من المانح help.getAppConfig قبل الموافقة؛ ويُوقف الحساب المجمد عند هذه المرحلة. إذا رفض Telegram المانح قبل الموافقة على تسجيل الدخول، يتم استبعاد المفتاح المرشح غير المعتمد ويمكن بدء الاستيراد من جديد. يحل مانح آخر محل المفتاح المرشح المحفوظ فقط عندما يبلغ Telegram أن هذا المفتاح المرشح غير مسجل الدخول؛ أما المفتاح المرشح الذي تم تسجيل دخوله أو الذي ينتظر كلمة مرور المصادقة الثنائية (2FA) فيتم الاحتفاظ به. تظل مساحة العمل محجوزة لهذا الحساب؛ ولا يؤدي الفشل في إتمام العملية إلى حذف مساحة العمل الجديدة. احتفظ بدليل البيانات ومفتاح الخزينة الخاصين بها. تتضمن بيانات الاعتماد النهائية وسجل account.authorized سجل اليومية طريقة الاستيراد وتنسيقات الإدخال و معرف واجهة برمجة تطبيقات المتبرع، دون مفتاح المتبرع أو كلمة المرور.

في 5 نوفمبر 2026، اجتاز حساب مخصص الاختبارات الحية مع المتبرعين Telethon وPyrogram وTData: إتمام المصادقة الثنائية (2FA)، ومفاتيح ترخيص جديدة مميزة، والوصول المتزامن من قبل المتبرع والعميل الجديد، وقراءة قناة عامة. كما استأنفت حالة Telethon مرشحًا محفوظًا بعد انقطاع عند خطوة كلمة المرور. أكمل كل ترخيص جديد طلبات التهيئة الستة بعد تسجيل الدخول، وتم التحقق من المجلة الموقعة الخاصة به. ظلت الجلسة الأصلية قابلة للاستخدام في جميع التنسيقات الأربعة المقدمة.

تربط قاعدة بيانات أخطاء RPC الخاصة بـ Telegram FRESH_CHANGE_ADMINS_FORBIDDEN بتغيير المسؤولين، وFRESH_CHANGE_PHONE_FORBIDDEN بتغيير رقم الهاتف، وFRESH_RESET_AUTHORISATION_FORBIDDEN بـ إلغاء الجلسات الأخرى، أو تغيير مدة صلاحيتها، أو تسجيل مفتاح مرور. SESSION_TOO_FRESH_* وPASSWORD_TOO_FRESH_* تتعلقان بنقل الملكية و سحب الإيرادات أو الهدايا. هذه ليست عمليات تحصيل؛ ولا يعني تسجيل الدخول الجديد فرض حظر شامل على القراءة لمدة 24 ساعة. يمكن للتصدير إرجاع TAKEOUT_INIT_DELAY_* بشكل منفصل. TgWitness يحتفظ بفترات التوقف التي يطلبها الخادم ولا يعيد المحاولة لقبول الرموز تلقائيًا أو يلغي الجلسات للتغلب على القيود.

المزيد من الأدوات → الحساب → أمان الحساب → جلسات هذا الحساب → إنهاء جميع الجلسات الأخرى تستدعي وظيفة `auth.resetAuthorizations` بناءً على طلب المشغل وتسجل `account.all_other_sessions_terminated` مع عدد الجلسات قبل وبعد. يقبل Telegram ذلك من جلسة مسجلة الدخول لمدة 24 ساعة. عندما يتم تسجيل الدخول إلى مساحة العمل هذه عبر رمز الاستجابة السريعة (QR) من جلسة مستوردة، فإن الجلسة التي وافقت عليها تظل مسجلة الدخول: يقوم TgWitness بإنهاء الجلسات الأخرى واحدة تلو الأخرى باستخدام account.resetAuthorization و يسجل kept_approving_session. اجعل هذه هي الجلسة الوحيدة ثم توقف لهذا السبب ولا تقم بتغيير كلمة المرور.

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

اجعل هذه هي الجلسة الوحيدة التي يسمح فيها Telegram بإجراء نفس العملية على مؤقت. يظهر الخيار تحت الجلسات في هذا الحساب لمفتاح تم إنشاؤه في مساحة العمل هذه ويتم تسجيله كـ session.exclusive_automatic. أثناء المراقبة، يتحقق المجمع كل خمس دقائق مما إذا كانت 24 ساعة قد مرت منذ سجل account.authorized لذلك المفتاح — يرد Telegram بـ FRESH_RESET_AUTHORISATION_FORBIDDEN قبل ذلك — ثم يقوم بتنفيذ نفس العملية مرة واحدة. يتم تسجيل النجاح كـ session.exclusive_from، مثل الزر اليدوي. يتم تسجيل الرفض مرة واحدة على النحو التالي: session.exclusive_postponed مع سبب Telegram، ويقوم المجمع بإعادة المحاولة بتأخير متزايد يصل إلى ست ساعات. لا يؤثر وضع للقراءة فقط هنا: فإنهاء الجلسات هو إجراء يتعلق بأمن الحساب، وليس إجراءً متعلقًا بالدردشة.

يتم حفظ كلمة مرور من خطوتين تم إنشاؤها بواسطة التشغيل التلقائي في خزنة مساحة العمل، مشفرة بمفتاح مساحة العمل، قبل أن يقوم Telegram بتعيينها. تقوم اللوحة بجلبها مرة واحدة من POST /api/account/sessions/only/password، الذي يقوم بحذفها، ويعرضها في نفس مربع الحوار الخاص بالتدفق اليدوي عند فتح الجلسات لهذا الحساب. تشير صفحة الاتصال إلى وجود كلمة مرور في انتظار. ولا تدخل هذه الكلمة أبدًا إلى السجل وتبقى سارية حتى بعد إعادة التشغيل حتى يتم عرضها.

يتم الإبلاغ أيضًا عن الجلسات الجديدة أثناء المراقبة: عندما تضاف إدخالة إلى قائمة جلسات Telegram، يقوم السجل account.sessions بتسميتها تحت added، وتصدر اللوحة تنبيهًا يتضمن الجهاز والتطبيق والبلد من تلك اللقطة.

مسبار الشاهد#

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

أثناء المراقبة، ترسل مساحة العمل هذه probe:<n>:<token> إلى المجموعة كل 60–120 ثانية وتسجل probe.sent. يرد الشاهد بـ ack:<n>:<token> ويسجل probe.seen و probe.ack_sent. يتم تسجيل إقرار الاستلام (ack) الذي يصل إلى هذه الجلسة كتحديث مباشر في غضون 20 ثانية بصفته probe.acked. وإلا، تقرأ مساحة العمل السجل الأخير للمجموعة. يتم تسجيل إقرار الاستلام الموجود هناك ولكن لم يتم تسليمه مباشرةً على أنه coverage.gap مع السبب probe_ack_missed_live: تقوم اللوحة بإصدار تنبيه وتصنف استلام الحدث على أنه فاشل حتى وصول إقرار استلام لاحق مباشرةً (connection.restored، السبب probe_ack_live). لا يتم تسجيل أي إقرار استلام على أنه probe.unanswered؛ ويُسجل انقطاع الاتصال أثناء الانتظار أو السجل غير القابل للقراءة على أنه probe.inconclusive. يتم تسجيل حالات للقراءة فقط وقيود Telegram وفترات توقف FloodWait مرة واحدة على أنها probe.skipped.

Telethon .session#

ما هي هذه الأداة؟ قاعدة بيانات SQLite التي تنشئها الأدوات القائمة على Telethon، على سبيل المثال my_account.session
معترف بها من قبل الجداول sessions (مع dc_id، server_address، port، auth_key) وversion = 7 أو 8
المتطلبات صف واحد فقط من الجلسات المصرح بها؛ قاعدة بيانات مغلقة وكاملة

أغلق أولاً البرنامج الذي أنشأ الملف. إذا كان my_account.session-journal أو my_account.session-wal موجودًا بجانبه، فهذا يعني أن قاعدة البيانات لم تكتمل بعد: افتح العميل الأصلي وأغلقه بشكل صحيح. قد يؤدي حذف ملفات «sidecar» هذه إلى ترك نسخة تالفة.

Pyrogram .session#

ما هي هذه الأداة؟ قاعدة بيانات SQLite التي تنشئها الأدوات القائمة على Pyrogram
معترف بها من قبل الجدول sessions مع dc_id، auth_key، test_mode، user_id، is_bot؛ version = 2 أو 3
المتطلبات جلسة مستخدم واحدة مصرح بها على شبكة الإنتاج. يتم رفض جلسات الروبوتات وجلسات مراكز البيانات التجريبية

يتم التحقق من معرّف المستخدم المخزّن مقابل Telegram أثناء تسجيل الدخول.

زوج من الجلسة وملف JSON#

غالبًا ما يتم توزيع الحسابات على شكل ملفين يحملان الاسم نفسه، على سبيل المثال 447700900123.session و447700900123.json. حدد كلا الملفين في آن واحد.

  • من ملف JSON، تستخدم TgWitness app_id/api_id وapp_hash/api_hash، لذا لا يتعين عليك عادةً إدخال بيانات اعتماد واجهة برمجة التطبيقات (API).
  • يستخدم ملف تعريف الاتصال device_model (الاسم المستعار device)، وsystem_version (الاسم المستعار sdk)، وapp_version، وlang_code، وsystem_lang_code (الاسم المستعار system_lang_pack)، و lang_pack، وtz_offset الاختياري (بالثواني من توقيت UTC، من -43200 إلى 50400). تكون للحقول المُقدَّمة الأولوية على القيم الافتراضية المُولَّدة ولغة اللوحة/المتصفح . يتم رفض الأسماء المستعارة المتعارضة. يتم حفظ ملف التعريف المُحلَّل في بيانات اعتماد مساحة العمل المشفرة وإعادة استخدامه بعد إعادة التشغيل، بما في ذلك إصدار التطبيق الخاص به.
  • يتم تجاهل phone وإعدادات الوكيل ورموز الجهاز . twoFA للقراءة فقط عند تحديد إنشاء ترخيص مستقل؛ أما الاستيراد المباشر فيتجاهله.
  • ملف JSON الذي لا يحتوي على حقل ترخيص مدعوم هو مجرد بيانات وصفية. أضف ملف الجلسة الخاص به أو تابع باستخدام تسجيل الدخول عبر الهاتف أو رمز الاستجابة السريعة (QR). يمكن لملف JSON الذي يحتوي على جلسة مدعومة أو مفتاح ترخيص (Auth Key) أن يقوم بالترخيص من تلقاء نفسه؛ انظر Account JSON.

Telegram Desktop (TData)#

TData هو المجلد tdata الخاص بتطبيق Telegram Desktop (التطبيق متعدد المنصات المتوفر على desktop.telegram.org).

النظام الموقع الافتراضي لـ tdata
Windows %APPDATA%\Telegram Desktop\tdata (Telegram المحمول: بجوار Telegram.exe)
Linux ~/.local/share/TelegramDesktop/tdata
macOS ~/Library/Application Support/Telegram Desktop/tdata

لاستيرادها:

تحذير بشأن الجلسات المتوازية. الاستيراد المباشر لـ TData يعيد استخدام مفتاح التفويض الخاص بـ Telegram Desktop. لا تستخدم هذا المفتاح في Desktop و TgWitness في آن واحد. قد يقوم Telegram بإبطال صلاحية التفويض مع AUTH_KEY_DUPLICATED، مما يجعل كلا النسختين غير قابلتين للاستخدام حتى تسجيل الدخول من جديد.

أغلق Desktop تمامًا، بما في ذلك العملية الموجودة في علبة النظام، وحافظ على إغلاق تلك النسخة أثناء استخدام TgWitness للجلسة المستوردة. : أغلق البرنامج، ولا تقم بتسجيل الخروج أو إلغاء الجلسة: إلغاء الجلسة يؤدي أيضًا إلى إبطال صلاحية النسخة المستوردة. إذا كنت بحاجة إلى تشغيل كلا العميلين، فحدد إنشاء تفويض مستقل وأبقِ Desktop مغلقًا حتى يتم تسجيل الدخول الجديد بنجاح، أو قم بتسجيل الدخول إلى TgWitness عبر الهاتف أو رمز الاستجابة السريعة (QR). يُنصح باستخدام حساب مخصص، لكن ذلك لا يجعل استخدام المفاتيح المستنسخة بالتوازي آمنًا.

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

  1. أغلق تطبيق Telegram Desktop تمامًا.
  2. قم بإنشاء ملف ZIP يحتوي فقط على هذين العنصرين من tdata:

    • key_datas
    • الملف المكون من 16 حرفًا الذي ينتهي بـ «s» بجانبه، وعادةً ما يكون «D877F783D5D3EF8Cs»

    عادةً ما يتجاوز ضغط المجلد بأكمله مع ذاكرة التخزين المؤقتة للوسائط الحدود المسموح بها (512 إدخالًا، 32 ميغابايت بعد فك الضغط). 3. حدد ملف ZIP في قسم «الملفات». إذا كان لدى Telegram Desktop رمز مرور محلي، فأدخله أولاً في حقل «رمز المرور» أو نص الجلسة. هذه ليست كلمة مرور المصادقة الثنائية (2FA).

ميزات مدعومة: حساب واحد لكل أرشيف، تخزين حديث بنظام key_datas/key_data0/key_data1، ورمز مرور محلي. ميزات غير مدعومة: المجلدات التي تحتوي على عدة حسابات مسجلة الدخول، وتصميمات سطح المكتب القديمة، وملفات ZIP المحمية بكلمة مرور، والتطبيق الأصلي المنفصل لنظام macOS «Telegram for macOS».

Telethon StringSession#

سطر واحد من النص، يبدأ عادةً بـ 1 ويبلغ طوله حوالي 350 حرفًا. قم بتحميله كملف .txt أو .tgwitness-session (بحد أقصى 4 كيلوبايت)، أو الصقه تحت «رمز المرور» أو «نص الجلسة». لا تُقبل سوى سلاسل Telethon؛ أما سلاسل Pyrogram وTDLib فتستخدم تنسيقات مختلفة.

مفتاح المصادقة و DC في سطر واحد#

غالبًا ما تحتوي قوائم الحسابات على التفويض الخام بالصيغة <512 hexadecimal characters>:<DC id>، على سبيل المثال a1b2…ef:5. الصق هذا السطر تحت Passcode أو نص الجلسة، أو قم بتحميله كملف نصي، أو ضعه في حقل session في ملف JSON الخاص بالحساب. يقوم TgWitness بتعيين DC 1–5 إلى نفس عناوين الإنتاج المستخدمة في استيراد JSON لـ auth_key + dc_id، ويبلغ عن التنسيق على أنه Auth key HEX وDC. يتم رفض أي رقم DC آخر أو طول مفتاح آخر.

حساب JSON#

كائن JSON واحد، بحجم 64 كيلوبايت كحد أقصى، في ملف ينتهي بـ .json.

الحقل (الأسماء المستعارة) المعنى
api_id (app_id) معرّف التطبيق، وهو عدد موجب
api_hash (app_hash) هاش التطبيق، 32 حرفًا سداسي عشريًّا
string_session (session_string، session_str؛ session القديمة) نص StringSession الخاص بـ Telethon، أو <512 hexadecimal characters>:<DC id>، وليس اسم ملف
auth_key (auth_key_hex) + dc_id مفتاح المصادقة الكامل المكون من 512 حرفًا وDC 1–5
user_id (id) اختياري؛ تتم المقارنة مع Telegram قبل حفظ التفويض
device_model (device) وصف جهاز الاتصال
system_version (sdk) إصدار نظام التشغيل المتصل
app_version إصدار التطبيق الذي تم إرساله إلى Telegram
lang_code, system_lang_code (system_lang_pack), lang_pack لغة العميل، ولغة النظام، وحزمة لغة العميل؛ يُسمح بوجود قيمة فارغة لـ lang_pack
tz_offset فارق التوقيت عن التوقيت العالمي المنسق (UTC) اختياري بالثواني، يُرسل في initConnection.params؛ سلسلة أعداد صحيحة أو أعداد صحيحة عشرية

في حالة وجود كل من الاسم المستعار والاسم الرئيسي، يجب أن يتطابقا. تحظى حقول جلسة Telethon الصريحة بالأولوية على كتلة session عامة بتنسيق آخر. إذا كان كلاهما يحتوي على جلسات Telethon يمكن التعرف عليها، فيجب أن تصف نفس التفويض. في حالة عدم وجود حقل صريح، يجب أن يكون session عبارة عن StringSession صالح لـ Telethon أو مفتاح تفويض و DC بالصيغة <512 hexadecimal characters>:<DC id>. أمثلة:

{ "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" }
{
  "api_id": 1234567,
  "api_hash": "0123456789abcdef0123456789abcdef",
  "auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS",
  "dc_id": 2,
  "user_id": 123456789
}

المثال الأول يملأ بيانات اعتماد واجهة برمجة التطبيقات (API) فقط؛ قم بتسجيل الدخول عبر الهاتف أو رمز الاستجابة السريعة (QR)، أو أضف ملف جلسة. لا تُقبل القوائم المجمعة (مصفوفة JSON للحسابات).

حدد ما لديك#

كما ترى إنه الاستخدام
*.session؛ عند فتحه في محرر نصوص، يظهر SQLite format 3 في الأعلى Telethon أو Pyrogram SQLite الملفات (يتم اكتشافها تلقائيًا)
مجلد «tdata» يحتوي على «key_datas» Telegram Desktop TData ضغط الملفين في ملف ZIP، ثم «الملفات»
سطر نصي واحد يبدأ بـ 1، حوالي 350 حرفًا Telethon StringSession الملفات
سطر نصي واحد 512 characters 0-9a-f، ثم : ورقم من 1 إلى 5 مفتاح المصادقة و DC الملفات، رمز مرور الصندوق، أو نص الجلسة
*.json مع app_id/app_hash البيانات الوصفية المصاحبة الملفات، إلى جانب جلستها
*.json مع auth_key أو string_session حساب JSON الملفات
512 حرفًا 0-9a-f مفتاح المصادقة مفتاح المصادقة
32 حرفًا 0-9a-f تجزئة واجهة برمجة التطبيقات (API) معرف واجهة برمجة التطبيقات (API) + التجزئة
td.binlog أو db.sqlite من تطبيق TDLib تخزين TDLib غير مدعوم
123456789:AA… رمز البوت غير مدعوم

التنسيقات غير المدعومة#

التنسيق بديل
تخزين TDLib (td.binlog) وعمليات تصدير TDLib تسجيل الدخول عبر الهاتف أو رمز الاستجابة السريعة (QR)
سلاسل جلسات Pyrogram استخدم ملف Pyrogram .session، أو الهاتف/رمز الاستجابة السريعة (QR)
TData مع عدة حسابات مسجلة الدخول قم بتسجيل الخروج من الحسابات الأخرى في Telegram Desktop، أو استخدم ملف الجلسة الخاص بكل حساب
رموز البوت غير مدعوم: تراقب TgWitness بصفتها حساب مستخدم
قوائم CSV/JSON للعديد من الحسابات استورد ملفات الجلسات المدعومة عبر الحسابات → استيراد الحسابات، أو سجّل الدخول عبر الهاتف/رمز QR في مساحات عمل منفصلة
Test-DC أو جلسات البوت استخدم حساب مستخدم فعلي

حسابات متعددة#

اضغط على + بجانب محدد الحساب، أو افتح المزيد من الأدوات → الحساب → الإعدادات → إعدادات الاتصال → مساحات العمل، وأدخل تسمية ثم سجّل الدخول.

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

الاستيراد الجماعي ومجموعات الحسابات#

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

تجمع المجموعة الحسابات ذات الصلة معًا دون دمج جلساتها أو مفاتيحها أو أدلتها. يؤدي فتح المجموعة في قسم «الحسابات» إلى صفحتها على /groups/<id>:

  • الحسابات: مسار اتصال كل عضو، وملاحظاته، وآخر رسالة له، مع بدء الكل وإيقاف كل شيء مؤقتًا.
  • يحتاج إلى انتباه: الحسابات التي تم تسجيل الخروج منها، أو غير المتاحة، أو التي تعاني من مشكلة في الاتصال أو الاستقبال أو المصدر أو الوسائط؛ كل اسم يؤدي إلى بطاقته.
  • ترى المحادثات عبر عدة حسابات: المصادر المشتركة، والحسابات التي تراقبها، و الانقطاعات في فترة المراقبة المتاحة لمساحة العمل (حتى سبعة أيام). يؤدي التصدير باستخدام N حسابات إلى تقسيم تصدير القناة أو المجموعة الفائقة بينها وتوقيع أرشيف واحد.
  • تصدير المجموعة: صورة واحدة ZIP مع التصدير الموقّع لكل حساب تحت accounts/ و manifest.json مع إدراج بصمات SHA-256 وبصمات المفاتيح الخاصة بها، موقعة من قبل مساحة العمل الرئيسية في manifest.signature.json. تحقق من أرشيف كل حساب على حدة باستخدام python -m tgwitness.verify وبصمة الإصبع الموثوقة لذلك الحساب.

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

تسجيل الخروج#

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

عندما ينهي Telegram الجلسة#

إذا قام Telegram بحظر الحساب أو تجميده أو تسجيل الخروج منه، أو إنهاء الجلسة من جهاز آخر، فإن السجل يسجل السبب وخطأ Telegram والمسار ومركز البيانات. تُظهر حالة الحساب خيار «تنزيل تقرير فقدان الحساب»: وهو ملف JSON موقّع يحتوي على سجلات الـ 24 ساعة التي سبقت الفقدان، وتحديدًا الاتصالات والمسارات والجلسات وإشعارات الحساب وفجوات التغطية، كل منها مع تجزئة السجل وتوقيعه. تحقق من ذلك باستخدام python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP؛ حيث يحتوي تصدير الأدلة على سلسلة التجزئة الكاملة. يتم أيضًا اكتشاف الحساب المجمد عند اتصاله وأثناء المراقبة، ويتم إيقاف إجراءات الإرسال والانضمام الخاصة به.

الحفاظ على أمان ملفات الحسابات#

  • تعامل مع كل .session وملف TData ZIP وStringSession ومفتاح المصادقة وملف JSON الخاص بالحساب كما لو كان كلمة مرور. تحتفظ TgWitness بتفويضات الدخول المستوردة في خزينة مشفرة؛ ويمكنك إزالة الملفات الأصلية بعد ذلك.
  • لا تقم بتشغيل نفس التفويض في برنامجين في آن واحد. فقد يقوم Telegram بإلغائه (AUTH_KEY_DUPLICATED)، وستتوقف النسختان عن العمل.
  • لا يمكن إعادة تنشيط جلسة منتهية الصلاحية أو تم إلغاؤها عن طريق التحويل. يرجى تسجيل الدخول مرة أخرى.

حل المشكلات#

رسالة أم أعراض ما يجب فعله
يتعذر قراءة هذه الجلسة. أغلق العميل الأصلي... ملف SQLite مفتوح أو غير مكتمل (ملف -journal/-wal المرافق). أغلق البرنامج الأصلي بشكل صحيح وانسخ الملف مرة أخرى.
مخططات Telethon SQLite المدعومة: 7 و8 / Pyrogram … 2 و 3 تم إنشاء الملف باستخدام إصدار قديم جدًّا أو غير معروف من المكتبة. قم بتسجيل الدخول عبر الهاتف/رمز الاستجابة السريعة (QR) بدلاً من ذلك.
لا يتم دعم سوى جلسات المستخدمين المصرح لهم بالإنتاج ينتمي ملف Pyrogram إلى روبوت أو إلى شبكة الاختبار.
يتجاوز حجم أرشيف TData 512 إدخالًا أو 32 ميغابايت ملف ZIP يحتوي فقط على key_datas وD877F783D5D3EF8Cs، وليس المجلد بأكمله.
يتعذر فك تشفير TData. تحقق من رمز المرور المحلي لسطح المكتب أدخل رمز المرور المحلي لـ Telegram Desktop في حقل «رمز المرور» أو نص الجلسة.
استيراد حساب TData واحد في كل مرة كان لدى Telegram Desktop عدة حسابات؛ انظر «التنسيقات غير المدعومة».
تصف الملفات المختارة حسابات مختلفة أو بيانات اعتماد واجهة برمجة التطبيقات (API) اختر ملفات حساب واحد فقط.
لا يحتوي ملف JSON على أي بيانات اعتماد أو تفويضات مدعومة لواجهة برمجة التطبيقات (API) تحقق من أسماء الحقول في ملف JSON الخاص بالحساب.
بيانات تعريف واجهة برمجة التطبيقات (API) فقط لا يحتوي ملف JSON على جلسة عمل. أضف الملف .session أو استخدم الهاتف/رمز الاستجابة السريعة (QR).
يجب أن يحتوي مفتاح المصادقة HEX على جميع الأحرف الـ512 السداسية العشرية المفتاح مقطوع أو يحتوي على ….
معرف الحساب لا يتطابق مع الحساب المستورد يختلف معرّف المستخدم الخاص بالملف عما أوردته Telegram؛ فالملف يخص حسابًا آخر.
الحساب مملوك بالفعل لمساحة عمل أخرى افتح مساحة العمل تلك بدلاً من إضافة الحساب مرتين.
متصل، لكن هناك مجموعة خاصة مفقودة من قائمة الدردشة في المزيد من الأدوات → المصادر تحقق من العضوية. يقوم المختار بفحص أول 1,000 حوار؛ قم برفع الحد الأقصى من خلال المزيد من الأدوات → المعلمات.
فشل الاتصال عبر الوكيل تحقق من المسار ووضع IP. يحاول الوضع التلقائي MTProxy إدخالًا آخر فعالًا. يظل وضع «إخفاء العنوان» في حالة انتظار؛ أما الوضع «مباشر» (كملاذ أخير) فيمكنه الاتصال مباشرةً بعد انقضاء فترة التأخير المحددة. انظر أوضاع التوجيه.

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