فرمت‌های حساب کاربری و جلسه

TgWitness به عنوان یک حساب کاربری تلگرام (نه یک ربات) از طریق MTProto، با استفاده از Telethon، وارد می‌شود. هر حساب در فضای کاری خود (که در API و ابزارهای خط فرمان به آن workspace گفته می‌شود) با جلسه، منابع، دفترچه یادداشت و کلید امضای مخصوص به خود قرار دارد.

فایل‌های جلسه، رشته‌های جلسه و کلیدهای احراز هویت، مجوزهای حساب کاربری هستند: هر کسی که یکی از آن‌ها را در اختیار داشته باشد می‌تواند به‌عنوان آن حساب کاربری عمل کند. آن‌ها حاوی تاریخچه پیام‌ها نیستند.

[!هشدار] از هر چیزی که تحمل از دست دادن آن را ندارید، استفاده نکنید. ما قویاً توصیه می‌کنیم که حساب‌های شخصی یا هر حساب باارزش دیگری را متصل نکنید و روی حسابی که برایتان ارزش دارد، شناسه API / هش API ایجاد نکنید. این موضوع به معنای آزمایش‌نشده بودن TgWitness نیست: تلگرام حساب‌ها را به طور غیرقابل پیش‌بینی محدود و برای همیشه مسدود می‌کند — به دلیل حجم درخواست‌هایی که آن را بیش از حد می‌داند، صرف‌نظر از کلاینت یا هدف، و بدون هیچ‌گونه مستندات کافی. بسیاری از این مسدودسازی‌ها برگشت‌ناپذیر هستند. از حساب‌های اختصاصی استفاده کنید. اجرای روان تست‌ها به تلگرام بستگی دارد، نه به نرم‌افزار، و هیچ تضمینی برای آینده ندارد.

• نگاهی اجمالی
• قبل از شروع: شناسهٔ API و هش API
• شماره تلفن · کد QR · کلید اuth + شناسه DC
• فایل‌های حساب: تله‌تون .جلسه · پایروگرام .session · جفت جلسه + JSON · TData · رشتهٔ جلسه · JSON حساب
• شناسایی کنید که چه چیزی در اختیار دارید · فرمت‌های پشتیبانی‌نشده
• حساب‌های متعدد · حفظ امنیت فایل‌های حساب · عیب‌یابی

نگاهی اجمالی#

TgWitness فایل‌ها را بر اساس محتویاتشان شناسایی می‌کند، نه بر اساس نامشان. تغییر نام یک فایل هرگز آن را تبدیل نمی‌کند.

قبل از شروع: شناسهٔ API و هش API#

شما می‌توانید بدون ایجاد یک اپلیکیشن تلگرام API وارد شوید. هنگامی که هیچ جفتی وارد نشده، وارد نشده یا از قبل در فضای کاری ذخیره نشده باشد، TgWitness یک جفت را به صورت تصادفی از مجموعه داخلی ۵۰ جفت API عمومی (tgwitness/api_pool.py) خود انتخاب می‌کند. اگر تلگرام یک جفت را رد کند (API_ID_INVALID, API_ID_PUBLISHED_FLOOD, UPDATE_APP_TO_LOGIN)، جفت بعدی امتحان می‌شود، تا هشت جفت در هر ورود؛ جفت‌های رد شده تا زمان راه‌اندازی مجدد نادیده گرفته می‌شوند. جفتی که با آن وارد شده است با حساب کاربری ذخیره شده و برای آن حساب مجدداً استفاده می‌شود. یک شناسه API و هش API، اپلیکیشن را به تلگرام معرفی می‌کنند؛ آنها به خودی خود حساب کاربری را تأیید نمی‌کنند.

برای استفاده از برنامهٔ خود به جای آن (حساب کاربری که آن را ثبت می‌کند در معرض خطر است؛ ببینید: چرا استخر API داخلی؟):

1. وب‌سایت my.telegram.org را باز کنید و با هر شماره تلفنی که مالک آن هستید وارد شوید. کد به اپلیکیشن تلگرام ارسال می‌شود، نه از طریق پیامک.
2. ابزارهای توسعهٔ API را انتخاب کنید.
3. یک برنامه ایجاد کنید: هر عنوان و نام کوتاه (۵–۳۲ حرف)، پلتفرم دسکتاپ. URL و توضیحات می‌توانند خالی بمانند.
4. ID اپلیکیشن api_id (یک عدد) و هش اپلیکیشن api_hash (۳۲ کاراکتر هگزادسیمال) را کپی کنید.

در پنل، شناسه API + هش را زیر فرم ورود پیدا کنید. می‌توانید یک جفت api_id:api_hash را در شناسه API بچسبانید و هر دو فیلد پر می‌شوند. یک جفت می‌تواند برای تمام حساب‌های کاربری شما استفاده شود. پس از ورود موفقیت‌آمیز، این جفت فقط در همان فضای کاری ذخیره و رمزگذاری می‌شود و هرگز به مرورگر بازگردانده نمی‌شود.

سه اعتبارنامه‌ی متفاوت درگیر هستند:

اگر تلگرام باید از طریق یک پروکسی دسترسی پیدا کند، ابتدا آن را در حساب کاربری → تنظیمات → تنظیمات اتصال → تغییر مسیر اتصال تنظیم کنید.

شماره تلفن#

1. حساب کاربری را باز کنید، به برگه «تلفن» بروید و شماره را به فرمت بین‌المللی وارد کنید، برای مثال +44 7700 900123. فاصله‌ها و خط‌های تیره به طور خودکار حذف می‌شوند.
2. روی ادامه کلیک کنید. شناسه API و هش می‌توانند خالی بمانند.
3. کدی را که تلگرام ارسال می‌کند وارد کنید (معمولاً به اپلیکیشن تلگرام؛ ارسال از طریق پیامک تضمین‌شده نیست).
4. اگر حساب کاربری احراز هویت دو مرحله‌ای داشته باشد، آن رمز عبور را وارد کنید. این توکن پنل نیست و کد عبور دستگاه نیز نیست.
5. شناسه حساب کاربری نمایش‌داده‌شده پس از ورود را بررسی کنید، سپس منابع را انتخاب کنید.

کدهای ورود و رمز عبور احراز هویت دو مرحله‌ای هرگز روی دیسک ذخیره نمی‌شوند.

کد QR#

از این زمانی استفاده کنید که حساب کاربری قبلاً در یک تلفن یا رایانه دیگر وارد شده باشد.

1. زبانه‌ی کد QR → نمایش کد QR. شناسهٔ API + هش می‌توانند خالی بمانند.
2. روی دستگاه وارد‌شده: تنظیمات → دستگاه‌ها → اتصال دستگاه دسکتاپ، کد را اسکن کرده و تأیید کنید.
3. در صورتی که تلگرام درخواست کند، رمز عبور ۲FA را در TgWitness وارد کنید.

تصویر QR به‌صورت محلی تولید می‌شود. کدها منقضی می‌شوند؛ برای تلاش مجدد روی «تولید کد QR دیگر» کلیک کنید. قفل کردن پنل، تغییر فضای کاری یا شروع ورود دیگری، کد در انتظار را لغو می‌کند.

کلید اuth + شناسه DC#

کلید احراز هویت (Auth Key) یک مجوز خام ۲۵۶ بایتی است که پشت هر جلسه تلگرام قرار دارد و به صورت ۵۱۲ کاراکتر هگزادسیمال، به همراه شماره مرکز داده DC 1–5 نوشته می‌شود.

1. کلید احراز هویت تب. کلید کامل را الصاق کنید؛ کلید کوتاه‌شده حاوی … کار نخواهد کرد.
2. شناسه DC ارائه‌شده همراه با کلید را انتخاب کنید.
3. اختیاری: شناسه کاربری را وارد کنید. در غیر این صورت، اگر تلگرام حساب متفاوتی را گزارش کند، TgWitness از اتصال خودداری می‌کند.
4. روی حساب Connect کلیک کنید.

یک کلید احراز هویت (۵۱۲ کاراکتر) با هش API (۳۲ کاراکتر) یکسان نیست. همین کلید همچنین می‌تواند به صورت JSON وارد شود، به JSON حساب کاربری مراجعه کنید.

فایل‌های حساب#

گزینه «حساب جدید» را باز کنید → «فایل‌ها» را انتخاب کرده و تا چهار فایل متعلق به یک حساب (در مجموع ۸ مگابایت) را برگزینید، سپس دکمه «اتصال حساب» را فشار دهید.

• فایل‌ها در حافظه‌ی سرور TgWitness شما تبدیل می‌شوند. بارگذاری‌ها ذخیره نمی‌شوند، فایل‌های ZIP روی دیسک استخراج نمی‌شوند و هیچ سرویس خارجی‌ای درگیر نمی‌شود.
• سپس جلسهٔ حاصل با تلگرام بررسی می‌شود. اگر یک فایل شناسهٔ کاربر را مشخص کند، باید با حسابی که تلگرام گزارش می‌کند مطابقت داشته باشد.
• فایل‌هایی که حساب‌های مختلف یا اعتبارنامه‌های API متفاوت را توصیف می‌کنند، به جای انتخاب یکی، رد می‌شوند.
• کد عبور یا متن جلسه، فیلد رمز عبور محلی TData را در بر می‌گیرد، یک کادر برای چسباندن یک StringSession و فایل‌های Read بدون نیاز به ورود (فرم را بدون تماس با تلگرام پر می‌کند).

تله‌تون .session#

ابتدا برنامه‌ای را که فایل را ایجاد کرده است ببندید. اگر فایل‌های my_account.session-journal یا my_account.session-wal در کنار آن وجود داشته باشد، پایگاه داده نهایی نشده است: کلاینت اصلی را به درستی باز و ببندید. حذف این فایل‌های جانبی (sidecar) می‌تواند یک نسخه خراب به جا بگذارد.

پایروگرام .session#

شناسه کاربری ذخیره‌شده هنگام ورود با تلگرام بررسی می‌شود.

جفت جلسه + JSON#

حساب‌ها اغلب به صورت دو فایل با نام یکسان توزیع می‌شوند، برای مثال 447700900123.session و 447700900123.json. هر دو را همزمان انتخاب کنید.

• از روی JSON، TgWitness از app_id/api_id و app_hash/api_hash استفاده می‌کند، بنابراین معمولاً نیازی به وارد کردن اعتبارنامه‌های API ندارید.
• میدان‌های دیگر مانند phone، device، sdk، app_version، lang_pack یا رمز عبور ذخیره‌شده twoFA نادیده گرفته می‌شوند. اگر حساب دارای احراز هویت دو مرحله‌ای باشد، TgWitness آن را درخواست می‌کند.
• یک JSON به خودی خود تنها متادیتا است. بدون فایل جلسه، با ورود از طریق تلفن یا QR ادامه دهید.

تلگرام دسکتاپ (TData)#

TData پوشهٔ tdata در اپلیکیشن Telegram Desktop (اپلیکیشن چندسکویی از desktop.telegram.org) است.

برای وارد کردن آن:

هشدار جلسه موازی. وارد کردن TData از کلید مجوز تلگرام دسکتاپ استفاده مجدد می‌کند؛ این کار یک ورود مستقل ایجاد نمی‌کند. از آن کلید به طور همزمان در دسکتاپ و TgWitness استفاده نکنید. تلگرام می‌تواند با خطای AUTH_KEY_DUPLICATED مجوز را باطل کند و هر دو نسخه را تا زمان ورود مجدد غیرقابل استفاده رها سازد.

کلاینت دسکتاپ را به طور کامل، شامل فرآیند سینی (tray) آن، ترک کنید و در حالی که TgWitness از جلسه وارد شده استفاده می‌کند، آن کپی را بسته نگه دارید. خروج کنید، از جلسه خارج نشوید یا آن را لغو نکنید: لغو نیز نسخه واردشده را باطل می‌کند. اگر به اجرای همزمان هر دو کلاینت نیاز دارید، با تلفن یا QR وارد TgWitness شوید تا مجوز مخصوص به خود را ایجاد کنید. استفاده از یک حساب کاربری اختصاصی توصیه می‌شود، اما این کار کلیدهای کلون‌شده را برای استفاده همزمان ایمن نمی‌سازد.

این امر در مورد موارد وارد شده نیز صدق می‌کند .session فایل‌ها، متن StringSession و هگز Auth Key. سایر کلاینت‌ها با مجوزهای مستقل خود می‌توانند به حالت ورود باقی بمانند. به مستندات AUTH_KEY_DUPLICATED تلگرام مراجعه کنید.

1. کاملاً از تلگرام دسکتاپ خارج شوید.

2. یک فایل ZIP ایجاد کنید که فقط شامل این دو مورد از tdata باشد:

   • key_datas
   • پایان فایل ۱۶ کاراکتری که با s خاتمه می‌یابد، در کنار آن، معمولاً D877F783D5D3EF8Cs

   زیپ کردن کل پوشه به همراه کش رسانه‌ای آن معمولاً از محدودیت‌ها (۵۱۲ مورد، ۳۲ مگابایت بدون فشرده‌سازی) فراتر می‌رود. ۳. در بخش «فایل‌ها»، زیپ را انتخاب کنید. اگر تلگرام دسکتاپ رمز عبور محلی دارد، ابتدا آن را در قسمت «رمز عبور» یا متن جلسه وارد کنید. این رمز عبور احراز هویت دو مرحله‌ای (2FA) نیست.

پشتیبانی‌شده: یک حساب در هر آرشیو، ذخیره‌سازی مدرن key_datas/key_data0/key_data1، رمز عبور محلی. پشتیبانی‌نشده: پوشه‌هایی با چندین حساب واردشده، طرح‌بندی‌های قدیمی‌تر دسکتاپ، فایل‌های ZIP محافظت‌شده با رمز عبور، و اپلیکیشن بومی جداگانه macOS به نام «Telegram for macOS».

جلسه رشته‌ای تله‌تون#

یک خط متن، معمولاً با شروع با 1 و با طول حدود ۳۵۰ کاراکتر. آن را به عنوان یک فایل .txt یا .tgwitness-session (حداکثر ۴ کیلوبایت) بارگذاری کنید، یا آن را زیر متن رمز عبور یا جلسه قرار دهید. فقط رشته‌های تله‌تون پذیرفته می‌شوند؛ رشته‌های Pyrogram و TDLib از فرمت‌های متفاوتی استفاده می‌کنند.

JSON حساب#

یک شیء JSON، حداکثر ۶۴ کیلوبایت، در فایلی با پسوند .json.

اگر هم نام مستعار و هم نام اصلی موجود باشند، باید با هم مطابقت داشته باشند. مثال‌ها:

{ "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 از حساب‌ها) پذیرفته نمی‌شوند.

شناسایی کنید که چه چیزی در اختیار دارید#

فرمت‌های پشتیبانی‌نشده#

حساب‌های متعدد#

روی + در کنار انتخابگر حساب کاربری ضربه بزنید، یا مسیر حساب کاربری → تنظیمات → تنظیمات اتصال → فضاهای کاری را باز کنید، یک برچسب وارد کرده و وارد شوید.

• هر تعداد فضای کاری، از جمله فضای اصلی. هر کدام دارای جلسه، مسیر پروکسی، منابع، سیاست ضبط، دفترچه شواهد، کلید امضا، نقاط کنترل و خروجی‌های خود هستند.
• تغییر فضای کاری نمایش‌داده‌شده، سایر فضاها را متوقف نمی‌کند.
• یک ژورنال به حساب کاربری که آن را ایجاد کرده متصل می‌ماند. ورود به سیستم با حساب کاربری متفاوت نیازمند یک فضای کاری دیگر است و یک حساب نمی‌تواند به دو فضای کاری اختصاص یابد.
• توکن پنل اصلی بر تمام فضاهای کاری کنترل دارد. دسترسی صادرشده می‌تواند افراد دیگر را به حساب‌ها و چت‌های منتخب محدود کند، با مجوزهای جداگانه و محدودیت‌های جلسه.
• حساب‌ها یک فضای کاری را بازنامه‌گذاری می‌کند و یکی از فضاهای کاری افزوده‌شده را همراه با جلسه، دفترچه، منابع و کلید امضای آن حذف می‌کند. فضای کاری اصلی را نمی‌توان از پنل حذف کرد.

ورود دسته‌ای و گروه‌های حساب#

از حساب‌ها → وارد کردن حساب‌ها برای افزودن چند حساب، جفت‌کردن فایل‌ها بر اساس نام پایه و دیدن نتیجه هر ورود استفاده کنید. هر حساب فضای کاری جداگانه‌ای دارد. گروه‌ها می‌توانند تنظیمات انتخابی را از یک الگو کپی کنند، بدون ادغام نشست‌ها، کلیدها یا شواهد. به راهنمای ورود و گروه‌ها و داشبورد مخزن MTProxy مراجعه کنید.

خروج#

گزینه حساب → خروج از تلگرام (با توقف مشاهده) از تلگرام می‌خواهد که جلسه را پایان دهد، بنابراین این جلسه از بخش تنظیمات → دستگاه‌ها در حساب کاربری نیز ناپدید می‌شود و از گاوصندوق فضای کاری حذف می‌گردد. دفترچه یادداشت، منابع، تنظیمات و کلید امضا باقی می‌مانند و دفترچه یادداشت، خروج را ثبت می‌کند. محیط کاری همچنان متعلق به حساب کاربری خود است: فقط همان حساب کاربری می‌تواند دوباره به آن متصل شود. اگر تلگرام پاسخی ندهد، جلسه همچنان در اینجا حذف می‌شود و پنل این موضوع را اعلام می‌کند؛ جلسه را در تلگرام تحت «تنظیمات → دستگاه‌ها» پایان دهید.

جلسه تله‌تون را به‌صورت آفلاین تبدیل کنید#

پنل فایل‌های .session را مستقیماً وارد می‌کند. برای تبدیل آفلاین به یک فایل StringSession، از پوشه پروژه اجرا کنید:

.venv\Scripts\python.exe -m tgwitness.sessions account.session --out account.tgwitness-session   # Windows

.venv/bin/python -m tgwitness.sessions account.session --out account.tgwitness-session          # Linux/macOS

این مبدل فقط از Telethon SQLite (تا ۶۴ مگابایت) خواندن می‌کند، هرگز ورودی را تغییر نمی‌دهد، هیچ درخواست شبکه‌ای انجام نمی‌دهد و از بازنویسی فایل خروجی موجود خودداری می‌کند.

حفظ امنیت فایل‌های حساب#

• با هر .session، فایل ZIP TData، StringSession، کلید احراز هویت و JSON حساب کاربری مانند یک رمز عبور رفتار کنید. TgWitness مجوز واردشده را در گاوصندوق رمزگذاری‌شده خود نگه می‌دارد؛ شما می‌توانید بعداً فایل‌های اصلی را حذف کنید.
• یک مجوز را همزمان در دو برنامه اجرا نکنید. تلگرام ممکن است آن را لغو کند (AUTH_KEY_DUPLICATED)، و هر دو نسخه از کار می‌افتند.
• یک جلسه منقضی‌شده یا لغوشده را نمی‌توان با تبدیل احیا کرد. دوباره وارد شوید.

عیب‌یابی#

همچنین ببینید: اتصال و امنیت برای پروکسی‌ها و رمزگذاری، و نحوه کارکرد جمع‌آوری برای آنچه پس از ورود ثبت می‌شود.