# TgWitness: Telegram Export, OSINT & Verification

Canonical page: https://phishdestroy.github.io/TgWitness/docs/reference/overview/

Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads alongside their methods and limits.

[Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.github.io/TgWitness/llms.txt)

با یک دستور نصب شود یا در GitHub Actions اجرا گردد. گزینه‌های تحقیق، مقیاس منتشرشده و آنچه یک آرشیو تأیید می‌کند را درک کنید.

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

## با کاری که در اختیار دارید شروع کنید

| وظیفه شما | کوتاه‌ترین مسیر | آنچه دریافت می‌کنید |
| --- | --- | --- |
| ذخیره یک گفتگو یا حساب کاربری | نصب، اتصال حساب کاربری، انتخاب دامنهٔ خروجی | یک آرشیو امضا شده شامل تاریخچهٔ منتخب، نتایج جمع‌آوری و مواد تأیید |
| روی یک راه‌‌انداز موقت جمع‌آوری کنید | از GitHub Actions برای ضبط استفاده کنید، یک جلسهٔ جدید را مجاز کنید و دامنه را انتخاب کنید | یک آرشیو رمزگذاری‌شده با سوابق گردش کار گیت‌هاب |
| تغییرات را در طول زمان دنبال کنید | نظارت را برای چت‌های منتخب فعال نگه دارید | نسخه‌های ذخیره شده، اعلان‌های حذف، پیوست‌ها و پوشش ثبت‌شده |
| تحقیق کنید و یافته‌ها را به اشتراک بگذارید | در آرشیو جستجو کنید، از Case Board استفاده کنید و یک گزارش یا نسخه اشتراک‌گذاری را پیکربندی کنید | یافته‌های مرتبط با منبع و انتقال قابل راستی‌آزمایی مناسب برای دریافت‌کننده |

### نصب با یک دستور

نصب‌کننده شامل پایتون و وابستگی‌ها است. خروجی گرفتن از سورس، داکر، یک ارائه‌دهنده هوش مصنوعی و یک شاهد مستقل گزینه‌های اختیاری هستند، نه پیش‌نیازهای راه‌اندازی.

لینوکس / مک‌اواس:

```
curl -fsSL https://get.destroy.tools/install.sh | bash
```

ویندوز، در پاورشل یا Command Prompt:

```
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
```

پنل را باز کنید، حساب تلگرام خود را متصل کنید و دامنه جمع‌آوری را انتخاب کنید. نصب به خودی خود جمع‌آوری را آغاز نمی‌کند. [راهنمای نصب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/installation/) ، دسترسی محلی، سرورها، به‌روزرسانی‌ها و بررسی نسخه دانلود شده را توضیح می‌دهد.

برای یک اجرای موقت، [راهنمای GitHub Actions را](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) دنبال کنید. آن گردش کار به یک فورک گیت‌هاب، احراز هویت و یک رمز عبور بایگانی نیاز دارد. صفحه ضبط این مراحل و بودجه زمانی جلسه را پیش از اجرا توضیح می‌دهد. فایل بایگانی حاصل را دانلود و نگهداری کنید و همچنین مواد تأیید اعتبار آن را نیز نگه دارید.

## تنظیمات بیشتر زمانی که وظیفه به آن‌ها نیاز دارد

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

دامنه، مجوزها و نسخه‌های به اشتراک گذاشته شده بهینه‌سازی‌شده به اپراتورها کمک می‌کنند تا انتخاب کنند چه چیزی را جمع‌آوری و افشا کنند. راهنمایی‌های مربوط به صلاحیت قضایی و تنظیمات گزارش از این تصمیم پشتیبانی می‌کنند؛ انتخاب یک پروفایل به خودی خود موجب انطباق قانونی یا قابلیت پذیرش نمی‌شود. به [بخش‌های خروجی‌گیری حساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/account-export/)، [دسترسی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/) و [پیکربندی گزارش](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-reports/) مراجعه کنید.

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

## سوابق را حفظ کنید، هر کسی را که به نفعش است

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

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

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

این بررسی‌ها از بازبینی یکپارچگی و منشأ پشتیبانی می‌کنند. آن‌ها محتوای یک پیام را به یک گزارهٔ درست تبدیل نمی‌کنند یا پیام‌های حذف‌شده و دیده نشده را بازسازی نمی‌کنند. از اثر انگشت کلید به‌دست‌آمده به‌طور مستقل و مراحل تأیید در [راهنمای اعتماد](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) و [قالب مدرک](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) استفاده کنید.

## مقیاس منتشرشده و عملکرد اندازه‌گیری‌شده

نتایج زیر بارهای کاری و تاریخ‌های مختلف را توصیف می‌کنند. شمارش‌ها قابل تعویض نیستند: یک رویداد دفترچه خاطرات لزوماً یک پیام منحصربه‌فرد تلگرام نیست.

| تاریخ | بار کاری | نتیجهٔ منتشرشده | آنچه اندازه‌گیری شد |
| --- | --- | --- | --- |
| 1 نوامبر 2026 | اجرای سرور، ده پایگاه‌داده فضای کاری | 1,610,818 رکورد دفترچه یادداشت؛ 900,232 رویداد پیام جدید، 80,683 رویداد ویرایش و 400,536 رویداد حذف | فهرست فقط-خواندنی؛ نه آزمون توان عملیاتی یا تأیید کامل زنجیره جدید |
| 5 نوامبر 2026 | جستجو در بیش از 1,000,000 پیام مصنوعی در 200 چت | فهرست در 71ثانیه ساخته شد؛ زمان جستجوی میانه برای هر پرس‌وجو بین 9تا 190میلی‌ثانیه | معیار جستجوی محلی؛ نه تحویل زنده تلگرام |
| 6 نوامبر 2026 | دو خروجی جدید واقعی تلگرام | پیام‌های 27,030 و 29,299؛ در مجموع 56,329 پیام در هر دو اجرا | دو حساب در هر اجرا از طریق WARP، متن و متادیتا، بدون دانلود پیوست‌ها |
| 6 نوامبر 2026 | همان دو خروجی، شامل آماده‌سازی و بسته‌بندی | پیام‌ها در ثانیه 127.713 و 141.781 | نرخ‌های کامل خروجی اندازه‌گیری‌شده؛ هر دو آرشیو با کلیدهای سنجاق‌شده تأیید شده‌اند |

[سوابق تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/) ، موجودی سرور، بررسی‌های جمع‌آوری زنده و اندازه‌گیری جستجو را ارائه می‌دهد. [عملکرد خروجی](https://phishdestroy.github.io/TgWitness/docs/validation/) ، دو اجرای واقعی، سخت‌افزار، مدت‌زمان‌ها، هش‌های آرشیو و فایل‌های اندازه‌گیری امضا شده را منتشر می‌کند. آن‌ها نتایج را برای بازنگری‌ها و شرایط ثبت‌شده خود تعیین می‌کنند، نه یک نرخ یا سقف ظرفیت جهانی.

### تاریخچه و مدت زمان تست

نگهدارنده تا تاریخ 6 نوامبر 2026، بیش از شش ماه آزمایش را گزارش می‌کند. این تاریخچه آزمایش‌های پروژه را توصیف می‌کند. اندازه‌گیری‌های عمومی تاریخ‌دار در بالا، هر بار اجرای جداگانه را مستند می‌کنند؛ آنها یک دوره جمع‌آوری شش‌ماهه پیوسته و تأییدشده به‌طور مستقل را اثبات نمی‌کنند. سن پیام‌های صادرشده نیز با مدت‌زمان اجرای گردآورنده متفاوت است.

## وضعیت قابلیت را دقیقاً بخوانید

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

استفاده کنید [توانایی‌های فعلی](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md), [ویژگی‌ها و محدودیت‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/), [تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/) و [فهرست تغییرات](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/) با هم. هنگام استناد به یک نتیجه، نسخهٔ آزمایش‌شده را ثبت کنید. 6 اسکرین‌شات اندازه‌گیری نوامبر همچنین تست‌های ناموفق و ردشده را نیز حفظ می‌کند؛ این‌ها موفقیت محسوب نمی‌شوند.

## قابل خواندن توسط انسان‌ها و ابزارهای هوش مصنوعی

این وب‌سایت یک فایل مختصر `llms.txt`، یک کتاب راهنمای کامل انگلیسی در `llms-full.txt` و `llms-full.md`، و نسخه‌های مارک‌داون صفحات آن را ارائه می‌دهد. این‌ها فرمت‌های مستندسازی هستند، نه یک الزام هوش مصنوعی برای اجرای TgWitness.

اختیاری [MCP](https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/) و [دسترسی خط فرمان](https://phishdestroy.github.io/TgWitness/fa/docs/reference/cli/) ابزارهای مجاز را قادر به خواندن سوابق منتخب ذخیره‌شده می‌سازد. محتوای پیام همچنان ورودی غیرقابل اعتماد باقی می‌ماند. خلاصه‌ها باید به منابع ارجاع دهند، حقایق مشاهده‌شده را از استنتاج متمایز کنند و عدم قطعیت را حفظ نمایند. جستجوی تمام متن، OCR و خروجی هوش مصنوعی مشاهدات اصلی امضا‌شده را تغییر نمی‌دهند.