TgWitness / مستندسازی

آنچه آزمایش شده است ←

منبع / راه‌اندازی

Telegram · راه‌اندازی اولیه و تنظیمات

جادوگر راه‌اندازی، اهداف، سطوح رابط، مسیرهای اتصال و تنظیمات مشترک یک گروه حساب.

TgWitness / مستندسازی · شروع کار

شروع کار

حساب‌ها · اتصال · دسترسی

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

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

/settings همان رکوردهایی را ویرایش می‌کند که ویزارد ویرایش می‌کند. جست‌وجو فیلدهای اصلی، پارامترها و فرم‌های گسترده را پوشش می‌دهد؛ یک فیلد پنهان را می‌توان بدون تغییر سطح باز کرد. سطح‌ها فقط آنچه نمایش داده می‌شود را تغییر می‌دهند: سرور مجوزها را خودش بررسی می‌کند. بخشی که همهٔ تنظیماتش بالاتر از سطح انتخاب‌شده است، باز هم آن‌ها را نشان می‌دهد. تنظیمات گردآوری و نخستین اتصال بر عهدهٔ مدیر فضای کاری است.

صفحهٔ تنظیمات یک فهرست است. کارت حساب در بالا حساب تلگرام را باز می‌کند. زیر آن هر ردیف یک بخش و مقدار در حال استفاده را نام می‌برد: کدام گفتگوها؟ و اتصال زیر حساب؛ هدف، ضبط و فایل‌ها، حفاظت از ضبط و اعلان‌ها و نسخه بیرونی زیر ضبط؛ زبان، زمان و ظاهر زیر پنل؛ و صفحه‌های تخصصی زیر ابزارهای بیشتر. کنار فهرست، کارتی نشان می‌دهد که آیا مقادیر پیشنهادی فعال‌اند، همراه با مقادیر اصلی و لغو آخرین تغییر، و تغییرات اخیر آخرین ویرایش‌ها را فهرست می‌کند.

یک بخش در پنجره‌ای بالای لیست باز می‌شود و آدرس مخصوص به خود را دارد، مانند /settings/connection. فلش بازگشت، دکمه بستن، کلید Esc، کلیک کردن خارج از پنجره و دکمه بازگشت مرورگر به لیست بازمی‌گردند. گزینه کدام چت‌ها؟ با ذخیره انتخاب چت حفظ می‌شود؛ بستن آن با تغییرات ذخیره‌نشده، ابتدا یک سؤال را مطرح می‌کند. ذخیره، انواع منبع، چت‌های مستثنی، اقدامات انجام‌شده و تنظیمات چت جدیدِ ابزارهای بیشتر → منابع → دامنه را حفظ می‌کند؛ چتی که از اینجا انتخاب شود، از فهرست چت‌های مستثنی حذف شده و به عنوان یک منبع دستی انتخاب‌شده ثبت می‌شود. هر تغییر به مدت ۲۰ ثانیه گزینه لغو (Undo) را نمایش می‌دهد و هر مورد در تغییرات اخیر (Recent changes) را می‌توان بعداً لغو کرد. یک عملیات «لغو» فقط تنظیماتی را که آن مورد تغییر داده بود، از جمله محدودیت‌های سفارشی فایل، بازمی‌گرداند. اگر یک تغییر بعدی همان تنظیمات را دستکاری کند، عملیات «لغو» رد می‌شود و هیچ تغییری رخ نمی‌دهد. یک عملیات «لغو» یک رکورد جدید با شناسه settings.changed در مجله (journal) ایجاد می‌کند.

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

نام‌های بخش‌ها در هر سطح یکسان باقی می‌مانند. برای تغییر سطح، ظاهر را در پایین نوار کناری باز کنید. راهنمای پنل هر بخش را توصیف می‌کند.

اهداف#

هدف مجموعه فایل‌ها خدمات خارجی آدرس سرور
فقط دانلود صادرات یک‌باره از صفحهٔ تنظیمات نهایی آغاز می‌شود؛ جمع‌آوری مداوم غیرفعال باقی می‌ماند. عکس‌ها تا ۲۰ مگابایت برچسب‌های زمانی خودکار
دنبال کردن چت‌ها مستمر عکس‌ها و ویدیوها تا ۶۰ ثانیه / ۲۰ مگابایت برچسب‌های زمانی و اعلان‌های مشکل خودکار
مدارک یک پرونده مستمر تمام فایل‌ها تا ۱ گیگابایت برچسب‌های زمانی، drand، اعلان‌ها خیر، آن را مخفی کن

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

تغییر هدف، ابتدا تفاوت را نشان می‌دهد و می‌توان تغییرات دستی را حفظ کرد. یک فیلد که با هدف متفاوت است، با عبارت «توسط شما تغییر کرده» علامت‌گذاری می‌شود و می‌توان آن را به حالت اولیه بازگرداند. بازنگری تنظیمات مانع از اعمال یک تفاوت بررسی‌شده بر روی تغییری می‌شود که در یک تب دیگر ایجاد شده است.

اتصال#

تا زمانی که یک مسیر در اینجا انتخاب نشود، یک فضای کاری جدید از Automatic MTProxy · لیست‌های عمومی با پنهان کردن آدرس (امنیت اتصال) استفاده می‌کند. انتخاب خودکار در پایین، یک مرحله تنظیم جداگانه است.

Automatic ابتدا WARP، سپس سرورهای عمومی MTProxy و در نهایت یک اتصال مستقیم را امتحان می‌کند، که مورد آخر تنها زمانی انجام می‌شود که آدرس سرور قابل نمایش باشد. Automatic و WARP می‌توانند اجزای دارای بررسی هش را نصب کرده و سرور را در Cloudflare ثبت کنند؛ بدون این رضایت، Automatic از WARP صرف‌نظر می‌کند. WARP از مدیر موجود wgcf/wireproxy و یک پورت محلی SOCKS5 استفاده می‌کند؛ جدول مسیریابی سیستم تغییر نمی‌کند.

واردات انبوه قبل از اینکه هر جلسه‌ای به تلگرام برسد، مسیر را می‌پرسد: WARP (پیش‌فرض)، MTProxy عمومی یا مستقیم. بررسی جلسه از همان نوع مسیر استفاده می‌کند، و هر حساب واردشده قبل از اولین ورود خود، تونل WARP مخصوص به خود را دریافت می‌کند.

پراکسی شما می‌پذیرد tg://proxy, socks5://, http:// و https://. گواهی یک پروکسی HTTPS قبل از ارسال اعتبارنامه‌ها به آن بررسی می‌شود.

بررسی اتصال به مدت پنج دقیقه معتبر است و به مسیر، سیاست و پاسخ‌های جادوگر بستگی دارد؛ تغییر هر یک از آن‌ها نیازمند یک بررسی جدید است. ادامه بدون بررسی امکان‌پذیر است و جایگزین ورود تلگرام نمی‌شود. مسیر انتخاب‌شده در پس‌زمینه مجدداً بررسی می‌شود و پس از قطع اتصال، «اتوماتیک» زنجیره خود را دوباره اجرا می‌کند. هنگامی که هیچ پروکسی عمومی پاسخی ندهد، شمارشگر با WARP و اقدامات بررسی مجدد به رنگ قرمز درمی‌آید.

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

حساب‌های یک گروه تنظیمات خود را به اشتراک می‌گذارند. در صفحهٔ تنظیمات یک حساب، حساب‌ها → گروه‌ها و تنظیمات مشترک → تنظیمات مشترک یا تنظیمات گروه را باز کنید.

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

  • هر عضو گروه را دنبال می‌کند. تنظیمات یک مقدار را علامت‌گذاری می‌کند 🔗 از گروه یا ✏️ مقدار خود؛ بازگشت به مقدار گروه آن را بازمی‌گرداند.
  • یک تغییر، حساب‌هایی را که شامل می‌شود فهرست می‌کند (در ۲ از ۳ حساب اعمال می‌شود) و پیش از جایگزینی مقدار خود، برای هر حساب جداگانه می‌پرسد. حساب‌های بدون تیک، مقدار خود را حفظ می‌کنند.
  • پارامتری که گروه به اشتراک نمی‌گذارد تا زمانی که اشتراک‌گذاری نمی‌شود: هر حساب مقدار خود را حفظ می‌کند را فشار دهید، باقی می‌مانداین مقدار را به اشتراک بگذارید.
  • کپی تنظیمات از یک حساب، مقادیر حساب انتخاب‌شده را به‌عنوان تنظیمات گروه در نظر می‌گیرد.
  • از حساب منتقل‌شده به گروه پرسیده می‌شود که آیا مقادیر گروه را بپذیرد؟ در غیر این صورت، مقادیر خود را که با ✏️ نشانه‌گذاری شده‌اند، حفظ می‌کند. حساب‌هایی که بعداً اضافه می‌شوند با مقادیر گروه شروع می‌کنند.
  • یک حساب ناظر حالت IP خود را تا زمان توقف حفظ می‌کند.

هر تغییر در دفترچهٔ ثبت‌شدهٔ فضای کاری اصلی و هر عضوی که شامل آن می‌شود، ثبت می‌گردد. حذف یک گروه، حساب‌های آن و مقادیر فعلی‌شان را حفظ می‌کند.

صفحه گروه /groups/<id> اعضا، مواردی که نیاز به توجه دارند و گفتگوهایی را که چندین حساب مشاهده می‌کنند، نشان می‌دهد. به گروه‌های حساب کاربری مراجعه کنید.

فضاهای کاری موجود#

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

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