# TgWitness · فارسی > Documentation edition: فارسی. Project version: `0.9.1`. Source branch: `main`. This index links the Markdown editions of the public pages. The complete handbook is built from the same page content, including source URLs. Untranslated sections retain the English original; a language edition is not a claim that every section has been translated. - [Project context, installation, measured scale and verification limits](https://phishdestroy.github.io/TgWitness/docs/reference/overview/index.md) - [English project summary](https://phishdestroy.github.io/TgWitness/llms.txt) - [Complete handbook · فارسی](https://phishdestroy.github.io/TgWitness/fa/llms-full.txt) - [Complete handbook as Markdown · فارسی](https://phishdestroy.github.io/TgWitness/fa/llms-full.md) - [Source code and release history](https://github.com/phishdestroy/TgWitness) - [Collection modes and evidence levels](https://phishdestroy.github.io/TgWitness/fa/guides/modes.md) - [Published checks and measurements](https://phishdestroy.github.io/TgWitness/docs/validation/index.md) ## Complete documentation map ### Guides - [کار با آرشیو](https://phishdestroy.github.io/TgWitness/fa/docs/archive/index.md): بارگذاری تاریخچه، جستجو در سوابق ذخیره‌شده، بررسی منابع هوش مصنوعی و اتصال ابزارهای خود. - [GitHub Actions ضبط می‌کند](https://phishdestroy.github.io/TgWitness/fa/docs/capture/index.md): Takeout，خروجی با API معمولی یا گزارش یک گفتگو را روی اجراکننده موقت GitHub انتخاب کنید． - [حساب اختصاصی](https://phishdestroy.github.io/TgWitness/fa/docs/dedicated-account/index.md): یک حساب تلگرام جداگانه برای جمع‌آوری آماده کنید. - [در چند دقیقه شروع کنید](https://phishdestroy.github.io/TgWitness/fa/docs/start/index.md): با یک فرمان نصب کنید، یک حساب تلگرام متصل کنید و در Windows، Linux یا macOS آرشیوی قابل راستی‌آزمایی خروجی بگیرید. - [اتصال یک حساب](https://phishdestroy.github.io/TgWitness/fa/docs/accounts/index.md): تلگرام را از طریق کد QR، شماره تلفن یا وارد کردن جلسه متصل کنید. منابع را انتخاب کرده و بررسی کنید که پیام‌های جدید به دفترچه شواهد شما برسند. - [یک پروکسی انتخاب کنید](https://phishdestroy.github.io/TgWitness/fa/docs/proxies/index.md): مسیرهای خودکار MTProxy را حفظ کنید یا از پروکسی خود استفاده کنید. حالت‌های IP، قوانین پشتیبان و مسیر درخواست‌های خارجی را انتخاب کنید. - [صادرات و تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/exports/index.md): صادرات تاریخچه ضبط‌شده تلگرام، تأیید امضاها و مقایسه دفترچه با نقطهٔ کنترلی نگهداری‌شده توسط یک شاهد مستقل. - [ببینید مدرک چگونه کار می‌کند](https://phishdestroy.github.io/TgWitness/fa/docs/concepts/index.md): پیگیری یک پیام از زمان ضبط تا نقطهٔ کنترل. یک رکورد نمونه را تغییر دهید، زنجیرهٔ SHA-256 آن را مجدداً محاسبه کنید و ببینید نقطهٔ کنترل حفظ‌شده چه چیزی را تشخیص می‌دهد. - [تحقیق در تمام چت‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/cases/index.md): یک تحقیق سراسری تلگرام را در سراسر کانال‌ها، گروه‌ها، چت‌های خصوصی و ربات‌ها اجرا کنید: ضبط کل حساب کاربری، تاریخچه، افراد، لینک‌ها، فایل‌ها، خطوط زمانی و شواهد تأییدشده. - [یک بورد پرونده بسازید](https://phishdestroy.github.io/TgWitness/fa/docs/case-board/index.md): مشاهدات ذخیره‌شده، نکات برجسته دقیق و برش‌های عملیاتی را در یک تابلوی خصوصی جمع‌آوری کنید، آن‌ها را با تیم خود بحث کنید و یک مجموعه ارائه دهید. - [طراحی یک گزارش](https://phishdestroy.github.io/TgWitness/fa/docs/reports/index.md): داده‌های گزارش را انتخاب کنید، یکی از هشت طرح و محتوای آن را برگزینید، سپس پیش‌نمایش و خروجی HTML، PDF امضا‌شده یا یک بسته کامل مدرک را صادر کنید. - [یک نسخهٔ اشتراک‌گذاری آماده کنید](https://phishdestroy.github.io/TgWitness/fa/docs/handover/index.md): سوابق و فیلدهایی را که دریافت‌کننده می‌تواند دریافت کند انتخاب کنید، نسخهٔ نهایی را بررسی کرده و منیفست امضا شده و مرز ژورنال منبع را تأیید کنید. - [مدیریت گروهی از حساب‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/groups/index.md): مقایسهٔ فضاهای کاری گروهی، یافتن منبع، بازبینی دوره‌های مشاهده و اعمال تنظیمات مشترک با استثناهای هر حساب کاربری. - [آن را امن نگه دارید](https://phishdestroy.github.io/TgWitness/fa/docs/security/index.md): ببینید جلسات، کلیدها و شواهد کجا قرار دارند، چه اطلاعاتی از دستگاه شما خارج می‌شود، محافظت‌ها چه چیزهایی را پوشش می‌دهند و چگونه می‌توان یک نصب را مستحکم‌تر کرد. - [یک مورد را به اشتراک بگذارید](https://phishdestroy.github.io/TgWitness/fa/docs/access/index.md): به بازبینان و تحلیلگران دسترسی به حساب‌ها و چت‌های منتخب را با مجوزهای جداگانه، محدودیت‌های جلسه و توکن‌های قابل‌پس‌گرفتن فراهم کنید. - [راه‌اندازی یک بات شاهد](https://phishdestroy.github.io/TgWitness/fa/docs/witness/index.md): نقاط کنترل دفتر ثبت امضا شده را با یک شاهد جداگانه، کلید اختصاصی و دسترسی فقط-خواندن به کانال تلگرام خود منتشر کنید. - [آن را در حال اجرا نگه دارید](https://phishdestroy.github.io/TgWitness/fa/docs/server/index.md): TgWitness را روی سروری با حافظه دائمی، دسترسی به پنل خصوصی، پشتیبان‌گیری و بررسی‌ها پس از راه‌اندازی مجدد اجرا کنید. - [مشخص کنید چه چیزی اشتباه پیش رفته است](https://phishdestroy.github.io/TgWitness/fa/docs/troubleshooting/index.md): دسترسی پنل، اتصال تلگرام، پیام‌های مفقود، FloodWait و وضعیت شاهد را با استفاده از سیگنال‌های مناسب برای هر مشکل بررسی کنید. ### Reference - [گفتگوهای مخفی: پیاده‌سازی و دمو](https://phishdestroy.github.io/TgWitness/fa/docs/reference/secret-chats/index.md): پیاده‌سازی مجزای Secret Chat را درک کنید، رابط کاربری فرضی را امتحان کنید و نواقص باقی‌مانده را بررسی کنید. - [TgWitness: شروع، مقیاس و شواهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/overview/index.md): با یک دستور نصب شود یا در GitHub Actions اجرا گردد. گزینه‌های تحقیق، مقیاس منتشرشده و آنچه یک آرشیو تأیید می‌کند را درک کنید. - [بارگذاری تاریخچه منبع](https://phishdestroy.github.io/TgWitness/fa/docs/reference/history/index.md): بارگذاری پیام‌های گذشته از منابع فعال، مکث و از سرگیری، و تأیید گزارش پیشرفت امضا شده. - [تحلیل بایگانی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/analysis/index.md): جستجوی پیام‌های ذخیره‌شده، بازبینی ورودی‌های هوش مصنوعی و نگهداری گزارش‌های تحلیلی همراه با ارجاعات منبع. - [خط فرمان](https://phishdestroy.github.io/TgWitness/fa/docs/reference/cli/index.md): جستجو، خواندن زمینه، شمارش فعالیت و صادر کردن پیام‌های ذخیره‌شده از اسکریپت‌ها و ایجنت‌ها، با خروجی --json، کدهای خروجی پایدار و توکن‌های محدودخوانی. - [جستجوی متن کامل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/index.md): پیام‌های ذخیره‌شده را بر اساس شکل‌های واژه‌ای، عبارات دقیق، دامنه‌ها و نام‌های کاربری @ پیدا کنید، بهترین تطابق‌ها در اولویت، با شاخص متصل به دفترچهٔ امضا‌شده. - [MCP فقط-خواندنی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/index.md): یک کلاینت MCP را به فضاهای کاری و چت‌های منتخب با دسترسی منقضی‌شونده و قابل فسخ متصل کنید. - [شناسایی نوری حروف (OCR) و رونویسی محلی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/media-analysis/index.md): تصاویر و فایل‌های صوتی ضبط‌شده را با یک کارگر محلی شناسایی کنید؛ متن استخراج‌شده را به فایل منبع آن پیوند دهید. - [وب‌هوک‌های خروجی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/webhooks/index.md): ارسال رویدادهای محدودشده به گیرندگان HTTPS با امضاهای HMAC، تلاش‌های مجدد و وضعیت تحویل. - [اعلان عدم سازگاری اپراتور](https://phishdestroy.github.io/TgWitness/fa/docs/reference/notice/index.md): اطلاعیه اپراتور ما درباره تیلور وسینگ و رکورد منبع آن. - [اعلان عدم سازگاری مجوز و معماری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/license/index.md): TgWitness تحت مجوز MIT برای همه است و چرا از نظر معماری با گردش کار Taylor Wessing ناسازگار است. - [راه‌اندازی سریع](https://phishdestroy.github.io/TgWitness/fa/docs/reference/quickstart/index.md): هر روش نصب و راه‌اندازی TgWitness: بسته ویندوز، پایتون، داکر و دمو مصنوعی، همراه با بررسی‌های اولیه. - [فرمت‌های حساب کاربری و جلسه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/index.md): ورود با شماره تلفن، کد QR یا کلید احراز هویت، وارد کردن جلسات تله‌تون، پایروگرام یا تلگرام دسکتاپ و اجرای چندین حساب کاربری. - [دسترسی و مجوزها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/index.md): اعطای دسترسی محدود به حساب‌ها و چت‌ها، انتخاب مجوزها، محدود کردن جلسات و آدرس‌های IP و لغو دسترسی. - [اتصال، پروکسی‌ها و حفاظت از داده‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/index.md): احراز هویت، استخرهای خودکار پروکسی، حالت‌های IP، سیاست پشتیبان، درخواست‌های خارجی و ذخیره‌سازی مخفی. - [راه‌اندازی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/deployment/index.md): TgWitness را به‌عنوان یک سرویس روی ویندوز، لینوکس، macOS یا Docker اجرا کنید، پشت HTTPS، همراه با پشتیبان‌گیری و به‌روزرسانی‌ها. - [نحوهٔ کارکرد جمع‌آوری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/index.md): دامنهٔ مشاهده، به‌روزرسانی‌های زنده، بازبینی‌ها، پیوست‌ها، اقدامات خود و معنای یک شکاف، رکورد به رکورد. - [روندها و عملیات‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/index.md): عملیات روزانه پنل: حالت‌ها، دسته‌بندی‌های نظارت، پارامترها، اعلان‌ها، خروجی‌ها، پشتیبان‌گیری و ظرفیت. - [حالت تحقیق](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/index.md): تحقیقات کل حساب در سراسر کانال‌ها، گروه‌ها، چت‌های خصوصی و ربات‌ها، از دامنه تا بستهٔ پروندهٔ تأییدشده. - [مرجع Case Board](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/index.md): نشانک‌ها، برجسته‌سازی‌های دقیق، برش‌های عملیاتی، بحث‌ها، دسترسی محدودشده و تاریخچه حاشیه‌نویسی امضا‌شده مورد استفاده در Case Board. - [ پیکربندی و اعتبارسنجی گزارش](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-reports/index.md): فیلترهای گزارش، هشت طرح، پیش‌تنظیم‌های محتوا، سوابق تغییرات ذخیره‌شده و ارزیابی گنجانده‌شده در صادرات امضا‌شده. - [ویژگی‌ها و محدودیت‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/index.md): مدل جمع‌آوری فعلی، گردش کارهای چندحساب، خروجی‌ها و مرزهای عملیاتی TgWitness. - [چگونگی کارکرد شواهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/how-it-works/index.md): زنجیره هش، امضاها، نقاط کنترل و شاهدان با فرمول‌های دقیقی که اعتبارسنج استفاده می‌کند توضیح داده شده‌اند. - [فرمت مدرک](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/index.md): محتویات فایل ZIP امضا شده، انواع سوابق، رسیدهای فرایند، پروفایل افراد، نسخه‌های خارج از محل و تأیید آفلاین. - [شاهد مستقل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/index.md): یک ویژنس را با کلید و بات اختصاصی خود اجرا کنید، نقاط کنترل امضا شده را در یک کانال منتشر کنید و خروجی‌ها را با آن مطابقت دهید. - [برچسب‌های زمانی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/timestamp/index.md): تمبرهای زمانی RFC 3161 برای نقاط کنترل امضا شده: چه چیزی به مرجع ارسال می‌شود و چگونه پاسخ تأیید می‌شود. - [امنیت و مدیریت داده‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/security/index.md): مدل تهدید، مدل دسترسی، اسرار در حالت استراحت، در معرض دید شبکه، وارد کردن جلسات و نحوه گزارش آسیب‌پذیری. - [معماری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/architecture/index.md): اجزای جمع‌آورنده، پنل، دفترچه، کارگران و شاهد، و نحوهٔ جابجایی داده‌ها بین آن‌ها. - [آنچه آزمایش شده است](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/index.md): آزمون زنده تلگرام، بررسی‌های خودکار، بررسی‌های مرورگر و آنچه هنوز تأیید نشده است. - [فهرست تغییرات](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/index.md): هر تغییر در هر نسخه، از جمله تغییراتی که هنوز منتشر نشده‌اند. - [راهنمای پنل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/index.md): هر صفحه از پنل: چت‌ها، دفترچه یادداشت، منابع، خروجی‌ها، موارد اضافی، حالت‌های حفاظتی و بررسی کد. - [راه‌اندازی اولیه و تنظیمات](https://phishdestroy.github.io/TgWitness/fa/docs/reference/settings/index.md): جادوگر راه‌اندازی، اهداف، سطوح رابط، مسیرهای اتصال و تنظیمات مشترک یک گروه حساب. - [نصب، تأیید و به‌روزرسانی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/installation/index.md): نصب با یک دستور، بررسی امضاها و هش‌ها، به‌روزرسانی و حذف یک نصب. - [ذخیره‌سازی و بازیابی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/storage/index.md): نسخه‌برداری، انتقال فایل‌های قدیمی‌تر به فضای ابری شما، نسخه‌های کپی‌شده تحت Object Lock و بازیابی روی دستگاه جدید. - [صادرات حساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/account-export/index.md): صادرات آنچه یک حساب اکنون می‌تواند بخواند: دامنه، کارهای قابل از سرگیری، یک آرشیو امضا شده و نسخه‌های اشتراک‌گذاری‌شدهٔ به حداقل‌رسیده. - [نمایشگاه عمومی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/showcase/index.md): انتشار پیام‌های ذخیره‌شده‌ی کانال‌های عمومی منتخب و اسنپ‌شات‌های امضاشده از طریق لینک‌های منقضی‌شونده و قابل‌ابطال. - [استقرار با تضمین بالا](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/index.md): یک سرور مهر و موم‌شدهٔ ۲۴ ساعته و ۷ روز هفته در Hetzner یا Phala Cloud، DNS Gateway و چک‌هایی که شخص ثالث می‌تواند تکرار کند. --- # Telegram · در چند دقیقه شروع کنید Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/start/ با یک فرمان نصب کنید، یک حساب تلگرام متصل کنید و در Windows، Linux یا macOS آرشیوی قابل راستی‌آزمایی خروجی بگیرید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) با یک دستور نصب شود، یک حساب تلگرام را متصل کنید و انتخاب کنید چه چیزی را ذخیره کنید. ## روی رایانهٔ خود نصب کنید نصب‌کننده شامل پایتون و وابستگی‌ها است. با خروجی چت شروع کنید؛ ابزارهای مشاهده و بررسی را هر زمان که نیاز داشتید اضافه کنید. ### لینوکس / مک‌اواس ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` ### ویندوز · پاورشل / CMD ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` سرور اوبونتو: به‌عنوان ریشه اجرا شود. دسکتاپ: به‌عنوان کاربر عادی اجرا شود. آدرس پنل نمایش‌داده‌شده توسط نصاب را باز کنید و از کلید دسترسی آن استفاده کنید. سپس حساب تلگرام خود را متصل کنید. کلید پنل و مجوز تلگرام شما جدا از هم هستند. [نصب، امضاها و به‌روزرسانی‌ها](https://phishdestroy.github.io/TgWitness/docs/reference/installation/)توضیحاتی دربارهٔ نسخهٔ دانلودشده، دسترسی محلی و گزینه‌های سرور ارائه می‌دهد. [دستورالعمل‌های سورس و داکر](https://phishdestroy.github.io/TgWitness/docs/reference/quickstart/)در دسترس باقی می‌مانند. ## اولین وظیفه خود را انتخاب کنید 1. [حساب کاربری را از طریق شماره تلفن، کد QR یا وارد کردن یک جلسه پشتیبانی‌شده متصل کنید](https://phishdestroy.github.io/TgWitness/fa/docs/accounts/). 2. دامنهٔ چت‌ها، پوشه یا حساب کاربری را انتخاب کنید. 3. [صادرات تاریخچهٔ انتخاب‌شدهٔ](https://phishdestroy.github.io/TgWitness/docs/reference/account-export/)، یا شروع مشاهده برای حفظ تغییرات آتی. 4. [آرشیو](https://phishdestroy.github.io/TgWitness/fa/docs/exports/) را با اثر انگشت کلید مورد اعتماد جداگانه تأیید کنید. ## از یک رانر موقت گیت‌هاب استفاده کنید [GitHub Actions راهنمای شما در مراحل فورک، احراز هویت، دامنه و رمز عبور بایگانی است](https://phishdestroy.github.io/TgWitness/docs/capture/). نتیجه رمزگذاری‌شده و سوابق گردش کار آن را پس از اجرا دانلود کنید. برای این گردش کار به سرور جمع‌آوری دائمی نیازی نیست. ## بدون حساب کاربری نگاهی بیندازید [دموی مرورگر را در](https://phishdestroy.github.io/TgWitness/demo/?lang=fa)باز کنید تا پیام‌های فرضی را بررسی کنید، ویرایش‌ها را مقایسه کنید و پیش از نصب هر چیزی، خروجی را بازبینی کنید. ![نمای گفتگو با تلگرام‌ویجت همراه با پیام‌های نمونه](https://phishdestroy.github.io/TgWitness/assets/chats-dark.png) یک فضای کاری نمونه. دفترچهٔ شما به‌طور جداگانه آغاز می‌شود. ## ادامه یک تحقیق برای کارهای در حال انجام، منابع، سیاست‌های فایل، جستجو، گزارش‌ها و مجوزهای اشتراک‌گذاری مورد نیاز پرونده‌تان را اضافه کنید. [شروع، مقیاس و شواهد](https://phishdestroy.github.io/TgWitness/docs/reference/overview/)گزینه‌ها و اندازه‌گیری‌های منتشرشده را توضیح می‌دهد. برای نصب روی سرور، بخش [«نگه داشتن آن در حال اجرا» را](https://phishdestroy.github.io/TgWitness/fa/docs/server/) دنبال کنید. --- # از یک حساب جداگانه استفاده کنید. هرگز از حساب اصلی خود استفاده نکنید. Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/dedicated-account/ یک حساب تلگرام جداگانه برای جمع‌آوری آماده کنید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) قبل از اتصال حساب کاربری بخوانید توصیه ما مبنی بر عدم استفاده از حساب اصلی‌تان شوخی نیست. این یک واقعیت است. حساب اصلی - با هَشِ اپلیکیشن خود، ۹۹٪ از حساب‌ها از سیستم خارج می‌شوند - ممنوعیت حساب‌ها تنها به‌خاطر اعتماد پایین، شایع است - استفاده از حساب اصلی شما یک ایده واقعاً احمقانه است یک حساب اضافی بر روی جفت‌های شناسه/هَش API عمومی - بیش از یک میلیون حساب کاربری از طریق این جفت‌های شناسه/هش API ثبت شده‌اند. - این جفت‌های شناسه/هَش API بیش از ۵ سال است که فعال هستند. - هیچ‌کس نمی‌تواند از طریق این جفت‌های API هیچ‌یک از داده‌های شما را ببیند 01 ## چرا نباید از حساب اصلی خود استفاده کنید این اطلاعات دقیق است. ما دقیقاً می‌دانیم نقاط ضعف این مشکلات کجا هستند. 1. ### با هَشِ اپلیکیشن خود، ۹۹٪ از حساب‌ها از سیستم خارج می‌شوند وارد شدن به my.telegram.org با حسابی که به آن دسترسی ندارید، برای به‌دست آوردن هَش اپلیکیشن، و سپس هر درخواستی از طریق آن هَش، به معنای ۹۹٪ احتمال خروج حساب کاربری است. می‌توانید آن را بررسی کنید. 2. ### ممنوعیت حساب‌ها تنها به‌خاطر اعتماد پایین، شایع است حساب‌ها صرفاً به این دلیل که تلگرام به آن‌ها اعتماد ندارد مسدود می‌شوند و این ممنوعیت‌ها مکرراً اتفاق می‌افتند. شما هم می‌توانید این را بررسی کنید. استفاده از حساب شخصی خودتان واقعاً ایده‌ای احمقانه است. 3. ### کلیدهای جلسه کپی‌شده را می‌توان لغو کرد اجرای همزمان کلید واردشده TData/session در تلگرام دسکتاپ و TgWitness می‌تواند خطای `AUTH_KEY_DUPLICATED` را فعال کند. تلگرام آن مجوز را باطل می‌کند، بنابراین هر دو نسخه به ورود مجدد نیاز دارند. یک حساب اختصاصی مانع از این امر نمی‌شود. کلاینت اصلی را به طور کامل ترک کنید و در حالی که از جلسه وارد شده آن استفاده می‌کنید، آن را بسته نگه دارید. برای استفاده موازی، با تلفن یا QR به TgWitness وارد شوید تا یک مجوز جداگانه ایجاد کنید؛ سایر کلاینت‌های دارای مجوز جداگانه می‌توانند همچنان وارد شده باقی بمانند. [هشدار وارد کردن جلسه را بخوانید](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=fa#session-warning) مستندات تلگرام - [خطاهای خروج: AUTH_KEY_UNREGISTERED, SESSION_REVOKED](https://core.telegram.org/api/errors) - [ایجاد هش اپلیکیشن خود: به‌دست‌آوردن api_id](https://core.telegram.org/api/obtaining_api_id) 02 ## چرا TgWitness از طریق جفت‌های عمومی هش اپلیکیشن و شناسه اپلیکیشن کار می‌کند به همین دلیل ما TgWitness را بر پایهٔ جفت‌های عمومی هَش/شناسهٔ اپلیکیشن ساختیم. به نظر ما، با این روش احتمال مسدود شدن کمتر است: بیش از یک میلیون حساب تلگرام از طریق این جفت‌ها ثبت شده‌اند و برنامه‌های مختلف زیادی از طریق آن‌ها کار می‌کنند. از نظر منطق ما، این بهتر از کار مستقیم با هش اپلیکیشن شخصی است: این جفت‌ها قطعاً بیش از ۵ سال عمر دارند. ### جفت آی‌دی/هَش API جدید خودتان ایجادشده در my.telegram.org از حساب کاربری. - حدود ۹۹٪ این حساب‌ها از حالت لاگین خارج می‌شوند - یک برنامه جدید، یک حساب ### جفت‌های شناسه/هَش API عمومی از مجموعه همان جفت‌های شناسه/هش API که بسیاری از برنامه‌ها استفاده می‌کنند. - بیش از یک میلیون حساب کاربری ثبت شده - برنامه‌های مختلف - این جفت‌های API بیش از ۵ سال است که در حال کار هستند ### چرا هیچ‌کس نمی‌تواند از طریق این جفت‌های API هیچ‌یک از داده‌های شما را ببیند - #### این جفت API یک نام است، نه یک کلید تلگرام هنگام اتصال یک برنامه و درخواست کد ورود، شناسه API و هش API را می‌پرسد. این‌ها برنامه را شناسایی می‌کنند و هیچ دسترسی‌ای به هیچ حسابی نمی‌دهند؛ مستندات تل‌تون اشاره می‌کند که یک جفت با هر شماره تلفن کار می‌کند. - #### کلید جلسه شما هرگز سرور شما را ترک نمی‌کند ورود با استفاده از تبادل دیفی–هلمن بین TgWitness و تلگرام یک کلید مجوز ایجاد می‌کند؛ خودِ کلید هرگز ارسال نمی‌شود. مستندات تلگرام: پس از تأیید مجوز، کلید با کاربر مرتبط می‌شود و هر فراخوانی با این کلید به‌عنوان آن کاربر اجرا می‌شود. سایر برنامه‌ها با همان جفت کلید، کلیدهای مخصوص به خود را دارند و نمی‌توانند از کلید شما استفاده کنند. - #### ترافیک با کلید شما رمزگذاری می‌شود هر درخواست و پاسخ با کلید مجوز جلسه رمزگذاری می‌شود، نه با هش API. دانستن هش API هیچ چیزی را رمزگشایی نمی‌کند. - #### صاحب یک جفت شناسه/هش API هیچ‌چیز نمی‌بیند. تلگرام هیچ روشی ندارد که حساب‌ها، جلسات یا پیام‌ها را بر اساس شناسه API فهرست کند. مالک یک جفت تنها تنظیمات اپلیکیشن خود را در my.telegram.org می‌بیند. - #### فقط حساب کاربری شما می‌بیند که کدام اپ است تنظیمات → دستگاه‌های حساب کاربری شما، نام اپلیکیشن و شناسهٔ API هر جلسه، دستگاه، آدرس IP و تاریخ‌ها را فهرست می‌کند. هیچ‌کس دیگری این فهرست را نمی‌بیند. مستندات تلگرام - [مجوز کاربر: کلید به کاربر متصل می‌شود](https://core.telegram.org/api/auth) - [auth.sendCode: api_id, api_hash](https://core.telegram.org/method/auth.sendCode) - [initConnection](https://core.telegram.org/method/initConnection) - [ایجاد کلید احراز هویت MTProto](https://core.telegram.org/mtproto/auth_key) - [رمزگذاری MTProto](https://core.telegram.org/mtproto/description) - [account.getAuthorizations](https://core.telegram.org/method/account.getAuthorizations) - [یک ورودی احراز هویت (سشن) تلگرام حاوی چه اطلاعاتی است](https://core.telegram.org/constructor/authorization) - [کسب api_id](https://core.telegram.org/api/obtaining_api_id) - [کد منبع باز اپلیکیشن‌های تلگرام](https://telegram.org/apps#source-code) کتابخانه‌ها و رشته‌های بحث - [تله‌تون: ورود به تلگرام](https://docs.telethon.dev/en/stable/basic/signing-in.html) - [opentele: اعتبارنامه‌های API اپلیکیشن‌های رسمی](https://opentele.readthedocs.io/en/latest/documentation/authorization/api/) - [opentele: TelegramClient](https://opentele.readthedocs.io/en/latest/documentation/telethon/telegramclient/) - [استک اورفلو: آیا api_hash باید مخفی نگه داشته شود؟](https://stackoverflow.com/questions/49490818/should-telegram-api-hash-be-kept-secret) ### همان جفت‌های شناسه/هش API در برنامه‌های دیگر 7 جفت‌های شناسه/هش API اپلیکیشن‌های رسمی تلگرام عمومی هستند و در بسیاری از برنامه‌ها و کتابخانه‌های مستقل گنجانده شده‌اند: - [opentelePython · src/api.py](https://github.com/anmv/opentele/blob/4df17bd8c443d6452afc5a2d29ec7922fad1a5c3/src/api.py#L575) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [opentele2Rust · opentele2-core/src/api.rs](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/api.rs#L641) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [GrampoPython · Grampo/ut/api.py](https://github.com/abbas-bachari/Grampo/blob/00aa662d853c4ac2180432371c5e0d9444bbfe9e/Grampo/ut/api.py#L526) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [tgmanagePython · api/schemas/api_app.py](https://github.com/xdsnich/tgmanage/blob/f67c46be0ab234bd04526a8663d3936bd98a8597/api/schemas/api_app.py#L47) - Android 6 - iOS 8 - Desktop 2040 - macOS 2834 - Telegram X 21724 - Web K 2496 - [LyChatBotTDLib · helpers/tdlib/index.js](https://github.com/LyoSU/LyChatBot/blob/fac0ae5d5f2cddb8a26312014f51c0f6f40ec191/helpers/tdlib/index.js#L11) - macOS 2834 - [hsadasdPython · config.py](https://github.com/herobrinovaleksandr-png/hsadasd/blob/6842c74895038c16e219324fcd07dbe8153f37f0/config.py#L68) - Desktop 2040 - Desktop 17349 - Telegram X 21724 - macOS 2834 - iOS 10840 - Web 2496 - +4 - [blb.teamblb.team/threads/…294](https://blb.team/threads/app-hash-app-id-ofitsial-nykh-kliyentov.294/) - Android 4 · 5 · 6 - iOS 8 - Desktop 2040 - Desktop 17349 - macOS 2834 - Telegram X 21724 یک پست انجمن که جفت‌های شناسه API/هَش API اپلیکیشن‌های رسمی تلگرام را برای ثبت‌نام حساب‌ها فهرست می‌کند. 03 ## راه‌های ایجاد یک حساب اضافی یک حساب تلگرام به شماره‌تلفنی نیاز دارد که کد ورود را دریافت کند. مدت‌زمان فعالیت حساب را مشخص کنید. - بهترین انتخاب ### سیم‌کارت پیش‌پرداخت یا eSIM ******** چقدر دوام دارد تا زمانی که آن را شارژ نگه دارید به خاطر داشته باشید مطمئن‌ترین: تلگرام بهترین پشتیبانی را از شماره‌های موبایل واقعی دارد. شماره‌ای که اپراتور آن را پس می‌گیرد، به شخص دیگری اختصاص می‌یابد. - ### یک برنامه با شماره‌های تلفن مجازی ******** چقدر دوام دارد تا زمانی که اپلیکیشن شماره تلفن را حفظ کند به خاطر داشته باشید تلگرام ممکن است شماره مجازی را رد کند، کد را ارسال نکند یا بلافاصله حساب جدید را محدود سازد؛ برخی اپلیکیشن‌ها شماره‌هایی را که استفاده نشده‌اند پس می‌گیرند. - ### اجاره شماره تلفن ******** چقدر دوام دارد برای دوره اجاره به خاطر داشته باشید وقتی پایان می‌یابد، شماره به مشتری بعدی منتقل می‌شود. - ### فعال‌سازی یک‌باره ******** چقدر دوام دارد تنها یک کد ورود به خاطر داشته باشید این شماره بلافاصله به استخر بازمی‌گردد، اغلب با سابقه‌ای از مالکان قبلی. قبل از هر چیز، رمز عبور رایانش ابری را تنظیم کنید. هر کسی که بعداً شماره را در اختیار داشته باشد می‌تواند کد ورود را درخواست کند. یک رمز ابری (احراز هویت دو مرحله‌ای) مانع از ورود آن‌ها می‌شود؛ بدون آن حساب متعلق به مالک بعدی شماره خواهد بود. مستندات تلگرام - [سوالات متداول اسپم: شماره‌های مجازی و مالکان قبلی](https://telegram.org/faq_spam) - [تأیید دو مرحله‌ای](https://core.telegram.org/api/srp) ### شماره‌های اجاره‌ای +888 (Fragment) برخی بازارهای آنلاین و خدمات اجاره موقت شماره‌های رسمی +888 تلگرام از Fragment را ارائه می‌دهند. قیمت تقریبی: ۲۰ دلار آمریکا در روز. - می‌توانید مستقیماً در تلگرام وب یا تلگرام دسکتاپ یک حساب کاربری ثبت کنید. - می‌توانید حساب‌های موجود را حذف کرده و حساب‌های جدید ایجاد کنید. - این حساب‌ها عموماً با بررسی‌های کمتر ضدتقلب مواجه هستند، اما مصونیت یا امتیازات ویژه‌ای ارائه نمی‌کنند. این شماره متعلق به شما نیست. پس از پایان اجاره، مالک می‌تواند آن را بازپس گیرد. فوراً یک رمز عبور ابری تنظیم کنید و این حساب را بلندمدت در نظر نگیرید. داشتن شماره +888 به نام خودتان یا استفاده از سیم‌کارت پیش‌پرداختی که تحت کنترل شماست، همچنان قابل‌اعتمادتر است. ### حساب‌های آماده از مارکت‌پلیس‌ها برخی بازارهای آنلاین (برای مثال G2G یا Z2U) حساب‌های تلگرام آماده—جدید، کهنه یا دارای فایل‌های جلسه—می‌فروشند. - [G2G: فهرست حساب‌های تلگرام](https://www.g2g.com/uk/categories/telegram-accounts) - [Z2U: فهرست حساب‌های تلگرام](https://www.z2u.com/telegram/accounts-5-15140) هرگز از حساب اصلی خود استفاده نکنید! یک حساب اختصاصی که به این روش تهیه شده باشد، همچنان امن‌تر از وارد کردن حساب اصلی تلگرام شما در TgWitness است. #### هشدارها پیش از خرید - این کار نقض شرایط خدمات تلگرام است. - بسیاری از حساب‌ها به‌صورت انبوه ثبت شده‌اند (خودنصب) یا تاریخچهٔ نامعلومی دارند. - ممکن است برخی فروشندگان هنوز دسترسی بازیابی داشته باشند. - حساب‌های حاصل از چنین بازارهایی اغلب بعداً مسدود یا محدود می‌شوند. - از بازارهای آنلاین که علناً ابزارهای سرقت (stealers)، ابزارهای فیشینگ یا حساب‌های به‌وضوح سرقت‌شده را می‌فروشند، اجتناب کنید. - خرید یک حساب — حتی حساب‌هایی که به‌عنوان خودکار ثبت‌شده تبلیغ می‌شوند — از پلتفرم‌هایی که آشکارا ابزارهای فیشینگ، استیلرها، جلسات یا حساب‌های سرقت‌شده را می‌فروشند، نه تنها شرایط خدمات تلگرام را نقض می‌کند بلکه قوانین اکثر کشورها را نیز زیر پا می‌گذارد. این امر می‌تواند بعداً شواهد شما را باطل کند. با دقت انتخاب کنید. #### اگر از این گزینه استفاده کنید 1. حساب را یک‌بارمصرف در نظر بگیرید. 2. تمام جلسات دیگر را خاتمه دهید، رمز ابری را تنظیم کرده و روش‌های بازیابی را فوراً تغییر دهید. 3. از ۲–۳ حساب از ارائه‌دهندگان مختلف یا حساب‌هایی که خودتان ثبت‌نام کرده‌اید استفاده کنید. **پریمِیوم، حذف و تأخیر هفت روزه** اگر حساب دارای سرویس پریمیوم باشد، کسی که به شماره تلفن دسترسی دارد نمی‌تواند فوراً حساب را حذف کند. شما یک اعلان دریافت می‌کنید و هفت روز فرصت دارید پیش از حذف آن اقدام کنید. این موضوع اهمیت دارد زیرا تحقیقات شما به حساب کاربری وابسته است: شما زمان دارید تا جایگزین را آماده کنید. **حساب‌های جدید و اعتبارنامه‌های API** اگر api_id/api_hash خود را از یک حساب جدید که خودتان با شماره‌ای از سرویس پیامکی ثبت‌نام کرده‌اید به‌دست آورده و استفاده کنید، حساب کاربری در اولین درخواست API یا تأیید دسترسی جلسه، از حالت لاگین خارج خواهد شد. هنگام برنامه‌ریزی یک تحقیق، این نکته را در نظر داشته باشید. 04 ## ایجاد حساب از دریافت شماره تلفن تا اولین گفتگوی ثبت‌شده. 1. ### دریافت شماره تلفن سیم‌کارت پیش‌پرداخت‌شده یا eSIM وقتی حساب باید برای مدت طولانی فعال بماند؛ اجاره یا فعال‌سازی یک‌باره برای یک کار کوتاه. خدمات در زیر فهرست شده‌اند. 2. ### به‌جز حساب اصلی خود ثبت‌نام کنید در اپلیکیشن رسمی تلگرام روی دستگاه جداگانه، شبیه‌ساز یا پروفایل تلفن ثبت‌نام کنید، نه در کنار حساب اصلی‌تان. 3. ### حساب را با یک رمز عبور ابری محافظت کنید فوراً یک رمز عبور ابری و یک ایمیل بازیابی که در هیچ جای دیگری استفاده نشده است تنظیم کنید. 4. ### محدود کردن تنظیمات حریم خصوصی حساب شماره تلفن **هیچ‌کس**، مرا با شماره‌ام پیدا کن **مخاطبینم**، آخرین مشاهده، عکس‌های پروفایل و بیو **هیچ‌کس** یا **مخاطبینم**؛ همگام‌سازی مخاطبین را غیرفعال کنید. 5. ### حساب را از خودویرانگری محافظت کنید خودویران‌سازی حساب را روی طولانی‌ترین مدت تنظیم کنید تا اگر TgWitness متوقف شود، حساب کاربری‌تان از دست نرود. 6. ### برای حساب یک پروفایل خنثی در نظر بگیرید بدون نام، عکس، نام کاربری یا بیو حساب‌های دیگر شما، بدون مخاطبین شخصی. 7. ### اجازه دهید حساب جدید گرم شود در ابتدا، روزانه فقط به چند چت بپیوندید. حساب‌های جدیدی که عجله می‌کنند، ابتدا محدود می‌شوند. 8. ### با ربات‌ها هیچ‌چیز را به اشتراک نگذارید هرگز دکمه «اشتراک‌گذاری شماره تلفن» یا «اشتراک‌گذاری موقعیت مکانی» را برای یک ربات فشار ندهید. لینک‌ها و اپلیکیشن‌های کوچک را از طریق VPN یا پروکسی روی آن دستگاه باز کنید. 9. ### حساب را به TgWitness متصل کنید در فضای کاری خود، از مسیر **حساب → کد QR** متصل شوید، سپس روی **منابع → حالت تحقیق** ضربه بزنید. اپلیکیشن جایی است که شما عمل می‌کنید، TgWitness سوابق را ثبت می‌کند. مستندات تلگرام - [تأیید دو مرحله‌ای](https://core.telegram.org/api/srp) - [تنظیمات حریم خصوصی](https://core.telegram.org/api/privacy) - [خودویرانگری حساب در صورت غیرفعال بودن](https://core.telegram.org/method/account.setAccountTTL) 05 ## خدمات شماره تلفن این‌ها گزینه‌هایی هستند که می‌توانید از آن‌ها شروع کنید. کشورها، قیمت‌ها و اینکه آیا تلگرام یک شماره مشخص را می‌پذیرد یا خیر، اغلب تغییر می‌کنند، بنابراین قبل از پرداخت بررسی کنید. ### سیم‌کارت پیش‌پرداخت و eSIM ۱۱ - [SMARTYsmarty.co.uk](https://smarty.co.uk) - UK - SIM - [VOXIvoxi.co.uk](https://www.voxi.co.uk) - UK - SIM - [iD Mobileidmobile.co.uk](https://www.idmobile.co.uk) - UK - SIM - [Threethree.co.uk](https://www.three.co.uk) - UK - SIM - [Asda Mobilemobile.asda.com](https://mobile.asda.com) - UK - SIM - [Ultra Mobileultramobile.com](https://www.ultramobile.com) - US - پیش‌پرداخت‌شده طرح PayGo، بسیار ارزان - [US Mobileusmobile.com](https://www.usmobile.com) - US - پیش‌پرداخت‌شده - [Mint Mobilemintmobile.com](https://www.mintmobile.com) - US - پیش‌پرداخت‌شده - [Tracfonetracfone.com](https://www.tracfone.com) - US - پیش‌پرداخت‌شده - [eSIM Plusesimplus.me](https://esimplus.me) - eSIM - [Numero eSIMnumeroesim.com](https://numeroesim.com) - eSIM ### اپلیکیشن‌های دارای شماره تلفن مجازی 20 - [Google Voicevoice.google.com](https://voice.google.com) - US فقط برای ایالات متحده؛ ثبت‌نام نیازمند شماره تلفن آمریکایی است - [TextNowtextnow.com](https://www.textnow.com) - US - CA این شماره در صورت عدم استفاده بازپس گرفته می‌شود - [TextFreetextfree.us](https://www.textfree.us) - US - [2ndLine2ndline.co](https://www.2ndline.co) - US - CA - [Talkatonetalkatone.com](https://www.talkatone.com) - US - [TextMego-text.me](https://go-text.me) - US - CA - سایر کشورها - [textPlustextplus.com](https://textplus.com) [Google Play](https://play.google.com/store/apps/details?id=com.gogii.textplus) - [FreeToneGoogle Play](https://play.google.com/store/apps/details?id=com.textmeinc.freetone) - US [TextMe Up · textmeup.com](https://www.textmeup.com) - [Nextplusnextplus.me](https://nextplus.me) - US - [Dingtonedingtone.me](https://www.dingtone.me) - US - CA - [Burnerburnerapp.com](https://www.burnerapp.com) - US - CA - سرویس پولی با دوره آزمایشی - [Hushedhushed.com](https://hushed.com) - کشورهای بسیاری - سرویس پولی قیمت پایین - [Sidelinesideline.com](https://www.sideline.com) - US - [MySudomysudo.com](https://mysudo.com) - US - CA - UK - [2NumberGoogle Play](https://play.google.com/store/apps/details?id=com.bpmobile.second.phone) [App Store](https://apps.apple.com/app/id1216135390) - [SLYNUMBERslynumber.com](https://slynumber.com) [Google Play](https://play.google.com/store/apps/details?id=com.dev.slynumber) - [Phonerphonerapp.com](https://phonerapp.com) - [Onoffonoff.app](https://www.onoff.app) - EU شماره‌های موبایل اروپایی در یک برنامه - [Sonetelsonetel.com](https://sonetel.com) - کشورهای بسیاری - یک شماره بدون هزینه - [Zadarmazadarma.com](https://zadarma.com) - کشورهای بسیاری شماره‌های تلفن مجازی ### اجاره شماره تلفن و فعال‌سازی‌های یک‌باره 12 اجاره شماره تلفن باعث می‌شود آن شماره برای هفته‌ها یا ماه‌ها در اختیار شما باشد. فعال‌سازی یک‌باره یک کد ورود یک‌بار مصرف صادر می‌کند: بلافاصله پس از ثبت‌نام، رمز عبور ابری را تنظیم کنید. - [OnlineSimonlinesim.io](https://onlinesim.io) - اجاره شماره تلفن - فعال‌سازی‌های یک‌باره - [SMSPVAsmspva.com](https://smspva.com) - اجاره شماره تلفن - فعال‌سازی‌های یک‌باره - [5SIM5sim.net](https://5sim.net) - اجاره شماره تلفن - فعال‌سازی‌های یک‌باره - [SMSPoolsmspool.net](https://www.smspool.net) - اجاره شماره تلفن - فعال‌سازی یک‌باره - [VAK-SMSvak-sms.com](https://vak-sms.com) - اجاره شماره تلفن - فعال‌سازی‌های یک‌باره - [TextVerifiedtextverified.com](https://www.textverified.com) - اجاره شماره تلفن - فعال‌سازی‌های یک‌باره - [JuicySMSjuicysms.com](https://juicysms.com) - اجاره شماره تلفن - فعال‌سازی‌های یک‌باره - [365SMS365sms.org](https://365sms.org) - اجاره شماره تلفن - فعال‌سازی‌های یک‌باره - [SIMSMSsimsms.org](https://simsms.org) - اجاره شماره تلفن - فعال‌سازی‌های یک‌باره - [GrizzlySMSgrizzlysms.com](https://grizzlysms.com) - فعال‌سازی یک‌باره - [SMS-MANsms-man.com](https://sms-man.com) - فعال‌سازی یک‌باره - [Tiger SMStiger-sms.com](https://tiger-sms.com) - فعال‌سازی یک‌باره --- # Telegram · اتصال یک حساب Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/accounts/ تلگرام را از طریق کد QR، شماره تلفن یا وارد کردن جلسه متصل کنید. منابع را انتخاب کرده و بررسی کنید که پیام‌های جدید به دفترچه شواهد شما برسند. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) یک فضای کاری = یک حساب، ژورنال آن و کلید آن. ## انتخاب روش ورود **حساب‌ها** ← افزودن فضای کاری ← تنظیمات اتصال. برای این کار از یک حساب جداگانه استفاده کنید. - **کد QR:** آن را از صفحه دستگاه‌ها در Telegram اسکن و تأیید کنید. - **شماره تلفن:** شماره، کد، سپس رمز 2FA اگر دارید. - **وارد کردن نشست:** فایل نشست خودتان یا داده‌های Telegram Desktop. از نمایه API داخلی یا API ID و hash خودتان استفاده کنید. فقط برنامه را شناسایی می‌کند، شما را وارد نمی‌کند و چیزی را پنهان نمی‌کند. **ابتدا به پروکسی نیاز دارید؟** می‌توانید قبل از ورود، [مسیر اتصال را انتخاب و آزمایش کنید](https://phishdestroy.github.io/TgWitness/fa/docs/proxies/). هر حساب مسیر مخصوص به خود را دارد. ## انتخاب کنید چه چیزی را مشاهده کنید 1. گفتگوها، گروه‌ها یا کانال‌هایی را که لازم دارید انتخاب کنید. 2. تنظیمات جمع‌آوری، از جمله رسانه، را بررسی کنید. 3. اجرا کنید و اتصال و فعالیت اخیر را بررسی کنید. حساب باید دسترسی داشته باشد. مدیران و اعضا چیزهای متفاوتی می‌بینند و ژورنال نشان می‌دهد این حساب چه دریافت کرد. کل حساب؟ **منابع ← محدوده مشاهده ← حالت تحقیق**، بررسی کنید، **ذخیره محدوده**. راهنمای کامل: [تحقیق روی کل یک حساب](https://phishdestroy.github.io/TgWitness/fa/docs/cases/). ## مسیر کامل را بررسی کنید در گروه آزمایشی، از حساب دیگری پیامی بفرستید، ویرایشش کنید، حذفش کنید. هر سه باید در ژورنال دیده شوند. سپس [خروجی بگیرید و تأیید کنید](https://phishdestroy.github.io/TgWitness/fa/docs/exports/). «متصل» یعنی اتصال کار می‌کند. پیام آزمایشی ثبت‌شده یعنی رویدادها واقعاً می‌رسند. ## حساب دیگری اضافه کنید فضای کاری جدید در **حساب‌ها**، همان مراحل. اثر انگشت کلید هر حساب را یادداشت کنید تا بعداً خروجی‌ها را از هم تشخیص دهید. --- # Telegram · یک پروکسی انتخاب کنید Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/proxies/ مسیرهای خودکار MTProxy را حفظ کنید یا از پروکسی خود استفاده کنید. حالت‌های IP، قوانین پشتیبان و مسیر درخواست‌های خارجی را انتخاب کنید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) حساب را آنلاین نگه دارید و خودتان تصمیم بگیرید که آیا اصلاً مجاز است IP سرور شما را نشان دهد. ## ابتدا حالت IP را انتخاب کنید 01**پنهان کردن آدرس** فقط پروکسی. اگر هیچ‌کدام کار نکند، صبر می‌کند. 02**به‌عنوان آخرین راه‌حل** پس از تأخیری مستقیم وصل می‌شود و به محض کار کردن یک پروکسی به آن برمی‌گردد. 03**سرور پشت تونل یا VPN** اتصال مستقیم مشکلی ندارد. VPN را برای شما تنظیم یا بررسی نمی‌کند. مسیر، اتصال را انتخاب می‌کند. حالت IP تعیین می‌کند که آیا اتصال مستقیم مجاز است یا خیر. ## بگذارید استخر مسیر را حفظ کند 1. **حساب ← تنظیمات ← تنظیمات اتصال**. 2. حالت IP و **MTProxy خودکار**، یا یک مسیر ثابت را انتخاب کنید. 3. ذخیره کنید، **آزمایش اتصال Telegram** (پیش از ورود هم کار می‌کند). 4. جمع‌آوری را شروع کنید و برای خودتان پیام آزمایشی بفرستید. فضاهای کاری جدید با MTProxy خودکار و **پنهان کردن آدرس** شروع می‌شوند. استخر چهار فهرست عمومی را می‌گیرد، سرورها را بررسی می‌کند، خوب‌ها را نگه می‌دارد و مرده‌ها را عوض می‌کند. ## از پروکسی خود استفاده کنید SOCKS5، HTTP CONNECT، لینک پروکسی Telegram یا کاتالوگ اپراتور. پیش از تغییر، مشاهده را متوقف کنید. رازهای Fake TLS (`ee`…) کار نمی‌کنند. **تنظیمات چرخش، اشتراک‌گذاری و تلاش مجدد** **پارامترها ← MTProxy خودکار**: آستانه‌های خطا، زمان‌های استراحت، چرخش، تعداد حساب برای هر پروکسی. حد 1 یعنی حساب به‌جای اشتراک صبر می‌کند. پروکسی‌های مختلف همچنان ممکن است IP خروجی مشترک داشته باشند. ## جدا کردن تلگرام از درخواست‌های خارجی MTProxy فقط Telegram را حمل می‌کند. مهرهای زمانی، اعلان‌ها، کپی‌ها و بررسی‌های کد از یک پروکسی SOCKS5/HTTP جداگانه، مسیر SOCKS5/HTTP حساب، یا اگر حالت اجازه دهد مستقیم می‌روند. یا خاموششان کنید. `TGWITNESS_PROXY_FEED_PROXY` مسیر دانلود فهرست‌ها را تعیین می‌کند. [شاهد](https://phishdestroy.github.io/TgWitness/fa/docs/witness/) تنظیمات خودش را دارد. هیچ‌کدام از این‌ها به مرورگر یا شبکه سیستم شما دست نمی‌زند. بیشتر: [حالت‌ها و پیش‌فرض‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/#ip-modes)، [چه کسی می‌تواند مسیرها را تغییر دهد](https://phishdestroy.github.io/TgWitness/fa/docs/access/). --- # Telegram · صادرات و تأیید Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/exports/ صادرات تاریخچه ضبط‌شده تلگرام، تأیید امضاها و مقایسه دفترچه با نقطهٔ کنترلی نگهداری‌شده توسط یک شاهد مستقل. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) فایل‌هایی به کسی بدهید که خودش بتواند با فضای کاری شما مقایسه و بررسی کند. نگهداری یک مرجعخروجی ZIP امضا شدهگیرنده تأیید می‌کند با امضاها و نقاط بازرسی تازه آشنا شده‌اید؟ [یک رکورد نمونه را تغییر دهید](https://phishdestroy.github.io/TgWitness/fa/docs/concepts/#chain) و ببینید کدام بررسی آن را می‌گیرد. نگهداری نسخهٔ پشتیبان دور از دستگاه جمع‌آوری‌کننده؟ به [تنظیمات S3](https://phishdestroy.github.io/TgWitness/fa/docs/exports/#s3)، [Object Lock](https://phishdestroy.github.io/TgWitness/fa/docs/exports/#s3-retention) یا [بازیابی تأییدشده](https://phishdestroy.github.io/TgWitness/fa/docs/exports/#s3-restore) بروید. ## یک مرجع قابل اعتماد را حفظ کنید اثر انگشت کلید فضای کاری را جایی غیر از جمع‌کننده یادداشت کنید. هنگام جمع‌آوری، نقاط بازرسی امضاشده را هم جای دیگری نگه دارید یا یک [شاهد مستقل](https://phishdestroy.github.io/TgWitness/fa/docs/witness/) اجرا کنید. گیرنده کلید و وضعیت قبلی ژورنال را با همین‌ها بررسی می‌کند. ## فایل ZIP امضا شده را دانلود کنید **خروجی‌ها** ← ZIP شواهد امضاشده. کل ژورنال و فهرست امضاشده فایل‌ها در آن است. گزارش خوانا را در [Report studio](https://phishdestroy.github.io/TgWitness/fa/docs/reports/) شکل دهید یا فقط داده‌های انتخابی را به‌صورت [برگزیده تحویل](https://phishdestroy.github.io/TgWitness/fa/docs/handover/) بفرستید. گزارش‌های HTML، PDF و JSON مهر خودشان را دارند. CSV فقط یک نسخه کاری است؛ برای یکپارچگی از CSV داخل ZIP تأییدشده استفاده کنید. ## با یک نسخهٔ معتبر از TgWitness تأیید کنید در محیط پروژه، با اثر انگشت و مسیرهای خودتان: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --checkpoint retained-checkpoint.json ``` در صورت موفقیت `key_pinned: true` و `checkpoint_checked: true` را می‌بینید. آن خروجی را کنار بایگانی نگه دارید. نقطه بازرسی باید در انتهای خروجی یا پیش از آن باشد. ## از نتیجه تأیید استفاده کنید - **فایل‌ها:** فهرست هش‌هایشان را مقید می‌کند، امضاها ژورنال را. هر تغییری دیده می‌شود. - **هویت:** اثر انگشتی که نگه داشتید ثابت می‌کند این همان کلیدی است که انتظار داشتید. - **وضعیت قبلی:** نقطه بازرسی خروجی را با ابتدای ژورنالی که پیش از تحویل ذخیره شده مقایسه می‌کند. - **پوشش:** شکاف‌ها، نتایج دریافت و آزمون ارسال ← ویرایش ← حذف نشان می‌دهند این تنظیمات واقعاً چه چیزی را گرفته است. جزئیات: [تأیید چه چیزی را ثابت می‌کند و چه چیزی را نه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope). ## راه‌اندازی نسخهٔ آف‌سایت S3 **خروجی‌ها ← کپی خارج از محل** در فضای کاری شما. با AWS S3 و هر سرویس سازگار با S3 کار می‌کند. بخش‌های ژورنال، فایل‌های ذخیره‌شده، نقاط بازرسی با مهرهای زمانی‌شان و خروجی‌های تمام‌شده گفتگو را کپی می‌کند و هر کدام پیش از ترک جمع‌کننده با `AES-256-GCM` رمزگذاری می‌شود. دموی آنلاین این کنترل‌ها را با بارگذاری خاموش نشان می‌دهد. اعتبارنامه‌های واقعی را فقط در نصب خودتان وارد کنید. [![پنل کامل کپی خارج از محل: کنترل‌های نقطه پایانی، منطقه، باکت، کلیدهای دسترسی، زمان‌بندی، قفل شیء و کلید بازیابی](https://phishdestroy.github.io/TgWitness/assets/off-site-copy.png)](https://phishdestroy.github.io/TgWitness/assets/off-site-copy.png) پنل کامل با گزینه‌های پیشرفته بازشده. هیچ‌یک از اطلاعات اعتبارسنجی ذخیره‌سازی نمایش داده نمی‌شوند. | میدان | چه چیزی را باید وارد کنید | | --- | --- | | نقطهٔ پایانی | URL ذخیره‌سازی، بدون مسیر bucket یا اعتبارنامه. مثال: `https://s3.example.invalid`. | | منطقه | هر چه ارائه‌دهنده‌تان لازم دارد. پیش‌فرض `us-east-1`. | | بکت | یک bucket موجود که می‌توانید در آن بنویسید. مثال: `example-case-backup`. | | پوشه در سطل | پیشوند، پیش‌فرض `tgwitness`. یک پیشوند برای هر فضای کاری روی آن اضافه می‌شود. | | شناسه کلید دسترسی / کلید دسترسی مخفی | هر دو با هم، در گاوصندوق ذخیره می‌شوند. بعداً هر دو را خالی بگذارید تا حفظ شوند. | | آدرس‌های به سبک مسیر | روشن: `endpoint/bucket`. خاموش: `bucket.endpoint`. به ارائه‌دهنده بستگی دارد. | | کپی فاصله زمانی | 1 تا 1,440 دقیقه، پیش‌فرض 5. فقط وقتی برنامه در حال اجراست. | | نگهداری قفل اشیاء | روزها و حالت، اگر bucket از Object Lock پشتیبانی کند. صفر پیش‌فرض bucket را نگه می‌دارد. | 1. bucket را بسازید، مقصد و اعتبارنامه‌ها را با تیک‌نخورده بودن **نگهداری کپی خارج از محل** پر کنید و **ذخیره کپی خارج از محل** را بزنید. 2. **آزمایش اتصال** یک شیء آزمایشی رمزگذاری‌شده بارگذاری می‌کند. 3. **دانلود کلید رمزگذاری** و آن را دور از جمع‌کننده نگه دارید. بدون کلید، بازیابی ممکن نیست. 4. **نگهداری کپی خارج از محل** را تیک بزنید، ذخیره کنید، سپس **کپی همین حالا** یا بگذارید زمان‌بندی اجرا شود. ## بررسی نگهداری و پیشرفت کپی در **گزینه‌های بیشتر** روزهای نگهداری و `GOVERNANCE` یا `COMPLIANCE` را انتخاب کنید. TgWitness نگهداری را از یک شیء بارگذاری‌شده دوباره می‌خواند و می‌گوید: تأیید شد، وجود ندارد یا بررسی ناموفق بود. پنل آخرین دور، تعداد اشیا، بایت‌ها، مرز ژورنال کپی‌شده و خطاها را نشان می‌دهد. فایل محلی گم‌شده گزارش و در دور بعد دوباره امتحان می‌شود، بقیه کپی می‌شوند. بارگذاری‌ها از اتصال مستقیم، SOCKS5 یا HTTP می‌روند. با مسیر فقط MTProxy، کپی با خطا منتظر می‌ماند. ## کلید بازیابی را جداگانه نگه دارید JSON کلید شامل کلید رمزگشایی، مقصد، پیشوند و اثر انگشت کلید است. برای بازیابی به آن و اعتبارنامه‌های ذخیره‌سازی با دسترسی خواندن نیاز دارید. endpoint، bucket یا پیشوند را عوض کردید؟ کلید را دوباره دانلود کنید. کپی تازه در مقصد جدید شروع می‌شود؛ خروجی‌های قدیمی گفتگو سر جایشان می‌مانند. ## بازیابی و تأیید روی دستگاه دیگر به یک نصب قابل اعتماد TgWitness، JSON کلید، اعتبارنامه‌های فقط‌خواندنی ذخیره‌سازی و یک پوشه خالی نیاز دارید: ### پاورشل ویندوز ``` $env:TGWITNESS_S3_ACCESS_KEY = 'YOUR_READ_ACCESS_KEY' $env:TGWITNESS_S3_SECRET_KEY = 'YOUR_READ_SECRET_KEY' python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence ``` ### لینوکس / مک‌اواس ``` export TGWITNESS_S3_ACCESS_KEY='YOUR_READ_ACCESS_KEY' export TGWITNESS_S3_SECRET_KEY='YOUR_READ_SECRET_KEY' python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence ``` همه چیز ابتدا در یک پوشه موقت خصوصی بررسی می‌شود: کل ژورنال، نقاط بازرسی، هش و اندازه فایل‌ها. مسیرهای ناامن، بخش‌های متناقض یا ژورنالی کوتاه‌تر از نقطه بازرسی‌اش شکست می‌خورند و در آن صورت چیزی نوشته نمی‌شود. در صورت موفقیت `events.jsonl`، `media/`، `checkpoints/` و `exports/` را می‌گیرید. خروجی JSON فرمان را کنارشان نگه دارید و با نقاط بازرسی یا سوابق شاهدی که خودتان نگه داشته‌اید مقایسه کنید. --- # Telegram · GitHub Actions ضبط می‌کند Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/capture/ Takeout, خروجی با API معمولی یا گزارش یک گفتگو را روی اجراکننده موقت GitHub انتخاب کنید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) Takeout，خروجی با API معمولی یا گزارش یک گفتگو را روی اجراکننده موقت GitHub انتخاب کنید． جاوااسکریپت را فعال کنید تا یک کلید تولید شود و آرشیو خود را رمزگشایی کنید. **مرجع کامل** [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Documentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Independent capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md) ![Independent capture](https://phishdestroy.github.io/TgWitness/assets/chapter-capture.svg) **Preview available from `main`.** A fork launches a pinned reusable workflow from `phishdestroy/TgWitness`. The workflow exports an account, selected chats or one chat's event journal using a newly created Telegram session, attests the evidence ZIP or multipart manifest, and uploads only recipient-encrypted handoffs. The normal administration panel is not exposed. Choose `client=official_web` to run the [official-client witness](https://github.com/phishdestroy/TgWitness/blob/main/docs/OFFICIAL-WITNESS.md) with guarded Telegram Web controls and video. It requires your own upstream proxy and observes one rendered chat. The default `client=api` retains the full-account export modes described below. The verifier checks the archive against its GitHub attestation, the approved workflow and collector commits, and the signed journal and attachment hashes. The collection process uses pinned upstream code and fresh storage. A reviewer can inspect that code and verify the delivered archive against its recorded run. **On this page** - [User flow](https://phishdestroy.github.io/TgWitness/fa/docs/capture/#user-flow) - [Session time budget](https://phishdestroy.github.io/TgWitness/fa/docs/capture/#session-time-budget) - [Choose this mode or a persistent workspace](https://phishdestroy.github.io/TgWitness/fa/docs/capture/#choose-this-mode-or-a-persistent-workspace) - [What is public, and what must stay private](https://phishdestroy.github.io/TgWitness/fa/docs/capture/#what-is-public-and-what-must-stay-private) - [Troubleshooting](https://phishdestroy.github.io/TgWitness/fa/docs/capture/#troubleshooting) - [Local decryption and verification](https://phishdestroy.github.io/TgWitness/fa/docs/capture/#local-decryption-and-verification) - [How the fork is kept outside the capture process](https://phishdestroy.github.io/TgWitness/fa/docs/capture/#how-the-fork-is-kept-outside-the-capture-process) - [Cryptographic handoff](https://phishdestroy.github.io/TgWitness/fa/docs/capture/#cryptographic-handoff) - [Limits and validation](https://phishdestroy.github.io/TgWitness/fa/docs/capture/#limits-and-validation) - [Maintainer release sequence](https://phishdestroy.github.io/TgWitness/fa/docs/capture/#maintainer-release-sequence) ## User flow The helper explains the five stages and lets you try message or collector substitution on sample data. **Start my capture** opens the wizard. 1. Choose **GitHub Actions capture (preview)** on the project homepage, the workspace login screen, or **Exports → Open capture helper**. You can also open the [official helper](https://phishdestroy.github.io/TgWitness/sealed.html?lang=en) or `tgwitness/static/capture.html` from a trusted checkout in a modern browser. The helper makes no network requests for key or file processing. The helper supports the site's interface languages; the temporary collection panel supports English and Russian. 2. Generate a key and save **sealed-key.json**. This is the only private decryption key. Copy the separate public **recipient** value. Losing the private key loses access to both the connection and the archive. Confirm that you saved it to unlock the next step. If you already have a delivery file, load the saved key and choose **I already have an archive**. 3. Fork TgWitness, enable Actions in the fork, and run **Sealed chat capture**. Paste the public recipient and choose 30, 60, or 120 minutes. Never put a phone number, login code, Telegram password, private key, or session in workflow inputs, commits, issues, or logs. 4. During the run, download **sealed-connection** from Artifacts and unzip it. Load `connection.tgwsealed` in the helper, using the saved private key. The resulting link contains a random access secret in its URL fragment. Keep this link private. The panel removes the fragment and keeps the secret in this tab's session storage; it is not placed in HTTP access logs. 5. Open the connection link. Sign in with a QR code, or with your phone number and the login code. Enter your two-step verification password if Telegram asks for it. The built-in API credential pool is used by default, just like the normal workspace. You may expand the optional custom credentials section and enter both `api_id` and `api_hash` from [my.telegram.org/apps](https://my.telegram.org/apps). Leave both fields empty to use the built-in pool; a partial or malformed pair is rejected. Session imports are not allowed. Choose the export mode and scope. The connection link contains an access secret: keep it private. 6. Choose **Telegram Takeout**, **Regular Telegram API** or **Chat event journal**. For account export, choose all accessible chats or load and select one or more chats, then set dates, chat types, account categories and attachment rules. Check settings and size, optionally save the settings JSON for an independent reviewer, then press **Start capture**. Settings are fixed after starting. Resume works only while this runner exists; finishing early preserves acquired data and records gaps. Deadline expiry after starting produces an explicitly partial archive; expiry before starting or cancellation produces no archive. 7. Wait for **sealed-result**, download and unzip it, and decrypt `delivery.tgwsealed` in the helper. You receive `delivery.zip`, containing `evidence.zip`, `attestation.jsonl`, and instructions. Browser decryption is limited to 256 MiB; larger packages use the streaming local command below. Large results also include `delivery-NNNNNN.tgwsealed` parts; the main `delivery.tgwsealed` then contains `evidence.parts.json` and the attestation. Download every part and assemble locally as described below. 8. End the temporary session in Telegram Settings → Devices if revocation was not confirmed or the runner was killed. Normal completion attempts logout; network failures and forced runner termination prevent an absolute guarantee. The repository must contain the published pinned source and reusable-workflow commits. A local branch alone cannot be invoked by another GitHub repository. ## Session time budget Before collection, **Calculate time and size** estimates the selected history and files from message counts and a bounded sample. The display includes time already spent signing in, estimated collection time and a reserve for packaging. For files, the initial estimate uses 1 MiB/s and a twofold time margin; progress replaces that assumption with the measured rate. Use **Messages only** or select fewer chats when the estimate exceeds the remaining time. Telegram's reported Takeout wait is added to the budget. The collector stops acquisition when the remaining time is needed for packaging, retains acquired data and marks a partial result. A 120-minute session therefore uses its remaining collection window rather than waiting for the deadline before preparing the archive. The display identifies selections whose full size could not be sampled. ## Choose this mode or a persistent workspace | Capture mode | Configurable scope | Difference | | --- | --- | --- | | Telegram Takeout, the default | All accessible cloud chats or selected chats, dates, account categories, media policies and JSON/HTML views | Uses Telegram's official export mechanism; approval or waiting may be required. Takeout can enumerate left channels/groups where Telegram permits it and request additional personal data. | | Regular Telegram API | The same account scope and output choices, subject to methods available through the regular API | Does not initialize Takeout; cannot enumerate left channels/supergroups or fetch Takeout-only personal data. Contacts cover Telegram users rather than the complete saved phone contact list. Rate limits still apply. | | Chat event journal | One selected chat, attachment policies and optional avatars | Captures history and changes observed during this run. Account categories, date filters and Desktop-compatible views do not apply. | All three modes have the same GitHub attestation and encrypted delivery. Takeout is an acquisition method, not a stronger signature. It is never silently replaced by regular API access. JSON/HTML views are generated by TgWitness; they are not Telegram-signed files or guaranteed byte-identical Desktop exports. See the [official Takeout API](https://core.telegram.org/api/takeout). Defaults use Takeout, all accessible chat types including archived chats, all dates, account profile and contacts, compatible JSON and HTML, and file downloads. The initial media budget is 4 GiB, with visible per-type file limits; larger files or exhausted download budgets use server hashes where available. Review these limits before collecting. Hashes cannot reconstruct a file. Optional photos, stories, session metadata and extra personal data remain separate choices. Takeout may require approval in an established Telegram session. Telegram sets the delay; a new login or runner does not bypass it. The maximum capture window is 120 minutes including login and approval, so a large account or long approval wait may not finish. A persistent local export can resume the same session, but does not inherit GitHub attestation. ### Agree and verify the settings After **Check settings and size**, use **Save settings for verification**. Agree the resulting `sealed-export-settings.json` with the reviewer before collection. Changes invalidate the saved assessment. The collector signs the effective settings and their SHA-256, and account-export receipts bind the same options. The verifier reports the actual mode, selection and completeness, and rejects a disagreement between the journal and nested account export. ``` python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete ``` `--expected-selection` rejects a different transport, chat scope, filter or attachment policy. `--require-complete` rejects partial account exports and chat journals, whose overall completeness is not established. Without these flags, verification still checks provenance and integrity while reporting the recorded settings and gaps. A file supplied only with the finished archive cannot establish what was agreed beforehand. A valid signature never turns omitted data into data that was collected, or proves the owner did not edit/delete messages before capture. | Need | Mode | | --- | --- | | Export accessible account data or selected chats during a limited session and give a reviewer an externally attested archive | GitHub Actions capture (preview) | | Observe several chats continuously, manage accounts, search and read a growing archive | Local or Docker workspace | This starts a separate capture with a new login. It does not upload your existing local journal, export the currently open workspace, or reuse its Telegram session. An unfinished cloud capture cannot resume after its runner is destroyed; a new workflow starts a new capture. The workspace's **Exports → Open capture helper** opens the complete wizard inside the panel. The standalone page uses the same wizard, controls and themes. Both keep keys and decryption in your browser. GitHub workflow startup and the temporary Telegram panel open in separate tabs; the wizard tells you when to return. Locking the workspace clears the wizard's in-memory key. Your saved key file remains on your device. ## What is public, and what must stay private Collection runs on a standard GitHub-hosted runner. GitHub, the approved collector and dependencies, the helper page, the browser and the HTTPS tunnel are trusted parts of this setup. The temporary host processes the Telegram session and plaintext messages; the delivered artifacts are encrypted for the recipient. Forking copies project code into your repository. It does **not** export your Telegram account. The recipient workflow input is a public encryption key. Keep `sealed-key.json`, Telegram credentials, login codes, 2FA passwords and the decrypted connection URL out of commits, workflow inputs and public logs. The workflow publishes encrypted connection/result artifacts for one day. Download both in time; GitHub Actions availability, account limits and billing apply. A public fork is not a promise of unlimited free compute. No payment or GitHub access token is entered into the helper. The private decryption key stays in your browser/file. Telegram session material and plaintext observations necessarily exist inside the temporary collector. GitHub and the HTTPS tunnel remain trusted infrastructure. Attestation may make the archive digest and workflow identity public; the archive contents are not placed in the attestation. The attestation timestamp is not a message timestamp. ## Troubleshooting | Symptom | Next step | | --- | --- | | No **Run workflow** button | Open your own fork, enable Actions, and sync it with upstream `main`. Do not edit the approved upstream pins to bypass a failure. | | No `sealed-connection` artifact | Check whether the job started and completed its startup/upload step. Queue, runner, image download, tunnel or repository policy failures can prevent startup. | | Cannot open the connection | Load the saved key for this run, unzip the downloaded artifact and select `connection.tgwsealed`. The runner must still be active. | | History is paused | Check the panel's status and use Resume while the session remains active, or finish with the data already collected. Telegram limits and inaccessible content can leave gaps. | | No `sealed-result` | Cancellation or expiry before starting collection produces no archive. A failed collection, attestation or packaging step also prevents delivery. Inspect the failed step without posting credentials. | | Browser cannot decrypt a large archive | Use the streaming CLI below for packages larger than 256 MiB. A wrong or lost private key cannot decrypt the result. | | Verification rejects the signer | Use a trusted current TgWitness installation and the exact caller `OWNER/REPOSITORY`. Do not accept a replacement policy supplied with the archive. | | Telegram still lists the temporary session | End it in Settings → Devices. Logout can fail and a forcibly terminated workflow may not run cleanup. | Before relying on this preview, try a small chat you control: create a message and attachment, collect them, decrypt the result, run the verifier, check the coverage/media outcomes and confirm Telegram session revocation. Automated checks use a synthetic Telegram client plus a separate real GitHub certificate test; they do not establish live account acceptance. ## Local decryption and verification Use tools from an independently trusted installation, not executable files supplied by an unknown evidence archive: ``` python -m tgwitness.sealed_crypto decrypt delivery.tgwsealed --key sealed-key.json --out delivery.zip # Unzip delivery.zip using your archive manager, then: python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness ``` For multipart delivery, decrypt the main package first and keep its extracted manifest beside every encrypted part, then run: ``` python -m tgwitness.sealed_parts evidence.parts.json --key sealed-key.json --out evidence.zip python -m tgwitness.sealed_verify evidence.parts.json --assembled evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness ``` The manifest is the attested subject and binds every part and the assembled ZIP. Use `--max-gib` to set an appropriate uncompressed verification ceiling for a large archive; the default is 4 GiB. Expected-selection and complete-scope checks also work with multipart delivery. Python 3.11+, the project's dependencies, and a recent GitHub CLI supporting `--signer-digest` and `--deny-self-hosted-runners` are required. A CLI key generator is also available: `python -m tgwitness.sealed_crypto keygen sealed-key.json`. The verifier uses `tgwitness/sealed_policy.json` from the trusted installation. It checks the caller repository, upstream signer workflow, approved signer commit, hosted runner requirement, complete ZIP digest, internal journal and attachment integrity, fresh account-key origin, and expected collector commit. It displays history and media outcomes instead of implying all data was saved. An empty approved-release list fails closed. Updating the policy is an explicit trust decision; never accept an archive's own proposed policy automatically. For offline use, obtain trusted roots ahead of time from a trusted environment: ``` gh attestation trusted-root > trusted_root.jsonl python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --trusted-root trusted_root.jsonl ``` The timestamp of the attestation concerns the archive's commitment. It does not authenticate message timestamps or the collector's wall clock. See [GitHub's verification options](https://cli.github.com/manual/gh_attestation_verify). ## How the fork is kept outside the capture process The caller contains a job-level reference to the upstream reusable workflow at a full commit SHA. That workflow explicitly checks out **the upstream repository at a fixed collector SHA**. A default `actions/checkout` in a reusable workflow would check out the caller and is intentionally not used. The workflow does not restore caller caches, consume caller artifacts, execute caller files, or accept source/image URLs, shell commands, prepared ZIP files, or hashes to sign. It accepts a bounded public recipient and session duration. Actions, the Python base image, and cloudflared are pinned by immutable digests; Python dependencies use the existing hash-locked requirements. The image is built from the trusted source without a cache. The collector runs as a non-root user with a read-only image, dropped Linux capabilities, resource limits, and no Docker socket or GitHub-token environment. Its only mounts are fresh configuration, workspace, and output directories. The restricted FastAPI application exposes login, dialogs, configurable account or chat collection, status, resume, finish, and cancellation. There is no plaintext download route, general administration route, import route, or signing endpoint. The supervisor stops the network-facing containers before the attest action reads the final fixed `evidence.zip` or `evidence.parts.json`. The packaging container has no network. The upload steps name only `connection.tgwsealed` and `delivery*.tgwsealed`; neither plaintext evidence nor Telegram credentials are uploaded as artifacts. Cleanup removes the private directories and containers, with no claim of physical disk erasure. Artifact retention is one day; download before expiry. A fork owner can replace the caller or create a different signed file. The strict verifier must reject the resulting **different signer workflow/digest**. This construction still depends on the absence of exploitable bugs in approved code and on the integrity of GitHub's runner and signing infrastructure. ## Cryptographic handoff Each recipient key is RSA-3072 (RSA-4096 imports also accepted), exponent 65537. Each envelope has a fresh random AES-256 key and 96-bit nonce. RSA-OAEP with SHA-256/MGF1-SHA256 wraps the AES key. AES-GCM with a 128-bit tag authenticates the complete prefix and payload. The public recipient is DER SPKI in base64; the private key file contains DER PKCS8 in base64. Envelope bytes are `TGWSEAL1\n`, a big-endian uint32 JSON-header length, the header, ciphertext, and a 16-byte GCM tag. The header has exactly `algorithm`, `key`, and `nonce`; algorithm is `RSA-OAEP-256+A256GCM`. The complete prefix through the header is GCM additional authenticated data. Header size is bounded at 8192 bytes. The CLI streams payloads up to 8 GiB and authenticates before installing the requested output; it refuses overwriting an existing destination. This is a project-specific envelope around standard cryptographic primitives, not an independently audited encryption format. The original evidence bytes are attested **before** placing the evidence and attestation in the encrypted outer package. This avoids a circular dependency between the archive's hash and a certificate included inside that same archive. For public repositories, attestation metadata (repository, workflow, commit, artifact name and digest) is public. Never put chat names in public metadata. ## Limits and validation This mode uses the signed journal and account-export engine. Secret Chats, deleted history from before collection and data inaccessible to the account are excluded. Private cloud chats are eligible when selected. The chat picker is capped at 20,000 dialogs; account export discovers its own inventory. Missing data, failed files and unfinished tasks are recorded. Attachment limits and runner disk/time limits still apply. Large delivery uses encrypted parts instead of a fixed 4 GiB delivery cutoff. Completion means the frozen selected tasks finished, not that every historical Telegram record exists in the archive. The chat journal can also observe live updates; neither mode is an atomic snapshot. Generated screenshots and screen recordings are not part of this mode. Tests cover synthetic fresh login, scope isolation, media, cancellation, partial deadline completion, failed logout, forbidden API paths and fields, preloaded workspace rejection, wrong-key and tamper rejection, required verifier flags, and browser/Python encryption interoperability. The browser acceptance test uses a plainly labelled mock attestation; it is not a real Sigstore test. Real hosted-runner, Docker, GitHub attestation, and live Telegram acceptance must be reported separately from local synthetic checks. [GitHub Actions terms](https://docs.github.com/en/site-policy/github-terms/github-terms-for-additional-products-and-features#actions) restrict use of hosted runners to the software project's lifecycle. A fork does not remove these restrictions; this preview must not be marketed as unrestricted free production hosting. [Cloudflare Quick Tunnels](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) are also intended for testing and development. The helper/workflows are suitable for evaluating this feature; production service eligibility remains a separate deployment requirement. ## Maintainer release sequence 1. Commit and review the collector, supervisor, container definition and tests. 2. Pin that collector commit in `sealed-collector.yml`, then commit/review the reusable workflow. Never silently derive the checkout from the caller SHA. 3. Pin the reusable workflow commit in `sealed-witness.yml` and add its workflow/collector SHA pair to `sealed_policy.json` in a trusted release. 4. Publish all referenced commits and the helper, then test an independent fork and the real GitHub certificate. Do not squash away commits referenced by these pins unless the references are regenerated and published again. See [reusable workflows and attestations](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating) for the distinction between the caller repository and the upstream signer. --- # Telegram · تحقیق در تمام چت‌ها Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/cases/ یک تحقیق سراسری تلگرام را در سراسر کانال‌ها، گروه‌ها، چت‌های خصوصی و ربات‌ها اجرا کنید: ضبط کل حساب کاربری، تاریخچه، افراد، لینک‌ها، فایل‌ها، خطوط زمانی و شواهد تأییدشده. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) یک پرونده کامل در کانال‌ها، گروه‌ها، گفتگوهای خصوصی و ربات‌ها: جمع‌آوری کنید، نقطه‌ها را به هم وصل کنید، خط زمانی را بازسازی کنید، تحویل دهید. یک رویداد ساختگی، از اول تا آخر. جمع‌آوری، جستجو و نمایه افراد رکوردها را پیدا می‌کنند، [Case Board](https://phishdestroy.github.io/TgWitness/fa/docs/case-board/) آن‌ها را سامان می‌دهد و [Report studio](https://phishdestroy.github.io/TgWitness/fa/docs/reports/) ارائه‌شان می‌کند. پرونده بررسی‌شده / تغییر مقصد پرداخت ### یک حادثه. چهار گفتگو. یک ردپا برای بازسازی. یک پست کانال به یک ربات اشاره می‌کند. گروهی درباره لینک پرداخت جدید حرف می‌زند و ربات آن را نشان می‌دهد. پست ویرایش می‌شود، یک گفتگوی خصوصی لینک را تکرار می‌کند، یک پیام گروه ناپدید می‌شود. چه کسی هر نسخه را ارسال کرده است؟لینک در کجا ظاهر شد؟کدام فایل حفظ شده است؟چه چیزی تغییر کرد و چه زمانی؟ بارگذاری تاریخچه، هوش مصنوعی، MCP، OCR و webhookها: [کار با بایگانی](https://phishdestroy.github.io/TgWitness/fa/docs/archive/). ## ۱. پوشش‌دهی کل حساب کاربری محدوده کل حساب فقط روی حساب اختصاصی. حساب اصلی گفتگوهای انتخابی یا یک پوشه می‌گیرد. 1. [حساب را وصل کنید](https://phishdestroy.github.io/TgWitness/fa/docs/accounts/) در فضای کاری خودش. شماره پرونده، شناسه حساب، فضای کاری و اثر انگشت کلید را یادداشت کنید. 2. **منابع ← محدوده مشاهده ← حالت تحقیق**: **کل حساب**، هر چهار نوع منبع، **اقدامات خود**. برای هر گفتگوی جدید نمایه و آخرین **200 پیام قابل‌مشاهده** ذخیره می‌شود. **ذخیره محدوده** و تأیید کنید. 3. **بارگذاری گفتگوها** و با فهرست گفتگوهای حساب مقایسه کنید. حد 1,000 گفتگو است (تا 20,000 در **پارامترها ← گفتگوهای خوانده‌شده از فهرست حساب**)؛ گفتگوهای فراتر از آن وقتی فعال شوند ظاهر می‌شوند. 4. **تنظیمات ضبط** ← **همه فعالیت‌های قابل‌مشاهده**، محدودیت پیوست‌ها و فضای دیسک را بررسی کنید. شروع کنید، سپس با یک پیام، یک ویرایش و یک حذف آزمایش کنید. کانال‌هاگروه‌هاگفت‌وگوهای خصوصیربات‌ها یک حساب / یک کلید امضایی**تمام فعالیت‌های قابل مشاهده برای حساب انتخاب‌شده → یک گزارش** پیام‌ها · ویرایش‌ها · اعلان‌های حذف · واکنش‌های قابل مشاهده · رویدادهای عضویت · اقدامات خود «کل حساب» یعنی هر گفتگویی که این حساب می‌تواند باز کند، منهای موارد مستثنا. بدون گفتگوهای مخفی. گفتگوهای جدید با ظاهر شدن اضافه می‌شوند؛ تاریخچه قدیمی خودکار دانلود نمی‌شود. ## ۲. بازیابی تاریخچه و نگهداری فایل‌ها یک مجموعه در Case Board بسازید و موارد مهم را نشانک‌گذاری کنید. دفتر منابع نگه دارید: شناسه گفتگو، عنوان، حساب، نقش، شروع ضبط زنده، نتیجه تاریخچه، نتیجه رسانه، شکاف‌ها. | نیاز | اقدام در پنل | آنچه ارائه می‌دهد | | --- | --- | --- | | تاریخچه در سراسر چت‌های فعال‌شده | منابع → بارگذاری کل تاریخچه | پیام‌های در دسترس گذشته وارد دفتر کار می‌شوند، همراه با توقف/از سرگیری و گزارش پیشرفت امضا شده. [راهنمای تاریخچه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/history/). | | زمینهٔ گفتگوی موجود در دفترچهٔ شواهد | منابع → تنظیمات ضبط → نمای کلی تاریخچه | پیام‌های اخیر به‌صورت رکوردهای امضاشده. پیش‌فرض 500، تا 10,000 در **پارامترها ← بزرگ‌ترین اسنپ‌شات تاریخچه**. | | تاریخچهٔ کامل یک چت که در حال حاضر قابل مشاهده است | خروجی کامل چت ← خروجی کل چت، یا چت‌ها ← خروجی چت | یک بسته امضاشده جداگانه با `chat.json` و `chat.html`، یکی برای هر گفتگو. | | زمینه زمانی که یک گفتگوی جدید ظاهر می‌شود | دامنهٔ مشاهده → وقتی یک چت یا ربات جدید ظاهر می‌شود | نمایه آن و تا 1,000 پیام اخیر (200 در حالت تحقیق). روی گفتگوهای موجود اعمال نمی‌شود. | | بایت‌های پیوست | دانلود پیوست‌های قابل مشاهده + محدودیت‌های هر نوع | دنبال `media.saved` با SHA-256 و اندازه بگردید. در صف، ردشده یا ناموفق یعنی ذخیره نشده. | خروجی گفتگو وارد ژورنال یا نمایه افراد نمی‌شود. برای جستجوی تاریخچه قدیمی در TgWitness، از **بارگذاری کل تاریخچه** یا اسنپ‌شات‌ها استفاده کنید. اینجا: کانال، گروه، گفتگوی ربات و گفتگوی خصوصی، به‌علاوه فایل فاکتور و هش آن. آنچه پیش از ضبط حذف شده، از دست رفته است. ## ۳. گفتگوی در حال تحول و اقدامات خود را حفظ کنید بگذارید اجرا شود. گفتگوهای داغ را با ستاره در اولویت بگذارید، بررسی‌های مجدد را در **تنظیمات ضبط ← بررسی مجدد** تنظیم کنید و `recheck.completed`، FloodWait و نتایج رسانه را زیر نظر داشته باشید. **گفتگوها ← نمایه ← ذخیره نمایه همین حالا** توضیح گفتگو، فرمان‌های ربات و دیگر فراداده‌ها را ذخیره می‌کند. **دنبال کردن یک ربات یا دعوت‌نامه به‌عنوان بخشی از پرونده** 1. **گفتگوها ← باز کردن لینک Telegram**، اول پیش‌نمایش را ذخیره کنید. لینک و پیش‌نمایش رکوردهای امضاشده می‌شوند. 2. در صورت نیاز، **پیوستن / باز کردن و مشاهده** به گفتگو می‌پیوندد یا ربات را با پارامتر شروعش اجرا می‌کند. 3. برای مستند کردن یک اقدام، از پنل پاسخ دهید یا از **فشردن دکمه** استفاده کنید. `interaction.requested` و `interaction.result` را همراه با پاسخ ربات می‌گیرید. این‌ها اقدامات واقعی‌اند. دکمه‌هایی که در برنامه دیگری فشرده شده‌اند دیده نمی‌شوند، فقط پاسخ ربات. بدون برنامه‌های وب، پرداخت یا تلفن/مکان. ## ۴. دنبال کردن افراد، لینک‌ها و فایل‌ها در سراسر چت‌ها 1. **ژورنال**، **همه منابع**، یک عبارت، دامنه یا نام کاربری را جستجو کنید. نتایج را باز کنید و **به تخته** بفرستید. 2. **گفتگوها ← افراد ← روشن کردن نمایه‌ها**، فردی را انتخاب کنید: تاریخچه نام، پاسخ‌ها، فعالیت، **همچنین در…**، لینک‌ها، کیف‌پول‌ها، تلفن‌ها. رکوردهای ارجاع‌شده را باز کنید. 3. همان شناسه عددی کاربر را در گفتگوهای دیگر دنبال کنید. نام، کیف‌پول یا آواتار مشابه یک سرنخ است، نه مدرک. 4. هش فایل‌ها را مقایسه کنید. SHA-256 یکسان = بایت‌های یکسان. اینکه چه کسی آن‌ها را به اشتراک گذاشت سؤال دیگری است. نقشه پرونده / دنبال کنید ارجاعات رامورد فرضی · نمودار زنده نیست کانال / اطلاعیه**منبع اصلی → مقصد ویرایش‌شده** پیام شمارهٔ #۱۰۱، #۱۸۸ · پیام شمارهٔ #۸۴ · فرستنده نامشخص گروه / عملیات**کاربر ۷۱۰۰۱ لینک جدید را منتشر می‌کند** ثبت شمارهٔ ۱۴۶ · پیام شمارهٔ ۳۰۹ رسید فایل ذخیره شده شمارهٔ ۱۵۱ گفت‌وگوی ربات / سفارش**یک دکمه به آن مقصد اشاره می‌کند** رکورد شمارهٔ ۱۷۳ · پیام شمارهٔ ۱۲: بازگرداندن متادیتای دکمه خصوصی / پیگیری**کاربر 71001 مقصد را تکرار می‌کند** ثبت شمارهٔ ۲۰۵ · پیام شمارهٔ ۹۲۲ رسید فایل ذخیره شده شمارهٔ ۲۰۹ چهار چت مشاهدات متفاوتی ارائه می‌دهند. سوابق منبع را برای هر ارتباط دنبال کنید؛ پست کانال فرستنده‌ای مشخص ندارد. شناسه‌های عددی و ارجاعات سوابق برای این راهنمای گام‌به‌گام ابداع شده‌اند. این نقشهٔ توضیحی نشان می‌دهد چگونه نتایج جستجو، پروفایل‌ها و سوابق بررسی‌شده را به هم متصل کنید؛ Case Board کارت‌های مربوطه و ارجاعات منابع را ذخیره می‌کند. | اتصال | حمایت از مشاهده | نتیجه‌گیری برای حفظ | | --- | --- | --- | | همان حساب تلگرام | شناسهٔ کاربر ۷۱۰۰۱ در گروه #۱۴۶ و چت خصوصی #۲۰۵ | شناسه فرستنده یکسان در هر دو گفتگو. اینکه او در دنیای واقعی کیست سؤال دیگری است. | | مقصد تکراری | `pay.example.invalid/new` در #146، متادیتای دکمه #173، پست ویرایش‌شده #188 و #205 | یک لینک در چهار جا. اینکه چه کسی آن را کنترل می‌کند به منابع دیگر نیاز دارد. | | همان بایت‌های فایل | مقادیر کامل SHA-256 یکسان در رسیدهای رسانه‌ای تکمیل‌شده #151 و #209 | هر دو فایل بایت به بایت یکسان‌اند. | نمایه‌ها فقط افرادی را پوشش می‌دهند که در *این فضای کاری* چیزی نوشته‌اند، نه فهرست اعضا. ارجاع برای هر واقعیت: **پارامترها ← رکوردهای ارجاع‌شده برای هر واقعیت**. ## ۵. بازسازی توالی و علامت‌گذاری فواصل نسخه‌ها در **گفتگوها**، سپس **ژورنال** با **همه منابع** + **ویرایش‌ها**، **حذف‌ها**، **پوشش**. هر دو زمان را در خط زمانی بگذارید: تاریخ Telegram و زمان مشاهده. 1. 09:00 · #101**پست کانال ضبط شد** مقصد اصلی حفظ می‌شود. 2. 09:12 · #146 / #151**گروه لینک متفاوتی را معرفی می‌کند** کاربر ۷۱۰۰۱ آن را ارسال می‌کند؛ دانلود پیوست کامل می‌شود. 3. 09:16 · #173**ربات مقصد یکسانی را نشان می‌دهد** متادیتای ذخیره شده صفحه‌کلید حاوی لینک است. 4. 09:20 · #188**تغییرات اعلان کانال** مشاهدات اصلی و ویرایش‌شده هر دو باقی می‌مانند. 5. 09:24 · #205 / #209**پیگیری خصوصی آن را تکرار می‌کند** پیوست ذخیره‌شده همان هش کامل SHA-256 را مانند #151 دارد. 6. 09:28 · #231**اعلان حذف گروه دریافت شد** مشاهدهٔ قبلی همچنان برقرار است؛ نه هویت حذف‌کننده و نه زمان دقیق حذف ارائه نشده است. زمان‌ها و ارجاعات مشاهده‌ای نمایشی. سایر سوابق دفترچه بین این موارد قرار دارند. ترتیب ژورنال ترتیب رسیدن است، نه لزوماً ترتیب وقوع. رکوردهای زنده، اسنپ‌شات‌ها، پیام‌های بازیابی‌شده، حذف‌ها و «در بررسی مجدد پیدا نشد» را جدا نگه دارید و هر شکاف را نامعلوم علامت بزنید. ## ۶. گسترش پرونده به سایر حساب‌های جمع‌آوری‌کننده یک فضای کاری برای هر حساب، همان مراحل. نقش و اثر انگشت هر کدام را یادداشت کنید. شماره پیام‌ها برای هر حساب جداست، پس همیشه بگویید کدام فضای کاری و کدام گفتگو. یک [گروه حساب](https://phishdestroy.github.io/TgWitness/fa/docs/groups/) وضعیت را نشان می‌دهد، تنظیمات را به اشتراک می‌گذارد و از همه با هم خروجی می‌گیرد، هر کدام با ژورنال و کلید خودش. خط زمانی بین حساب‌ها را در یادداشت‌هایتان می‌سازید. پرونده طولانی است؟ یک [شاهد مستقل](https://phishdestroy.github.io/TgWitness/fa/docs/witness/) اضافه کنید و بسنجید هر حساب واقعاً چه می‌گیرد. ## ۷. ارائه یک بسته پرونده قابل بررسی یک ZIP امضاشده از هر فضای کاری (همیشه کل ژورنال، فیلترها اهمیتی ندارند)، به‌علاوه نمایه افراد، خروجی‌های گفتگو و فایل‌ها. ``` CASE-001/ # assembled by the analyst case-notes.md # question, findings, alternative explanations sources.csv # every chat, role, acquisition result and gap timeline.csv # account + chat + message + seq + both times workspace-A/ evidence.zip # complete signed observation journal retained-checkpoint.json profiles-operations.json # separately signed people profiles history-channel.zip # signed current-history export history-group.zip verification.txt workspace-B/ # separate journal and trusted fingerprint witness/ # retained checks, journal and signed posts SHA256SUMS # hashes of the delivered files ``` اثر انگشت‌ها را جداگانه بفرستید. همه چیز را در برابر فضای کاری خودش تأیید کنید: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --checkpoint retained-checkpoint.json python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` خروجی ابزار تأیید، اصل‌ها، پوشش و سابقه انتقال را کنار یافته‌هایتان نگه دارید. گزارش را در Report studio بنویسید. اگر گیرنده به کمتر نیاز دارد، یک [تحویل کمینه](https://phishdestroy.github.io/TgWitness/fa/docs/handover/) آماده کنید. --- # Telegram · یک بورد پرونده بسازید Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/case-board/ مشاهدات ذخیره‌شده، نکات برجسته دقیق و برش‌های عملیاتی را در یک تابلوی خصوصی جمع‌آوری کنید، آن‌ها را با تیم خود بحث کنید و یک مجموعه ارائه دهید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) پیام‌های ذخیره‌شده را به پرونده‌ای تبدیل کنید که تیمتان با هم روی آن کار می‌کند. نشانک‌ها، نقل‌قول‌های دقیق، برش‌ها و بحث، هر کدام به منبعش پیوند دارد. هر تغییر یک بازبینی امضاشده است. ## از یک پیام تا کارت پرونده 1. **تحقیق ← Case Board** (حالت استاندارد یا متخصص). برای پرونده یک مجموعه بسازید. 2. در **ژورنال** یا یک گفتگو **به تخته** (یا **B**) را بزنید. کارت در صندوق ورودی می‌نشیند، به آن عنوان بدهید و جابه‌جایش کنید. 3. متنی را در پیام انتخاب کنید، **برجسته‌سازی ← تخته** نقل‌قول دقیق و نسخه را نگه می‌دارد. یادداشت کنید چرا مهم است. 4. بحث کنید، وضعیت تعیین کنید، هر وقت لازم بود به منبع برگردید. **ارائه** تیم را گام به گام در آن می‌گرداند. ### یک لینک پرداخت تغییر یافته را دنبال کنید نمونه‌ی مصنوعی · نمونه‌ی محلی 1. **ثبت.** مشاهدهٔ ذخیرهٔ شمارهٔ ۱۴۲ و نسخهٔ پیام آن را باز کنید. 2. **نشانک.** نقل‌قول، مرجع منبع و سؤال شما را روی یک کارت نگه دارید. 3. **بازبینی.** یک نظر تیمی اضافه کنید و کارت را به بخش بازبینی منتقل کنید. 4. **ارائه.** مرور مجموعه و باز کردن زمینه منبع استنادشده. #### مشاهدهٔ ذخیره شدهٔ شمارهٔ ۱۴۲ «از لینک پرداخت جدید استفاده کنید.» چت عملیات · پیام ۳۸ · مشاهده‌شده ۰۹:۱۲ UTC #### کارت: مقصد تغییر یافته > از لینک پرداخت جدید استفاده کنید. سؤال: کدام مقصد در نسخهٔ قبلی ظاهر شد؟ #### بازبینی تیم تحلیلگر: با مشاهده شماره ۱۰۱ مقایسه کنید. وضعیت: بازبینی · نسخه حفظ شده #### زمینهٔ منبع کارت → نسخهٔ ذخیره شده → مشاهدهٔ قبلی توضیحات و مشاهده تلگرام به‌طور جداگانه قابل تشخیص باقی می‌مانند. ## یک بازهٔ مفید را یک‌بار ذخیره کنید با Shift روی دو پیام کلیک کنید برای **برش بین**، از **برش بر اساس زمان** استفاده کنید یا فیلترهای فعلی ژورنال را ذخیره کنید. **نمایش رکوردهای افزوده‌شده از زمان نشانک** آنچه بعداً آمده را نشان می‌دهد. برش‌های زمانی از زمان مشاهده استفاده می‌کنند؛ برش‌های شناسه پیام آن پیام‌ها را هنگام تغییر دنبال می‌کنند. ## نقش مناسب را به هر همکار بدهید **بازبین** می‌خواند، **تحلیلگر** کارت و نظر اضافه می‌کند، **اپراتور** مجموعه‌ها و تصمیم‌ها را هم مدیریت می‌کند. مجوزهای گفتگو روی کارت‌ها هم اعمال می‌شوند. ## کار را به یک محصول قابل تحویل منتقل کنید برش‌ها به‌صورت JSON امضاشده یا CSV خروجی می‌گیرند. گزارش‌ها می‌توانند نشانک‌ها، برش‌ها و نظرات را شامل شوند، این را در [Report studio](https://phishdestroy.github.io/TgWitness/fa/docs/reports/) تنظیم کنید. برای گیرنده محدود، از [تحویل](https://phishdestroy.github.io/TgWitness/fa/docs/handover/) استفاده کنید. جزئیات: [مرجع Case Board](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/). --- # Telegram · طراحی یک گزارش Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reports/ داده‌های گزارش را انتخاب کنید، یکی از هشت طرح و محتوای آن را برگزینید، سپس پیش‌نمایش و خروجی HTML، PDF امضا‌شده یا یک بسته کامل مدرک را صادر کنید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) خواننده را از پرسش پرونده مستقیم به رکوردهای ذخیره‌شده ببرید. Report studio داده‌هایی که انتخاب می‌کنید، تاریخچه تغییرات، نمودارها و یافته‌هایتان را کنار هم می‌گذارد. هشت طرح، HTML و PDF بومی. هر گزارش HTML، PDF و JSON با کلید شما مهر می‌شود. ## ساخت گزارش در سه مرحله 1. **خروجی‌ها ← پیکربندی و پیش‌نمایش ← داده**: کل فضای کاری، یا گفتگوها، نویسندگان، تاریخ‌ها (UTC، زمانی که TgWitness رکورد را دید) و انواع رکورد را انتخاب کنید. 2. **طرح و محتوا**: یک طرح و آنچه داخلش می‌رود را انتخاب کنید: نمودارها، شرکت‌کنندگان، متن کامل گفتگو، تغییرات، موارد Case Board، جزئیات پرونده و یادداشت‌هایتان. 3. **پیش‌نمایش**: شمارش‌ها، فعالیت، نمونه‌ها و بازه‌های شناسه گم‌شده را بررسی کنید. ذخیره کنید، سپس قالبی را که لازم دارید دانلود کنید. ### مطالب ذخیره‌شده را برای خواننده مرتب کنید نمونه‌ی مصنوعی · طرح شماتیک، نه گزارش تولیدشده 1. **انتخاب کنید.** دو چت و دورهٔ مشاهده برای پرونده را انتخاب کنید. 2. **نوشتن.** یک طرح‌بندی و بخش‌هایی را که به سؤال پاسخ می‌دهند، انتخاب کنید. 3. **پیش‌نمایش.** شمارش‌های انتخاب‌شده و متن‌های ذخیره شدهٔ قبل و بعد را بازبینی کنید. 4. **تأیید کنید.** فایل نهایی را تولید کرده و امضای آن را با اثر انگشت فضای کاری مورد اعتماد مقایسه کنید. #### مشاهدات منتخب ۲ چت · ۱ روز مشاهده پیام‌ها، ویرایش‌ها و اعلان‌های حذف #### ساختار گزارش ##### تغییر مقصد پرداخت پرسش پرونده → دامنه → یافته‌ها → ارجاعات سوابق **زمینه پیام** مشاهده شماره ۱۴۲: «از لینک پرداخت جدید استفاده کنید.» **تغییرات ذخیره شده** قبل: old.example.invalid → بعد: new.example.invalid #### انتخاب را بازبینی کنید ۱۸ مشاهده · ۲ ویرایش ذخیره شده زمان‌های ارسال، ویرایش و مشاهده برچسب‌های جداگانه‌ای دارند. #### تحویل‌شدنی نهایی PDF امضا شده + JSON امضا شده، یا یک فایل ZIP امضا شده همراه با گزارش قابل خواندن گیرنده فایل و اثر انگشت مورد اعتماد را بررسی می‌کند. ## سبک خواندن را انتخاب کنید **Classic, Editorial, Briefing, Analytics, Technical, Overview, Reading series, and Ledger & margin**: همان رکوردها، ظاهر متفاوت. تعویض، انتخاب و یادداشت‌هایتان را نگه می‌دارد. هر یک از 25 زبان. PDFها با فونت‌های همراه ساخته می‌شوند و مرورگر لازم نیست. چینی، ژاپنی و کره‌ای به فونتی مثل Noto Sans CJK روی سرور نیاز دارند (در سطح سیستم یا در `TGWITNESS_FONT_DIR`)، وگرنه فقط HTML و JSON می‌گیرید. ## یک تغییر را همراه با زمینهٔ آن بخوانید ویرایش‌ها قبل و بعد را نشان می‌دهند، حذف‌ها آخرین نسخه ذخیره‌شده را. پاسخ‌ها، بازارسال‌ها، واکنش‌ها، دکمه‌ها و پیوست‌ها ارجاع‌هایشان را حفظ می‌کنند. پیش‌نمایش طرح از 50,000 رکورد اول استفاده می‌کند و پیش‌نمایش داده همه چیز را دقیق می‌شمارد. برای چیدمان نهایی صفحه، PDF را بسازید. ## نسخهٔ گیرنده را با دقت انتخاب کنید فیلترها فقط گزارش را شکل می‌دهند، ZIP شواهد همچنان کل ژورنال و فایل‌ها را دارد. اگر گیرنده باید کمتر بگیرد، از [تحویل کمینه](https://phishdestroy.github.io/TgWitness/fa/docs/handover/) استفاده کنید. بیشتر: [محتوای گزارش](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-reports/)، [تأیید خروجی](https://phishdestroy.github.io/TgWitness/fa/docs/exports/). --- # Telegram · یک نسخهٔ اشتراک‌گذاری آماده کنید Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/handover/ سوابق و فیلدهایی را که دریافت‌کننده می‌تواند دریافت کند انتخاب کنید، نسخهٔ نهایی را بررسی کرده و منیفست امضا شده و مرز ژورنال منبع را تأیید کنید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) فقط آنچه لازم است را به اشتراک بگذارید، اصل دست‌نخورده می‌ماند. تحویل یک برگزیده امضاشده جداگانه است: گفتگوها و افراد را انتخاب کنید، هویت‌ها یا متن را پنهان کنید، فایل‌ها و یادداشت‌های تیم را انتخاب کنید. فهرست ثبت می‌کند چه نگه داشته، کوتاه و کنار گذاشته شد. ## خروجی گیرنده را آماده کنید 1. **خروجی‌ها ← برگزیده تحویل**: هدف را بنویسید، گفتگوها و بازه را انتخاب کنید، اگر افراد بانام لازم دارید **بارگذاری افراد گفتگوهای انتخابی**. 2. بقیه: نام مستعار، کنار گذاشته، یا همان‌طور که ثبت شده. متن و فایل‌ها کلیدهای جداگانه‌اند؛ تلفن‌ها و ایمیل‌ها را می‌توان پوشاند. 3. Case Board: هیچ، نشانک‌ها و برش‌ها، یا کارت‌ها با نظرات. نام اعضای تیم را می‌توان با نام مستعار عوض کرد. 4. **دانلود برگزیده تحویل**، بازش کنید، تأییدش کنید، پیش از ارسال نگاهی بیندازید. ### یک نسخهٔ اصلی، یک نسخهٔ اشتراکی عمدی مثال مصنوعی · صرفاً برای نمایش هویت 1. **انتخاب کنید.** گفتگوی پرونده را شامل کنید و فردی را که استخراج دربارهٔ اوست شناسایی کنید. 2. **حداقل‌سازی.** انتخاب کنید که شرکت‌کنندهٔ دیگر چگونه در نسخهٔ مشترک‌شده ظاهر شود. 3. **بازرسی کنید.** گزارش و سوابق آرشیو تولیدشده را پیش از ارسال باز کنید. 4. **اشتراک‌گذاری.** نسخهٔ بررسی‌شده را تحویل دهید و اثر انگشت معتبر آن را به‌طور جداگانه اعلام کنید. #### مشاهدهٔ اصلی نورا · کاربر ۷۱۰۰۲ «لینک اصلاح‌شده را دریافت کردم.» ژورنال منبع این مشاهدهٔ ذخیره شده را حفظ می‌کند. #### نسخه دریافت‌کننده به‌صورت ضبط‌شده نمایش دهید: نورا · کاربر ۷۱۰۰۲ · «لینک اصلاح‌شده را دریافت کردم.» نام مستعار: P01 · «لینک اصلاح‌شده را دریافت کردم.» حذف: پیام این شرکت‌کننده از متن کپی حذف می‌شود. #### فایل‌های واقعی را بازرسی کنید فایل‌های report.html و records.jsonl را بخوانید. هویت‌ها، متن، پیوست‌ها و نظرات اختیاری تیم را بررسی کنید. #### خروجی امضا شده انتخاب + هش‌های فایل + مانیفست امضا شده یک بستهٔ جداگانه که به مرز مجلهٔ منبع خود پیوند خورده است ## کنترل‌ها را با هم استفاده کنید | کنترل | تأثیر بر کپی | | --- | --- | | افراد | افراد انتخاب‌شده با نام می‌مانند؛ بقیه نام مستعار می‌گیرند یا کنار گذاشته می‌شوند. | | متن | همه متن، فقط متن افراد انتخاب‌شده و حساب شما، یا هیچ. | | فایل‌ها | فایل‌های افراد انتخاب‌شده و حساب شما، همه فایل‌های نمایش‌داده‌شده، یا هیچ. | | تخته پرونده | هیچ، نشانک‌ها و برش‌ها، یا کارت‌ها با بحث. | متن و فایل‌ها را هم بخوانید: نام مستعار نام‌هایی را که داخل پیام یا پیوست نوشته شده حذف نمی‌کند. اگر فایل انتخابی گم شده، بازیابی‌اش کنید یا پیوست‌ها را کنار بگذارید. ## متن را به‌گونه‌ای نگه‌دارید که به‌طور مستقل قابل بررسی باشد. ``` python -m tgwitness.verify handover.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` بایگانی اصلی و نقاط بازرسی را خودتان نگه دارید. گیرنده می‌تواند نسخه‌اش را بدون گرفتن کل فضای کاری تأیید کند. طرح: [Report studio](https://phishdestroy.github.io/TgWitness/fa/docs/reports/). مرجع‌های مورد اعتماد: [تأیید خروجی](https://phishdestroy.github.io/TgWitness/fa/docs/exports/). --- # Telegram · مدیریت گروهی از حساب‌ها Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/groups/ مقایسهٔ فضاهای کاری گروهی، یافتن منبع، بازبینی دوره‌های مشاهده و اعمال تنظیمات مشترک با استثناهای هر حساب کاربری. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) چند حساب را با هم اجرا کنید، هر کدام همچنان با رکوردها و کلید خودش. گروه وضعیت اتصال، شروع/توقف، تنظیمات مشترک و خروجی‌ها را در یک صفحه می‌گذارد. وقتی چند حساب روی یک پرونده کار می‌کنند کاربردی است. ## مرور کلی گروه را باز کنید گروه را در **حساب‌ها** باز کنید. هر حساب وضعیت، مسیر، تأخیر و آخرین پیام ذخیره‌شده را نشان می‌دهد. **نیاز به توجه** موارد خراب را فهرست می‌کند و **رفع** شما را مستقیم به آنجا می‌برد. **شروع همه** / **توقف همه** پیش از اجرا می‌پرسند. **تنظیمات گروه** مشترک است، اما مقادیر خود حساب تا وقتی جایگزینشان نکنید می‌مانند. ### بازبینی تغییر مسیر در یک گروه مثال مصنوعی · بررسی‌ها و نتایج نمایشی 1. **انتخاب کنید.** گروه را انتخاب کرده و بررسی کنید که کدام حساب‌ها تغییر خواهند کرد. 2. **آماده کنید.** وقتی باید جدا بماند، مسیر اختصاصی هر حساب را حفظ کنید. 3. **بررسی کنید.** اتصال پیشنهادی را آزمایش کرده و نتایج اندازه‌گیری‌شده را بازرسی کنید. 4. **اعمال کنید.** قبل از ذخیره مجدداً بررسی کرده و نتایج هر حساب را مرور کنید. #### تیم پرونده جمع‌آورنده کانال · جمع‌آورنده گروه · حساب مرجع ۳ فضای کاری مجزا #### انتخاب بازبینی‌شده ۲ حساب از مسیر پیشنهادی استفاده می‌کنند. حساب مرجع مسیر خود را حفظ می‌کند. #### بررسی‌های آماده‌سازی جمع‌آورنده کانال: انتقال تلگرام ۸۴ میلی‌ثانیه جمع‌کننده گروهی: انتقال تلگرام ۹۱ میلی‌ثانیه این اعداد اندازه‌گیری‌های فرضی برای مثال هستند. #### نتایج برنامه جمع‌آورنده کانال: مسیر ذخیره شد، مشاهده از سر گرفته شد. جمع‌آور گروهی: بررسی مجدد ناموفق، تنظیمات قبلی بازیابی شدند. حساب مرجع: مسیر خود حفظ شده است. ## مسیر را با یک مرحله بازبینی تغییر دهید 1. **تغییر مسیر گروه**، نوع و تنظیمات را انتخاب کنید. 2. **مرور انتخاب**: ببینید کدام حساب‌ها تغییر می‌کنند و کدام مسیر خودشان را دارند. 3. **آماده‌سازی و بررسی** یک اتصال تازه Telegram را آزمایش می‌کند، به‌علاوه IP خروجی در صورت امکان. 4. **اعمال اتصال بررسی‌شده** و هر نتیجه را ببینید. حساب‌های در حال اجرا ادامه می‌دهند، بیکارها بیکار می‌مانند. تأخیر زمان برقراری اتصال Telegram است و IP خروجی همان است که مسیر هنگام بررسی نشان داد. نتایج ممکن است بین حساب‌ها فرق کند. ## از دسترسی هم‌پوشان استفاده کنید **گفتگوهایی که چند حساب می‌بینند** منابع مشترک و پوششان را فهرست می‌کند. کانال‌ها و سوپرگروه‌ها را می‌توان با چند حساب هم‌زمان از طریق **خروجی با … حساب** گرفت. گفتگوهای خصوصی و گروه‌های ساده نه، چون شماره پیام‌هایشان برای هر حساب جداست. ## صادرات گروه به صورت بسته **خروجی گروه** یک ZIP با خروجی امضاشده هر حساب و فهرست امضاشده آن‌ها می‌دهد. هر کدام اثر انگشت خودش را برای تأیید حفظ می‌کند. خط زمانی ادغام‌شده را باز هم خودتان می‌سازید. بعدی: [گزارش‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reports/)، [Case Board](https://phishdestroy.github.io/TgWitness/fa/docs/case-board/)، [تأیید خروجی‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/exports/). --- # Telegram · ببینید مدرک چگونه کار می‌کند Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/concepts/ پیگیری یک پیام از زمان ضبط تا نقطهٔ کنترل. یک رکورد نمونه را تغییر دهید، زنجیرهٔ SHA-256 آن را مجدداً محاسبه کنید و ببینید نقطهٔ کنترل حفظ‌شده چه چیزی را تشخیص می‌دهد. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) پیام‌ها تغییر می‌کنند. سابقه شما از آنچه دیدید نباید تغییر کند و هر کسی باید بتواند این را بررسی کند. در ادامه دو آزمایش کوچک. پیام‌های جعلی، همه چیز در مرورگر شما اجرا می‌شود و چیزی به Telegram نمی‌رود. ## از خروجی چت تا یک سند قابل راستی‌آزمایی [خروجی Telegram Desktop](https://telegram.org/blog/export-and-more) تاریخچه‌ای را که همین الان می‌بینید به‌صورت HTML یا JSON ذخیره می‌کند. TgWitness یک ژورنال پیوسته از تغییرات، امضا روی هر رکورد و نقاط بازرسی‌ای که دیگران می‌توانند با آن مقایسه کنند اضافه می‌کند. | وظیفه | صادرات تلگرام دسکتاپ | TgWitness | | --- | --- | --- | | خواندن گفتگوهای ذخیره شده | HTML یا JSON همراه با رسانه‌های منتخب | گفت‌وگوهای ذخیره‌شده، دفترچه یادداشت قابل جستجو و گزارش‌های آفلاین | | تغییر را در طول زمان دنبال کنید | تاریخچه موجود هنگام خروجی گرفتن | نسخه‌های قدیمی، ویرایش‌های بعدی و حذف‌ها، همه نگه داشته می‌شوند | | پس از تحویل، فایل‌ها را بررسی کنید | فایل‌های خروجی استاندارد HTML/JSON امضا نشده‌اند | فهرست امضاشده، رکوردهای امضاشده و گزارش‌های مهرشده، بررسی‌شده با کلید مورد اعتماد | | با یک وضعیت نگهداری‌شده قبلی مقایسه کنید | یک نسخه مرجع جداگانه یا هش را نگه دارید | نقاط کنترل امضا شده، شاهد جداگانه و مهرهای زمانی خارجی اختیاری | این مقایسه بر اساس [کد خروجی Telegram Desktop](https://github.com/telegramdesktop/tdesktop/tree/768d47cda6c7f447c10a25d1f363279493a90ed7/Telegram/SourceFiles/export/output) تا تاریخ 2 نوامبر 2026 است. ## یک پیام، سه مشاهده یک پیام جدید، یک ویرایش و یک حذف به سه رکورد جداگانه تبدیل می‌شوند. ویرایش اولی را بازنویسی نمی‌کند و حذف آن را پاک نمی‌کند. ۰۱ / مسیر پیامسکانس نمایشی Telegram delivers an update to the collector, which appends a journal record. · تلگرام · مجموعه‌کننده · مجله · به‌روزرسانی → · ضمیمه → نمای گفتگو کنونی پیام شمارهٔ ۴۲ پیام حذف شد پیام از نمای چت ناپدید شده است. دفترچهٔ مشاهدات ۳ رکورد 1. 01 `message.new` ساعت ۱۰:۰۰ ملاقات کنید ✓ 2. 02 `message.edited` ساعت ۱۱:۰۰ ملاقات کنید ✓ 3. 03 `message.deleted` اطلاعیه حذف برای #۴۲ ✓ تمام سه مشاهده دریافت‌شده در دفترچه شواهد باقی می‌مانند. مسیر ساده‌شده برای یک منبع از پیش انتخاب‌شده. سوابق عملیاتی نیز دفترچه واقعی را به اشتراک می‌گذارند. ضبط بستگی به آنچه حساب کاربری می‌تواند ببیند و آنچه تلگرام ارائه می‌دهد دارد. Telegram نمی‌گوید چه کسی پیامی را حذف کرد یا دقیقاً کی. TgWitness به‌جای حدس زدن این فیلدها را خالی می‌گذارد. ## یک رکورد را تغییر دهید. هش را دنبال کنید. هر رکورد هش رکورد قبلی را در خود دارد. نقطه بازرسی‌ای که جای دیگری نگه داشته شده طول ژورنال و آخرین هش را ثابت می‌کند. ۰۲ / محوطهٔ آزمایشی زنجیرهٔ هشSHA-256 واقعی · سوابق نمونه ثبت ۰۱**پیام دریافت شد**`h₁ = SHA-256(e₁)`پیوندها به ۶۴ صفر ثبت ۰۲**ساعت ۱۱:۰۰ ملاقات کنید**`h₂ = SHA-256(e₂)`شامل h₁ ثبت ۰۳**حذف مشاهده شد**`h₃ = SHA-256(e₃)`شامل h₂ در جای دیگری نگهداری می‌شود**۳ رکورد · سر `h₃`**این مرز ثابت را با دفترچهٔ ارائه‌شده مقایسه کنید. تغییر یک رویداد، هَش آن را تغییر می‌دهد. بازسازی زنجیره، سر آن را تغییر می‌دهد. حذف انتها، آن را کوتاه‌تر از نقطهٔ کنترل باقی‌مانده می‌کند. **رکورد ۲ و هش‌های کامل را بررسی کنید.** این دقیقاً همان JSON با هش UTF-8 است که در این مثال آمده است. مقادیر فرضی هستند؛ نه فیلد و سریال‌سازی با فرمت دفترچه شواهد مطابقت دارد. ``` ``` هَش دوم رکورد ذخیره شده `` هاش رکورد ۲ مجدداً محاسبه شد `` این sandbox هش‌ها را محاسبه می‌کند، نه امضاها را. اعتبارسنج واقعی همچنین امضای Ed25519، توالی و لینک هر رویداد را بررسی می‌کند. بازسازی صرف هش‌ها نمی‌تواند امضاهای معتبری تحت کلید مورد اعتماد ایجاد کند. ## قوانین واقعی، در چند خط هَش + امضا h0 = 064 hi = hex(SHA-256(C(ei))) σi = Ed25519.Sign(sk, unhex(hi)) **C** نُه فیلد رویداد به‌صورت JSON با UTF-8 است: کلیدهای مرتب، بدون فاصله اضافه، بدون escape کردن ASCII، بدون NaN/بی‌نهایت. `previous_hash` برابر hi−1 است، h0 برابر 64 صفر است و امضاها 32 بایت خام چکیده را پوشش می‌دهند. فیلدها: `seq`، `observed_at`، `source_at`، `kind`، `chat_id`، `message_id`، `actor_id`، `payload`، `previous_hash`. مشخصات کامل: [کدگذاری رویداد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#event-canonicalization). نقطه کنترل حفظ‌شده Nexport ≥ Ncheckpoint hexport[Ncheckpoint] = Hcheckpoint امضای نقطه بازرسی را با کلید سنجاق‌شده بررسی کنید، سپس آن را با ژورنال مقایسه کنید. خروجی بعدی می‌تواند طولانی‌تر باشد، اما در نقطه بازرسی باید منطبق باشد. ## سه سؤال، سه بررسی متفاوت [۰۱ / یکپارچگی**آیا این رکورد تغییر کرده است؟** هش‌ها و امضاها در برابر کلیدی که به آن اعتماد دارید.](https://phishdestroy.github.io/TgWitness/fa/docs/exports/)[۰۲ / تداوم**چه چیزی قبلاً نگهداری شده بود؟** خروجی را با نقاط بازرسی‌ای که شاهد نگه داشته مقایسه کنید.](https://phishdestroy.github.io/TgWitness/fa/docs/witness/)[۰۳ / تحویل**آیا این رویدادهای آزمایشی دریافت شدند؟** پیام‌های آزمایشی بفرستید، ویرایش و حذف کنید و ببینید هر حساب چه گرفت.](https://phishdestroy.github.io/TgWitness/fa/docs/cases/) امضاها به «آیا تغییر کرده؟» پاسخ می‌دهند، نقاط بازرسی به «آیا با آنچه قبلاً بود می‌خواند؟» و پیام‌های آزمایشی به «آیا همه چیز را گرفتیم؟». [تأیید چه چیزی را ثابت می‌کند و چه چیزی را نه.](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope) بعدی: [تحقیق روی کل یک حساب](https://phishdestroy.github.io/TgWitness/fa/docs/cases/) از شروع تا بسته پرونده. [Export Clinic: watch the controlled Desktop experiment](https://phishdestroy.github.io/TgWitness/docs/export-clinic/). Compare the two-minute film, the original recording and seven pairs of test exports. Local modification is disclosed. --- # Telegram · آن را امن نگه دارید Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/security/ ببینید جلسات، کلیدها و شواهد کجا قرار دارند، چه اطلاعاتی از دستگاه شما خارج می‌شود، محافظت‌ها چه چیزهایی را پوشش می‌دهند و چگونه می‌توان یک نصب را مستحکم‌تر کرد. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) چه چیزی از دستگاه شما خارج می‌شود، هر راز چه چیزی را باز می‌کند و حفاظت‌ها چه چیزی را پوشش می‌دهند در برابر آنچه بر عهده شماست. **127.0.0.1**آدرس پنل به‌صورت پیش‌فرض **۲۵۶ بیتی**توکن پنل تصادفی **0**شبکه‌های توزیع محتوا (CDN)، تحلیل‌ها یا فونت‌های دور **Ed25519**امضا در هر رکورد ## جایی که همه‌چیز زندگی می‌کند جمع‌کننده، پنل و هر رکورد روی دستگاه شما می‌مانند. به‌طور پیش‌فرض فقط با Telegram تماس گرفته می‌شود؛ بقیه هر کدام یک کلید جداگانه است. ۰۶ / آنچه از دستگاه خارج می‌شودنصب شما کامپیوتر یا سرور شما **پنل**127.0.0.1:8787 · توکن حامل **مجموعه‌کننده**یک کلاینت تلگرام به ازای هر فضای کاری پوشهٔ داده‌ها **مجله**SQLite · زنجیره‌ای هش · امضا شده **رسانه‌ها**فایل‌هایی با نام‌گذاری SHA-256 **گنجینه**فرنت · جلسه، جفت API، کلید امضا، پروکسی - **تلگرام**همیشه · از طریق مسیر شما اتصال MTProto حساب: مستقیم، SOCKS5، HTTP یا MTProxy. حالت مخفی‌سازی IP منتظر یک پروکسی فعال است. بازگشت مستقیم نیازمند حالتی است که صراحتاً آن را مجاز کند. - **نسخه خارج از محل**اختیاری · به‌صورت پیش‌فرض غیرفعال ژورنال، فایل‌ها و نقاط کنترل با AES-GCM رمزگذاری می‌شوند پیش از بارگذاری در ذخیره‌سازی سازگار با S3. کلید نزد شما باقی می‌ماند؛ پیوست‌ها با هش‌های کلیدمحور نام‌گذاری می‌شوند، نه هش محتوای آن‌ها. - **اخطاریه‌ها**اختیاری · به‌صورت پیش‌فرض غیرفعال مشکلات و شمارش تغییرات همراه با عناوین چت. گزیده‌های پیام تنها در صورتی ارسال می‌شوند که آن‌ها را فعال کنید. - **مرجع زمان‌بندی**اختیاری · به‌صورت پیش‌فرض غیرفعال فقط هش SHA-256 یک نقطهٔ کنترل امضا شده و یک عدد یک‌بار مصرف تصادفی. بدون پیام‌ها، بدون نام‌های چت. - **شاهد**اختیاری · به‌صورت پیش‌فرض غیرفعال با یک توکن فقط-خواندن، نقاط کنترل امضا‌شده و شمارنده‌های ضبط را استخراج می‌کند. نمی‌تواند مکالمات را بخواند یا تنظیمات را تغییر دهد. پیش‌فرض: تنها اتصال تلگرام از این دستگاه خارج می‌شود. مقاصد اختیاری برای هر فضای کاری پیکربندی می‌شوند. متن پیام و رسانه‌ها به‌صورت رمزگذاری‌نشده در دایرکتوری داده‌ها ذخیره می‌شوند: آن را با رمزگذاری دیسک و مجوزهای فایل محافظت کنید. ## هر رمز چه چیزی را آشکار می‌کند | مخفی | محلی که نگهداری می‌شود | آنچه را که باز می‌کند | اگر فاش شود | | --- | --- | --- | --- | | **توکن پنل** | `panel-token.txt` در پوشه داده؛ مرورگر آن را برای هر زبانه نگه می‌دارد | همه چیز در هر فضای کاری | TgWitness را متوقف کنید، `panel-token.txt` را حذف کنید، دوباره اجرا کنید: یک توکن جدید می‌گیرید | | **جلسه تلگرام** | گاوصندوق، رمزگذاری‌شده (`credentials.enc`) | خود حساب تلگرام | جلسه را در تلگرام تحت *«تنظیمات» → «دستگاه‌ها»* پایان دهید. | | **کلید امضا** | گاوصندوق، رمزگذاری‌شده (`signing.enc`) | امضای رکوردها با اثر انگشت شما | نقاط بازرسی در جای دیگر، شاهد و مهرهای زمانی همچنان نشان می‌دهند پیش‌تر چه وجود داشت | | **کلید گاوصندوق** | `vault.key` کنار داده‌ها، یا یک کلید اصلی خارجی | گاوصندوق | فرض کنید نشست و کلید امضا هم نشت کرده‌اند | | **توکن شاهد** | روی میزبان شاهد | فقط‌خواندنی: نقاط بازرسی و سلامت | آن را در صفحه شاهد حذف کنید، یکی تازه بسازید | | **کپی کلید خارج از محل** | گاوصندوق؛ یک‌بار آن را دانلود کنید تا در صورت نیاز بازیابی شود | کپی خارج از محل | هر کسی که bucket را هم داشته باشد می‌تواند رمزگشایی کند: کپی را افشاشده فرض کنید | ## محدودهٔ پوشش حفاظتی ### پوشش داده شده - رکوردی که تغییر کرده، حذف یا جابه‌جا شده: زنجیره هش یا یک امضا می‌شکند. - ژورنالی که پس از ذخیره نقطه بازرسی در جای دیگر کوتاه یا بازسازی شده: نقطه بازرسی دیگر منطبق نیست. - حدس زدن توکن: 256 بیت تصادفی، مقایسه با زمان ثابت، 15 شکست در دقیقه و آدرس مسدود می‌شود. - محتوای خصمانه گفتگو: متن متن می‌ماند و هرگز HTML نمی‌شود؛ پیوست‌ها به‌صورت فایل دانلود می‌شوند؛ پنل چیزی از سایت‌های دیگر بارگذاری نمی‌کند. - پوشه داده دزدیده‌شده با کلید گاوصندوق خارجی: نشست‌ها و کلیدها رمزگذاری‌شده می‌مانند. ### به شما واگذار شد - توکن اصلی همه کار می‌کند. به دیگران دسترسی محدود بدهید و توکن اصلی را برای خودتان نگه دارید. - هر کسی که روی دستگاه مدیر باشد می‌تواند همه چیز را بخواند و ژورنال را دوباره امضا کند. اثر انگشت و نقاط بازرسی را جای دیگری نگه دارید. - TgWitness پیام‌ها و رسانه را رمزگذاری نمی‌کند. دیسک را رمزگذاری کنید و مجوزها را محدود کنید. - HTTP ساده بیرون از localhost توکن را نشت می‌دهد. از HTTPS یا تونل SSH استفاده کنید. - امضاها نمی‌گویند چه چیزی از دست رفته. پوشش را بررسی کنید و تحویل را روی حساب‌ها و منابع خودتان آزمایش کنید. [دسترسی به یک پرونده را به اشتراک بگذارید](https://phishdestroy.github.io/TgWitness/fa/docs/access/) با مجوزها، انقضا و محدودیت نشست. ## سخت‌گیری یک نصب ۰ از ۸ انجام شد 1. **از یک حساب Telegram اختصاصی استفاده کنید**، هرگز حساب اصلی‌تان را. 2. **پنل را روی 127.0.0.1 نگه دارید.** دسترسی از راه دور فقط با HTTPS (Caddy همراه) یا تونل SSH. 3. **دیسک را رمزگذاری کنید** که پوشه داده روی آن است، پیام‌ها و رسانه همان‌طور که هستند ذخیره می‌شوند. 4. **پوشه داده را محدود کنید** به حساب سرویس (0700 در Unix، مجوزهای پوشه در Windows). 5. **کلید گاوصندوق را جای دیگری نگه دارید** روی سرورها: پیش از اولین اجرا `TGWITNESS_VAULT_KEY_FILE` را تنظیم کنید. 6. **اثر انگشت و نقاط بازرسی را ذخیره کنید** روی سیستمی دیگر، و شاهد را روی میزبانی دیگر اجرا کنید. 7. **هرگز** کلیدهای `data/`، sessions، `panel-token.txt` یا vault را در گیت‌هاب یا یک چت **آپلود نکنید**. 8. سربرگ‌های `Authorization` را در یک پروکسی معکوس **ثبت نکنید**. **آیا می‌توانم توکن پنل را بدون از دست دادن داده‌ها تغییر دهم؟** بله، فقط پنل را باز می‌کند. TgWitness را متوقف کنید، `panel-token.txt` را حذف کنید، دوباره اجرا کنید. ژورنال، نشست‌ها و کلیدها می‌مانند. اگر `TGWITNESS_TOKEN` تنظیم شده باشد، مقدار آن بر فایل مقدم است. **چرا پیام‌ها هنگام ذخیره‌سازی رمزگذاری نمی‌شوند؟** جمع‌کننده باید آن‌ها را بخواند تا جستجو، مقایسه و خروجی‌گیری کند. کلیدی روی همان دستگاه جلوی کسی را که به هر حال می‌تواند آن دستگاه را بخواند نمی‌گیرد. رمزگذاری دیسک از دیسک دزدیده‌شده محافظت می‌کند و مجوزها از سیستم در حال اجرا. ## گزارش یک آسیب‌پذیری **Security → Report a vulnerability** در GitHub. نسخه، تأثیر و بازتولید حداقلی با داده جعلی. هرگز اعتبارنامه، پوشه حساب یا شواهد واقعی نفرستید. اگر گزارش خصوصی خاموش است، یک issue باز کنید و کانال خصوصی بخواهید، بدون جزئیات بهره‌برداری. --- # Telegram · راه‌اندازی یک بات شاهد Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/witness/ نقاط کنترل دفتر ثبت امضا شده را با یک شاهد جداگانه، کلید اختصاصی و دسترسی فقط-خواندن به کانال تلگرام خود منتشر کنید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) یک فرایند جداگانه ژورنال شما را بررسی می‌کند و نقاط بازرسی امضاشده را در یک کانال منتشر می‌کند. ## دو میزبان، دو کلید امضا میزبان / گردآورنده**حساب + دفترچه** کلید امضای گردآورنده جلسه تلگرام نقطه پایانی نقطه‌کنترل فقط-خواندنی ← درخواست پاسخ امضا‌شده → میزبان B / شاهد**تأیید و نگهداری** اثر انگشت جمع‌آوری ثابت‌شده کلید امضای شاهد جداگانه ژورنال اختصاصی + توکن بات شاهد ← رابط برنامه‌های کاربردی ربات تلگرام ←**کانال شما · پست‌های امضا شده با TGW1** شاهد خود به‌صورت خودکار چک‌ها را انجام می‌دهد. دسترسی گردآورنده فقط خواندنی است. انتشار ربات از اتصال و توکن شاهد استفاده می‌کند؛ هیچ جلسه حساب کاربری‌ای به شاهد داده نمی‌شود. ۰۳ / تصمیمات نقطه‌کنترلپاسخ‌های مصور آخرین پذیرش**۱۲۰ رکورد**`head 9c7d…` پاسخ بعدی**۱۲۸ رکورد**`head a4f2…` پذیرفته شد: شمارش افزایش می‌یابد، امضا تأیید می‌شود و کلید مطابقت دارد. شاهد این مرز جدید را حفظ می‌کند. تمام مثال‌های پاسخ‌دهی فرض می‌کنند که امضای معتبر و کلید سنجاق‌شده وجود دارد. هش‌های اینجا نمونه‌های مختصر هستند. تنها تعداد بیشتر به‌تنهایی نمی‌تواند ثابت کند که کل پیش‌وند قدیمی بدون تغییر باقی مانده است؛ خروجی را با نقاط کنترل حفظ‌شده مقایسه کنید. ## یک ربات و یک کانال آماده کنید با BotFather یک ربات بسازید و اجازه دهید در کانالتان پست بگذارد. شاهد را جای دیگری اجرا کنید: میزبانی دیگر، ترجیحاً با مدیریت کسی دیگر، بسیار ارزشمندتر از فرایند دومی کنار جمع‌کننده است. ## سه مرحله در بخش اضافی 1. **دسترسی فقط‌خواندنی.** **افزونه‌ها ← شاهد مستقل**، توکن بسازید، فایل را ذخیره کنید. فقط نقاط بازرسی و سلامت را می‌خواند، نه چیز دیگری. 2. **کانال و فاصله زمانی.** کانال Telegram یا webhook دیسکورد، به‌علاوه آدرس جمع‌کننده‌ای که شاهد به آن دسترسی دارد. فایل تنظیمات را ذخیره کنید. 3. **اجرا.** `witness.json`، `witness-token.txt` و `bot-token.txt` را با هم روی میزبان شاهد بگذارید و اجرا کنید: ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json ``` منتظر اولین پست امضاشده در کانال بمانید، سپس اثر انگشت شاهد را جای امنی ذخیره کنید. به‌جای آن Discord؟ URL وب‌هوک را با نام `discord-webhook.txt` ذخیره کنید. هر شاهد در یک جا منتشر می‌کند؛ بررسی‌های طولانی به‌صورت فایل در Discord می‌رسند. ## انتخاب کنید هر چند وقت یک‌بار منتشر شود انتشار هر بررسی یک سابقه بیرونی منظم می‌دهد: هر پنج دقیقه یعنی حدود 288 پست در روز برای هر فضای کاری. تنظیمات پیشرفته می‌توانند فقط هنگام تغییر یا مشکل منتشر کنند، یا از پروکسی یا Bot API سفارشی استفاده کنند. **این بات در واقع چه چیزی را تصدیق می‌کند؟** از جمع‌کننده یک نقطه بازرسی امضاشده می‌خواهد، آن را با کلید مورد انتظار بررسی می‌کند و ژورنال امضاشده خودش را نگه می‌دارد، از جمله پاسخ‌های ازدست‌رفته و ردشده. وضعیت ژورنال را بررسی می‌کند، خودش Telegram را زیر نظر ندارد. برای آن، یک آزمون تحویل کنترل‌شده اجرا کنید. ## بعداً شواهد را بررسی کنید ژورنال شاهد، پست‌ها و اثر انگشت‌ها را نگه دارید. [چطور آن‌ها را بررسی کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/#verify) در برابر خروجی جمع‌کننده. --- # Telegram · کار با آرشیو Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/archive/ بارگذاری تاریخچه، جستجو در سوابق ذخیره‌شده، بررسی منابع هوش مصنوعی و اتصال ابزارهای خود. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) پیام را پیدا کنید. منبع را بررسی کنید. پرونده را بسازید. 01**وارد کردن تاریخچه** پیام‌های گذشته منابع فعال را به فضای کاری بکشید. 02**منابع را دنبال کنید** جستجو کنید، سپس پیام ذخیره‌شده پشت هر نتیجه را باز کنید. 03**واگذاری را واضح نگه دارید** تحلیل شما در یک فایل، شواهد امضاشده کنارش. سوابق ضبط‌شده، متن شناسایی‌شده و نتیجه‌گیری‌های تحلیلگر از یکدیگر مجزا باقی می‌مانند. ## بارگذاری پیام‌های گذشته 1. **منابع ← گفتگوهای در محدوده**: گفتگوهای فعال را بررسی کنید و مشاهده را شروع کنید. 2. **بارگذاری کل تاریخچه**. فهرست منابع را همان‌طور که الان هست برمی‌دارد. 3. **توقف موقت تاریخچه** / **ادامه تاریخچه** در هر زمان. پس از راه‌اندازی مجدد، دستی ادامه دهید. 4. نتایج هر منبع و صف دانلود را بررسی کنید، گزارش پیشرفت امضاشده را کنار خروجی نگه دارید. این فضای کاری را پر می‌کند. خروجی HTML/JSON یک گفتگو چیز دیگری است. [جزئیات](https://phishdestroy.github.io/TgWitness/fa/docs/reference/history/). ## ابتدا جستجو کنید، سپس در مورد هوش مصنوعی تصمیم بگیرید 1. **ژورنال** به‌صورت محلی جستجو می‌کند، با فیلتر منبع و زمان. 2. یک عبارت یا دامنه را جستجو کنید، رکورد و نسخه‌هایش را باز کنید. 3. برای هوش مصنوعی، مدیر یک ارائه‌دهنده را در **یکپارچه‌سازی‌ها** تنظیم می‌کند. سپس **از بایگانی بپرسید**: گفتگوها و بازه را انتخاب کنید، به **داده‌های ارسالی به مدل** نگاه کنید و تیک چیزهایی را که نباید بیرون بروند بردارید. 4. ارجاع‌ها را بررسی کنید، پاسخ را به‌عنوان گزارش ذخیره کنید، یادداشت‌هایتان را اضافه کنید. جستجو به هوش مصنوعی نیاز ندارد. گزارش‌ها منابع و بازبینی‌های خود را جدا از ژورنال امضاشده نگه می‌دارند. [تنظیم ارائه‌دهنده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/analysis/). ## اتصال مورد نیاز خود را انتخاب کنید | وظیفه | باز | راه‌اندازی | | --- | --- | --- | | اجازه دهید یک کلاینت هوش مصنوعی گفتگوهای انتخابی را بخواند | **یکپارچه‌سازی‌ها → MCP** | [MCP را نصب کنید، توکن محدود بسازید، وصل شوید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/) | | شناسایی متن در رسانه‌های ذخیره‌شده | یک رکورد `media.saved` → **شناسایی پیوست** | [worker محلی Docker را راه‌اندازی کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/media-analysis/) | | ارسال رویدادها به n8n یا یک SIEM | **یکپارچه‌سازی‌ها → وب‌هوک‌های خروجی** | [گیرنده اضافه کنید، HMAC را بررسی کنید، شناسه‌های تکراری را حذف کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/webhooks/) | **کدام توکن دسترسی کجا قرار می‌گیرد؟** دسترسی به پنل برای آدم‌هاست. MCP توکن‌های فقط‌خواندنی خودش را دارد و webhookها راز HMAC خودشان را. هیچ‌کدام به نشست Telegram نیاز ندارند. [دسترسی پنل را به اشتراک بگذارید](https://phishdestroy.github.io/TgWitness/fa/docs/access/) یا [یک کلاینت MCP را پیکربندی کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/). ## ارائه منابع و نتیجه‌گیری‌ها گزارش را کنار ZIP امضاشده بگذارید. گزارش برداشت شما از منابع است و ZIP همان چیزی است که گیرنده تأیید می‌کند. [صادرات و تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/exports/) · [پیگیری یک تحقیق کامل](https://phishdestroy.github.io/TgWitness/fa/docs/cases/) --- # Telegram · یک مورد را به اشتراک بگذارید Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/access/ به بازبینان و تحلیلگران دسترسی به حساب‌ها و چت‌های منتخب را با مجوزهای جداگانه، محدودیت‌های جلسه و توکن‌های قابل‌پس‌گرفتن فراهم کنید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) موردی را که کسی نیاز دارد به اشتراک بگذارید. کنترل بقیه را حفظ کنید. 01**شواهد را انتخاب کنید** کل فضاهای کاری یا گفتگوهای منفرد. 02**انتخاب اقدامات** مشاهده، خروجی، یا فقط عملیاتی که لازم دارند. 03**محدودیت‌ها را تعیین کنید** یک توکن شخصی با انقضا، محدودیت نشست و قواعد IP در صورت تمایل. دامنهٔ جمع‌آوری مشخص می‌کند چه چیزی ضبط می‌شود. دامنهٔ دسترسی مشخص می‌کند یک فرد چه می‌تواند ببیند و انجام دهد. ## دسترسی به کسی بدهید 1. به‌عنوان مدیر، **دسترسی** را باز کنید. 2. نامی بدهید، فضاهای کاری و گفتگوها را انتخاب کنید. 3. بازبین فقط به **مشاهده** نیاز دارد. برای دانلود **خروجی** را اضافه کنید. 4. محدودیت‌ها را تنظیم کنید، سپس روی **«ایجاد دسترسی»** کلیک کنید. 5. توکن را کپی کنید (یک بار نمایش داده می‌شود) و همراه آدرس پنل به‌صورت خصوصی بفرستید. 6. اول در یک نشست جداگانه مرورگر بررسی کنید که چه خواهند دید. ## با کاری که باید انجام دهند شروع کنید | شخص | دسترسی | نتیجه | | --- | --- | --- | | بازبین | گفت‌وگوهای منتخب؛ فقط مشاهده | گفتگو را می‌خواند، نمی‌تواند چیزی را تغییر دهد. | | تحلیلگر | گفت‌وگوهای منتخب؛ مشاهده و خروجی‌گیری | آنچه پرونده لازم دارد را می‌خواند و دانلود می‌کند. | | اپراتور | فضای کاری‌های کامل انتخاب‌شده؛ منابع و مجموعه | تصمیم می‌گیرد چه چیزی مشاهده شود، جمع‌کننده‌ها را شروع و متوقف می‌کند. | این‌ها فقط نمونه‌اند، نه نقش‌های ثابت. دسترسی محدود به گفتگو هرگز تنظیمات حساب یا خروجی کامل ژورنال نمی‌گیرد. دسترسی به همه فضاهای کاری حساب‌هایی را که بعداً اضافه شوند هم شامل می‌شود. ## هر زمان که بخواهید نظر خود را تغییر دهید دسترسی را هر زمان ویرایش کنید، از درخواست بعدی اعمال می‌شود. یک نشست را پایان دهید یا همه را لغو کنید. فایل‌های دانلودشده برنمی‌گردند. جمع‌آوری ادامه دارد. **محدودیت‌های جلسه و آی‌پی** نشست‌های موازی و ورودها را محدود کنید، تاریخ پایان بگذارید، IP یا زیرشبکه‌ها را مجاز کنید، یا به IP اولین ورود قفل کنید. انقضا عدم فعالیت را می‌شمارد و پنل باز فعال حساب می‌شود. پشت پروکسی، بررسی کنید برنامه کدام IP کلاینت را می‌بیند. **کلید اصلی و گزارش فعالیت** توکن اصلی نزد مدیر می‌ماند. دسترسی صادرشده نمی‌تواند دسترسی دیگران را مدیریت کند یا کنسول مدیریت را باز کند. تغییرات دسترسی و نشست‌ها بدون توکن در ژورنال امضا می‌شوند. مدیر سرور همچنان همه چیز را می‌بیند. هر هفت مجوز و قواعد نشست: [مرجع دسترسی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/). --- # Telegram · آن را در حال اجرا نگه دارید Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/server/ TgWitness را روی سروری با حافظه دائمی، دسترسی به پنل خصوصی، پشتیبان‌گیری و بررسی‌ها پس از راه‌اندازی مجدد اجرا کنید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) جمع‌کننده را روشن و داده‌ها را در راه‌اندازی‌های مجدد امن نگه دارید. ## روش راه‌اندازی را انتخاب کنید نصب بومی: [راه‌انداز](https://phishdestroy.github.io/TgWitness/fa/docs/start/) به‌علاوه قالب‌های سرویس در [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md). Docker، از پوشه پروژه: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` پنل روی localhost:8787 گوش می‌دهد. آن را محلی یا از طریق تونل SSH باز کنید، با توکن فرمان دوم. ## تمام دایرکتوری داده‌ها را حفظ کنید نصب بومی: `data/live`. Docker: حجم `tgwitness-data`. ژورنال‌ها، نشست‌ها و کلیدها باید کنار هم باشند. خروجی امضاشده شاهد است، نه پشتیبان. 1. اول جمع‌آوری را متوقف کنید. 2. کل پوشه داده را به جای امنی بیرون از میزبان کپی کنید. 3. پیش از اعتماد، بازیابی آن را روی یک نصب جداگانه امتحان کنید. ## پس از راه‌اندازی مجدد بررسی کنید فضای کاری و کلید، اتصال، منابع و رسیدن پیام‌های جدید را بررسی کنید. TgWitness آنچه Telegram هنوز دارد را جبران می‌کند، نه هر چیزی که هنگام خاموشی رخ داده. کانتینر «healthy» یعنی وب‌سرور پاسخ می‌دهد. اینکه جمع‌آوری کار می‌کند یا نه را پیام آزمایشی و شاهد می‌گویند. ## فقط آنچه را که قصد دارید منتشر کنید HTTPS، حجم‌ها، به‌روزرسانی‌ها و بازیابی در مرجع استقرار هستند. آنچه واقعاً آزمایش شده: [سابقه اعتبارسنجی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/). --- # Telegram · مشخص کنید چه چیزی اشتباه پیش رفته است Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/troubleshooting/ دسترسی پنل، اتصال تلگرام، پیام‌های مفقود، FloodWait و وضعیت شاهد را با استفاده از سیگنال‌های مناسب برای هر مشکل بررسی کنید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) از نشانه شروع کنید، هر بار یک چیز را بررسی کنید. ## پنل یک توکن می‌خواهد توکن پنل را از فایلی که راه‌انداز چاپ کرد می‌خواهد. Docker: `docker compose exec tgwitness cat /data/panel-token.txt`. نه کد Telegram، نه توکن ربات، نه توکن شاهد. ## تلگرام متصل نمی‌شود بررسی اتصال را اجرا کنید. روی پروکسی عمومی، یکی دیگر انتخاب و ذخیره کنید. نوع پروکسی و قالب راز را بررسی کنید. تازه‌سازی فهرست‌ها خودبه‌خود مسیر را عوض نمی‌کند. ## متصل است، اما پیام جدید ندارد 1. آیا مشاهده در فضای کاری درست در حال اجراست؟ 2. آیا منبع انتخاب شده و برای آن حساب قابل‌مشاهده است؟ 3. یک پیام یکتا در گروه آزمایشی بفرستید و آن را جستجو کنید. 4. در ژورنال دنبال قطعی‌ها یا خطاهای Telegram بگردید. گفتگوی ساکت فقط چیز تازه‌ای ندارد. اگر کامل بودن مهم است، یک آزمون تحویل کنترل‌شده اجرا کنید. ## FloodWait یا یک وقفه پس از راه‌اندازی مجدد FloodWait یعنی Telegram می‌گوید «آهسته‌تر». صبر کنید تا بگذرد و بار را سبک کنید، اتصال دوباره کمکی نمی‌کند. پس از راه‌اندازی مجدد TgWitness آنچه Telegram هنوز دارد را جبران می‌کند؛ باقی شکاف است، پس یادداشتش کنید. ## ربات پیکربندی شده اما هیچ پستی ارسال نمی‌کند آیا شاهد در حال اجراست، ربات می‌تواند در کانال پست بگذارد، به جمع‌کننده و Bot API دسترسی دارد؟ در ژورنالش دنبال پست‌های ناموفق بگردید. یک درخواست در سمت جمع‌کننده به این معنا نیست که پستی منتشر شده. ## یکپارچه‌سازی توکن گیت‌هاب کجاست؟ **برنامه‌ریزی‌شده.** بخش «اضافه» گردش کار پیشنهادی برای بررسی شاخه‌برداری و ساخت را توصیف می‌کند. در حال حاضر هیچ فرم توکن گیت‌هاب یا تأیید خودکار وجود ندارد که نشان دهد یک نصب در حال اجرا با یک مخزن مطابقت دارد. [وضعیت فعلی ویژگی‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/)را ببینید. گزارش باگ؟ نسخه، سیستم‌عامل، مراحل و خطای پاک‌سازی‌شده. هرگز نشست، توکن، پیام خصوصی یا پوشه داده را در issue عمومی نگذارید. --- # 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 و خروجی هوش مصنوعی مشاهدات اصلی امضا‌شده را تغییر نمی‌دهند. --- # Telegram · راه‌اندازی سریع Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/quickstart/ هر روش نصب و راه‌اندازی TgWitness: بسته ویندوز، پایتون، داکر و دمو مصنوعی، همراه با بررسی‌های اولیه. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) هر روش نصب و راه‌اندازی TgWitness: بسته ویندوز، پایتون، داکر و دمو مصنوعی، همراه با بررسی‌های اولیه. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![شروع کار](https://phishdestroy.github.io/TgWitness/assets/chapter-start.svg) **انگلیسی** · [روسی](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/QUICKSTART.md) · [اوکراینی](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/QUICKSTART.md) · [اسپانیایی](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/QUICKSTART.md) · [پرتغالی (برزیل)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/QUICKSTART.md) · [ترکی](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/QUICKSTART.md) · [عربی](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/QUICKSTART.md) · [فارسی](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/QUICKSTART.md) · [اردو](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/QUICKSTART.md) · [هندی](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/QUICKSTART.md) · [بهاسا اندونزی](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/QUICKSTART.md) · [تایلندی](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/QUICKSTART.md) · [فونت ساده‌شدهٔ چینی](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/QUICKSTART.md) TgWitness یک برنامه مستقل برای مشاهده گروه‌ها و کانال‌های تلگرامی است که حساب‌های کاربری شما به آن‌ها دسترسی دارند. این برنامه به صورت محلی و با دایرکتوری داده اختصاصی خود اجرا می‌شود. **اولین بازدید؟** پیش از اتصال حساب، [نسخهٔ نمایشی را امتحان کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/quickstart/#explore-the-interface). برای پراکسی‌ها، شاهدان، خروجی‌ها یا راه‌اندازی سرور، [راهنمای مناسب را انتخاب کنید](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md). ## نصب و راه‌اندازی [ثبت با GitHub Actions (پیش‌نمایش)](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) یک روش را انتخاب کنید. دانلودهای قابل حمل پس از انتشار نسخهٔ نهایی در دسترس قرار می‌گیرند: | میزبان | هیچ چیزی نصب نشده است | منبع: پایتون ۳.۱۱+ | داکر: انجین/دسکتاپ با Compose 2.20+ | | --- | --- | --- | --- | | ویندوز | `TgWitness--windows-amd64-portable.zip` را از GitHub Releases استخراج کنید، روی `TgWitness.cmd` دوبار کلیک کنید | روی `Start.cmd` دوبار کلیک کنید | روی `scripts\Docker.cmd` دوبار کلیک کنید | | لینوکس / مک‌اواس | — | `sh start.sh` | `sh scripts/docker-start.sh` | برای روش‌های مبتنی بر سورس، [شاخهٔ `main` فعلی را دانلود و استخراج کنید](https://github.com/phishdestroy/TgWitness/archive/refs/heads/main.zip) یا مخزن را کلون کنید: ``` git clone https://github.com/phishdestroy/TgWitness.git cd TgWitness ``` در صورت یافت نشدن Python مناسب، `Start.cmd` پیشنهاد نصب Python 3.12 را برای کاربر ویندوز شما می‌دهد (از طریق winget یا نصب‌کنندهٔ امضاشدهٔ python.org). در صورت نبود Python، اسکریپت `start.sh` دستور دقیق نصب را برای توزیع لینوکس یا macOS شما چاپ می‌کند. اولین اجرا از طریق سورس، محیط `.venv` را ایجاد کرده و وابستگی‌ها را به‌طور خودکار نصب می‌کند. Docker برنامه را می‌سازد و آن را در پس‌زمینه راه‌اندازی می‌کند؛ پایتون میزبان غیرضروری است. `scripts\Docker.cmd` و `scripts/docker-start.sh` آدرس پنل و توکن را زمانی که کانتینر سالم است چاپ می‌کنند. دستورات معادل Docker در هر میزبان پشتیبانی‌شده عبارتند از: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` http://127.0.0.1:8787 را باز کنید. از توکنی که توسط دستیار Docker یا دستور دوم Docker چاپ شده است استفاده کنید، یا برای نصب قابل حمل یا سورس، **فایل data/live/panel-token.txt را** بخوانید. در بخش **«اتصال تلگرام**» در زیر ادامه دهید. نصب‌های بومی و داکر از ذخیره‌سازی جداگانه‌ای استفاده می‌کنند؛ راه‌اندازی داکر، ژورنال بومی موجود را وارد نمی‌کند. برای یک سرور، [استقرار](https://phishdestroy.github.io/TgWitness/fa/docs/reference/deployment/) شامل HTTPS خودکار، راه‌اندازی مجدد، تصاویر منتشرشده، به‌روزرسانی‌ها و پشتیبان‌گیری‌ها است. ## رابط کاربری را کاوش کنید 1. دستور **TgWitness-Demo.cmd را** در بستهٔ قابل حمل، **scripts\Demo.cmd** را در یک پوشهٔ منبع ویندوز، یا `sh start.sh --demo` را در لینوکس/macOS اجرا کنید. اجرای سورس ابتدا `.venv` را ایجاد کرده و وابستگی‌ها را نصب می‌کند. 2. **http://127.0.0.1:8787 را** باز کنید. 3. دموی محلی به‌طور خودکار دفترچه نمونه را باز می‌کند. برای دسترسی مستقیم محلی نیازی به کپی توکن نیست. پیام‌های دمو خیالی هستند. حالت دمو نمی‌تواند به یک حساب واقعی تلگرام متصل شود. ## اتصال تلگرام > [!هشدار] **از هر چیزی که تحمل از دست دادنش را ندارید، استفاده نکنید.** ما قویاً توصیه می‌کنیم که حساب‌های شخصی یا باارزش خود را متصل نکنید و روی حسابی که برایتان ارزش دارد، شناسه/هش API ایجاد نکنید. تلگرام حساب‌ها را به طور غیرقابل پیش‌بینی و اغلب به صورت دائم، صرف‌نظر از کلاینت، مسدود می‌کند. یک اجرای آزمایشی موفقیت‌آمیز به تلگرام بستگی دارد، نه به TgWitness، و هیچ تضمینی برای آینده ندارد. 1. اگر دموی بومی در حال اجرا باشد، آن را متوقف کرده و **Start.cmd** یا `sh start.sh` را اجرا کنید. در غیر این صورت، نصب زندهٔ بالا را همچنان در حال اجرا نگه دارید. 2. برای باز کردن پنل، از توکن پنل مربوط به روش نصب خود استفاده کنید. 3. اگر به پروکسی نیاز دارید، آن را در مسیر **حساب کاربری → تنظیمات → تنظیمات اتصال → تغییر مسیر اتصال** ذخیره کنید. 4. در بخش **«حساب» (Account)**، شماره تلفن خود را وارد کرده و دکمه **«ادامه» (Continue)** را فشار دهید، سپس **«کد QR» (QR code) → «نمایش کد QR» (Show QR code**) را انتخاب کنید، یا فایل‌ها را انتخاب کرده و دکمه **«اتصال حساب» (Connect account**) را فشار دهید. **«شناسه API + هش» (API ID + Hash)** اختیاری است: فضای کاری از جفت ذخیره شده یا وارد شده خود، یا یک جفت فعال از مجموعه داخلی استفاده می‌کند. برای استفاده از اپلیکیشن خود، یک جفت `API ID:API Hash` را در بخش «شناسه API» (API ID) جای‌گذاری کنید. برای یک کلید احراز هویت کامل، **«کلید احراز هویت» (Auth key) را** انتخاب کنید، تمام ۵۱۲ کاراکتر هگزادسیمال را الصاق کنید و شناسه DC ارائه‌شده را انتخاب کنید. شناسه کاربر اختیاری است و در صورت وارد کردن، تیک آن زده می‌شود. 5. روش ورود انتخابی خود را تکمیل کنید: تلفن/کد/2FA، تأیید از طریق اپلیکیشن تلگرام واردشده برای QR، یا وارد کردن یک جلسه مجاز پشتیبانی‌شده. 6. شناسه حساب نمایش‌داده‌شده را بررسی کنید. **منابع** آزاد: چت‌های شما به‌طور خودکار بارگذاری می‌شوند؛ گروه‌های خود را اضافه کنید. 7. در بخش **«انتخاب تغییرات قابل نگهداری**»، دسته‌بندی‌های رویداد یا پیش‌تنظیم **«پیام‌ها، ویرایش‌ها و حذف‌ها**» را انتخاب کرده، سپس تنظیمات پایش را ذخیره کنید. 8. تنظیمات پیوست را به‌طور جداگانه انتخاب کنید، سپس دکمهٔ **«شروع مشاهده» را** فشار دهید. اطلاعات اعتبارنامه API، برنامه شما را شناسایی می‌کنند؛ آن‌ها به خودی خود، حساب کاربری را مجاز نمی‌سازند. گروه‌های خصوصی به نام کاربری عمومی نیازی ندارند، اما حساب کاربری شما باید دسترسی داشته باشد. برای حساب‌های موجود، [حساب‌ها و قالب‌های نشست](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/) را ببینید: پنل از Telethon StringSession، فایل‌های SQLite مربوط به Telethon/Pyrogram، فایل ZIP تک‌حسابی TData و فایل‌های JSON پشتیبانی‌شدهٔ حساب پشتیبانی می‌کند. یک نشست و فایل JSON همراه آن را با هم انتخاب کرده و **اتصال حساب** را بزنید. ورود با کد QR نیز با همان تنظیمات اختیاری API در دسترس است. نشست‌های TDLib، نشست‌های ربات و فهرست‌های حساب CSV/JSON پشتیبانی نمی‌شوند. برای چندین حساب، از **حساب‌ها → وارد کردن حساب‌ها** استفاده کنید و فایل‌های نشست پشتیبانی‌شدهٔ آن‌ها را انتخاب نمایید. فایل‌های JSON همراه بر اساس نام پایهٔ فایل جفت می‌شوند؛ هر حساب واردشده فضای کاری مخصوص به خود را دریافت می‌کند. بخش [وارد کردن دسته‌ای و گروه‌های حساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#bulk-import-and-account-groups) را ببینید. برای افزودن حساب کاربری دیگر، دکمه **+** را در کنار انتخابگر حساب کاربری فشار دهید یا به مسیر **حساب کاربری → تنظیمات → تنظیمات اتصال → فضاهای کاری** بروید، یا از **بخش حساب‌ها** استفاده کنید. فضاهای کاری دارای جلسات، دفترچه‌های ثبت، کلیدها، منابع و صف‌های مجزا هستند. تغییر نماها باعث توقف سایر گردآورنده‌ها نمی‌شود. یک حساب تلگرام نمی‌تواند در این نصب به دو فضای کاری اختصاص داده شود. تعداد ثابتی از فضاهای کاری وجود ندارد؛ آنها یک فرآیند را به اشتراک می‌گذارند، بنابراین ظرفیت به ماشین بستگی دارد. توکن پنل زنده از دسترسی به مجوزهای تلگرام و مطالب ذخیره‌شده شما محافظت می‌کند؛ این توکن از اعتبارنامه‌های API تلگرام جداست. تنها یک دمو محلی که صراحتاً راه‌اندازی شده و مستقیماً به آن دسترسی پیدا شده باشد، ورود خودکار خواهد داشت. یک دمو از راه دور/پروکسی همچنان از `data/demo/panel-token.txt` استفاده می‌کند. ## بازبینی و صدور - **مجله:** جستجو و فیلتر کردن مشاهدات بر اساس منبع و نوع رویداد. - یک رویداد را انتخاب کنید تا رکورد اصلی، انتساب و نسخه‌های ذخیره‌شده آن را بررسی کنید. - جزئیات ویرایش محتوای موجود قبل و بعد را نشان می‌دهند. جزئیات حذف، در صورت وجود، آخرین محتوای ضبط‌شده را نشان می‌دهند؛ عامل ناشناس همچنان ناشناس باقی می‌ماند. - **خروجی‌ها:** ZIP امضا‌شده، JSONL، CSV و HTML آفلاین. - **خروجی کامل چت** (منابع → خروجی کامل چت): دانلود کل تاریخچه قابل مشاهده یک چت به صورت یک بسته امضا شده با `chat.json` (سبک خروجی تلگرام) و یک `chat.html` قابل خواندن. چت‌های خصوصی زمانی کار می‌کنند که حساب کاربری عضو باشد. این یک نسخهٔ لحظه‌ای فعلی است، نه بازسازی پیام‌های حذف‌شده یا ویرایش‌شده در گذشته. نسخه را با `python verify.py chat-export.zip --fingerprint TRUSTED_SHA256` تأیید کنید. - **ذخیره نقطه کنترل:** مرز دفترچهٔ امضا شده را خارج از جمع‌کننده نگه دارید. - **دانلود رسید اجرای امضا شده:** حفظ سوابق برنامه/نسخهٔ گردآورنده. - **درخواست مهر زمانی را آماده کنید:** یک درخواست آفلاین برای یک مرجع مهر زمانی آماده کنید؛ برای دریافت و تأیید پاسخ، به [فایل TIMESTAMP.md](https://phishdestroy.github.io/TgWitness/fa/docs/reference/timestamp/) مراجعه کنید. - **تأیید دفترچه:** بررسی امضاهای رویداد و پیوندهای زنجیره. خروجی ZIP همچنین رسانه‌ها را بررسی می‌کند. مرورگرهای پشتیبانی‌شده خروجی‌های حجیم را مستقیماً در یک فایل انتخاب‌شده ذخیره می‌کنند. سایر مرورگرها حداکثر ۱۲۸ مگابایت را در بافر نگه می‌دارند. در حالی که سرور در حال اجراست، CLI پخش (streaming) دانلودهای بزرگ‌تر را بدون بافر کردن کل پاسخ پشتیبانی می‌کند: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` برای یک فضای کاری دیگر، با استفاده از **«صادرات → شناسه فضای کاری» (Exports → Workspace ID**)، `--profile ID` را اضافه کنید. برای یک سرور از راه دور، `--url https://your-server` را اضافه کنید. محدودیت پیش‌فرض انتقال ۵ گیگابایت است؛ `--max-mib` آن را تغییر می‌دهد. محتوای ZIP امضا شده به طور پیش‌فرض دارای محدودیت تأیید اعتبار جداگانه ۴ گیگابایتی برای فایل‌های فشرده نشده است (**پارامترها** آن را افزایش می‌دهند؛ چنین آرشیوهایی را با `verify.py --max-gib N` تأیید کنید). آرشیو را با استفاده از یک نسخه مورد اعتماد از اعتبارسنج و یک اثر انگشت/نقطه کنترل کلیدی که به طور مستقل نگهداری شده است، تأیید اعتبار کنید. ## نصب را بررسی کنید ``` python start.py --setup-only python start.py --check python start.py --check --json ``` ابزار `--check` وابستگی‌های محلی، پشتیبانی از امضا، ذخیره‌سازی، پیکربندی کلید و آدرس گوش دادن را بررسی می‌کند. این ابزار هیچ چیزی نصب نمی‌کند و به تلگرام متصل نمی‌شود. یک پورت شلوغ ممکن است به این معنی باشد که یک نمونه دیگر در حال اجرا است. از یک `--port` دیگر استفاده کنید یا ابتدا آن را متوقف کنید. راه‌انداز در `.venv` نصب می‌شود. دستورات کمکی `python -m tgwitness...` باید از `.venv\Scripts\python.exe` در ویندوز یا `.venv/bin/python` در لینوکس/macOS استفاده کنند، مگر اینکه آن محیط از قبل فعال باشد. ## جلسات، حفاظت و عملکرد یک پایگاه داده SQLite بسته و یکپارچه `.session` می‌تواند به صورت محلی با `python -m tgwitness.sessions account.session --out account.tgwitness-session` تبدیل شده و سپس در حساب کاربری بارگذاری شود. وارد کردن مستقیم فایل و ورود با QR نیز در دسترس است. برای مشاهده فرمت‌های ورود، SOCKS5، HTTP CONNECT، MTProxy و کلیدهای اصلی خارجی به [CONNECTION-SECURITY.md](https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/) مراجعه کنید. **توقف مشاهده** جمع‌آوری را متوقف می‌کند. **قفل کردن** فقط دسترسی از طریق مرورگر را می‌بندد. با بستن زبانه، فرایند جمع‌آوری همچنان اجرا می‌شود. متوقف کردن فرایند، جمع‌آوری را قطع می‌کند؛ ثبت تاریخچه نمی‌تواند تمام ویرایش‌ها یا حذف‌های ازدست‌رفته را بازسازی کند. برای سیاست‌های رویدادها، صف‌های پیوست، جداسازی حساب‌ها و رفتار هنگام راه‌اندازی مجدد، [نحوهٔ کار جمع‌آوری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/) را ببینید. جلسات و اسرار رمزگذاری می‌شوند. محتوای پیام، رسانه‌ها و خروجی‌ها به یک دیسک یا حجم رمزگذاری‌شده نیاز دارند. امضاها یکپارچگی را نسبت به یک کلید مورد اعتماد برقرار می‌کنند؛ آن‌ها اصالت تلگرام را اثبات نمی‌کنند و از جعل توسط اپراتوری که گردآورنده و کلید آن را کنترل می‌کند، جلوگیری نمی‌کنند. برای پشتیبان‌گیری/بازیابی [فایل OPERATIONS.md](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/)، برای میزبانی [فایل DEPLOYMENT.md](https://phishdestroy.github.io/TgWitness/fa/docs/reference/deployment/) و برای نمونه‌های سرویس به [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) مراجعه کنید. پنل نصب‌شده همچنین شامل یک راهنمای راه‌اندازی آفلاین در آدرس `/guide.html` است. تأیید واقعی و محدودیت‌های باقی‌مانده در [فایل‌های VERIFICATION.md](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/) و [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md) ثبت شده‌اند. --- # نصب، تأیید و به‌روزرسانی Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/installation/ نصب با یک دستور، بررسی امضاها و هش‌ها، به‌روزرسانی و حذف یک نصب. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) Translation coverage: this edition includes material from the English original. نصب با یک دستور، بررسی امضاها و هش‌ها، به‌روزرسانی و حذف یک نصب. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [شروع کار](https://phishdestroy.github.io/TgWitness/fa/docs/reference/quickstart/) ![شروع کار](https://phishdestroy.github.io/TgWitness/assets/chapter-start.svg) [پروژه](https://github.com/phishdestroy/TgWitness/blob/main/README.md) · [راه‌اندازی سریع](https://phishdestroy.github.io/TgWitness/fa/docs/reference/quickstart/) · [استقرار](https://phishdestroy.github.io/TgWitness/fa/docs/reference/deployment/) **در این صفحه** - [نصب با یک دستور](https://phishdestroy.github.io/TgWitness/fa/docs/reference/installation/#install-with-one-command) - [جایی که همه‌چیز اجرا می‌شود](https://phishdestroy.github.io/TgWitness/fa/docs/reference/installation/#where-everything-runs) - [تنظیمات جستجوی متن کامل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/installation/#full-text-search-settings) - [دسترسی خط فرمان](https://phishdestroy.github.io/TgWitness/fa/docs/reference/installation/#command-line-access) - [پیش از اجرا تأیید کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/installation/#verify-before-running) - [به‌روزرسانی یک نصب موجود](https://phishdestroy.github.io/TgWitness/fa/docs/reference/installation/#update-an-existing-installation) - [دستورهای روزمره در اوبونتو](https://phishdestroy.github.io/TgWitness/fa/docs/reference/installation/#everyday-commands-on-ubuntu) - [TgWitness را حذف کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/installation/#remove-tgwitness) ## با یک دستور نصب کنید نصب‌کنندهٔ راهنمایی‌شده شامل یک محیط اجرای خصوصی پایتون است. برای نصب‌های آینده از همان آدرس استفاده کنید: هر انتشار، نصب‌کننده، هش‌ها، امضاها و اطلاعات ساخت را به‌طور همزمان به‌روزرسانی می‌کند. **لینوکس / مک‌اواس (بش):** ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` روی یک سرور اوبونتو، برای نصب یک سرویس پس‌زمینه، آن را با دسترسی ریشه اجرا کنید. روی یک دسکتاپ، آن را با حساب کاربری معمولی خود اجرا کنید. **ویندوز (PowerShell یا Command Prompt):** ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` در ویندوز نیازی به مدیر سیستم نیست. فرآیند فرزند PowerShell ترمینال شما را با نتیجه باز نگه می‌دارد. پایتون و وابستگی‌ها در نصب باقی می‌مانند. در اوبونتو، **«این رایانه**»، **«لینک موقت HTTPS**» یا **«دامنه اختصاصی**» را انتخاب کنید. نصب‌کننده آدرس پنل و کلید دسترسی را چاپ می‌کند. برای یک لینک موقت، آن آدرس HTTPS را در مرورگر خود باز کرده و کلید را وارد کنید. با دسترسی محلی روی یک سرور از راه دور، از یک فوروارد SSH از رایانه خود استفاده کنید (`ssh -L 8787:127.0.0.1:8787 user@server`) و آن را باز کنید `http://127.0.0.1:8787`. در macOS و ویندوز، پنل محلی در مرورگر شما باز می‌شود؛ ترمینال آن را در حال اجرا نگه دارید. در پنل وارد تلگرام شوید و انتخاب کنید چه اطلاعاتی را جمع‌آوری کنید. نصب به تنهایی باعث شروع جمع‌آوری تلگرام نمی‌شود. ## محلی که همه‌چیز در آن اجرا می‌شود `get.destroy.tools` یک **Cloudflare Worker دانلودهای ایستا را ارائه می‌دهد** است. این برنامه پنل TgWitness، جلسه تلگرام یا پایگاه داده شواهد کاربر ندارد. این برنامه به یک VPS پروژه مسیریابی نمی‌شود. این برنامه روی ماشینی که دستور را در آن اجرا می‌کنید، اجرا می‌شود. | نصب | برنامه | داده‌ها | | --- | --- | --- | | اوبونتو به‌عنوان ریشه | `/opt/tgwitness` | سرویس سیستم: `/var/lib/tgwitness-`; استفاده کنید `tgwitness paths` برای مسیر دقیق. | | کاربر لینوکس / مک‌اواس | `~/.local/share/tgwitness` | `data/live` زیر آن نصب. | | کاربر ویندوز | `%LOCALAPPDATA%\TgWitness` | `data\live` زیر آن نصب. | تنظیم `TGWITNESS_INSTALL_DIR` برای انتخاب پوشهٔ دیگر. نسخه‌های نصب‌شده و داده‌ها جدا هستند. نصاب، حساب‌ها، پیام‌ها یا کلیدهای شما را به سایت دانلود آپلود نمی‌کند. انتخاب یک تونل کلودفلر، ترافیک پنل را از طریق کلودفلر ارسال می‌کند؛ استفاده از دامنهٔ خودتان، ترافیک را به سرور خودتان هدایت می‌کند. With `TGWITNESS_TRUSTED_PROXIES`, the panel accepts a single `X-Forwarded-Proto: https` from a trusted proxy to set Secure download cookies. هر نصب شامل **فایل‌های START-HERE.html** و **START-HERE.txt** است که شامل مسیرهای محلی، دستورات و لینک‌هایی به مخزن (repository) می‌باشد. اجرا کنید `tgwitness guide` برای باز کردن راهنما. در ویندوز، از دستور زیر استفاده کنید: `& "$env:LOCALAPPDATA\TgWitness\bin\tgwitness.cmd" guide` در PowerShell استفاده کنید. ## تنظیمات جستجوی متن کامل [جستجوی متن کامل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/) (پیش‌نمایش) نیازی به تنظیم ندارد. نمایه‌اش پس از به‌روزرسانی در پس‌زمینه ساخته می‌شود. | متغیر یا فرمان | اثر | | --- | --- | | `TGWITNESS_FULLTEXT=disk` | پیش‌فرض: شاخص در نگهداری می‌شود `search/fulltext.sqlite3` هر فضای کاری | | `TGWITNESS_FULLTEXT=memory` | فایل شاخص وجود ندارد؛ شاخص در هر بار راه‌اندازی دوباره ساخته می‌شود | | `TGWITNESS_FULLTEXT=off` | بدون نمایه؛ فقط جستجوی متنی دقیق | | `tgwitness index status` | وضعیت هر فضای کاری را فهرست‌بندی کنید | | `tgwitness stop`, `tgwitness index rebuild`, `tgwitness start` | هر نمایه را از دفترچهٔ امضا‌شده بازسازی کنید | انتخاب مدیر در **Journal → Filters → Search index** بر متغیر آن فضای کاری اولویت دارد. دستورات دایرکتوری دادهٔ نصب را که آن‌ها را اجرا می‌کند پیدا می‌کنند؛ در جاهای دیگر، اضافه کنید `--data-dir` با مسیر از `tgwitness paths`. برای یک فرهنگ لغت کامل اوکراینی (داده‌های GPL-3.0)، نصب کنید `pymorphy3-dicts-uk` در محیط پایتون نصب. ## دسترسی خط فرمان [خط](https://phishdestroy.github.io/TgWitness/fa/docs/reference/cli/) [فرمان](https://phishdestroy.github.io/TgWitness/fa/docs/reference/cli/) (پیش‌نمایش) آرشیو را برای اسکریپت‌ها و ایجنت‌ها می‌خواند. | متغیر | اثر | | --- | --- | | `TGWITNESS_URL` | آدرس پنل برای `tgwitness search`, `context`, `messages`, `stats` و `export`؛ پیش‌فرض `http://127.0.0.1:8787` وقتی یک توکن تنظیم می‌شود | | `TGWITNESS_MCP_TOKEN` | توکن اتصال را از **Integrations → MCP** بایگانی کنید، که با کلاینت‌های MCP به اشتراک گذاشته می‌شود؛ `--token-file` در عوض آن را از یک فایل می‌خواند | | `TGWITNESS_DATA` | زمانی که هیچ ... داده نمی‌شود، دایرکتوری داده‌ها مستقیماً خوانده می‌شود. `--data-dir`، URL یا توکن داده نشده باشد | ## پیش از اجرا تأیید کنید دستور یک‌خطی برای اجرای اسکریپت اولیه به HTTPS اعتماد می‌کند. آن اسکریپت قبل از نصب، نشانی SHA-256 و امضای RSA پروژه را روی برنامه و محدودیت‌ها بررسی می‌کند. همچنین می‌توانید ابتدا اسکریپت اولیه را دانلود و تأیید کنید. کلید انتشار عمومی [release-signing.pub](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/release-signing.pub) است. SHA-256 آن عبارت است از: ``` 039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d ``` این اثر انگشت را از یک بازنگری مخزن که به آن اعتماد دارید، حفظ کنید. یک چک‌سام از همان سرور دانلود، عدم تطابق را تشخیص می‌دهد؛ کلید عمومی مستقل مورد اعتماد، چیزی است که امضای یک نسخه را احراز هویت می‌کند. برای دانلودهای تأیید اعتبار زیر از یک دایرکتوری جدید و خالی استفاده کنید. **لینوکس / مک‌اواس — در یک دایرکتوری دانلود جدید و خالی اجرا شود** (نیازمند curl و OpenSSL): ``` curl -fSLO https://get.destroy.tools/install.sh && curl -fSLO https://get.destroy.tools/install.sh.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.sh.sig install.sh && bash install.sh ``` The `&&` زنجیره در صورتی که بررسی دانلود، اثر انگشت کلید یا امضا ناموفق باشد، قبل از اجرا متوقف می‌شود. اگر انتشار بین دانلود اسکریپت و امضای آن رخ دهد، هر دو را دوباره دانلود کنید. نصبی‌های قدیمی، URLهای بستهٔ ثابت خود را حفظ می‌کنند. **ویندوز — قبل از اجرا، SHA-256 را بررسی کنید:** ``` Invoke-WebRequest https://get.destroy.tools/install.ps1 -OutFile install.ps1 -UseBasicParsing Get-FileHash .\install.ps1 -Algorithm SHA256 Invoke-RestMethod https://get.destroy.tools/SHA256SUMS.txt ``` هش را با ... مقایسه کنید `install.ps1` خط. برای بررسی مستقل امضا، از OpenSSL (برای مثال، از طریق Git Bash) و همان اثر انگشت کلید عمومی فوق استفاده کنید: ``` curl -fSLO https://get.destroy.tools/install.ps1 && curl -fSLO https://get.destroy.tools/install.ps1.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.ps1.sig install.ps1 && powershell.exe -NoProfile -ExecutionPolicy Bypass -File install.ps1 ``` خود نصب ویندوز امضاهای بسته را با .NET تأیید می‌کند و به OpenSSL نیازی ندارد. این‌ها امضاهای جداگانه RSA-3072 / SHA-256 هستند، نه Authenticode. [منیفست](https://get.destroy.tools/manifest.json) نسخه نرم‌افزار، کامیت دقیق Git، شناسه انتشار تغییرناپذیر و SHA-256 هر آرتیفکت را ثبت می‌کند. این صفحه به منبع مربوطه لینک می‌دهد. منیفست و لیست چک‌سام نیز امضاهای جداگانه‌ای دارند (`manifest.json.sig` و `SHA256SUMS.txt.sig`). ## به‌روزرسانی یک نصب موجود **یک انتشار جدید، سایت دانلود را به‌روزرسانی می‌کند؛ برنامه‌های نصب‌شده وقتی دوباره نصب‌کننده را اجرا می‌کنید، به‌روزرسانی می‌شوند.** هیچ به‌روزرسانی‌کننده‌ی بدون نظارت یا راه‌اندازی مجدد خودکار برای مجموعه‌ی در حال اجرا وجود ندارد. کانال نصب‌کننده‌ی فعلی **پیش‌نمایشی** است؛ این کانال از نسخه‌های منتشرشده و بررسی‌شده‌ی `main`، که commit آن می‌تواند جدیدتر از آخرین نسخه شماره‌گذاری‌شده GitHub باشد. نسخه صفحه از `pyproject.toml`؛ commit و شناسه build آن، به‌روزرسانی‌ها را در همان نسخه پیش‌نمایش از هم متمایز می‌کند. انتشار پس از آنکه آن commit خاص از بررسی‌های کاربردی و امنیتی عبور کند و بسته امضا شده، تست‌های نصب سرویس اوبونتو و پاورشل ویندوز را پشت سر بگذارد، به‌صورت خودکار انجام می‌شود. در حین اجرای بررسی‌ها، یا در صورت شکست آن‌ها، همان دستورات به نصب نسخه قبلی بررسی‌شده ادامه می‌دهند. مانیفست build نشان می‌دهد که کدام commit در حال حاضر در دسترس است؛ شماره نسخه به تنهایی ممکن است بین به‌روزرسانی‌های پیش‌نمایشی ثابت بماند. از همان پوشه نصب و کاربر سیستم‌عامل قبلی استفاده کنید. از دایرکتوری کامل داده با متوقف کردن جمع‌آوری نسخه پشتیبان تهیه کنید؛ `tgwitness paths` آن را شناسایی می‌کند. یک خروجی امضا شده نسخه پشتیبان کامل نصب نیست. **نصب ریشهٔ اوبونتو در `/opt/tgwitness`:** ``` curl -fsSL https://get.destroy.tools/install.sh | TGWITNESS_INSTALL_DIR=/opt/tgwitness bash -s -- --no-start ``` پس از نصب موفقیت‌آمیز: ``` /opt/tgwitness/bin/tgwitness restart /opt/tgwitness/bin/tgwitness status /opt/tgwitness/bin/tgwitness open ``` برای نصب کاربر لینوکس/macOS، از فایل نصب اصلی آن استفاده کنید. `TGWITNESS_INSTALL_DIR` یا از پیش‌فرض استفاده کرده و دستور نصب اول را دوباره اجرا کنید. قبل از به‌روزرسانی، یک پنل در پیش‌زمینه را ببندید و پس از آن دوباره آن را راه‌اندازی کنید. برای یک سرویس کاربر لینوکس پیکربندی‌شده، آن را اجرا کنید `tgwitness restart` را اجرا کنید. **ویندوز:** پنل در حال اجرا را ببندید، دستور نصب ویندوز را دوباره اجرا کنید، سپس باز کنید `bin\tgwitness.cmd` در همان نصب. نصاب داده‌ها، جلسات، تنظیمات دسترسی و کلیدهای امضا را حفظ می‌کند. این نصاب تنها پس از اینکه محیط جدید بررسی‌های خود را با موفقیت پشت سر گذاشت، لانچر را تعویض می‌کند؛ نصب ناموفق، لانچر قبلی را سر جای خود باقی می‌گذارد. نسخه پشتیبان پیش از ارتقا را برای تغییرات در فرمت ذخیره‌سازی نگه دارید. ## دستورهای روزمره در اوبونتو | فرمان | نتیجه | | --- | --- | | `tgwitness open` | URL فعلی پنل و کلید دسترسی. | | `tgwitness paths` | مسیرهای دقیق برنامه، داده‌ها و راهنما. | | `tgwitness guide --print` | دستورالعمل‌های کار آفلاین. | | `tgwitness status` / `tgwitness logs` | دسترسی / گزارش‌های سرویس. | | `tgwitness stop` / `tgwitness start` | متوقف / از سرگیری سرویس؛ حفظ داده‌ها. | | `tgwitness token rotate` | کلید مدیر را تعویض کنید و جلسات مرورگر را پایان دهید. | | `tgwitness tunnel off` | تونل سریع عمومی را غیرفعال کنید؛ پنل محلی را حفظ کنید. | | `tgwitness tunnel on` / `tgwitness tunnel restart` | ایجاد یک لینک تونل سریع / جایگزینی آدرس آن. | برای مشاهده توکن‌های همکار، جلسات و محدودیت‌های IP و [انتشار نصبی](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/README.md#automatic-publication-from-github) برای گردش کار انتشار از گیت‌هاب به کلودفلر، به [بخش دسترسی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/) مراجعه کنید. ## حذف TgWitness هیچ پاک‌کننده‌ای وجود ندارد: شما پنل را متوقف کرده و پوشه‌های آن را حذف می‌کنید. حذف پوشهٔ داده‌ها، دفترچه‌ها، کلیدهای امضا، جلسات تلگرام و فایل‌های ذخیره‌شده را برای همیشه از بین می‌برد. پیش از آن: 1. آنچه نیاز دارید را صادر کنید (**صادرات → دانلود ZIP امضا شده**) و اثر انگشت کلید امضا و نقاط کنترل را خارج از این دستگاه نگه دارید. برای نگهداری خود فضای کاری، کل پوشه داده را با متوقف کردن جمع‌آوری کپی کنید. 2. سرورهایی را که در مسیر **Extras → Server 24/7** از **Your servers** یا با `python -m tgwitness.cloud destroy`؛ ارائه‌دهنده تا زمان حذف آن‌ها، هزینه‌شان را محاسبه می‌کند. 3. جلسه هر حساب را در تلگرام تحت **«تنظیمات» → «دستگاه‌ها»** پایان دهید. حذف فایل‌ها باعث خروج از جلسه از سمت تلگرام نمی‌شود. **نصب روت اوبونتو.** به پوشهٔ داده توجه کنید، سرویس را متوقف کنید، سپس سرویس، پوشه‌ها و میانبر را حذف کنید: ``` /opt/tgwitness/bin/tgwitness paths /opt/tgwitness/bin/tgwitness stop systemctl list-unit-files 'tgwitness-*' systemctl disable tgwitness- rm /etc/systemd/system/tgwitness-.service systemctl daemon-reload rm -rf /opt/tgwitness /var/lib/tgwitness- /usr/local/bin/tgwitness ``` **نصب برای کاربر لینوکس یا مک‌او‌اس.** پنل را ببندید. یک سرویس کاربر لینوکس پیکربندی‌شده با `systemctl --user disable --now tgwitness-`؛ واحد آن در `~/.config/systemd/user/`. سپس حذف کنید `~/.local/share/tgwitness` (یا `TGWITNESS_INSTALL_DIR`) و `~/.local/bin/tgwitness` را حذف کنید. **ویندوز.** پنل را ببندید و حذف کنید `%LOCALAPPDATA%\TgWitness` (یا `TGWITNESS_INSTALL_DIR`). نصاب هیچ سرویس، وظیفه زمان‌بندی‌شده یا میان‌بر اضافه نمی‌کند. --- # Telegram · راه‌اندازی اولیه و تنظیمات Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/settings/ جادوگر راه‌اندازی، اهداف، سطوح رابط، مسیرهای اتصال و تنظیمات مشترک یک گروه حساب. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) جادوگر راه‌اندازی، اهداف، سطوح رابط، مسیرهای اتصال و تنظیمات مشترک یک گروه حساب. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [شروع کار](https://phishdestroy.github.io/TgWitness/fa/docs/reference/quickstart/) ![شروع کار](https://phishdestroy.github.io/TgWitness/assets/chapter-start.svg) [حساب‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/) · [اتصال](https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/) · [دسترسی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/) یک فضای کاری جدید باز می‌شود `/first-run`: زبان و زمان، سطح رابط کاربری، هدف، اتصال، تلگرام و چت‌ها. هر پاسخ به محض تغییر روی سرور ذخیره می‌شود، بنابراین با بارگذاری مجدد، همان مرحله ادامه می‌یابد. آخرین صفحه فهرستی از پاسخ‌ها را نمایش می‌دهد و به شما امکان می‌دهد به هر کدام از آن‌ها بازگردید. زبان، منطقه زمانی IANA، تم و سطح به ازای هر اپراتور و هر فضای کاری ذخیره می‌شوند. ارزش‌های پیش‌فرض عبارتند از زبان مرورگر، منطقه زمانی دستگاه، تم سیستم و رابط کاربری ساده. تغییر زبان، جلسه پنل را حفظ می‌کند. زمان‌ها در مجله امضا شده هرگز تغییر نمی‌کنند. `/settings` ویرایش می‌کند همان سوابق را که جادوگر ویرایش می‌کند. جستجو شامل فیلدهای اصلی، پارامترها و فرم‌های توسعه‌یافته می‌شود؛ یک فیلد مخفی را می‌توان بدون تغییر سطح باز کرد. سطوح فقط آنچه را که نمایش داده می‌شود تغییر می‌دهند: سرور به طور خودکار مجوزها را بررسی می‌کند. تنظیمات مجموعه و اولین اتصال به مدیر فضای کاری تعلق دارند. | سطح | میدان‌ها | پنل کناری | | --- | --- | --- | | ساده | فقط موارد ضروری | خانه، چت‌ها، تغییرات، آرشیوها، تنظیمات | | استاندارد | تنظیمات مشترک همراه با توضیحات | افزودن Case Board، حساب‌ها و دسترسی | | کارشناس | تمام فیلدها، محدودیت‌ها و جزئیات فنی | افزودن منابع، موارد اضافی، پرسش از آرشیو، پارامترها، حساب، گزارش سیستم و یکپارچه‌سازی‌ها | [راهنمای پنل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/) هر بخش را توضیح می‌دهد. ## اهداف | هدف | مجموعه | فایل‌ها | خدمات خارجی | آدرس سرور | | --- | --- | --- | --- | --- | | نسخهٔ بایگانی | خاموش؛ **شروع** یک خروجی را اجرا می‌کند | عکس‌ها تا ۲۰ مگابایت | خاموش | خودکار | | دنبال کردن چت‌ها | مستمر | عکس‌ها و ویدیوها تا ۶۰ ثانیه / ۲۰ مگابایت | برچسب‌های زمانی و اعلان‌های مشکل | خودکار | | مدرک | مستمر | تمام فایل‌ها تا ۱ گیگابایت | برچسب‌های زمانی، drand، اعلان‌ها | خیر، آن را مخفی کن | کپی خارج از محل، ربات شاهد و بررسی کد برای ارائه مدرک توصیه می‌شوند. آدرس‌های ذخیره‌سازی و اعلان به یک مقصد اولیه نیاز دارند. ویژگی‌ای که با یک سرویس خارجی ارتباط برقرار می‌کند، درخواست اجازه برای درخواست‌های خارج از تلگرام را مطرح می‌کند؛ غیرفعال کردن آن، غیرفعال کردن مهرهای زمانی، اعلان‌ها و کپی خارج از محل را نیز پیشنهاد می‌دهد. تغییر هدف، ابتدا تفاوت را نشان می‌دهد و می‌توان تغییرات دستی را حفظ کرد. یک فیلد که با هدف متفاوت است، با عبارت **«توسط شما تغییر کرده»** علامت‌گذاری می‌شود و می‌توان آن را به حالت اولیه بازگرداند. بازنگری تنظیمات مانع از اعمال یک تفاوت بررسی‌شده بر روی تغییری می‌شود که در یک تب دیگر ایجاد شده است. ## اتصال **Automatic** ابتدا سرورهای عمومی MTProxy را امتحان می‌کند، سپس WARP و در نهایت اتصال مستقیم را، که این مورد آخر تنها زمانی انجام می‌شود که آدرس سرور قابل نمایش باشد. Automatic و WARP می‌توانند اجزای دارای بررسی هش را نصب کرده و سرور را در Cloudflare ثبت کنند. WARP از مدیر موجود wgcf/wireproxy و یک پورت محلی SOCKS5 استفاده می‌کند؛ جدول مسیریابی سیستم تغییر نمی‌کند. هنگامی که به سرویس‌های خارجی نیاز باشد، Automatic اتصال از طریق WARP را به MTProxy ترجیح می‌دهد. پراکسی شما می‌پذیرد `tg://proxy`, `socks5://`, `http://` و `https://`. گواهی یک پروکسی HTTPS قبل از ارسال اعتبارنامه‌ها به آن بررسی می‌شود. بررسی اتصال به مدت پنج دقیقه معتبر است و به مسیر، سیاست و پاسخ‌های جادوگر بستگی دارد؛ تغییر هر یک از آن‌ها نیازمند یک بررسی جدید است. **ادامه بدون بررسی** امکان‌پذیر است و جایگزین ورود تلگرام نمی‌شود. مسیر انتخاب‌شده در پس‌زمینه مجدداً بررسی می‌شود و پس از قطع اتصال، «اتوماتیک» زنجیره خود را دوباره اجرا می‌کند. هنگامی که هیچ پروکسی عمومی پاسخی ندهد، شمارشگر با WARP و اقدامات بررسی مجدد به رنگ قرمز درمی‌آید. ## گروه‌های حساب حساب‌های یک گروه تنظیمات خود را به اشتراک می‌گذارند. در صفحهٔ تنظیمات یک حساب، **حساب‌ها → گروه‌ها و تنظیمات مشترک → تنظیمات مشترک** یا **تنظیمات گروه** را باز کنید. این گروه هدف، فایل‌های ذخیره‌شده، زمان‌مهرها، drand، اعلان‌های مشکل، نسخهٔ خارج از محل، درخواست‌های خارج از تلگرام، حالت IP، موارد قابل ضبط، برنامهٔ بازبینی مجدد، قوانین اعلان، تنظیمات گزارش، پارامترها و مسیر اتصال را به اشتراک می‌گذارد. مقاصد اعلان، اعتبارنامه‌های پروکسی و ورود به سیستم به ازای هر حساب کاربری مجزا باقی می‌مانند، و همچنین شروع و توقف جمع‌آوری نیز به همین صورت است. - هر عضو گروه را دنبال می‌کند. تنظیمات یک مقدار را علامت‌گذاری می‌کند 🔗 **از گروه** یا ✏️ **مقدار خود**؛ **بازگشت به مقدار گروه** آن را بازمی‌گرداند. - یک تغییر، حساب‌هایی را که شامل می‌شود فهرست می‌کند (**در ۲ از ۳ حساب اعمال می‌شود**) و پیش از جایگزینی مقدار خود، برای هر حساب جداگانه می‌پرسد. حساب‌های بدون تیک، مقدار خود را حفظ می‌کنند. - پارامتری که گروه به اشتراک نمی‌گذارد تا زمانی که **اشتراک‌گذاری نمی‌شود: هر حساب مقدار خود را حفظ می‌کند** را فشار دهید، باقی می‌ماند**این مقدار را به اشتراک بگذارید**. - **کپی تنظیمات از یک حساب،** مقادیر حساب انتخاب‌شده را به‌عنوان تنظیمات گروه در نظر می‌گیرد. - از حساب منتقل‌شده به گروه پرسیده می‌شود **که آیا مقادیر گروه را بپذیرد؟** در غیر این صورت، مقادیر خود را که با ✏️ نشانه‌گذاری شده‌اند، حفظ می‌کند. حساب‌هایی که بعداً اضافه می‌شوند با مقادیر گروه شروع می‌کنند. - یک حساب ناظر حالت IP خود را تا زمان توقف حفظ می‌کند. هر تغییر در دفترچهٔ ثبت‌شدهٔ فضای کاری اصلی و هر عضوی که شامل آن می‌شود، ثبت می‌گردد. حذف یک گروه، حساب‌های آن و مقادیر فعلی‌شان را حفظ می‌کند. صفحه گروه `/groups/` اعضا، مواردی که نیاز به توجه دارند و گفتگوهایی را که چندین حساب مشاهده می‌کنند، نشان می‌دهد. به [گروه‌های حساب کاربری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#bulk-import-and-account-groups) مراجعه کنید. ## فضاهای کاری موجود یک فضای کاری که یک جلسه یا یک راه‌اندازی قبلی را دارد، ویزارد را دریافت نمی‌کند. مقادیر آن هنگام بارگذاری صفحه با یک هدف جایگزین نمی‌شوند. پنهان کردن یک فیلد، این ویژگی را غیرفعال نمی‌کند یا مقدار آن را حذف نمی‌کند. اندازه و برآورد زمانی، تا سه چت انتخاب‌شده و تا ۲۰ پیام از هر یک را می‌خواند. این یک برآورد است: این ابزار محدودیت‌های تلگرام، سرعت یک سرور مشخص یا فایل‌های موجود در هر چت را پیش‌بینی نمی‌کند. --- # Telegram · فرمت‌های حساب کاربری و جلسه Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/ ورود با شماره تلفن، کد QR یا کلید احراز هویت، وارد کردن جلسات تله‌تون، پایروگرام یا تلگرام دسکتاپ و اجرای چندین حساب کاربری. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) ورود با شماره تلفن، کد QR یا کلید احراز هویت، وارد کردن جلسات تله‌تون، پایروگرام یا تلگرام دسکتاپ و اجرای چندین حساب کاربری. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [شروع کار](https://phishdestroy.github.io/TgWitness/fa/docs/reference/quickstart/) ![شروع کار](https://phishdestroy.github.io/TgWitness/assets/chapter-start.svg) TgWitness به عنوان یک **حساب کاربری تلگرام** (نه یک ربات) از طریق MTProto، با استفاده از Telethon، وارد می‌شود. هر حساب در **فضای** کاری خود (که در API و ابزارهای خط فرمان به آن *workspace* گفته می‌شود) با جلسه، منابع، دفترچه یادداشت و کلید امضای مخصوص به خود قرار دارد. فایل‌های جلسه، رشته‌های جلسه و کلیدهای احراز هویت، **مجوزهای حساب کاربری** هستند: هر کسی که یکی از آن‌ها را در اختیار داشته باشد می‌تواند به‌عنوان آن حساب کاربری عمل کند. آن‌ها حاوی تاریخچه پیام‌ها نیستند. > [!هشدار] **از هر چیزی که تحمل از دست دادن آن را ندارید، استفاده نکنید.** ما قویاً توصیه می‌کنیم که حساب‌های شخصی یا هر حساب باارزش دیگری را متصل نکنید و روی حسابی که برایتان ارزش دارد، شناسه API / هش API ایجاد نکنید. این موضوع به معنای آزمایش‌نشده بودن TgWitness نیست: تلگرام حساب‌ها را به طور غیرقابل پیش‌بینی محدود و برای همیشه مسدود می‌کند — به دلیل حجم درخواست‌هایی که آن را بیش از حد می‌داند، صرف‌نظر از کلاینت یا هدف، و بدون هیچ‌گونه مستندات کافی. بسیاری از این مسدودسازی‌ها برگشت‌ناپذیر هستند. از حساب‌های اختصاصی استفاده کنید. اجرای روان تست‌ها به تلگرام بستگی دارد، نه به نرم‌افزار، و هیچ تضمینی برای آینده ندارد. - [نگاهی اجمالی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#at-a-glance) - [قبل از شروع: شناسهٔ API و هش API](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#before-you-start-api-id-and-api-hash) - [شماره تلفن](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#phone-number) · [کد QR](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#qr-code) · [کلید اuth + شناسه DC](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#auth-key--dc-id) - [فایل‌های حساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#account-files): [تله‌تون .جلسه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#telethon-session) · [پایروگرام .session](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#pyrogram-session) · [جفت جلسه + JSON](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#session--json-pair) · [TData](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#telegram-desktop-tdata) · [رشتهٔ جلسه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#telethon-stringsession) · [JSON حساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#account-json) - [شناسایی کنید که چه چیزی در اختیار دارید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#identify-what-you-have) · [فرمت‌های پشتیبانی‌نشده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#unsupported-formats) - [حساب‌های متعدد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#multiple-accounts) · [حفظ امنیت فایل‌های حساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#keeping-account-files-safe) · [عیب‌یابی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#troubleshooting) ## نگاهی اجمالی | آنچه در اختیار دارید | زبانه‌ی **«افزودن حساب»** | همچنین به موارد زیر نیاز خواهید داشت | | --- | --- | --- | | شماره تلفن و دسترسی به کدهای ورود آن | **تلفن** | رمز عبور ۲FA در صورت فعال بودن | | تلگرام در دستگاه دیگری باز است | **کد QR** | رمز عبور ۲FA در صورت فعال بودن | | یک فایل `.session` (تله‌تون یا پایروگرام) | **فایل‌ها** | JSON اختیاری همراه برای تنظیمات برنامه | | `.session` + `.json` با نام یکسان | **فایل‌ها** (هر دو را انتخاب کنید) | معمولاً هیچ چیز دیگری | | پوشهٔ `tdata` در تلگرام دسکتاپ | **فایل‌ها** (به‌صورت ZIP) | رمز عبور محلی دسکتاپ در صورت تنظیم | | یک جلسه رشته‌ای تله‌تون (متن، `.txt`، `.tgwitness-session`) | **فایل‌ها** | نیازی به جفت API جداگانه نیست | | یک کلید `.json` با جلسه یا کلید احراز هویت | **فایل‌ها** | نیازی به جفت API جداگانه نیست | | یک کلید احراز هویت (۵۱۲ کاراکتر هگزادسیمال) و شماره DC آن | **کلید رمزنگاری** | شناسه کاربری اختیاری | TgWitness فایل‌ها را بر اساس **محتویات**شان شناسایی می‌کند، نه بر اساس نامشان. تغییر نام یک فایل هرگز آن را تبدیل نمی‌کند. ## قبل از شروع: شناسهٔ API و هش API شما می‌توانید بدون ایجاد یک اپلیکیشن API تلگرام وارد شوید. هنگامی که هیچ جفتی وارد نشده، وارد نشده یا از قبل در فضای کاری ذخیره نشده باشد، TgWitness یک جفت را از مجموعه داخلی خود از 50 جفت API عمومی (`tgwitness/api_pool.py`) انتخاب می‌کند، و برای ورود جدید، ابتدا به تلگرام دسکتاپ اولویت می‌دهد و یک جفت ذخیره شده را نگه می‌دارد؛ سایر گزینه‌ها به صورت تصادفی انتخاب می‌شوند. اگر تلگرام یک جفت را رد کند (`API_ID_INVALID`، `API_ID_PUBLISHED_FLOOD`، `UPDATE_APP_TO_LOGIN`)، جفت بعدی امتحان می‌شود، تا هشت جفت در هر ورود؛ جفت‌های رد شده تا راه‌اندازی مجدد نادیده گرفته می‌شوند. جفتی که با آن وارد شده است با حساب کاربری ذخیره شده و برای آن دوباره استفاده می‌شود. یک **شناسه API** و **هش API**، اپلیکیشن را به تلگرام معرفی می‌کنند؛ آنها به خودی خود حساب کاربری را تأیید اعتبار نمی‌کنند. fields of connection missing use a deterministic device/OS pair from the bundled [opentele2 2.0.0 catalogs](https://github.com/DedInc/opentele2/tree/7e973bc71cd7a714ad13ac703c0895a90d36a735): Desktop `2040`, Android `6`, Android X `21724`, iOS `10840`, macOS `2834`, and Web `2496`. Android's source-build ID `4` also uses the Android catalog, as identified in [Telegram Android's BuildVars](https://github.com/DrKLO/Telegram/blob/master/TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java). وب به‌صورت پیش‌فرض روی A است؛ یک پسوند نسخه-اپلیکیشن وارداتی `K` یا بسته زبانی `macos`، K را انتخاب می‌کند، و نسخه `0.7.0`، Webogram را انتخاب می‌کند. شناسه‌های اپلیکیشن ناشناخته، پیش‌فرض‌های میزبان Telethon را حفظ می‌کنند. فیلدهای وارداتی همیشه برنده می‌شوند، از جمله نسخه قدیمی‌تر اپلیکیشن و بسته زبانی خالی. کاتالوگ هرگز شناسه/هش API را تغییر نمی‌دهد. نسخه اسنپ‌شات آن صراحتاً بررسی می‌شود، نه اینکه در حین ورود (لاگین) دریافت شود. یک پروفایل ذخیره شده پس از به‌روزرسانی‌ها پایدار باقی می‌ماند. توابع `account.getAuthorizations` متادیتای مجوزهای ذخیره‌شده تلگرام را گزارش می‌کند؛ این تابع بازتاب هر `initConnection` جدید نیست. آن را با پروفایل ارسال‌شده واقعی مقایسه کنید. اتصال یک مجوز موجود، هش API همراه آن را اعتبارسنجی نمی‌کند: تابع `initConnection` شناسه API را ارسال می‌کند، در حالی که هش توسط درخواست‌های ورود استفاده می‌شود. پس از احراز هویت با تلفن جدید یا QR، TgWitness پیکربندی، نزدیک‌ترین DC، وضعیت آنلاین، زبان‌ها (وقتی بسته زبان خالی نیست)، به‌روزرسانی‌های برنامه و به‌روزرسانی‌های شرایط خدمات را درخواست می‌کند، با فاصله 0.3–1.5 ثانیه بین درخواست‌ها. به‌روزرسانی وضعیت، به‌طور موقت حساب را آنلاین نشانه‌گذاری می‌کند. این توالی یک‌بار پس از تکمیل ورود اجرا می‌شود، نه در هنگام وارد کردن داده‌ها، اتصال مجدد یا راه‌اندازی مجدد. ابتدا احراز هویت ذخیره می‌شود؛ یک درخواست ناموفق، توالی را بدون تلاش مجدد یا رد ورود متوقف می‌کند. نتایج به صورت `account.initialized` ثبت می‌شوند، با نام‌های خطا به جای بدنه پاسخ‌ها. این توالی تضمینی در برابر محدودیت‌های حساب نیست. برای `tdesktop` ، در صورت عدم وجود `tz_offset` ، از جابجایی UTC محلی سرور استفاده می‌شود که با استفاده از [الگوریتم opentele2](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/fingerprint.rs) (MIT؛ مجوز در `tgwitness/client_profiles.LICENSE` ) به 900 ثانیه گرد شده است. این مقدار در هر اتصال به‌روزرسانی می‌شود تا تغییرات ساعت تابستانی در آن منعکس شود. `tz_offset` واردشده در هر پلتفرمی اولویت دارد و دقیقاً، از جمله صفر، حفظ می‌شود. سایر موارد موجود در `initConnection.params` حفظ می‌شوند. فرم ورود HTTP، منطقه زمانی عددی بازگشتی از وارد کردن فایل را می‌پذیرد؛ مقادیر بولی، کسری و آفست‌ها خارج از محدوده پشتیبانی‌شده رد می‌شوند. مسیرهای مستقیم، SOCKS5 و HTTP CONNECT از `ConnectionTcpObfuscated` (MTProto کوتاه‌شده و مبهم‌شده) تل‌تون استفاده می‌کنند. HTTPS CONNECT، TLS را تا پروکسی حفظ می‌کند و از همان انتقال مبهم‌شده در داخل تونل استفاده می‌کند. MTProxy، انتقال میانی تصادفی و پردازش مخفی خود را حفظ می‌کند. سوئیچ‌های مسیر از همان گزینه‌ها استفاده می‌کنند. ابهام‌سازی، قالب‌بندی بسته را تغییر می‌دهد؛ این کار حساب کاربری یا متادیتای کلاینت آن را از تلگرام پنهان نمی‌کند و به معنای مصونیت در برابر محدودیت‌ها نیست. پس از اتصال یک کلاینت مجاز، TgWitness پیکربندی، نزدیک‌ترین مرکز داده (DC)، مجوز فعلی، خط پایه بررسی‌شده لایه، زبان‌ها، به‌روزرسانی‌های برنامه و به‌روزرسانی‌های شرایط خدمات را بررسی می‌کند. این تشخیص‌ها یک‌بار برای هر نمونه کلاینت، قبل از جمع‌آوری اجرا می‌شوند و به همراه زمانشان در زیر جزئیات اتصال نمایش داده می‌شوند. `account.connection_checked` نتیجه را بدون هش‌های جلسه، آی‌پی‌ها، توکن‌ها یا هش‌های API ثبت می‌کند. آنها هرگز شرایط را قبول نمی‌کنند یا به‌روزرسانی‌ها را نصب نمی‌کنند. یک خطای درخواست یا توقف به دلیل FloodWait، درخواست‌های بعدی را متوقف می‌کند؛ یک نتیجه گمشده نامشخص باقی می‌ماند. بررسی‌های محلی همچنان می‌توانند نتایج خود را گزارش دهند، در حالی که بررسی‌های شبکه نادیده گرفته می‌شوند. تشخیص‌های FloodWait، روش TL ناموفق، هرگونه روکش‌های Takeout/range، انتظار درخواست‌شده توسط سرور و مهلت نهایی مؤثر را در `telegram.backoff` حفظ می‌کنند. جزئیات اتصال، در حالی که درخواست‌ها متوقف شده‌اند، روش و مهلت نهایی را نشان می‌دهند. این تشخیص شامل شمارنده‌های تماس کلاینت برای هر روش از زمان ایجاد آن کلاینت است؛ این شمارنده‌ها حل اختلاف هم‌تراز (nested peer resolution) را به صورت جداگانه می‌شمارند، اما بسته‌ها یا تلاش‌های داخلی برای تکرار (internal retry attempts) تل‌تون را نمی‌شمارند. شمارنده‌های فعلی نیز به عنوان `collector.rpc_activity` در API وضعیت در دسترس هستند. هیچ یک از آرگومان‌های درخواست، نام‌های کاربری، هش‌های دسترسی یا متن استثنا گنجانده نشده‌اند. آخرین گزارش تشخیصی و مهلت کامل پس از راه‌اندازی مجدد نیز باقی می‌مانند. وقفه‌های قبلی بدون رکورد روش، به صورت گذشته‌نگر قابل انتساب نیستند. برای بررسی منبع و تمایز بین کشف و استخراج تاریخچه، به [محدودیت‌های خروجی](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-LIMITS.md) مراجعه کنید. `official_app=True` یا `False` پرچم مجوز فعلی تلگرام است. هیچ‌کدام از این مقادیر مشخص نمی‌کنند که حساب کاربری محدود، مورد اعتماد یا تحت نظارت است. اسنپ‌شات‌های موجود `account.devices` در حالت شواهد، تاریخچه تمام دستگاه‌های واردشده را حفظ می‌کنند؛ در حالی که تشخیص‌های اتصال فقط توصیف دستگاه فعلی را نگه می‌دارند. پیش از اتصال، بررسی‌های مشاوره‌ای، پلتفرم API، بسته زبانی، فرمت‌های دستگاه/سیستم‌عامل و نسخه برنامه، لوکال سیستم موبایل و لایه اسکیمای واقعی تل‌تون را با خط پایه کاتالوگ بررسی‌شده مقایسه می‌کنند. هشدارها در لاگ سرور و متادیتای وضعیت حساب ظاهر می‌شوند؛ آنها هرگز مقادیر واردشده را جایگزین نمی‌کنند یا لایه اسکیما را تغییر نمی‌دهند. یک لایه متفاوت، سیگنال بررسی سازگاری است، نه مدرکی بر یک حساب کاربری خراب یا محدود. این بررسی‌ها و `official_app` تأیید نمی‌کنند که تلگرام این حساب کاربری را از محدودیت‌ها در امان می‌داند. وضعیت حساب کاربری قطع‌ارتباط‌شده به جای تولید یک توضیح دستگاه دیگر، از پروفایل ذخیره شده استفاده می‌کند. برای استفاده از برنامهٔ خود به جای آن (حساب کاربری که آن را ثبت می‌کند در معرض خطر است؛ ببینید: [چرا استخر API داخلی؟](https://github.com/phishdestroy/TgWitness/blob/main/docs/PROJECT-GUIDE.md#connect-a-telegram-account)): 1. [وب‌سایت my.telegram.org](https://my.telegram.org) را باز کنید و با هر شماره تلفنی که مالک آن هستید وارد شوید. کد به اپلیکیشن تلگرام ارسال می‌شود، نه از طریق پیامک. 2. **ابزارهای توسعهٔ API را** انتخاب کنید. 3. یک برنامه ایجاد کنید: هر عنوان و نام کوتاه (۵–۳۲ حرف)، پلتفرم **دسکتاپ**. URL و توضیحات می‌توانند خالی بمانند. 4. **ID اپلیکیشن api_id** (یک عدد) و **هش اپلیکیشن api_hash** (۳۲ کاراکتر هگزادسیمال) را کپی کنید. در پنل، **شناسه API + هش** را زیر فرم ورود پیدا کنید. می‌توانید یک جفت `api_id:api_hash` را در **شناسه API** بچسبانید و هر دو فیلد پر می‌شوند. یک جفت می‌تواند برای تمام حساب‌های کاربری شما استفاده شود. پس از ورود موفقیت‌آمیز، این جفت فقط در همان فضای کاری ذخیره و رمزگذاری می‌شود و هرگز به مرورگر بازگردانده نمی‌شود. سه اعتبارنامه‌ی متفاوت درگیر هستند: | مخفی | باز می‌کند | محل استقرار | | --- | --- | --- | | توکن پنل | پنل وب TgWitness | `panel-token.txt` در دایرکتوری داده‌ها، یا `TGWITNESS_TOKEN` | | شناسه API + هش | هیچ‌چیز به‌تنهایی؛ اپلیکیشن را شناسایی می‌کند | جفت پیش‌ساخته، تنظیمات واردشده، یا اپلیکیشن خودتان در my.telegram.org | | مجوز حساب | حساب تلگرام | ایجادشده از طریق ورود با تلفن/QR یا واردشده به‌عنوان یک جلسه | اگر تلگرام باید از طریق یک پروکسی دسترسی پیدا کند، ابتدا آن را در **حساب کاربری → تنظیمات → تنظیمات اتصال → تغییر مسیر اتصال** تنظیم کنید. ## شماره تلفن 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 حساب کاربری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#account-json) مراجعه کنید. ## فایل‌های حساب **گزینه «حساب جدید» را** باز کنید **→ «فایل‌ها» را** انتخاب کرده و تا **چهار فایل متعلق به یک حساب** (در مجموع **۸ مگابایت**) را برگزینید، سپس دکمه **«اتصال حساب» را** فشار دهید. فرم‌های **فایل‌ها**، **کلید احراز هویت** و واردات انبوه هشدار جلسه موازی را قبل از اتصال نمایش می‌دهند. به طور پیش‌فرض، مجوزهای وارد شده دوباره استفاده می‌شوند. در حالی که کلید یک کلاینت اصلی در اینجا در حال استفاده است، آن کلاینت را بسته نگه دارید. **فایل‌ها** و **کلید احراز هویت** همچنین گزینه **ایجاد یک مجوز مستقل** را ارائه می‌دهند که در زیر توضیح داده شده است. واردات انبوه همچنان از حالت مستقیم استفاده می‌کند. ورود با تلفن و ورود با QR تعاملی، مجوزهای جداگانه‌ای ایجاد می‌کنند. سربرگ هشدار در فرم وارد کردن فایل‌ها، کلید و فرم‌های بارگذاری انبوه، قبل از اتصال، هشدار جلسه موازی را نمایش می‌دهد. به طور پیش‌فرض، مجوزهای وارد شده دوباره استفاده می‌شوند. تا زمانی که کلید آن در اینجا در حال استفاده است، کلاینت اصلی را بسته نگه دارید. فایل‌ها و کلید همچنین امکان ایجاد یک مجوز مستقل را که در زیر توضیح داده شده است، فراهم می‌کنند. بارگذاری انبوه همچنان از حالت مستقیم استفاده می‌کند. ورود با تلفن و QR تعاملی، مجوزهای جداگانه‌ای ایجاد می‌کنند. - فایل‌ها **در حافظه‌ی** سرور TgWitness شما تبدیل می‌شوند. بارگذاری‌ها ذخیره نمی‌شوند، فایل‌های ZIP روی دیسک استخراج نمی‌شوند و هیچ سرویس خارجی‌ای درگیر نمی‌شود. - سپس جلسهٔ حاصل با تلگرام بررسی می‌شود. اگر یک فایل شناسهٔ کاربر را مشخص کند، باید با حسابی که تلگرام گزارش می‌کند مطابقت داشته باشد. - فایل‌هایی که حساب‌های مختلف یا اعتبارنامه‌های API متفاوت را توصیف می‌کنند، به جای انتخاب یکی، رد می‌شوند. - **کد عبور یا متن جلسه**، فیلد رمز عبور محلی TData را در بر می‌گیرد، یک کادر برای چسباندن یک StringSession و **فایل‌های Read بدون نیاز به ورود** (فرم را بدون تماس با تلگرام پر می‌کند). ### ایجاد یک مجوز مستقل **ایجاد یک مجوز مستقل را** قبل از اتصال فایل‌های وارد شده یا یک کلید احراز هویت (Auth Key) انتخاب کنید. TgWitness اجمالاً به اهداکننده وارد شده متصل می‌شود، از آن برای تأیید توکن ورود با QR کلاینت جدید استفاده می‌کند و بلافاصله پس از تأیید، اتصال به اهداکننده را قطع می‌کند. کلاینت جدید دارای کلید احراز هویت خود و یک پروفایل دسکتاپ جداگانه است. اعتبارنامه‌های API و پروفایل دستگاه ارائه‌شده توسط اهداکننده فقط برای اتصال اهداکننده استفاده می‌شوند. هیچ مجوز موجودی خارج نمی‌شود یا لغو نمی‌گردد. **در طول این مرحله، کلاینت اصلی اهداکننده را کاملاً بسته نگه دارید.** اتصال اولیه همچنان از کلید کپی‌شده خود استفاده می‌کند، بنابراین این حالت نمی‌تواند آن خطر استفاده موازی اولیه را از بین ببرد. پس از اتصال مجوز جدید، مالک می‌تواند کلاینت اصلی را دوباره باز کند و از هر دو به طور مستقل استفاده نماید. ورود تعاملی با **کد QR** به کلاینت اصلی اجازه می‌دهد تا ورود را بدون کپی یا اتصال کلید خود در اینجا تأیید کند. اگر تلگرام درخواست احراز هویت دو مرحله‌ای (2FA) کند، این حالت در صورت وجود، از `twoFA` انتخاب‌شده در JSON استفاده می‌کند، یا درخواست رمز عبور می‌کند. یک رمز عبور واردشده‌ی ردشده به فرم رمز عبور بازمی‌گردد. رمزهای عبور ذخیره نمی‌شوند. کلید کاندیدای ذخیره شده در `independent_login.enc` به‌صورت رمزگذاری‌شده، از جمله تغییرات حین مهاجرت به مرکز داده، ذخیره می‌شود. پس از یک وقفه، برای از سرگیری کاندیدای ذخیره شده، همان اهداکننده و این گزینه را انتخاب کنید. فضای کاری برای آن حساب کاربری رزرو شده باقی می‌ماند؛ عدم موفقیت در تکمیل، فضای کاری جدید را حذف نمی‌کند. دایرکتوری داده و کلید گاوصندوق آن را حفظ کنید. اعتبارنامه‌های نهایی و رکورد مجله `account.authorized` شامل روش وارد کردن، فرمت‌های ورودی و شناسه API اهداکننده هستند، بدون کلید یا رمز عبور اهداکننده. در 5 نوامبر 2026، یک حساب کاربری اختصاصی بررسی‌های زنده را با اهداکنندگان Telethon، Pyrogram و TData پشت سر گذاشت: 2تکمیل احراز هویت دو مرحله‌ای، کلیدهای احراز هویت جدید و مجزا، دسترسی همزمان اهداکننده و مشتری جدید، و خواندن یک کانال عمومی. مورد تله‌تون همچنین یک کاندیدای ذخیره شده را پس از یک وقفه در مرحله رمز عبور از سر گرفت. هر احراز هویت جدید شش درخواست اولیه پس از ورود را تکمیل کرد و ژورنال امضا شده آن تأیید شد. جلسه اصلی در هر چهار فرمت ارائه‌شده قابل استفاده باقی ماند. تلگرام [پایگاه داده خطاهای RPC](https://core.telegram.org/api/errors.json) وابسته `FRESH_CHANGE_ADMINS_FORBIDDEN` با تغییر مدیران، `FRESH_CHANGE_PHONE_FORBIDDEN` با تغییر شماره تلفن، و `FRESH_RESET_AUTHORISATION_FORBIDDEN` با لغو سایر جلسات، تغییر مدت‌زمان عمر آنها یا ثبت یک کلید عبور. `SESSION_TOO_FRESH_*` و `PASSWORD_TOO_FRESH_*` مربوط به انتقال مالکیت و برداشت درآمد یا هدیه است. این‌ها عملیات جمع‌آوری نیستند؛ ورود جدید به معنای یک ممنوعیت کلی ۲۴ ساعته برای خواندن نیست. خروجی می‌تواند به طور جداگانه بازگرداندTAKEOUT_INIT_DELAY_*. TgWitness مکث‌های درخواست‌شده توسط سرور را حفظ می‌کند و به طور خودکار برای پذیرش توکن دوباره تلاش نمی‌کند یا برای دور زدن محدودیت‌ها، جلسات را لغو نمی‌کند. 24ممنوعیت خواندن برای مدت -ساعته. Export می‌تواند به طور جداگانه بازگرداند `TAKEOUT_INIT_DELAY_*`. TgWitness تعلیق‌های درخواست‌شده توسط سرور را حفظ می‌کند و به‌طور خودکار پذیرش توکن را مجدداً امتحان نمی‌کند یا جلسات را برای دور زدن محدودیت‌ها لغو نمی‌کند. ### تله‌تون `.session` | | | | --- | --- | | چیست | پایگاه دادهٔ SQLite که ابزارهای مبتنی بر Telethon ایجاد می‌کنند، برای مثال `my_account.session` | | مورد تأیید | جدول‌ها `sessions` (با `dc_id`، `server_address`، `port`، `auth_key`) و `version` = ۷ یا ۸ | | پیش‌نیازها | دقیقاً یک ردیف جلسه مجاز؛ یک پایگاه دادهٔ بسته و کامل | ابتدا برنامه‌ای را که فایل را ایجاد کرده است ببندید. اگر فایل‌های `my_account.session-journal` یا `my_account.session-wal` در کنار آن وجود داشته باشد، پایگاه داده نهایی نشده است: کلاینت اصلی را به درستی باز و ببندید. حذف این فایل‌های جانبی (sidecar) می‌تواند یک نسخه خراب به جا بگذارد. ### پایروگرام `.session` | | | | --- | --- | | چیست | پایگاه دادهٔ SQLite که ابزارهای مبتنی بر Pyrogram ایجاد می‌کنند | | مورد تأیید | جدول `sessions` با `dc_id`، `auth_key`، `test_mode`، `user_id`، `is_bot`؛ `version` = ۲ یا ۳ | | پیش‌نیازها | یک جلسهٔ **کاربر** مجاز در شبکهٔ تولید. جلسات بات و DC آزمایشی رد می‌شوند. | شناسه کاربری ذخیره‌شده هنگام ورود با تلگرام بررسی می‌شود. ### جفت جلسه + 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) می‌تواند به‌تنهایی احراز هویت کند؛ به [JSON حساب کاربری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#account-json) مراجعه کنید. ### تلگرام دسکتاپ (TData) TData پوشهٔ `tdata` در اپلیکیشن Telegram Desktop (اپلیکیشن چندسکویی از desktop.telegram.org) است. | سیستم | مکان پیش‌فرض `tdata` | | --- | --- | | ویندوز | `%APPDATA%\Telegram Desktop\tdata` (تلگرام قابل حمل: در کنار `Telegram.exe`) | | لینوکس | `~/.local/share/TelegramDesktop/tdata` | | macOS | `~/Library/Application Support/Telegram Desktop/tdata` | برای وارد کردن آن: > **هشدار جلسه موازی.** واردات مستقیم TData از کلید مجوزدهی Telegram Desktop استفاده مجدد می‌کند. از آن کلید به طور همزمان در Desktop و TgWitness استفاده نکنید. تلگرام می‌تواند با خطای `AUTH_KEY_DUPLICATED` مجوز را باطل کند و هر دو نسخه را تا زمان ورود مجدد غیرقابل استفاده سازد. > > > > Desktop را به طور کامل، شامل فرآیند سینی (tray) آن، ببندید و در حالی که TgWitness از جلسه وارد شده استفاده می‌کند، آن نسخه را بسته نگه دارید. **خروج کنید، اما از سیستم خارج نشوید یا جلسه را لغو نکنید:** لغو همچنین نسخه وارد شده را باطل می‌کند. اگر به اجرای همزمان هر دو کلاینت نیاز دارید، گزینه **ایجاد یک مجوز مستقل را** انتخاب کرده و Desktop را تا زمانی که ورود جدید با موفقیت انجام شود بسته نگه دارید، یا با تلفن یا QR به TgWitness وارد شوید. استفاده از یک حساب کاربری اختصاصی توصیه می‌شود، اما این کار، کلیدهای کپی‌شده را برای استفاده همزمان ایمن نمی‌سازد. > > > > این امر در مورد موارد وارد شده نیز صدق می‌کند `.session` فایل‌ها، متن StringSession و هگز Auth Key. سایر کلاینت‌ها با مجوزهای مستقل خود می‌توانند به حالت ورود باقی بمانند. به [مستندات AUTH_KEY_DUPLICATED تلگرام](https://core.telegram.org/api/errors#406-not-acceptable) مراجعه کنید. 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`**. | میدان (نام‌های مستعار) | معنی | | --- | --- | | `api_id` (`app_id`) | شناسهٔ برنامه، یک عدد مثبت | | `api_hash` (`app_hash`) | هَش برنامه، ۳۲ کاراکتر هگزادسیمال | | `string_session` (`session_string`, `session_str`; `session` قدیمی) | متن Telethon StringSession، نه نام فایل | | `auth_key` (`auth_key_hex`) + `dc_id` | کلید احراز هویت ۵۱۲ کاراکتری و DC 1–5 را تکمیل کنید | | `user_id` (`id`) | اختیاری؛ پیش از ذخیرهٔ مجوز، با تلگرام بررسی می‌شود | | `device_model` (`device`) | توضیحات دستگاه اتصال | | `system_version` (`sdk`) | نسخه سیستم‌عامل اتصال | | `app_version` | نسخهٔ اپلیکیشن ارسال‌شده به تلگرام | | `lang_code`, `system_lang_code` (`system_lang_pack`), `lang_pack` | زبان کلاینت، زبان سیستم و بسته زبان کلاینت؛ یک `lang_pack` خالی مجاز است | | `tz_offset` | تغییر ساعت اختیاری UTC به ثانیه، ارسال‌شده در `initConnection.params`؛ رشته عدد صحیح یا عدد صحیح اعشاری | اگر هم نام مستعار و هم نام اصلی وجود داشته باشند، باید با هم مطابقت داشته باشند. فیلدهای صریح جلسه تل‌تون بر یک بلوب عمومی `session` در قالب دیگری اولویت دارند. اگر هر دو حاوی جلسات قابل تشخیص تل‌تون باشند، باید همان مجوز را توصیف کنند. در صورت عدم وجود فیلد صریح، `session` باید یک StringSession معتبر تل‌تون باشد. مثال‌ها: ``` { "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` را در بالا نشان می‌دهد | تله‌تون یا پایروگرام اس‌کیوالایت | **فایل‌ها** (به‌طور خودکار شناسایی‌شده) | | یک پوشهٔ `tdata` حاوی `key_datas` | تلگرام دسکتاپ TData | دو فایل را فشرده کنید، سپس **Files** | | یک خط متن با شروع `1`، حدود ۳۵۰ کاراکتر | جلسه رشته‌ای تله‌تون | **فایل‌ها** | | `*.json` با `app_id`/`app_hash` | متادیتای همراه | **فایل‌ها**، همراه با جلسهٔ آن | | `*.json` با `auth_key` یا `string_session` | JSON حساب | **فایل‌ها** | | ۵۱۲ کاراکتر `0-9a-f` | کلید رمزنگاری | **کلید رمزنگاری** | | ۳۲ کاراکتر `0-9a-f` | هَش API | **شناسهٔ API + هَش** | | `td.binlog` یا `db.sqlite` از یک اپلیکیشن TDLib | ذخیره‌سازی TDLib | پشتیبانی نمی‌شود | | `123456789:AA…` | توکن بات | پشتیبانی نمی‌شود | ## فرمت‌های پشتیبانی‌نشده | قالب | جایگزین | | --- | --- | | ذخیره‌سازی TDLib (`td.binlog`) و خروجی‌های TDLib | ورود با تلفن یا QR | | **رشته‌های** جلسه Pyrogram | از فایل Pyrogram `.session` استفاده کنید، یا تلفن/QR | | TData با چندین حساب کاربری واردشده | از حساب‌های دیگر در تلگرام دسکتاپ خارج شوید، یا از فایل جلسهٔ اختصاصی هر حساب استفاده کنید | | توکن‌های بات | پشتیبانی‌نشده: TgWitness به‌عنوان یک حساب کاربری مشاهده می‌کند | | فهرست‌های CSV/JSON از حساب‌های متعدد | فایل‌های نشست پشتیبانی‌شده را از طریق **حساب‌ها → وارد کردن حساب‌ها** وارد کنید، یا در فضاهای کاری مجزا با شماره تلفن/QR وارد شوید | | جلسات Test-DC یا بات | از یک حساب کاربری تولید استفاده کنید | ## حساب‌های متعدد روی **+** در کنار انتخابگر حساب کاربری ضربه بزنید، یا مسیر **حساب کاربری → تنظیمات → تنظیمات اتصال → فضاهای کاری را** باز کنید، یک برچسب وارد کرده و وارد شوید. - هر تعداد فضای کاری، از جمله فضای اصلی. هر کدام دارای جلسه، مسیر پروکسی، منابع، سیاست ضبط، دفترچه شواهد، کلید امضا، نقاط کنترل و خروجی‌های خود هستند. - تغییر فضای کاری نمایش‌داده‌شده، سایر فضاها را متوقف نمی‌کند. - یک ژورنال به حساب کاربری که آن را ایجاد کرده متصل می‌ماند. ورود به سیستم با حساب کاربری متفاوت نیازمند یک فضای کاری دیگر است و یک حساب نمی‌تواند به دو فضای کاری اختصاص یابد. - توکن پنل اصلی بر تمام فضاهای کاری کنترل دارد. [دسترسی صادرشده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/) می‌تواند افراد دیگر را به حساب‌ها و چت‌های منتخب محدود کند، با مجوزهای جداگانه و محدودیت‌های جلسه. - **حساب‌ها** یک فضای کاری را بازنامه‌گذاری می‌کند و یکی از فضاهای کاری افزوده‌شده را همراه با جلسه، دفترچه، منابع و کلید امضای آن حذف می‌کند. فضای کاری اصلی را نمی‌توان از پنل حذف کرد. ### ورود دسته‌ای و گروه‌های حساب برای افزودن چندین حساب، جفت کردن فایل‌ها بر اساس نام پایه و مشاهده نتیجه هر ورود، از مسیر **حساب‌ها → وارد کردن حساب‌ها** استفاده کنید. هر حساب فضای کاری مخصوص به خود را دریافت می‌کند. یک گروه حساب‌های مرتبط را بدون ادغام جلسات، کلیدها یا شواهدشان در کنار هم نگه می‌دارد. **باز کردن گروه** در **بخش حساب‌ها** به صفحهٔ آن در `/groups/`: - **حساب‌ها:** مسیر اتصال، مشاهده و آخرین پیام هر عضو، با شروع**همه** و **توقف همه**. - **نیاز به توجه:** حساب‌هایی که از آن‌ها خارج شده‌اند، در دسترس نیستند یا مشکل اتصال، دریافت، منبع یا رسانه دارند؛ هر نام به کارت مربوطه منتهی می‌شود. - **چت‌ها در چندین حساب قابل مشاهده‌اند:** منابع مشترک، حساب‌هایی که آن‌ها را مشاهده می‌کنند و وقفه‌ها در دورهٔ مشاهدهٔ فضای کاری موجود (تا هفت روز). **خروجی‌گیری با N حساب،** خروجی یک کانال یا ابرگروه را بین آن‌ها تقسیم می‌کند و یک آرشیو را امضا می‌کند. - **صادرات گروه:** یک ZIP با خروجی امضا‌شده هر حساب زیر `accounts/` و `manifest.json` که شامل امضاهای SHA-256 و اثرانگشت کلیدهای هر حساب است، امضا شده توسط فضای کاری اصلی در `manifest.signature.json`. هر آرشیو حساب را به طور جداگانه با `python -m tgwitness.verify` و اثر انگشت معتبر آن حساب. اعضا تنظیمات گروه را به اشتراک می‌گذارند؛ یک حساب می‌تواند مقادیر خود را حفظ کند. به [تنظیمات مشترک](https://phishdestroy.github.io/TgWitness/fa/docs/reference/settings/#account-groups)، [راهنمای وارد کردن و گروه‌ها](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Accounts.md#import-accounts-and-share-settings) و [داشبورد استخر MTProxy](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md#pool-dashboard-and-custom-sources) مراجعه کنید. ## خروج **گزینه حساب → خروج از تلگرام** (با توقف مشاهده) از تلگرام می‌خواهد که جلسه را پایان دهد، بنابراین این جلسه از بخش **تنظیمات → دستگاه‌ها** در حساب کاربری نیز ناپدید می‌شود و از گاوصندوق فضای کاری حذف می‌گردد. دفترچه یادداشت، منابع، تنظیمات و کلید امضا باقی می‌مانند و دفترچه یادداشت، خروج را ثبت می‌کند. محیط کاری همچنان متعلق به حساب کاربری خود است: فقط همان حساب کاربری می‌تواند دوباره به آن متصل شود. اگر تلگرام پاسخی ندهد، جلسه همچنان در اینجا حذف می‌شود و پنل این موضوع را اعلام می‌کند؛ جلسه را در تلگرام تحت **«تنظیمات → دستگاه‌ها»** پایان دهید. ## حفظ امنیت فایل‌های حساب - با هر `.session`، فایل ZIP TData، StringSession، کلید احراز هویت و JSON حساب کاربری مانند یک رمز عبور رفتار کنید. TgWitness مجوز واردشده را در گاوصندوق رمزگذاری‌شده خود نگه می‌دارد؛ شما می‌توانید بعداً فایل‌های اصلی را حذف کنید. - یک مجوز را همزمان در دو برنامه اجرا نکنید. تلگرام ممکن است آن را لغو کند (`AUTH_KEY_DUPLICATED`)، و هر دو نسخه از کار می‌افتند. - یک جلسه منقضی‌شده یا لغوشده را نمی‌توان با تبدیل احیا کرد. دوباره وارد شوید. ## عیب‌یابی | پیام یا نشانه | چه باید کرد | | --- | --- | | *نمی‌توان این جلسه را خواند. کلاینت اصلی آن را ببندید…* | فایل SQLite باز یا ناتمام است (سیدکار `-journal`/`-wal`). برنامهٔ اصلی را به‌طور صحیح ببندید و فایل را دوباره کپی کنید. | | *اسکیماهای Telethon SQLite پشتیبانی‌شده: ۷ و ۸* / *پایروگرام … ۲ و ۳* | یک نسخه بسیار قدیمی یا ناشناخته از کتابخانه این فایل را ایجاد کرده است. به جای آن با تلفن/کد QR وارد شوید. | | *فقط جلسات کاربری تولید مجاز پشتیبانی می‌شوند* | فایل Pyrogram متعلق به یک ربات یا شبکه آزمایشی است. | | *آرشیو TData از ۵۱۲ ورودی یا ۳۲ مگابایت فراتر رفته است* | فقط فایل‌های ZIP `key_datas` و `D877F783D5D3EF8Cs`، نه کل پوشه. | | *نمی‌توان TData را رمزگشایی کرد. رمز عبور محلی دسکتاپ را بررسی کنید.* | کد عبور محلی تلگرام دسکتاپ را در قسمت **«کد عبور» یا «متن جلسه**» وارد کنید. | | *وارد کردن یک حساب TData به صورت همزمان* | تلگرام دسکتاپ چندین حساب داشت؛ به [فرمت‌های پشتیبانی‌نشده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#unsupported-formats) مراجعه کنید. | | *فایل‌های منتخب، حساب‌های مختلف یا اعتبارنامه‌های API را توصیف می‌کنند* | فایل‌های یک حساب کاربری را انتخاب کنید. | | *JSON شامل هیچ اعتبارنامه‌ی API پشتیبانی‌شده یا مجوز نیست* | نام‌های فیلدها را در [JSON حساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#account-json) بررسی کنید. | | *فقط متادیتای API* | JSON فاقد جلسه است. فایل `.session` را اضافه کنید یا از تلفن/QR استفاده کنید. | | *کلید رمزنگاری HEX باید شامل تمام ۵۱۲ کاراکتر هگزادسیمال باشد* | کلید کوتاه شده است یا حاوی `…` می‌باشد. | | شناسه حساب با حساب واردشده مطابقت ندارد | شناسه کاربری فایل با آنچه تلگرام گزارش می‌کند متفاوت است؛ این فایل مربوط به حساب کاربری دیگری است. | | حساب کاربری از قبل به فضای کاری دیگری تعلق دارد | به جای افزودن دوباره‌ی حساب، آن فضای کاری را باز کنید. | | متصل است، اما یک گروه خصوصی در فهرست چت‌های **«منابع**» وجود ندارد. | عضویت را بررسی کنید. انتخابگر اولین ۱۰۰۰ دیالوگ را بازرسی می‌کند؛ محدودیت را در بخش **پارامترها** افزایش دهید. | | اتصال پروکسی ناموفق است | مسیر و حالت آی‌پی را بررسی کنید. MTProxy خودکار ورودی دیگرِ کارا را امتحان می‌کند. «پنهان کردن آدرس در انتظار»؛ «راست‌زمانی» به‌عنوان آخرین راه‌حل می‌تواند پس از تأخیر تنظیم‌شده مستقیماً متصل شود. [حالت‌های مسیریابی را](https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/#ip-modes) ببینید. | همچنین ببینید: [اتصال و امنیت](https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/) برای پروکسی‌ها و رمزگذاری، و [نحوه کارکرد جمع‌آوری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/) برای آنچه پس از ورود ثبت می‌شود. --- # Telegram · دسترسی و مجوزها Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/ اعطای دسترسی محدود به حساب‌ها و چت‌ها، انتخاب مجوزها، محدود کردن جلسات و آدرس‌های IP و لغو دسترسی. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) Translation coverage: this edition includes material from the English original. اعطای دسترسی محدود به حساب‌ها و چت‌ها، انتخاب مجوزها، محدود کردن جلسات و آدرس‌های IP و لغو دسترسی. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [شروع کار](https://phishdestroy.github.io/TgWitness/fa/docs/reference/quickstart/) ![شروع کار](https://phishdestroy.github.io/TgWitness/assets/chapter-start.svg) به یک بازبین دسترسی به یک چت، به یک تحلیلگر اجازه صدور یک پرونده، یا به یک اپراتور کنترل حساب‌های منتخب بدهید. هر شخص توکن مخصوص به خود را دریافت می‌کند. توکن پنل اصلی نزد مدیر باقی می‌ماند. [راه‌اندازی حساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/) · [مسیرهای اتصال](https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/) · [مدل امنیتی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/security/) ## دو دامنه، دو وظیفه متفاوت **دامنهٔ جمع‌آوری** مشخص می‌کند که یک حساب چه چیزی را ضبط می‌کند: چت‌های منتخب، یک پوشه تلگرام یا کل حساب. **دامنهٔ دسترسی** مشخص می‌کند که کدام یک از آن حساب‌ها و چت‌های ضبط‌شده را شخص دیگری می‌تواند ببیند و استفاده کند. اعطای دسترسی به معنای پیوستن به یک چت تلگرام، شروع جمع‌آوری یا اعطای مجوزهای حساب تلگرام نیست. یک دسترسی می‌تواند فضاهای کاری، چت‌های منتخب در آن‌ها، تمام فضاهای کاری، یا هر حساب کاربری یک [گروه حساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/#bulk-import-and-account-groups)را باز کند. **تمام فضاهای کاری، از جمله فضاهای کاری که بعداً اضافه می‌شوند،** حساب‌های آینده را نیز پوشش می‌دهند. یک دسترسی گروهی نیز حساب‌های کاربری که بعداً به آن گروه اضافه می‌شوند را پوشش می‌دهد. هنگامی که یک پرونده باید محدود به فضاهای کاری معین باقی بماند، آن‌ها را صراحتاً انتخاب کنید. ## دسترسی به کسی بدهید 1. به‌عنوان مدیر اصلی وارد شوید و **دسترسی را** باز کنید. 2. در بخش **«دسترسی به کسی بدهید**»، نامی را وارد کنید که در لاگ برایتان قابل تشخیص باشد. 3. فضاهای کاری را انتخاب کنید و در صورت نیاز، چت‌های فردی را نیز انتخاب کنید. 4. انتخاب کنید که این شخص ممکن است چه کاری انجام دهد. **«مشاهده»** همیشه گنجانده شده است. 5. زمان انقضا، محدودیت‌های ورود/جلسه و آدرس‌های مجاز را طبق نیاز تنظیم کنید. 6. روی **«ایجاد دسترسی»** کلیک کنید. توکن را همین حالا کپی کنید: فقط یک‌بار نمایش داده می‌شود. 7. آدرس پنل و توکن را به‌صورت خصوصی ارسال کنید. دریافت‌کننده آن توکن را در صفحه ورود عادی وارد می‌کند؛ او نیازی به توکن اصلی پنل شما یا یک جلسه تلگرام ندارد. پنل را با توکن صادرشده در یک جلسهٔ مجزای مرورگر باز کنید و پیش از تحویل آن، چت‌های قابل‌مشاهده و اقدامات مجاز را بررسی کنید. Access names remain in encrypted local storage and are resolved by the administrator's panel. Names are omitted from new access and workspace-creation audit records; existing signed records keep their original fields. ## انتخاب مجوزها برای یک نمایش عمومی متنی، به جای دسترسی بازبین معمولی از **«نمایش عمومی»** استفاده کنید. این حالت، کانال‌های عمومی صریحاً انتخاب‌شده، ویرایش‌ها و حذف‌های نگهداری‌شده، و آمار امضا شده را نشان می‌دهد، در حالی که فیلدهای نویسنده حذف شده و فایل‌ها در مرز API بسته می‌شوند. [یک نمایش را ایجاد و تأیید کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/showcase/). | مجوز | چه امکاناتی فراهم می‌کند | | --- | --- | | `view` | گفتگوهای مجاز، پیام‌های ضبط‌شده، پروفایل‌ها، فایل‌ها و سوابق مجلهٔ فیلترشده را بخوانید. همیشه گنجانده شده است. | | `export` | صادرات تاریخچه چت و پرونده‌ها مجاز است. صادرات شواهد کل فضای کاری نیازمند دسترسی به کل فضای کاری است. | | `sources` | مدیریت منابع، اسنپ‌شات‌ها و ضبط پروفایل. دسترسی محدود به چت‌ها تنها می‌تواند روی چت‌های مجاز عمل کند؛ کشف منابع در سطح حساب و تنظیمات دامنه بسته می‌مانند. | | `collect` | راه‌اندازی یا توقف یک جمع‌آورنده. نیازمند دسترسی کامل به فضای کاری است زیرا جمع‌آوری بر حساب کاربری تأثیر می‌گذارد. | | `interact` | تعاملات پشتیبانی‌شده تلگرام را در محدوده دسترسی انجام دهید. دسترسی محدود به چت نمی‌تواند از پیش‌نمایش لینک در سطح حساب استفاده کند. | | `settings` | تنظیمات جمع‌آوری، برچسب‌های زمانی، اعلان‌ها، نسخه‌های خارج از محل و پارامترها را تغییر دهید. نیازمند دسترسی کامل به فضای کاری است. | | `account` | وارد یا خارج شوید از تلگرام و مسیرهای اتصال را مدیریت کنید. نیازمند دسترسی کامل به فضای کاری است. | | `board.read` | یادداشت‌های تخته پرونده را تنها در محدوده فضای کاری و چت‌های مجاز بخوانید. | | `board.write` | افزودن نشانک‌ها، برجسته‌سازی‌ها، اسلایس‌ها، نظرات و وضعیت‌های باز/بازبینی. همچنین به `board.read` نیاز دارد. | | `board.manage` | مدیریت مجموعه‌ها، وضعیت‌های نهایی تیم و کارت‌های سایر شرکت‌کنندگان. همچنین نیاز به دسترسی خواندن/نوشتن تابلو دارد. | Only the main administrator can download the off-site replica recovery key. Delegated `settings` or `account` access does not grant that key. مجوزها و دامنه دسترسی با هم بررسی می‌شوند. تیک زدن یک مجوز، چت‌های دیگر را باز نمی‌کند و برای یک دسترسی محدود به یک چت، عملیات در سطح کل فضای کاری را فعال نمی‌سازد. برای یک خروجی‌گیری موازی، دسترسی باید در هر حساب کاربری انتخاب‌شده، چت صادرشده را پوشش دهد. یک دسترسی صادرشده نمی‌تواند دسترسی‌های جدید ایجاد کند، جلسات افراد دیگر را مدیریت کند یا کنسول ادمین را باز کند. ### سه پیکربندی مفید | شخص | دامنه | مجوزها | | --- | --- | --- | | بازبین | گفت‌وگوهای ضبط‌شده یک پرونده | `view` | | تحویل‌گیرنده در حال آماده‌سازی گزارش تحویل | گفت‌وگوها برای بررسی و صدور | `view`، `export`؛ فقط در صورتی `interact` را اضافه کنید که قرار باشد از طریق تلگرام اقدام کنند | | اپراتور جمع‌آوری | فضای کاری‌های انتخاب‌شدهٔ کامل | `view`، `sources`، `collect`؛ فقط در صورت نیاز `settings` یا `account` را اضافه کنید | پیش‌تنظیمات اولیه فرم دسترسی همچنین شامل «تخته پرونده» است: بازبین می‌تواند بخواند، تحلیلگر می‌تواند بخواند و بنویسد، و اپراتور می‌تواند آن را مدیریت کند. پیش‌تنظیمات همچنان قابل ویرایش هستند و امتیازات موجود به طور خودکار گسترش نمی‌یابند. برای دامنه‌های چت ارث‌بری شده و حریم خصوصی صادرات، به [«تخته پرونده»](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/) مراجعه کنید. ## محدودیت‌ها و جلسات | تنظیمات | نحوه کار | | --- | --- | | جلسات موازی | جلسات همزمان را به ۱ تا ۱۰۰ محدود کنید. در صورت رسیدن به حد، ورود بعدی را رد کنید یا قدیمی‌ترین جلسه را خاتمه دهید. | | ورود مجاز است | استفادهٔ موفقیت‌آمیز از توکن را به شروع جلسات محدود کنید. جلسات موجود تنها به این دلیل که آخرین ورود مجاز استفاده شده است، پایان نمی‌یابند. | | اعتبار تا | انقضای مطلق برای دسترسی. دسترسی منقضی‌شده نمی‌تواند وارد شود یا به ارسال درخواست‌ها ادامه دهد. | | دقایق بدون فعالیت | زمان انقضای عدم فعالیت جلسه، از ۵ دقیقه تا ۳۰ روز. درخواست‌های موفق آن را تمدید می‌کنند؛ یک پنل باز می‌تواند با ارسال درخواست‌های دوره‌ای خود را فعال نگه دارد. | | آدرس‌های مجاز | پذیرفتن آدرس‌های IP خاص یا زیرشبکه‌های CIDR. خالی گذاشتن برای اجازه دسترسی به هر آدرس مگر اینکه پیوند اولین ورود فعال باشد. | | به اولین ورود متصل شود | اولین ورود موفق، آدرس مجاز برای آن دسترسی را تعیین می‌کند. | آدرس IP، آدرس کلاینت است که توسط برنامه مشاهده می‌شود. در پشت یک پروکسی معکوس یا تونل، پیش از اتکا به قوانین IP، آدرسی را که در **بخش «جلسات باز» (Open sessions)** نمایش داده می‌شود بررسی کنید: در غیر این صورت، ممکن است چندین کاربر به اشتراک گذاشتن آدرس پروکسی ظاهر شوند. ## تغییر یا لغو دسترسی یک ورودی را در بخش **«دسترسی اعطا شده»** ویرایش کنید تا دامنه، مجوزها یا محدودیت‌های آن را تغییر دهید. تغییرات دامنه و مجوز در درخواست‌های بعدی بررسی می‌شوند، از جمله درخواست‌های مربوط به جلسات (session) که از قبل باز هستند. لغو دسترسی، جلسات آن را پایان می‌دهد و توکن صادر شده را غیرقابل استفاده می‌کند. **جلسات باز** همچنین به مدیر اجازه می‌دهد یک جلسه فردی را بدون لغو کل دسترسی، پایان دهد. Saved export copies retain their creator, workspace, chat scope and required permissions. An issued access can list or download its own copies only while those permissions still apply; copies containing Case Board also require `board.read`. The administrator can retrieve all copies. Older copies without this metadata and group bundles are administrator-only. Download tickets and prepared file responses recheck access after preparing the file, before sending its bytes. Each access, including the administrator, can hold ten pending download tickets per workspace; the workspace-wide limit is 1,000. Tickets expire after 120 seconds and are single-use. ابطال نمی‌تواند فایل‌هایی را که قبلاً دانلود شده‌اند، بازپس گیرد. خروج، قفل کردن پنل یا پایان دادن به یک جلسه، جمع‌آورنده در حال اجرا را متوقف نمی‌کند. ## آنچه مدیر می‌تواند ببیند بازبینان و تحلیلگران پیشرفت جمع‌آوری را بدون نقاط پایانی پروکسی، تشخیص‌های استخر، مسیرهای سرور یا خطاهای خام اتصال دریافت می‌کنند. تشخیص‌های اتصال به مجوز `account` در سراسر فضای کاری نیاز دارند. خواندن اعلان، نسخهٔ خارج از محل و تنظیمات پارامتر به مجوز `settings` نیاز دارد. رشته‌های کامل مرورگر User-Agent در جلسات دسترسی حفظ نمی‌شوند. یک ارتقا همچنین آن‌ها را از کش جلسه قابل تغییر حذف می‌کند. لاگ فرآیند پنل، آدرس‌های IP، اعتبارنامه‌های URL و اسرار برچسب‌گذاری‌شده را مخفی می‌کند. لاگ‌های خدمات محلی و سوابق ژورنال امضا شده قبلی بازنویسی نمی‌شوند. قوانین دسترسی و سوابق ورود امضا شده همچنان از آدرس کلاینت استفاده می‌کنند. ### کلید اصلی را جایگزین کنید از مسیر **دسترسی → محدودیت‌های من → صادر مجدد کلید مدیر** استفاده کنید، یا در حالی که پنل در حال اجراست، `tgwitness token rotate` را از یک نصب مدیریت‌شده اجرا کنید. تمام جلسات موجود مرورگر، از جمله جلساتی که با توکن‌های همکار باز شده‌اند، پایان می‌یابند. مرورگر درخواست‌کننده یک جلسه جدید دریافت می‌کند؛ کلید مدیر جدید را قبل از پنهان کردن آن ذخیره کنید. توکن‌های همکار صادرشده تا زمانی که به طور جداگانه لغو نشوند معتبر باقی می‌مانند. نصب‌کننده‌ای که از `TGWITNESS_TOKEN` استفاده می‌کند، باید آن تنظیم محیط را تغییر داده و مجدداً راه‌اندازی شود. ### مرزهای درخواست و پروکسی The API admits up to 600 requests per minute per client and credential family: panel, archive/MCP or witness. Authentication cooldowns are separate for these families. Ten rejected authentications within a minute start an exponential cooldown, from one second up to five minutes. A failed attempt after the cooldown increases it; ten minutes without a failed attempt resets escalation. Rejections return HTTP 429 and `Retry-After`. Limits are in memory, shared across workspaces in one panel process; restart clears them. Live streams are limited to four per bearer token and 32 for the panel process. Opening a stream also consumes the API request budget. Request bodies have a 60-second receive deadline, reduced to 10 seconds for login, demo access, archive API and witness-head paths, or 8 seconds for MCP transport. Each application permits four unfinished bodies per client address, with overall limits of 32 and 64 MiB of reserved route allowances. Requests without bodies do not consume these slots. Oversized bodies return 413, timed-out bodies return 408, and exceeded client capacity returns 429 with `Retry-After: 1`. Exhausted overall body capacity returns 503 with `Retry-After`. سربرگ‌های IP فوروارد شده نادیده گرفته می‌شوند، مگر اینکه همتای واقعی TCP به `TGWITNESS_TRUSTED_PROXIES` (آدرس‌های IP جدا شده با ویرگول یا CIDRها) تعلق داشته باشد. `TGWITNESS_PROXY_HEADER` را روی `x-forwarded-for` یا `cf-connecting-ip` تنظیم کنید. XFF از نزدیک‌ترین پروکسی به سمت اولین همتای غیرقابل اعتماد ردیابی می‌شود. متادیتای آدرس معتبر نامعتبر یا تکراری رد می‌شود، بنابراین نمی‌تواند یک آدرس پروکسی مجاز را به ارث ببرد. تونل سریع مدیریت‌شده به کانکتور محلی Cloudflared اعتماد می‌کند؛ راه‌اندازی دامنه-خود به Caddy محلی اعتماد می‌کند. استقرارهای مستقیم به طور پیش‌فرض به هیچ پروکسی اعتماد نمی‌کنند. اگر خودتان Uvicorn را راه‌اندازی می‌کنید، پردازش هدر پروکسی آن را غیرفعال کنید تا این مرز، همتای واقعی را دریافت کند. `TGWITNESS_PANEL_ALLOWED_IPS` دسترسی به تمامی پنل‌ها، از جمله پنل ادمین، را به IPها یا CIDRهای فهرست‌شده محدود می‌کند. پروب هویت مسیریابی (routing-identity) نصب‌کننده عمومی باقی می‌ماند و هیچ داده‌ای از حساب کاربری بازنمی‌گرداند. قبل از فعال‌سازی لیست مجاز (allowlist)، مسیر اداری محلی مورد نیاز را اضافه کنید. راهنمای **START-HERE** یک نصب مدیریت‌شده شامل پیکربندی سرویس و دستورالعمل‌های بازیابی است. یک انتخابگر پرس‌وجوی API `ws` باید فضای کاری را در مسیر درخواست مشخص کند؛ انتخابگرهای ناشناخته، نامطابق و تکراری با کد خطای 404 رد می‌شوند. اسکریپت‌ها و استایل‌های پنل دارای متادیتای یکپارچگی SHA-384 هستند. یک نقشهٔ وارداتی همچنین ماژول‌های JS واردشده به‌صورت محلی در مرورگرهایی را که از یکپارچگی import-map پشتیبانی می‌کنند، پوشش می‌دهد. پاسخ زبانه‌ای که به‌صورت پویا تولید می‌شود، جداگانه است. این بررسی‌ها، جایگزینی دارایی‌ها را نسبت به صفحه تحویل‌شده تشخیص می‌دهند؛ آن‌ها اعتمادی را نسبت به یک سرور مخرب که می‌تواند هم صفحه و هم هش‌های آن را جایگزین کند، ایجاد نمی‌کنند. **لاگ از زمان شروع**، لاگ‌های فرآیند را با فعالیت‌های دفترچه یادداشت از هر فضای کاری ترکیب می‌کند: ورودها، ردها، تغییرات مسیر و اقدامات اپراتور. این یک کنسول در حافظه‌ی رم برای فرآیند جاری است، نه یک کپی دائمی از هر پیام. رویدادهای پیام‌های مکرر به جای پر کردن کنسول، در دفترچه یادداشت باقی می‌مانند. اعطا، تغییر و لغو دسترسی، و شروع یا پایان جلسات نیز، سوابق دفتر روزنامه امضا شده با `access.*` ایجاد می‌کنند. توکن‌ها در این سوابق گنجانده نمی‌شوند. توکن‌های صادر شده و اعتبارنامه‌های جلسه به صورت هش در گاوصندوق رمزگذاری شده نگهداری می‌شوند. ****مدیر اصلی و مرز اعتماد**** توکن پنل اصلی بدون محدودیت باقی می‌ماند. ورود با آن به مرورگر، جلسات را ایجاد می‌کند که تابع محدودیت‌های جلسه‌ای است که مدیر پیکربندی کرده است. اسکریپت‌هایی که توکن اصلی را مستقیماً ارسال می‌کنند، دسترسی کامل خود را حفظ می‌کنند و به عنوان جلسات مرورگر شمرده نمی‌شوند. این کنترل دسترسی در سطح برنامه در یک نصب واحد است. تمام فضاهای کاری فرآیند سرور را به اشتراک می‌گذارند؛ این جداسازی از مدیر میزبان نیست. توکن اصلی، جلسات تلگرام، کلیدهای امضا و دایرکتوری داده را خصوصی نگه دارید. توکن شاهد یک نقطه کنترل/اعتبار سلامت جداگانه است، نه توکن دسترسی به پنل. --- # Telegram · اتصال، پروکسی‌ها و حفاظت از داده‌ها Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/ احراز هویت، استخرهای خودکار پروکسی، حالت‌های IP، سیاست پشتیبان، درخواست‌های خارجی و ذخیره‌سازی مخفی. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) احراز هویت، استخرهای خودکار پروکسی، حالت‌های IP، سیاست پشتیبان، درخواست‌های خارجی و ذخیره‌سازی مخفی. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/deployment/) ![راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/assets/chapter-operate.svg) این سند رفتار و محدودیت‌های TgWitness 0.8.0 را توصیف می‌کند. احراز هویت، دسترسی به منبع، اتصال شبکه و کامل بودن ضبط، حالات جداگانه‌ای هستند. برای مراحل ورود، فرمت‌های فایل و حساب‌های متعدد، از بخش [«حساب‌ها و فرمت‌های جلسه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/)» شروع کنید. برای سیاست‌های رویداد و رفتار راه‌اندازی مجدد، به بخش [«نحوه کارکرد جمع‌آوری»](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/) مراجعه کنید. ## راه‌اندازی اتصال هدایت‌شده در **اتصال**، مدیر می‌تواند **این حساب**، **گروه حساب‌ها** یا **تمام حساب‌ها** را انتخاب کرده، سپس یک مسیر را برگزیند. **بازبینی انتخاب**، حساب‌های تحت تأثیر را فهرست می‌کند. **آماده و بررسی کنید**، مسیر پیشنهادی را بدون تغییر مسیر ذخیره شده، آزمایش می‌کند. **اتصال بررسی‌شده را اعمال کنید**، دوباره بررسی می‌کند، در صورت لزوم مشاهده را متوقف می‌کند، مسیر را ذخیره کرده و مشاهده‌ای را که قبلاً در حال اجرا بوده از سر می‌گیرد. این هرگز جمع‌آوری را در حسابی که قبلاً غیرفعال بوده است آغاز نمی‌کند. دانلودهای سابقه در حالت مکث باقی می‌مانند و می‌توان آن‌ها را به صورت جداگانه از سر گرفت. صادرات فعال را قبل از تعویض، متوقف کنید. تغییرات گروهی به‌طور پیش‌فرض حساب‌ها را با مسیر خودشان حفظ می‌کنند. این گزینه را تنها زمانی پاک کنید که پیش‌نمایش شامل تغییراتی باشد که قصد دارید. برنامه نتیجه هر حساب را گزارش می‌کند؛ این یک تراکنش همه‌یا-هیچ در سراسر پایگاه‌های داده نیست. یک سوئیچ ناموفق، تنظیمات قبلی آن حساب را بازیابی می‌کند. خطای ازسرگیری به‌وضوح نمایش داده می‌شود. پیش‌نمایش‌ها پس از ده دقیقه منقضی می‌شوند و تغییرات در تنظیمات اتصال یا عضویت در گروه نیازمند بررسی مجدد است. | مسیر | TgWitness چه چیزی را مدیریت می‌کند | | --- | --- | | مستقیم | اتصالات از میزبان؛ VPN میزبان خارجی شناسایی یا اعمال نمی‌شود. | | وی‌پی‌ان | یک پروفایل کامل تونل WireGuard برای هر حساب کاربری، که توسط یک فرآیند محلی کاربرانpace SOCKS5 اجرا می‌شود. هیچ رابط میزبان یا درایوری نصب نشده است. | | پروکسی من | SOCKS5، HTTP CONNECT یا اعتبارنامه‌های MTProxy. یک URL می‌تواند فیلدهای SOCKS5/HTTP را پر کند. انتخاب چندین حساب این پروکسی واردشده را به اشتراک می‌گذارد. | | MTProto عمومی | استخر موجود مسیرهای Telegram را اختصاص می‌دهد. درخواست‌های خارجی تا زمانی که یک پروکسی مناسب جداگانه در تنظیمات پیشرفته پیکربندی نشود، غیرفعال هستند. | | WARP | یک تونل محلی جداگانه برای هر حساب انتخاب‌شده، با ثبت‌نام WARP و پروفایل WireGuard نگهداری‌شده در گاوصندوق آن حساب. | بررسی مسیر فعلی از یک اتصال حمل‌ونقل تازه‌ی تأییدنشده‌ی Telegram استفاده می‌کند، نه جلسه‌ی حساب کاربری. برای مسیرهای مجهز به HTTP، همچنین ردیابی HTTPS کلودفلر را از طریق آن مسیر درخواست می‌کند و IP خروجی گزارش‌شده، کشور، وضعیت WARP و زمان بررسی را نمایش می‌دهد. تاخیر اندازه‌گیری شده، زمان راه‌اندازی اتصال Telegram است، نه پینگ ICMP. آماده‌سازی WARP ناموفق است مگر اینکه ردیابی، فعال بودن WARP را گزارش دهد. این بررسی‌ها اتصال را برقرار می‌کنند، نه اصالت یا کامل بودن پیام‌های ضبط شده. یک فرآیند محلی در حال اجرا به تنهایی، یک بررسی خروج موفق محسوب نمی‌شود. ### WARP قابل حمل و WireGuard این یک **یکپارچه‌سازی غیررسمی WARP** با استفاده از [wgcf 2.3.1](https://github.com/ViRb3/wgcf/releases/tag/v2.3.1) و [wireproxy 1.1.3](https://github.com/windtf/wireproxy/releases/tag/v1.1.3) است. مدیر به صراحت پیش از اولین دانلود یا ثبت‌نام در WARP، راه‌اندازی را می‌پذیرد. این اتصالات راه‌اندازی مستقیماً به گیت‌هاب و کلودفلر متصل می‌شوند و آدرس IP ماشین را فاش می‌کنند. ترافیک حساب کاربری عادی تا زمان اعمال [تغییرات]، مسیر موجود خود را حفظ می‌کند. کلودفلر آدرس خروجی و کشور را انتخاب می‌کند؛ تونل‌های مجزا می‌توانند یک آدرس خروجی را به اشتراک بگذارند. انتخاب کشور، چرخش دوره‌ای IP و کلید قطع VPN در سطح کل میزبان توسط این ویژگی ارائه نمی‌شوند. دانلودهای کمکی پشتیبانی‌شده: لینوکس و macOS x86-64/ARM64، و ویندوز x86-64. آرتیفکت‌ها با هش‌های SHA-256 که در سورس بررسی‌شده بسته‌بندی شده‌اند، تطبیق داده می‌شوند، و فایل‌های اجرایی کش‌شده نیز قبل از اجرا مجدداً بررسی می‌شوند. هیچ ابزار کمکی به PATH اضافه نمی‌شود، به عنوان سرویس سیستم نصب نمی‌شود، یا یک listener عمومی به آن داده نمی‌شود. تمام فایل‌ها در زیر دایرکتوری `portable-routes/` فضای کاری و ورودی‌های گاوصندوق رمزگذاری‌شده قرار دارند. listener لوپ‌بک SOCKS5 به اعتبارنامه‌های تولیدشده به طور مستقل نیاز دارد. پروفایل‌های خصوصی و اطلاعات حساب کاربری WARP با گاوصندوق فضای کاری موجود رمزگذاری می‌شوند. در حین اجرا، ابزار کمکی به یک پیکربندی متن ساده فقط-مالک نیاز دارد؛ این پیکربندی در توقف عادی حذف می‌شود. از کار افتادن میزبان می‌تواند این فایل را در پوشه داده‌های فقط-مالک باقی بگذارد. این کار دیسک را رمزگذاری نمی‌کند و در برابر مدیر سیستم از آن محافظت نمی‌کند. سرپرست در صورتی که خط لوله والد پنل ناپدید شود، تونل را می‌بندد. یک تونل ناموفق هرگز یک بازگشت مستقیم را فعال نمی‌کند. راه‌اندازی مجدد پنل، تونل انتخابی را بازیابی می‌کند؛ راه‌اندازی‌های ناموفق با یک تأخیر محدود دوباره تلاش می‌کنند. **متوقف کردن تونل** همچنین مشاهده را متوقف می‌کند و وضعیت متوقف‌شده را حفظ می‌کند. **راه‌اندازی تونل** تونل را راه‌اندازی می‌کند؛ از سرگیری مشاهده را زمانی که آماده باشد به طور جداگانه انجام می‌دهد. پروفایل‌های بارگذاری‌شده WireGuard باید شامل یک رابط (Interface) و یک همتا (Peer)، تمام مسیرهای IPv4 و IPv6، و بدون هیچ‌گونه قلاب (hooks)، شامل (includes)، جایگزینی‌های محیطی (environment substitutions) یا شنونده‌های اضافی (extra listeners) باشند. آدرس‌های نقطه‌پایانی عمومی قبل از راه‌اندازی، حل و پین (pin) می‌شوند. برای OpenVPN/IPsec و نقطه‌پایانی‌های خصوصی از یک VPN خارجی یا دروازه (gateway) SOCKS5 استفاده کنید. ## روش‌های احراز هویت **شناسه API و هش API یک برنامه را شناسایی می‌کنند؛ آنها جایگزین ورود به حساب کاربری نمی‌شوند.** استفاده از آنها در TgWitness اختیاری است. اولویت‌بندی: یک جفت وارد شده در فرم، سپس یک جفت از JSON حساب کاربری وارد شده، سپس جفت ذخیره شده در فضای کاری، سپس استخر داخلی ۵۰ تایی فقط جفت تلگرام دسکتاپ (2040) همراه با توضیحات تطبیق‌یافتهٔ کلاینت تلگرام دسکتاپ ارسال می‌شود. شما می‌توانید از جفت اختصاصی خود از ابزارهای توسعهٔ API در [my.telegram.org](https://my.telegram.org) با تمام حساب‌های خود استفاده کنید؛ هر حساب همچنان مجوز (authorization) خود را دارد. | روش | پیش‌نیازها | پشتیبانی TgWitness | | --- | --- | --- | | تلفن، کد، احراز هویت دو مرحله‌ای اختیاری | دسترسی به حساب؛ جفت API اختیاری | ورود به پنل | | کلید رمزنگاری HEX + شناسه DC | کلید کامل ۵۱۲ کاراکتری و DC 1–5 | زبانه‌ی **کلید احراز هویت** مستقیم؛ شناسهٔ کاربر اختیاری قبل از ذخیره‌ی احراز هویت بررسی می‌شود | | جلسه رشته‌ای تله‌تون | یک رشته جلسه معتبر | ورود به پنل | | تله‌تون اس‌کیوالایت `.session` | متن تبلیغاتی بسته و یکنواخت | وارد کردن مستقیم اسکیماها از پنل ۷/۸؛ CLI آفلاین اختیاری | | پایروگرام اس‌کیوالایت `.session` | جلسه کاربری تولید بسته شد | وارد کردن مستقیم اسکیماها از پنل ۲/۳ | | Telegram Desktop TData ZIP | یک حساب مدرن؛ رمز عبور محلی در صورت محافظت‌شده | تبدیل در حافظه همراه با بررسی‌های چک‌سام و رمزگشایی | | JSON حساب | میدان‌های پشتیبانی‌شدهٔ API/جلسه/کلید | فقط متادیتا برای پر کردن اعتبارنامه‌های API کافی است؛ ورود با جلسه/کلید یا تلفن/QR همچنان لازم است | | ورود با QR | تأیید از یک اپلیکیشن تلگرام مجاز | تولید QR محلی، انقضا/تکرار تلاش، احراز هویت دو مرحله‌ای اختیاری | | TDLib / Pyrogram StringSession | فرمت‌های دیگر مخصوص کتابخانه | پشتیبانی‌نشده | | توکن بات | یک ربات با مدل دسترسی/به‌روزرسانی اختصاصی خود | توسط این گردآورنده استفاده نشده است | تلگرام ارسال کد را انتخاب می‌کند؛ پیامک تضمین‌شده نیست. هش API نمی‌تواند یک جلسه لغو شده را ترمیم کند یا رمز عبور ۲FA فراموش‌شده را جایگزین نماید. TgWitness کدهای ورود یا رمز عبور ۲FA تلگرام را روی دیسک ذخیره نمی‌کند. برای یک منبع خصوصی، حساب کاربری باید از قبل دسترسی داشته باشد. نام کاربری گروه غیرضروری است. وارد کردن پروکسی یا جلسه، نه حق عضویت و نه حق ادمین را اعطا نمی‌کند. عضویت فعلی، دسترسی به تاریخچه پیش از پیوستن را تضمین نمی‌کند. ## وارد کردن فایل جلسه تله‌تون Telethon SQLite، Pyrogram SQLite و TData تلگرام دسکتاپ از فرمت‌های متفاوتی استفاده می‌کنند. پنل ساختارهای پشتیبانی‌شده را تشخیص داده و تبدیل می‌کند؛ تغییر نام یک فایل، تبدیل آن نیست. یک جلسه و JSON همراه آن را در بخش **«فایل‌ها**» (**Files**) انتخاب کرده، سپس روی **«اتصال حساب» (Connect account**) کلیک کنید. تا چهار فایل مطابقت‌دار و مجموعاً ۸ مگابایت (MiB) پذیرفته می‌شود. برای جزئیات فرمت‌های TData/JSON، [محدودیت‌های فرمت را](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/) ببینید. امکان بازیابی رمز عبور وجود ندارد. ورود با تلفن/2FA یا QR یک مجوز جداگانه ایجاد می‌کند. مسیر خط فرمان اختیاری مخصوص تله‌تون همچنان در دسترس است: 1. کلاینت را با استفاده از جلسهٔ اصلی متوقف کرده و یک نسخهٔ یکسان بسازید. مبدل فایل‌هایی را که WAL/ژورنال ناقص دارند رد می‌کند. به جای حذف آن فایل‌ها برای دور زدن بررسی، کلاینت اصلی را به درستی ببندید. 2. از محیط TgWitness، اجرا کنید: ``` python -m tgwitness.sessions account.session --out account.tgwitness-session ``` 1. در بخش **افزودن حساب → فایل‌ها**، نتیجه را بارگذاری کنید یا رشتهٔ آن را چسبانده و ادامه دهید. 2. شناسه عددی حساب نمایش‌داده‌شده را بررسی کنید، منابع را انتخاب کرده و مشاهده را آغاز کنید. **فایل تبدیل‌شده، رمز دسترسی به حساب کاربری رمزگذاری‌نشده است.** آن را در یک مخزن محافظت‌شده نگه دارید و هرگز آن را در مخزن کد قرار ندهید یا برای یک سرویس تبدیل شخص ثالث ارسال نکنید. TgWitness جلسه مجاز را در گاوصندوق رمزگذاری‌شده خود ذخیره می‌کند. کپی کردن یک جلسه، مجوز جداگانه‌ای ایجاد نمی‌کند: همزمان کلاینت‌هایی را با کلیدهای دسترسی کلون‌شده اجرا نکنید و انتظار دریافت به‌روزرسانی مستقل را نداشته باشید. مبدل مجوز را منتقل می‌کند، نه پیام‌های اصلی، حافظهٔ موقت موجوده یا یک نشانگر به‌روزرسانی پایدار. این قابلیت بازیابی به‌روزرسانی را در صورت راه‌اندازی مجدد فرآیندها تضمین نمی‌کند. ## MTProto، تل‌تون و پروکسی‌ها MTProto پروتکل تلگرام است. Telethon کتابخانه کلاینت پایتونی است که TgWitness از آن استفاده می‌کند. MTProxy یک پروکسی حمل‌ونقل تلگرام است؛ SOCKS5 و HTTP CONNECT تونل‌های عمومی فراهم می‌کنند. هیچ‌کدام جایگزین احراز هویت حساب کاربری نمی‌شوند. مسیر هر فضای کاری را در **حساب → تنظیمات → تنظیمات اتصال → تغییر مسیر اتصال** قبل از ورود ذخیره کنید. فضاهای کاری جدید به‌طور پیش‌فرض با **MTProxy خودکار · فهرست‌های عمومی** و **پنهان کردن آدرس** ذخیره می‌شوند. فضاهای کاری موجود که به‌طور صریح از Direct استفاده کرده‌اند، حالت اجازه‌دهنده آن را حفظ می‌کنند. ## مُدهای IP مسیر، اتصال را انتخاب می‌کند. حالت IP، **محافظت IP** در بخش حساب پنل، تعیین می‌کند که چه زمانی آدرس سرور ممکن است فاش شود. این کنترل‌ها VPN را نصب نمی‌کنند یا تمام ترافیک دستگاه را مسیریابی نمی‌کنند. | حالت | تلگرام | درخواست‌های خارجی | | --- | --- | --- | | پنهان کردن آدرس (`hide`) | از پروکسی استفاده کنید؛ اگر هیچ‌کدام کار نکرد، منتظر بمانید. هیچ پشتیبان مستقیم دیگری وجود ندارد. | نیازمند SOCKS5/HTTP است؛ درخواست‌های بدون پروکسی مناسب را رد می‌کند. | | مستقیم به‌عنوان آخرین راه‌حل (`fallback`) | MTProxy خودکار ممکن است پس از تأخیر تنظیم‌شده از Direct استفاده کند و سپس به یک پروکسی فعال بازگردد. | ترجیحاً از پروکسی خارجی پیکربندی‌شده یا مسیر SOCKS5/HTTP حساب استفاده کنید؛ در غیر این صورت، گزینه Direct مجاز است. | | سرور پشت یک تونل یا VPN (`tunnel`) | مسیرهای مستقیم و بازگشت فوری خودکار به استخر مجاز است. | استفاده از Direct زمانی مجاز است که هیچ پروکسی قابل‌اعمال پیکربندی نشده باشد. | حالت تونل یا VPN بر این فرض است که شما آن شبکه را به‌طور جداگانه مدیریت می‌کنید. بدون یک تونل فعال، مقصدها می‌توانند آدرس خودِ سرور را ببینند. حالت را بر اساس شبکه واقعی خود انتخاب کنید، نه بر اساس نام گزینه. ### یک مسیر را انتخاب کنید | مسیر | تنظیمات | مرز | | --- | --- | --- | | MTProxy خودکار | فهرست‌های داخلی یا کاتالوگ اپراتور | یک مسیر تلگرام فعال را حفظ می‌کند؛ پشتیبان مستقیم به حالت IP بستگی دارد | | مستقیم | حالت تونل یا VPN | تله‌تون از مسیر شبکه میزبان استفاده می‌کند | | SOCKS5 | میزبان، پورت، نام کاربری/رمز عبور اختیاری | python-socks، DNS مقصد از راه دور فعال است | | اتصال HTTP | میزبان، پورت، نام کاربری/رمز عبور اختیاری | اتصال ساده HTTP CONNECT؛ TLS به خود پروکسی پیاده‌سازی نشده است | | MTProxy | میزبان، پورت، مخفی | انتقال آزمایشی تله‌تون؛ ۳۲ رقم هگزادسیمال یا `dd` + ۳۲ رقم هگزادسیمال | اسرار Fake TLS `ee` رد می‌شوند. نرمال‌سازی Telethon 1.45 می‌تواند پیش‌وند و دامنه را حذف کند، اما این کار، Fake TLS را پیاده‌سازی نمی‌کند. `tg://proxy?server=…&port=…&secret=…` یا `https://t.me/proxy?server=…&port=…&secret=…` را الصاق کنید و **از لینک، «پر کردن فیلدها» را** انتخاب کنید. این کار فیلدها را بدون اتصال یا ذخیره کردن اعتبارسنجی و پر می‌کند؛ مسیر را به صورت جداگانه بررسی و ذخیره کنید. فیلدهای دستی همچنان در دسترس هستند. به [لینک‌های پروکسی تلگرام](https://core.telegram.org/api/links#proxy-links) مراجعه کنید. ### پروکسی‌های عمومی ارائه‌شده توسط نصب شما فهرست داخلی چهار منبع را ترکیب می‌کند: [SoliSpirit/mtproto](https://github.com/SoliSpirit/mtproto)، [zakky8/mtproto-proxy-pro](https://github.com/zakky8/mtproto-proxy-pro)، [kort0881/telegram-proxy-collector](https://github.com/kort0881/telegram-proxy-collector) و [3yed-61/MTP-Collector](https://github.com/3yed-61/MTP-Collector). اسنپ‌شات ضمیمه‌شده حاوی اطلاعات انتهای نقطه، انتساب منبع و تاریخ‌های دانلود است. فهرست شدن یک ارائه‌دهنده، اثباتی بر کارکرد یا ارائه تمام به‌روزرسانی‌های تلگرام توسط آن نیست. **MTProxy به‌صورت خودکار** اتصال انتقال تلگرام را بررسی می‌کند، یک پروکسی فعال را حفظ می‌کند و در صورت از کار افتادن آن، به پروکسی دیگری سوئیچ می‌کند. فضاهای کاری (Workspaces) در صورت وجود ورودی‌های فعال کافی، ترجیح می‌دهند از پروکسی‌های متفاوت استفاده کنند؛ آدرس خروجی منحصربه‌فرد تضمین نمی‌شود. پراکسی‌های ناموفق پیش از تلاش مجدد استراحت می‌کنند. اگر هیچ‌کدام کار نکنند، حالت IP تعیین می‌کند که آیا جمع‌آوری باید منتظر بماند یا می‌تواند از اتصال مستقیم استفاده کند. تغییر پراکسی‌ها، حساب کاربری را تغییر نمی‌دهد یا دفترچه یادداشت آن را پاک نمی‌کند. انتخاب‌ها و تغییرات مسیر در دفترچه یادداشت امضا شده ثبت می‌شوند. هنگامی که مسیرهای خودکار فعال هستند، فهرست‌ها به‌صورت ساعتی تازه می‌شوند و بررسی‌های حمل‌ونقل به‌طور پیش‌فرض هر ده دقیقه یک‌بار اجرا می‌شوند. این بازه‌های زمانی قابل تنظیم هستند. **به‌روزرسانی فهرست‌های عمومی** نیازمند یک تازه‌سازی است؛ مشاهده صرف فهرست، مسیر دستی ذخیره‌شده را تغییر نمی‌دهد. **ترافیک تلگرام و درخواست‌های HTTPS از مسیرهای متفاوتی استفاده می‌کنند.** دانلود لیست‌ها از یک اتصال HTTPS جداگانه و مسیر درخواست خارجی ارائه‌شده استفاده می‌کند. `TGWITNESS_PROXY_FEED_PROXY` صراحتاً آن مسیر را با یک پروکسی HTTP/SOCKS5 بازنویسی می‌کند؛ هر دو واریانت Compose کلککتور آن را فوروارد می‌کنند. استخر پس‌زمینه از فضای کاری اصلی پیروی می‌کند. هیچ جلسه تلگرام، اعتبارنامه‌های API، توکن پنل یا توکن ربات به ارائه‌دهندگان فید ارسال نمی‌شود. نام ارائه‌دهندگان، تاریخ‌های اسنپ‌شات و مسیر دانلود در **بخش «منبع فهرست»** نمایش داده می‌شوند. یک MTProxy فقط ترافیک تلگرام را منتقل می‌کند. عملیات HTTP فضای کاری مانند ثبت زمان، اعلان‌ها، کپی‌های خارج از سایت و بررسی منبع، در صورت پیکربندی، از یک پروکسی جداگانه SOCKS5/HTTP استفاده می‌کنند و سپس از مسیر SOCKS5/HTTP حساب کاربری. در صورت عدم وجود هر یک از این موارد، Hide the address درخواست را رد می‌کند؛ حالت‌های دیگر Direct را مجاز می‌دانند. درخواست‌های خارجی را می‌توان غیرفعال کرد. یک پروکسی دانلود فید که به صراحت پیکربندی شده باشد، یک فراتر از تنظیمات اپراتور مجزا باقی می‌ماند. سرویس شاهد مستقل، مسیر خود را حفظ می‌کند. برای سرویس‌های خصوصی مدیریت‌شده توسط اپراتور، تنظیم محیط سرور موجود `TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1` مقصدهای خصوصی را مجاز می‌داند و حل نام میزبان را به سمت پروکسی واگذار می‌کند. این تنظیم از طریق پنل قابل فعال‌سازی نیست. حالت فقط عمومی مقصدهای `.onion` را قبل از استعلام از ریزولور عمومی رد می‌کند؛ سرویس‌های پیازی تور به آن تنظیم صریح مقصد خصوصی و یک پروکسی مناسب نیاز دارند. این رفتار DNS برای عملیات HTTP خارجی اعمال می‌شود، نه برای انتقال تلگرام. کلودفلر این [نقطه پایانی DNS JSON](https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/) را مستندسازی کرده است. ****پارامترهای استخر خودکار**** در **بخش پارامترها → MTProxy خودکار**، آستانه خرابی، زمان خنک‌سازی، چرخش برنامه‌ریزی‌شده، اشتراک‌گذاری پروکسی و تأخیر بازگشتی مجاز را پیکربندی کنید. | کنترل | پیش‌فرض | | --- | --- | | قطع اتصال‌ها قبل از جایگزینی | 3 دقیقه در 10 دقیقه | | پراکسی‌های امتحان‌شده در هر تلاش اتصال | 3 | | اولین / حداکثر استراحت پس از خرابی | 10 دقیقه / 6 ساعت | | چرخش برنامه‌ریزی‌شده | غیرفعال؛ در صورت خطا فعال شود | | حساب‌ها به ازای هر پروکسی | 0: ترجیحاً ورودی‌های جداگانه داشته باشید و در صورت نیاز آن‌ها را به اشتراک بگذارید. 1 را برای انتظار یک ورودی انحصاری تنظیم کنید. | | تاخیر قبل از بازگشت مستقیم مجاز | 10دقیقه؛ مخفی کردن آدرس هنوز امتناع می‌کند Direct | | تازهسازی فید / بررسی‌های انتقال | 60/10دقیقه؛ مقادیر فضای کاری اصلی برای استخر مشترک اعمال می‌شوند | پروکسی‌های مختلف، آدرس‌های خروجی متفاوتی را تضمین نمی‌کنند. این تنظیمات محدودیت‌های تلگرام را نادیده نمی‌گیرند و ناشناس بودن را اثبات نمی‌کنند. برای جایگزینی فهرست عمومی با کاتالوگ اپراتور خود، موارد زیر را برای بازنویسی پیکربندی کنید. این کار اشتراک‌های خارجی را به طور کامل غیرفعال می‌کند، حتی زمانی که آرایه `proxies` آن خالی باشد. [کاتالوگ خالی را](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proxies.config.example) به `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"} ]} ``` مقادیر نمونه باید جایگزین شوند. تا ۳۲ ورودی متمایز پذیرفته می‌شود. فهرست احرازشده برچسب‌ها/میزبان‌ها/پورت‌ها را بدون رمزهای مشترک بازمی‌گرداند؛ انتخاب یکی، اعتبارنامه‌های آن را در گاوصندوق فضای کاری ذخیره می‌کند. در دسترس بودن تا زمان انجام آزمون صریح انتقال، آزمایش‌نشده باقی می‌ماند. یک کاتالوگ معیوب، پیکربندی دستی را ممکن می‌سازد. راه‌اندازی بومی: مسیر JSON محلی را روی `TGWITNESS_PROXY_CATALOG` تنظیم کنید. داکر: ``` docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build ``` لایهٔ رویین، فایل‌های قابل خواندن تنها (`proxy-config`) را نصب می‌کند؛ فایل‌ها باید برای UID مخزن 10001 قابل خواندن باشند. آن دایرکتوری از Git، زمینهٔ ساخت Docker و آرشیوهای منبع حذف شده است. این کاتالوگ، حساب‌های جمع‌آوری‌کننده را پیکربندی می‌کند؛ [بات شاهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/) از مسیر HTTP/SOCKS5 خود استفاده می‌کند، نه MTProxy. راه برگشت مستقیم توسط حالت IP فوق کنترل می‌شود. قبل از تغییر مسیر، مشاهده را متوقف کنید. ذخیره کردن، کلاینت‌های قدیمی را قطع می‌کند و ورود ناکامل را لغو می‌کند؛ یک کلاینت جدید از مسیر ذخیره شده استفاده می‌کند. پیوند ژورنال/جلسه حساب کاربری باقی می‌ماند. تنظیمات، مسیر قبلی را جایگزین می‌کنند: هنگام ویرایش آن، اطلاعات پروکسی را دوباره وارد کنید. اطلاعات ورود به سیستم در `network.enc` رمزگذاری می‌شود. این API نام کاربری، رمز عبور یا کلمه عبور مخفی را بازنمی‌گرداند. رکوردهای امضا شده حاوی نوع مسیر و اینکه آیا اطلاعات ورود به سیستم موجود است یا خیر هستند، بدون در نظر گرفتن نقطه پایانی و کلمات مخفی. اپراتور می‌تواند نقطه پایانی را در پنل مشاهده کند. فیلدهای مخفی پس از ذخیره، قفل کردن یا تعویض فضاهای کاری پاک می‌شوند. **آزمایش اتصال تلگرام**، که پیش از ورود نیز در دسترس است، یک اتصال موقت و غیرمجاز تلگرام را از طریق مسیر باز و بسته می‌کند. این ابزار با هیچ وب‌سایت بررسی آی‌پی تماس نمی‌گیرد. موفقیت در این آزمایش، اتصال حمل‌ونقل را برقرار می‌کند، نه دسترسی به گروه، تحویل کامل پیام یا ناشناس‌بودن را. پراکسی بر روی اتصالات کلاینت تلگرام، از جمله دانلودهای رسانه‌ای DC تلگرام اعمال می‌شود. ابزارهای مرورگر، pip، SSH و TSA که به صورت دستی فراخوانی می‌شوند، مسیرهای جداگانه‌ای دارند. نام میزبان پراکسی ممکن است به صورت محلی حل شود. `rdns` بر روی نام‌های میزبان مقصد تأثیر می‌گذارد؛ تلگرام اغلب IPهای عددی DC را ارائه می‌دهد. پروتکل‌های SOCKS5 و HTTP CONNECT به خودی خود اعتبارنامه‌های پروکسی یا تونل ارتباطی بین کلاینت و پروکسی را رمزگذاری نمی‌کنند. MTProto ترافیک تلگرام را به طور جداگانه محافظت می‌کند. از یک کانال امن مناسب برای اتصال به پروکسی در یک شبکه ناامن استفاده کنید. گروه‌های خصوصی، چت‌های ابری هستند؛ MTProto آنها را به چت‌های مخفی رمزگذاری‌شده از سر تا سر تبدیل نمی‌کند. ## رمزنگاری و امضاها | لایه | پیاده‌سازی شد | مسئولیت اپراتور | | --- | --- | --- | | ترافیک تلگرام | تله‌تون MTProto | اعتماد پلتفرم، مسیر و در دسترس بودن | | پنل وب | توکن حامل، لوپ‌بک پیش‌فرض، محدودیت‌های درخواست | تونل HTTPS یا SSH برای دسترسی از راه دور | | رازها | فرنت برای اعتبارنامه‌های API، اعتبارنامه‌های جلسه، اعتبارنامه‌های پروکسی و کلید خصوصی امضا | از کلید رمزگشایی و میزبان در حال اجرا محافظت کنید | | کلید گاوصندوق | کلید محلی، یا کلید اصلی خارجی برای نصب جدید | جداسازی ذخیره‌سازی محافظت‌شده و پشتیبان‌گیری کلید | | پیام‌ها و پیوست‌ها | ذخیره‌سازی متن سادهٔ برنامه | دیسک/حجم رمزگذاری‌شده | | ZIP/JSONL/CSV/HTML | بررسی‌های یکپارچگی، عدم رمزنگاری محتوا | حفاظت از نسخه‌های صادرشده و انتقال‌ها | | منشأ و زمان | دفترچه ثبت امضا شده، رسید فرایند، ابزارهای RFC 3161 | کلید مورد اعتماد، نقاط بازرسی مستقل/TSA و رویهٔ نگهداری | **محافظت از ذخیره‌سازی** در حساب، این وضعیت‌ها را نشان می‌دهد. توکن پنل یک رمز دسترسی است، نه رمز عبور رمزگذاری. این توکن دسترسی ادمین را فراهم می‌کند؛ [توکن‌های صادرشده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/) می‌توانند به حساب‌ها و چت‌ها محدود شوند. فضاهای کاری، فرآیند میزبان را به اشتراک می‌گذارند و مستأجران ایزوله نیستند. BitLocker، LUKS، FileVault یا یک حجم رمزگذاری‌شده مدیریت‌شده می‌توانند از ذخیره‌سازی تحت مدل‌های تهدید مربوطه محافظت کنند. یک مدیر یک ماشین در حال اجرا که قفل نشده است، همچنان می‌تواند داده‌ها را بخواند. در برنامه‌ریزی ذخیره‌سازی، SQLite WAL/SHM، رسانه‌ها، خروجی‌های موقت، اسواپ، پشتیبان‌ها و دانلودهای مرورگر را نیز در نظر بگیرید. یک حجم داکر صرفاً به این دلیل که یک حجم است، رمزگذاری نمی‌شود. TgWitness، SQLCipher یا رمزگذاری اشیاء را پیاده‌سازی نمی‌کند. ## کلید اصلی خارجی برای یک نصب **جدید**، کلید اصلی را خارج از دایرکتوری داده قرار دهید. این کار به طور خودکار گاوصندوق کلید محلی موجود را مهاجرت نمی‌دهد. یک دایرکتوری کلید آماده کنید که فقط برای هویت سرویس قابل دسترسی باشد، سپس اجرا کنید: ``` 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 ``` در داکر، فایل را به صورت فقط-خواندنی در خارج از `/data`، برای مثال در `/run/secrets/tgwitness-master.key`، مونت کنید و متغیر محیط را روی آن مسیر تنظیم کنید. UID سرویس باید قادر به خواندن آن باشد. مسیر را، نه بایت‌های کلید، از طریق فایل‌های محیط/پیکربندی ارسال کنید. هر فضای کاری یک سالت عمومی تصادفی و کلید فرنت (Fernet) مخصوص به خود را که از طریق HKDF-SHA256 استخراج شده است، دریافت می‌کند. `vault.external.json`، متادیتای استخراج را ذخیره می‌کند، نه خود کلید اصلی را. در صورت گم شدن یا اشتباه بودن کلید، نرم‌افزار بدون جایگزینی بی‌سروصدا، از راه‌اندازی بازمی‌ماند. برای بازیابی، هم متادیتای سالت و هم کلید اصلی را حفظ کنید. تمام فضاهای کاری از یک کلید اصلی واحد مشتق می‌شوند؛ به خطر افتادن آن بر کل نصب تأثیر می‌گذارد. فرآیند در حال اجرا می‌تواند اسرار را رمزگشایی کند. این یک HSM یا KDF رمز عبور نیست. رمزهای عبور دلخواه انسانی به جای یک کلید تصادفی پذیرفته نمی‌شوند. کلید موجود را برای نصب‌های فعلی تا زمانی که یک مهاجرت عمدی پیاده‌سازی و تأیید شود، حفظ کنید. حذف `vault.key` یا جایگزینی یک کلید اصلی می‌تواند دسترسی به جلسات/کلیدهای امضا را از بین ببرد. پشتیبان‌های رمزگذاری‌شده و کلیدها را جداگانه نگه دارید و بازسازی را در یک محیط ایزوله آزمایش کنید. --- # Telegram · راه‌اندازی Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/deployment/ TgWitness را به‌عنوان یک سرویس روی ویندوز، لینوکس، macOS یا Docker اجرا کنید، پشت HTTPS، همراه با پشتیبان‌گیری و به‌روزرسانی‌ها. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) TgWitness را به‌عنوان یک سرویس روی ویندوز، لینوکس، macOS یا Docker اجرا کنید، پشت HTTPS، همراه با پشتیبان‌گیری و به‌روزرسانی‌ها. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/assets/chapter-operate.svg) **انگلیسی** · [روسی](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/DEPLOYMENT.md) · [اوکراینی](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/DEPLOYMENT.md) · [اسپانیایی](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/DEPLOYMENT.md) · [پرتغالی (برزیل)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/DEPLOYMENT.md) · [ترکی](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/DEPLOYMENT.md) · [عربی](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/DEPLOYMENT.md) · [فارسی](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/DEPLOYMENT.md) · [اردو](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/DEPLOYMENT.md) · [هندی](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/DEPLOYMENT.md) · [بهاسا اندونزی](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/DEPLOYMENT.md) · [تایلندی](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/DEPLOYMENT.md) · [فونت ساده‌شدهٔ چینی](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/DEPLOYMENT.md) ## انتخاب نصب برای بسته قابل حمل، فایل `TgWitness--windows-amd64-portable.zip` را از GitHub Releases استخراج کنید. برای سایر روش‌ها، فایل ZIP منبع را دانلود و استخراج کنید یا مخزن را کلون کنید، سپس دستور زیر را از دایرکتوری پروژه اجرا کنید: | نصب | شروع | آیا در پس‌زمینه اجرا می‌شود؟ | | --- | --- | --- | | بسته قابل حمل ویندوز | `TgWitness.cmd` | نه؛ پنجره را باز نگه دارید. | | بومی ویندوز | `Start.cmd` | خیر؛ از وظیفهٔ اختیاری لاگین برای استفاده در پس‌زمینه استفاده کنید. | | بومی لینوکس/macOS | `sh start.sh` | خیر؛ برای استفاده در پس‌زمینه از systemd/launchd استفاده کنید. | | داکر روی هر میزبان پشتیبانی‌شده | `docker compose up -d --build --wait` | بله، در حالی که دیمون Docker در حال اجراست. | | راهنمای داکر در ویندوز | `scripts\Docker.cmd` | بله؛ دستیار منتظر سلامت وب‌سرور می‌ماند. | | راهنمای داکر در لینوکس/macOS | `sh scripts/docker-start.sh` | بله؛ دستیار منتظر سلامت وب‌سرور می‌ماند. | برای یک سرور ابری که شخص ثالث باید بتواند آن را بررسی کند — ایجاد شده از طریق API ارائه‌دهنده، بدون SSH، و تنها از طریق تونل کلودفلر قابل دسترسی است — به [استقرار با تضمین بالا](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/) مراجعه کنید. راه‌اندازی بومی یک `.venv` خصوصی ایجاد می‌کند و وابستگی‌های پین‌شده را نصب می‌کند. داکر آن‌ها را داخل ایمیج می‌سازد، بدون اینکه به پایتون میزبان نیاز داشته باشد. راه‌اندازی اولیه نیاز به دسترسی به اینترنت دارد. هنگامی که هیچ Python 3.11+ یافت نشود، `Start.cmd` قبل از نصب Python 3.12 برای کاربر فعلی ویندوز (با استفاده از winget، در غیر این صورت با نصب‌کننده python.org پس از بررسی امضای بنیاد نرم‌افزار پایتون) سؤال می‌کند؛ این ابزار هرگز درخواست امتیازات ادمین نمی‌کند. Docker و سرویس‌های سیستم‌عامل همچنان از پیش‌نیازها هستند. نصب‌های بومی و قابل حمل از `data/live` در داخل پوشه خود استفاده می‌کنند. داکر از حجمی به نام `tgwitness-data` در `/data` استفاده می‌کند. این‌ها نصب‌های جداگانه‌ای هستند تا زمانی که شما عمداً دایرکتوری کامل داده را مهاجرت ندهید. انتظار نداشته باشید که یک کانتینر داکر جدید به طور خودکار حساب‌های بومی را کشف کند. ## نیازمندی‌های نصب نصب بومی به پایتون ۳.۱۱ یا جدیدتر با `venv` و `ensurepip`، دسترسی به اینترنت برای نصب اولین وابستگی، و یک دایرکتوری پروژه قابل نوشتن برای `.venv` نیاز دارد. پنل همراه نیازی به Node.js یا ساخت فرانت‌اند ندارد. لانچر را از حساب کاربری معمولی سیستم‌عامل خود اجرا کنید؛ TgWitness به امتیازات ادمین/روت نیاز ندارد. - **ویندوز:** `Start.cmd`، `py -3`، سپس `python` و سپس پوشه‌های نصب پیش‌فرض هر کاربر و Program Files را بررسی می‌کند و به نسخه ۳.۱۱ یا جدیدتر نیاز دارد. اگر هیچ‌کدام کار نکند، نصب خودکار بر اساس کاربر را که در بالا توضیح داده شد، ارائه می‌دهد. `py -3 start.py` نیز کار می‌کند. بسته قابل حمل به هیچ وجه به پایتون نیاز ندارد. - **لینوکس:** `start.sh` را امتحان می‌کند `python3.13`, `python3.12`, `python3.11`, `python3` و `python`, و زمانی که هیچ‌کدام مناسب نباشد، دستور نصب برای apt, dnf, pacman, zypper, apk یا Homebrew را چاپ می‌کند. نصب در دبیان/اوبونتو ممکن است به بسته `python3-venv` متناسب با تفسیرگر انتخاب‌شده نیاز داشته باشد. پایتون پیش‌فرض قدیمی‌تر توزیع باید با پایتون ۳.۱۱+ جایگزین یا تکمیل شود. - **macOS:** یک توزیعٔ جاریٔ Python 3.11+ را نصب کنید؛ فرض نکنید که یک مفسر ارائه‌شده توسط سیستم‌عامل این نیاز را برآورده می‌کند. از `python3 start.py` در دایرکتوری پروژه استفاده کنید. - **داکر:** از Docker Engine/Desktop با Compose نسخه 2.20 یا جدیدتر استفاده کنید. Docker Desktop باید از کانتینرهای لینوکس روی ویندوز استفاده کند. کانتینر وابستگی‌های پایتون خود را نصب می‌کند؛ میزبان نیازی به نصب جداگانه پایتون ندارد. ## کامپیوتر محلی از `Start.cmd` در ویندوز یا `sh start.sh` در لینوکس/مک‌او‌اس استفاده کنید. `scripts\Setup.cmd` یا `sh start.sh --setup-only` محیط را آماده می‌کند. لانچر در اولین استفاده وابستگی‌ها را نصب می‌کند؛ راه‌اندازی‌های بعدی از محیط موجود استفاده مجدد می‌کنند. برای راه‌اندازی و جمع‌آوری تلگرام به دسترسی به اینترنت نیاز است، اما مرور سوابق موجود و ایجاد خروجی‌ها به صورت آفلاین انجام می‌شود. پس از راه‌اندازی، دستور `python start.py --check` را اجرا کنید تا وابستگی‌های محلی، Ed25519، ذخیره‌سازی، پیکربندی کلید و آدرس گوش‌دادن را بدون راه‌اندازی یک گردآورنده بررسی کنید. برای خروجی ساختاریافته از `--json` استفاده کنید. پارامترهای مورد نظر `--data-dir`، `--host` و `--port` را ارسال کنید. این بررسی، بسته‌ها را نصب، دفترچه یادداشتی ایجاد یا تلگرام را متصل نمی‌کند؛ این یک گواهی یکپارچگی یا پوشش نیست. دستور شروع به صورت جداگانه دفترچه‌های یادداشت موجود را تأیید می‌کند. `python start.py --help` نیز از نصب جلوگیری می‌کند. پس از استفاده از start.py، دستورات کمکی را با `.venv\Scripts\python.exe` در ویندوز یا `.venv/bin/python` در لینوکس/macOS اجرا کنید، یا ابتدا آن محیط را فعال نمایید. مثال‌های `python -m ...` در زیر بر این فرض استوارند که محیط فعال است. ``` python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787 ``` متغیرهای محیطی: TGWITNESS_DATA, TGWITNESS_HOST, TGWITNESS_PORT, TGWITNESS_TOKEN. TGWITNESS_VAULT_KEY_FILE حالت کلید خارجی را برای نصب جدید انتخاب می‌کند؛ به توضیحات زیر مراجعه کنید. TGWITNESS_TOKEN، در صورت ارائه، باید حاوی حداقل ۲۴ کاراکتر باشد؛ از یک مقدار تصادفی و رمزنگاری‌شده استفاده کنید. بدون آن، برنامه یک توکن تصادفی ۲۵۶ بیتی در فایل panel-token.txt ایجاد می‌کند. نابودی محیطی آن فایل را بازنویسی نمی‌کند. برای چرخاندن اعتبارنامه‌ها، برنامه را مجدداً راه‌اندازی کنید. دقیقاً یک فرآیند می‌تواند مالک یک دایرکتوری داده باشد. یک قفل فایل سیستم‌عاملی چندسکویی از نوشتار همزمان تصادفی جلوگیری می‌کند. از یک کارگر Uvicorn استفاده کنید. پنل می‌تواند هر تعداد فضای کاری را مدیریت کند، با دایرکتوری‌های فضای کاری اضافی در زیر profiles//. برای نمونه‌های مجزای سرویس، از دایرکتوری‌ها و پورت‌های مجزا استفاده کنید. فایل‌های WAL در SQLite باید در حافظه دائمی محلی ذخیره شوند، نه در یک سیستم فایل شبکه‌ای. یک حجم را بین نسخه‌ها (replicas) مشترک نکنید. ## بسته قابل حمل ویندوز هر نسخه گیت‌هاب حاوی `TgWitness--windows-amd64-portable.zip` و `.sha256` آن است. این نسخه شامل محیط اجرایی رسمی و قابل جاسازی پایتون ۳.۱۲ از python.org (با چک‌سام ثابت‌شده در `tools/build_portable.py`)، TgWitness و وابستگی‌های ثابت‌شده آن، و سه لانچر است: | فایل | هدف | | --- | --- | | `TgWitness.cmd` | پنل را راه‌اندازی کنید؛ گزینه‌های اضافی ارسال می‌شوند، مثلاً `TgWitness.cmd --port 8790` | | `TgWitness-Demo.cmd` | دموی مصنوعی را در `data\demo` آغاز کنید | | `TgWitness-Check.cmd` | بدون راه‌اندازی، بررسی آمادگی را اجرا کنید | واژه‌نامه مورفولوژی روسی سنجاق‌شده و پروفایل‌های رنگی PDF برای استفاده آفلاین بسته‌بندی شده‌اند. بسته‌بندی تنها مسیرهای فایل شناخته‌شده آن‌ها را در دایرکتوری‌های وابستگی `data` مجاز می‌داند؛ فایل‌های غیرمنتظره در آن دایرکتوری‌ها باعث شکست ساخت می‌شوند. کل آرشیو را در یک پوشه قابل نوشتن مانند `Documents\TgWitness` استخراج کنید؛ آن را از داخل فایل ZIP یا پوشه Program Files اجرا نکنید. محیط اجرای برنامه از یک مسیر ماژول ایزوله استفاده می‌کند، بنابراین نصب‌های دیگر پایتون و `PYTHONPATH` بر آن تأثیری ندارند. داده‌ها در پوشه `data` این بسته باقی می‌مانند. برای به‌روزرسانی، TgWitness را متوقف کنید، نسخه جدید را در یک پوشه جدید استخراج کرده و پوشه `data` را کپی کنید. خودتان آن را روی ویندوز ۶۴ بیتی با پایتون ۳.۱۲ بسازید: ``` python tools/build_portable.py ``` ## کانتینر ``` docker compose up -d --build --wait ``` این کار یک حجم دائمی با نام برای /data ایجاد می‌کند. پورت وب به 127.0.0.1:8787 نگاشت شده است. این فرآیند با UID 10001 و با قابلیت‌های محدودشده، یک سیستم فایل ریشه فقط-خواندنی، و دایرکتوری‌های قابل نوشتن /data و /tmp اجرا می‌شود. `--wait` قبل از بازگشت، سلامت وب‌سرور را بررسی می‌کند؛ این ابزار هیچ‌گونه تأیید اعتبار یا تحویل پیام تلگرام را انجام نمی‌دهد. کمک‌کننده‌های ارائه‌شده پس از ساخت، از یک تایم‌اوت آمادگی ۱۸۰ ثانیه‌ای استفاده می‌کنند. دانلودهای وابستگی اولیه ممکن است بیشتر از این زمان طول بکشد. هر دو فایل پایه Compose از نام پروژه `tgwitness` استفاده می‌کنند، بنابراین استخراج یک نسخه جدید در یک دایرکتوری دیگر، به‌طور پنهان یک حجم داده جدید را انتخاب نمی‌کند. تنها یک استقرار را برای آن پروژه فعال نگه دارید. برای نصب‌های مستقل، از یک `docker compose -p NAME ...` منحصربه‌فرد و یک پورت میزبان متفاوت استفاده کنید و هر دو را در به‌روزرسانی‌ها حفظ کنید. برای یک استقرار قدیمی‌تر که از نام پروژه متفاوتی استفاده می‌کند، به استفاده از نام اصلی آن با `-p` ادامه دهید؛ `docker compose ls` پروژه‌های موجود را فهرست می‌کند. مقدار `deploy/env.example` را به `.env` کپی کرده و `TGWITNESS_PORT` را برای استفاده از یک پورت لوپ‌بک متفاوت تغییر دهید. به عنوان مثال، `TGWITNESS_PORT=8788` پنل را در `http://127.0.0.1:8788` در دسترس قرار می‌دهد؛ کانتینر همچنان در پورت 8787 در حال گوش دادن است. `.env` توسط گیت (Git) نادیده گرفته می‌شود. بازیابی توکن اولیه: ``` docker compose exec tgwitness cat /data/panel-token.txt ``` دستورهای مفید: ``` docker compose ps docker compose logs --tail 100 -f docker compose stop docker compose up -d --wait ``` `restart: unless-stopped` پس از از کار افتادن یا راه‌اندازی مجدد Docker daemon، گردآورنده را مجدداً راه‌اندازی می‌کند. در یک سرور لینوکس، Docker را با استفاده از مدیر سرویس توزیع خود، که معمولاً `sudo systemctl enable --now docker` است، در هنگام بوت فعال کنید. در ویندوز/macOS، گزینه «شروع به محض ورود» (start-at-sign-in) در Docker Desktop را فعال کنید. خروج از حساب کاربری دسکتاپ، حالت خواب، یا یک وضعیت متوقف‌شده دمون داکر می‌تواند فرآیند جمع‌آوری را قطع کند. یک کانتینر که به صراحت متوقف شده باشد، تا زمانی که آن را دوباره راه‌اندازی نکنید، متوقف باقی می‌ماند. حجم /tmp در پیکربندی نمونه به ۵۱۲ مگابایت محدود شده است. ساخت خروجی به جای آن از فضای `temporary-exports/` هر workspace روی /data دائمی استفاده می‌کند. فضایی را در آنجا برای خروجی‌های همزمان، رشد ژورنال/WAL، رسانه‌ها و پشتیبان‌ها رزرو کنید. راه‌انداز از deploy/constraints.txt برای ثابت کردن نسخه‌های وابستگی زمان اجرا استفاده می‌کند. داکر و سرورهای با تضمین بالا از روی deploy/requirements.lock و deploy/build.lock با pip --require-hashes نصب می‌شوند: هر فایل پکیج باید با یک رکورد SHA-256 که در کامیت ثبت شده مطابقت داشته باشد، بنابراین جایگزینی یک فایل در PyPI یا یک آینه‌ی دیگر رد می‌شود. تصویر پایه پایتون و بسته‌های سیستم‌عامل همچنان به تأیید مستقل نسخه نیاز دارند. از دستور docker compose down -v استفاده نکنید، مگر اینکه قصد دارید دفترچه شواهد و کلیدها را نابود کنید. گزارش وضعیت کانتینر، در دسترس بودن وب‌سرور را نشان می‌دهد، نه ضبط موفقیت‌آمیز تلگرام. وضعیت کالکتور پنل، ضربان قلب، خطاها و رویدادهای پوشش را بررسی کنید. ### پروفایل شاهد مستقل سرویس اختیاری `witness` یک [شاهد مستقل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/)را در کانتینر خود، با کلید و دفترچه خود در حجم `witness-data` اجرا می‌کند و فقط یک توکن شاهد فقط-خواندنی برای گردآورنده فراهم می‌آورد. توکن را در صفحه **Witness** پنل ایجاد کنید، آن را با یک توکن بات و کانال به `.env` اضافه کنید، سپس پروفایل را راه‌اندازی کنید: ``` docker compose --profile witness up -d # deploy/compose/compose.image.yaml: same flag docker compose logs witness # witness key fingerprint ``` این سرویس به کالکتور داخل شبکه Compose در آدرس `http://tgwitness:8787` دسترسی پیدا می‌کند (برای مثال، `TGWITNESS_WITNESS_COLLECTOR` بر آن اولویت دارد و `/profiles/` برای یک فضای کاری دیگر). برای یک شاهد روی سرور جداگانه که توسط شخص دیگری اجرا می‌شود، از `deploy/compose/compose.witness.yaml` در آنجا استفاده کنید و `TGWITNESS_WITNESS_COLLECTOR` را روی آدرس HTTPS کالکتور تنظیم کنید؛ آن فایل فقط شامل شاهد است. ## نصب یک تصویر منتشرشده محتویات `deploy/env.example` را به `.env` کپی کنید. `TGWITNESS_IMAGE` را با استفاده از نسخه منتشرشده و مسیر مخزن **با حروف کوچک** تنظیم کنید، برای مثال: ``` TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.1 TGWITNESS_PORT=8787 ``` این فایل را به‌تنهایی اجرا کنید، به‌جای `compose.yaml`: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt ``` نیازی به نصب سورس، پایتون یا کامپایلر روی میزبان نیست. گردش کار انتشار، کانتینرهای لینوکس AMD64 و ARM64، از جمله ماشین مجازی لینوکس Docker Desktop را هدف قرار می‌دهد. از یک تگ نسخه یا `ghcr.io/owner/repository@sha256:...` از خلاصه گردش کار استفاده کنید. هیچ تگ متحرک `latest` یا ارتقای خودکار برنامه پیکربندی نشده است. نسخه‌های image و source هنگامی که نام پروژه آنها یکسان باشد، از همان حجم داده استفاده می‌کنند. ## HTTPS خودکار روی یک سرور از یک سرور با داکر، دامنه‌ای که شما کنترل می‌کنید، و ذخیره‌سازی محلی پایدار استفاده کنید. رکوردهای A/AAAA دامنه را به سمت سرور نشانه بروید؛ AAAA را فقط در صورتی که IPv6 به آن برسد، منتشر کنید. دسترسی ورودی TCP 80 و 443 و خروجی DNS/HTTPS را برای صدور گواهی‌نامه مجاز کنید. سایر سرویس‌ها نباید از قبل این پورت‌ها را اشغال کرده باشند. مقدار `deploy/env.example` را به `.env` کپی کرده و یک نام میزبان بدون طرح یا مسیر تنظیم کنید: ``` TGWITNESS_DOMAIN=watch.your-domain.org ``` ساخت سورس را با لایه HTTPS آغاز کنید: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt ``` ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait ``` برای یک تصویر منتشرشده، به جای آن از `deploy/compose/compose.image.yaml` به عنوان اولین فایل استفاده کنید. هر دو آرگومان `-f` را برای دستورات وضعیت، لاگ، به‌روزرسانی و توقف بعدی نگه دارید. کدی گواهی‌نامه را دریافت و تمدید می‌کند، HTTP را به HTTPS هدایت مجدد می‌کند و درخواست‌ها را به جمع‌آورنده در شبکه خصوصی Compose فوروارد می‌کند. وضعیت گواهی‌نامه دارای حجم پایدار خود است. پورت میزبان مستقیم جمع‌آورنده فقط برای لوپ‌بک باقی می‌ماند. پیکربندی ارائه‌شده کدی، ثبت دسترسی را فعال نمی‌کند. `https://watch.your-domain.org` را باز کنید و توکن پنل را وارد کنید. آمادگی برای اتصال تأیید صدور گواهی‌نامه یا دسترسی خارجی را تضمین نمی‌کند. اگر HTTPS آماده نیست، DNS، قوانین فایروال و موارد زیر را بررسی کنید: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy ``` تصویر Caddy ارائه‌شده با تگ `2-alpine` خود دنبال می‌شود. فراخوانی (Pull) آن تصویر را تازه می‌کند؛ اگر به نسخه‌های ثابت زیرساخت نیاز دارید، یک هش آزمایش‌شده را در استقرار خود پین کنید. ## به‌روزرسانی‌ها و پشتیبان‌گیری‌ها حفظ نام پروژه Compose و حجم داده‌ها در طول به‌روزرسانی‌ها. ابتدا گردآورنده را متوقف کرده و یک نسخه پشتیبان کامل تهیه کنید. برای استقرار پیش‌فرض مبتنی بر منبع: ``` docker compose stop docker compose cp tgwitness:/data ../tgwitness-backup-before-update ``` هر بار از یک مقصد پشتیبان جدید، خارج از مخزن، استفاده کنید و آن را به عنوان ماده قابل دسترسی با حساب کاربری محافظت کنید. مسیر مثال صرفاً جهت نمایش است؛ از مکان پشتیبان خصوصی خود استفاده کنید. کل دایرکتوری، از جمله فایل‌های پنهان، تمام فضاهای کاری، کلیدها، ژورنال‌ها و رسانه‌ها را کپی کنید. در صورت پیکربندی، کلید اصلی گاوصندوق خارجی را به طور جداگانه پشتیبان‌گیری کنید. یک فایل ZIP مدرک، یک نسخه پشتیبان قابل بازیابی از برنامه نیست. برای HTTPS، همچنین در صورتی که نیاز به حفظ وضعیت گواهی/حساب دارید، حجم‌های Caddy را نیز حفظ کنید. برای استقرار در محیط تولید، فایل‌های نسخه جدید را تهیه کرده و اجرا کنید: ``` docker compose up -d --build --wait ``` برای استقرار با استفاده از image، `TGWITNESS_IMAGE` را به نسخهٔ دلخواه تغییر دهید، سپس اجرا کنید: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait ``` برای فرمان‌های توقف/کپی بالا نیز از فایل(های) Compose نصب خود استفاده کنید. فایل `.env`، تنظیمات سفارشی و همان نام پروژه را حفظ کنید. فرمان `down` ولوم‌های نام‌گذاری‌شده را نگه می‌دارد؛ **`down -v` آن‌ها را حذف می‌کند**. پوشهٔ `.venv` را بین سیستم‌عامل‌ها یا نسخه‌های پایتون کپی نکنید. برای به‌روزرسانی نصب مستقیم، TgWitness را متوقف کنید، از تمام پوشهٔ دادهٔ آن نسخهٔ پشتیبان بگیرید، فایل‌های کد منبع را جایگزین کنید و پیش از اجرا فرمان `python start.py --setup-only` را اجرا کنید. دسترسی پنل، هویت حساب، وضعیت مشاهده و پوشش را پس از یک به‌روزرسانی بررسی کنید. راه‌اندازی مجدد، به‌روزرسانی‌های از دست رفته تلگرام را بازسازی نمی‌کند. در صورتی که یک نسخه آینده فرمت‌های ذخیره‌سازی را تغییر دهد، بازگشت به نسخه قبلی ممکن است به نسخه پشتیبان پیش از به‌روزرسانی نیاز داشته باشد. ## سرور از راه دور سرویس را محدود به لوپ‌بک نگه دارید و از تونل SSH استفاده کنید، یا HTTPS را در یک پروکسی معکوس پایان دهید. فایل پایه Compose فقط برای استفاده محلی است؛ لایه اختیاری `deploy/compose/compose.https.yaml`، Caddy را برای یک دامنه پیکربندی‌شده فراهم می‌کند. توکن حامل را از URLها و لاگ‌های پروکسی دور نگه دارید. یک پروکسی معکوس باید اندازه درخواست و نرخ اتصال را محدود کند. HTTP ساده را در معرض اینترنت قرار ندهید. نمونه‌هایی برای systemd، یک وظیفه ورود به سیستم ویندوز، یک عامل کاربری macOS و Caddy در [پوشه deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) ارائه شده‌اند. مسیرهای آن‌ها را قبل از نصب بررسی/تطبیق دهید. آن‌ها قالب‌هایی هستند که ارائه شده‌اند، نه واجد شرایط بودن پلتفرم که به صورت محلی اجرا شوند. هیچ سرویس یا وظیفه پس‌زمینه‌ای توسط راه‌انداز عادی ثبت نمی‌شود. در ویندوز، اجرای بدون پنجره `pythonw.exe`، تشخیص‌های راه‌اندازی/سرور را در `logs/server.log` زیر دایرکتوری داده (۵ مگابایت برای هر فایل، دو نسخه پشتیبان چرخشی) ذخیره می‌کند. اجرای کنسول، ثبت کنسول را حفظ می‌کند. ثبت دسترسی HTTP در هر دو حالت غیرفعال است. لاگ‌ها را با دایرکتوری داده محافظت کرده و قبل از اشتراک‌گذاری آنها را بررسی کنید. ## راه‌اندازی مجدد و فواصل آخرین وضعیت مشاهده‌ی درخواستی حفظ می‌شود. اگر مشاهده فعال بود، راه‌اندازی مجدد تلاش می‌کند تا منابع انتخاب‌شده را دوباره متصل کرده و از سر بگیرد. توقف دستی آن نیت را لغو می‌کند. یک راه‌اندازی مجدد ناموفق ثبت شده و در پنل نمایش داده می‌شود. StringSession مجوز را حفظ می‌کند اما وضعیت پایدار به‌روزرسانی/واحد تل‌هون را نه. دیالوگ‌ها در هنگام راه‌اندازی مجدد بارگذاری می‌شوند. تلگرام/تل‌هون می‌تواند برخی از وقفه‌های ارتباطی را در حین اجرا بازیابی کند، اما TgWitness ادعای بازپخش پایدار در سراسر راه‌اندازی مجدد فرآیندها را ندارد. هر بار راه‌اندازی، سرآیند ژورنال قبلی و مرز آفلاین را ثبت می‌کند. نظارتگر هر ۱۰ ثانیه اتصال را بررسی می‌کند و هر دقیقه یک تپش قلب اضافه می‌کند (**پارامترها → رکورد زنده بودن هر بار**). وقفه های کوتاه ممکن است از دست بروند؛ یک انتقال متصل، تحویل کامل به‌روزرسانی را تضمین نمی‌کند. اسنپ‌شات‌ها مشاهدات صریح تاریخچه فعلی هستند، نه ترمیم شکاف. صف رسانه در پایگاه داده SQLite هر فضای کاری ذخیره می‌شود. یک پیام و کار آن به‌صورت اتمیک ثبت می‌شوند. کارهای در حال اجرا که متوقف شده‌اند، در شروع مجدد برای تلاش دوباره بازیابی می‌شوند. هر دانلود دارای یک زمان انتظار پایه ۱۲۰ ثانیه‌ای به علاوه زمان لازم با سرعت ۲۵۶ کیلوبایت بر ثانیه برای اندازه‌اش، و یک محدودیت ۱ تا ۲۰۰۰ مگابایت برای هر نوع پیوست است؛ زمان انتظار، سرعت و تلاش‌های مجدد در **بخش پارامترها** قرار دارند. گردآورنده فایل‌هایی را که اندازه‌شان نامشخص است نادیده می‌گیرد. توقف، کارهای صف‌شده را حفظ می‌کند. امکان تکرار دانلود از توصیف‌گر فایل مشاهده‌شده اصلی استفاده می‌کند، نه از آخرین نسخه یک پیام که بعداً ویرایش شده است. خطاهای موقت دارای تعداد تکرار محدودی هستند؛ توقف حالت FloodWait رسانه‌ای پس از راه‌اندازی مجدد نیز ادامه می‌یابد. بازیابی رسانه از بازیابی به‌روزرسانی تلگرام جداست و نمی‌تواند فایل‌های ناپدیدشده را بازسازی کند. ## پشتیبان‌گیری، بازیابی و ظرفیت فرآیند را قبل از کپی کردن **کل دایرکتوری داده**، شامل vault.key، signing.enc، credentials.enc، فایل‌های پایگاه داده/WAL SQLite، رسانه، توکن، نقاط کنترل، و تمام پروفایل‌ها/زیرپوشه‌ها متوقف کنید. نسخه کامل را در حالی که سرویس مقصد متوقف شده است، بازیابی کنید. کلیدهای گنجینه (vault keys) گم‌شده یا عدم تطابق کلید امضا (signing-key) باعث عدم راه‌اندازی می‌شود؛ برای دسترسی اجباری، کلیدها را دوباره تولید نکنید. نسخه‌های پشتیبان مخفی را رمزگذاری‌شده و با کنترل دسترسی نگه دارید. فایل‌های فشرده مدرک قابل حمل هستند؛ بر روی آثار بررسی کنید، نه نسخه‌های پشتیبان اپلیکیشن یا نسخه‌های پشتیبان جلسه تلگرام. هیچ حذف خودکار مبتنی بر نگهداری وجود ندارد. فضای دیسک را برای تمام پیام‌ها، متادیتای خام، رسانه‌ها، خروجی‌های موقت و نسخه‌های پشتیبان برنامه‌ریزی کنید. تأیید راه‌اندازی و خروجی گرفتن سوابق جریان به جای بارگذاری کل دفترچه. یک خروجی، یک نمای کلی خواندنی را ثابت می‌کند در حالی که نوشته‌های جدید WAL می‌توانند ادامه یابند؛ خروجی‌های طولانی‌مدت می‌توانند صفحات WAL را حفظ کنند، بنابراین ظرفیت دیسک همچنان اهمیت دارد. فایل‌های ZIP به ۴ گیگابایت بدون فشرده‌سازی محدود می‌شوند تا با پیش‌فرض اعتبارسنج مستقل مطابقت داشته باشند؛ **پارامترها → بزرگترین ZIP امضا شده** محدودیت را افزایش می‌دهد، و چنین آرشیوهایی با `verify.py --max-gib N` تأیید می‌شوند. سایر فرمت‌ها محدودیت تعداد رویداد ندارند. مرورگرهای پشتیبانی‌شده، بلوک‌های پاسخ را به فایلی که کاربر انتخاب کرده است، استریم می‌کنند. سایر مرورگرها حداکثر ۱۲۸ مگابایت (MiB) را در بافر نگه می‌دارند و انتقال‌های بزرگتر را به CLI احراز هویت‌شده هدایت می‌کنند: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` برای یک فضای کاری دیگر از `--profile ID` در **بخش «صادرات → شناسه فضای کاری» (Exports → Workspace ID)**، برای یک سرور راه دور از `--format zip|jsonl|csv|html`، `--url https://your-server`، یا برای تغییر محدودیت انتقال ۵ گیگابایتی از `--max-mib` استفاده کنید. HTTP ساده فقط برای لوپ‌بک مجاز است. توکن‌ها در هدرها جابجا می‌شوند، هدایت‌ها (redirects) رد می‌شوند، فایل‌های موجود بازنویسی نمی‌شوند و دانلودهای ناقص به عنوان فایل‌های کامل منتشر نمی‌شوند. اگر TGWITNESS_TOKEN توکن تولید شده را بازنویسی کند، از یک فایل جداگانه محافظت‌شده که حاوی آن مقدار فعال است استفاده کنید: panel-token.txt توسط این بازنویسی دوباره نوشته نمی‌شود. SHA-256 دستور فقط یک چک‌سام انتقال است؛ فایل ZIP امضا شده را به طور مستقل تأیید کنید. پنل، رسانه‌های صف‌شده/ناموفق، قدیمی‌ترین رسانه در انتظار، فضای آزاد دیسک، مکث‌های درخواست تلگرام و منابعی را که دسترسی‌شان تأیید نشده است، نمایش می‌دهد. این تشخیص‌ها یک مانیتور تحویل کامل از ابتدا تا انتها نیستند. فضاهای کاری یک فرآیند را به اشتراک می‌گذارند؛ یک حساب پر سر و صدا همچنان می‌تواند بر دیگران تأثیر بگذارد. فرآیندهای کارگر جداگانه، نگهداری/گردش، بازیابی به‌روزرسانی پایدار و صلاحیت کامل استقرار همچنان باقی می‌مانند. دسترسی محدود به پنل در [بخش دسترسی و مجوزها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/) مستندسازی شده است؛ نقاط کنترل مستقل در [راهنمای شاهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/) پوشش داده شده‌اند. روندهای دقیق: [اتصال/امنیت](https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/) و [حالت‌های عملیاتی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/). --- # Phala / Intel TDX · استقرار با تضمین بالا Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/ یک سرور مهر و موم‌شدهٔ ۲۴ ساعته و ۷ روز هفته در Hetzner یا Phala Cloud، DNS Gateway و چک‌هایی که شخص ثالث می‌تواند تکرار کند. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) Translation coverage: this edition includes material from the English original. یک سرور مهر و موم‌شدهٔ ۲۴ ساعته و ۷ روز هفته در Hetzner یا Phala Cloud، DNS Gateway و چک‌هایی که شخص ثالث می‌تواند تکرار کند. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/deployment/) ![راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/assets/chapter-operate.svg) استقرار با تضمین بالا، بررسی‌های مستقل محیط جمع‌آوری را به تأیید بایگانی اضافه می‌کند. بازبین، سوابق استقرار و دسترسی را که توسط ارائه‌دهنده ابری و کلودفلر نگهداری می‌شوند، استعلام می‌کند و استقرار Intel TDX، گواهی سخت‌افزاری محیط گردآورنده را اضافه می‌کند. استفادهٔ معمولی محلی و Docker بدون تغییر است. هیچ چیزی در اینجا اجرا نمی‌شود مگر اینکه با `python -m tgwitness.cloud`، و کالکتور تنها زمانی میزبان خود را می‌خواند که استقرار تنظیم کند. `TGWITNESS_ASSURANCE`. نمودار جریان · اپراتور → سرور، فایروال بدون قواعد ورودی (API ارائه‌دهنده); اپراتور → تونل و DNS (API کلودفلر); سرور، فایروال بدون قواعد ورودی → تونل و DNS (فقط خروجی); سرور، فایروال بدون قواعد ورودی → کلید امضا روی سرور ایجاد شده است; تأییدکننده، توکن‌های فقط-خواندنی → لاگ ارائه‌دهنده و فایروال; تأییدکننده، توکن‌های فقط-خواندنی → آدرس کانکتور تونل و ورودی; تأییدکننده، توکن‌های فقط-خواندنی → بیانیه تضمین امضا شده /api/; تأییدکننده، توکن‌های فقط-خواندنی → فایل فشرده شواهد · اپراتور · تأییدکننده، توکن‌هایفقط-خواندنی · سرور، فایروال بدون قواعدورودی · لاگ ارائه‌دهنده و فایروال · آدرس کانکتور تونل و ورودی · بیانیه تضمین امضا شده/api/ · فایل فشرده شواهد · تونل و DNS · کلید امضا روی سرور ایجادشده است · API ارائه‌دهنده · API کلودفلر · فقط خروجی **نمودار به صورت متن** 1. اپراتور → سرور، فایروال بدون قواعد ورودی (API ارائه‌دهنده) 2. اپراتور → تونل و DNS (API کلودفلر) 3. سرور، فایروال بدون قواعد ورودی → تونل و DNS (فقط خروجی) 4. سرور، فایروال بدون قواعد ورودی → کلید امضا روی سرور ایجاد شده است 5. تأییدکننده، توکن‌های فقط-خواندنی → لاگ ارائه‌دهنده و فایروال 6. تأییدکننده، توکن‌های فقط-خواندنی → آدرس کانکتور تونل و ورودی 7. تأییدکننده، توکن‌های فقط-خواندنی → بیانیه تضمین امضا شده /api/ 8. تأییدکننده، توکن‌های فقط-خواندنی → فایل فشرده شواهد **در این صفحه** - [آنچه یک اعتبارسنج می‌تواند بررسی کند](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#what-a-verifier-can-check) - [ارائه‌دهندگان](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#providers) - [ماشین مجازی محرمانه در Phala Cloud (Intel TDX)](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) - [قبل از شروع](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#before-you-start) - [از پنل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#from-the-panel) - [تونل سریع بدون دامنه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#quick-tunnel-without-a-domain) - [راه‌اندازی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#deploy) - [عیب‌یابی استقرار و قفل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#debug-deployment-and-lock) - [حذف یک استقرار](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#remove-a-deployment) - [هر سرور (خودگواهی‌شده)](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#any-server-self-attested) - [تأیید کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#verify) - [گزارش تحویل مدرک](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#report-for-evidence-handover) - [کلودفلر به‌عنوان شاهد بیرونی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#cloudflare-as-an-outside-witness) - [خواندن نتیجه استقرار](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#reading-the-deployment-result) ## آنچه یک راستی‌آزما می‌تواند بررسی کند | ادعا | چگونه بررسی می‌شود | نگه‌داری‌شده توسط | | --- | --- | --- | | سرور در زمان مشخصی از طریق API ارائه‌دهنده ایجاد شد. | شیء سرور و ایجاد آن در لاگ اختصاصی ارائه‌دهنده | ارائه‌دهنده | | هیچ‌کس از مسیرهای دسترسی ارائه‌دهنده استفاده نکرد | گزارش درخواست‌های کنسول، بازیابی، بازنشانی رمز عبور، بازسازی، ISO، تصاویر، پشتیبان‌ها | ارائه‌دهنده | | هیچ چیزی نمی‌تواند به آن متصل شود | فایروال ارائه‌دهنده هیچ قاعده ورودی ندارد؛ SSH از اولین راه‌اندازی پنهان می‌شود. | ارائه‌دهنده (فایروال)، میزبان (SSH) | | به پنل تنها از طریق تونل دسترسی پیدا می‌شود | ورودی تونل تنها به پنل فوروارد می‌شود؛ کانکتور از آدرس سرور اجرا می‌شود | کلودفلر | | این نرم‌افزار دقیقاً اجرا می‌شود | هَش امضا‌شدهٔ درخت منبع گردآورنده برابر با خروجی یک چک‌آوت از کامیت مستقرشده است. | کالکِتور، بررسی‌شده در برابر گیت | | کلید امضا روی آن سرور ایجاد شد | کلید بیانیه‌ای را امضا می‌کند که شامل شناسهٔ سرور ارائه‌دهنده و هش cloud-init دریافتی است. | کالکتور، بررسی‌شده در برابر ارائه‌دهنده | | این مجله متعلق به آن کلید و سرور است | هر فرایند در شواهد آغاز می‌شود ZIP اندازه‌گیری میزبان را برای آن سرور حمل می‌کند | شواهد ZIP | جمع‌آورنده وضعیت SSH، جلسات، تاریخچه ورود و اطلاعات بوت را در رکوردهای امضا شدهٔ شروع-فرآیند و `host.state` ثبت می‌کند. در یک ماشین مجازی معمولی، این‌ها رکوردهای موجودی محلی هستند که بازبین آن‌ها را با رکوردهای مستقل ارائه‌دهنده مقایسه می‌کند. استقرار Intel TDX در زیر، به‌طور اضافی اندازه‌گیری‌های پشتیبانی‌شده توسط سخت‌افزار را تأیید می‌کند. ## ارائه‌دهندگان | `--provider` | اطلاعات احراز هویت | دسترسی فقط-خواندن Verifier | لاگ ارائه‌دهنده برای اعتبارسنج | نگه‌داشته‌شده برای | | --- | --- | --- | --- | --- | | `hetzner` | `HCLOUD_TOKEN` | خواندن توکن همان پروژه | اقدامات سرور و فایروال | در حالی که منابع وجود دارند | | `digitalocean` | `DIGITALOCEAN_TOKEN` | توکن دسترسی شخصی فقط-خواندنی | اقدامات دراپلت | در حالی که دراپلت وجود دارد | | `linode` | `LINODE_TOKEN` | `linodes`, `firewall`, `events` دامنه‌های فقط-خواندنی | رویدادهای حساب، نسخه‌های قوانین فایروال | ۹۰ روز | | `vultr` | `VULTR_API_KEY` | کاربری با دسترسی خواندن و ... `activity_logs` مجوز | گزارش فعالیت حساب (روش، مسیر، عامل) | ۳۰ روز، با اشتراک گزارش‌های حسابرسی طولانی‌تر | | `aws` | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` | `ec2:DescribeInstances`, `ec2:DescribeSecurityGroups`, `cloudtrail:LookupEvents` | تاریخچه رویدادهای CloudTrail | ۹۰ روز | | `phala` | `PHALA_CLOUD_API_KEY` | یک کلید API از همان فضای کاری | بازنگری‌های برنامه و عملیات CVM: پیکربندی Docker Compose و تغییرات محیط، راه‌اندازی مجدد، ارتقاء سیستم‌عامل | در حالی که برنامه وجود دارد | | `generic` | هیچ | هیچ | هیچ: **خودگواهی‌شده** | – | برای هر پرونده از یک پروژه، تیم، حساب یا زیرحساب اختصاصی استفاده کنید: دسترسی فقط-خواندن اعتبارسنج سپس فقط این استقرار را نشان می‌دهد. اعتبارنامه‌ها از `--provider-token-file` یا متغیر بالا، هرگز از خط فرمان. برای AWS، فایل حاوی `ACCESS_KEY_ID SECRET_ACCESS_KEY [SESSION_TOKEN]`؛ منطقه است `--location`. آنچه سوابق هر ارائه‌دهنده نمی‌تواند نشان دهد، در هر گزارش چاپ می‌شود. به طور خلاصه: هتزنر درخواست‌های کنسول را ثبت می‌کند؛ کنسول بازیابی DigitalOcean، Lish/Glish در Linode و کنسول وب Vultr به این صورت ثبت نمی‌شوند، بنابراین روت در اولین بوت قفل می‌شود و ورود به کنسول نیاز به ریست کردن رمز عبور یا تغییر بوت دارد، که این موارد ثبت می‌شوند. Vultr آدرس کنسول را به هر کلیدی که بتواند نمونه را بخواند، بازمی‌گرداند؛ نه رکورد و نه گزارش آن را ذخیره می‌کنند. ## ماشین مجازی محرمانه روی Phala Cloud (Intel TDX) با `--provider phala` جمع‌کننده در یک ماشین مجازی محرمانه Intel TDX روی [Phala Cloud](https://phala.com/)، که توسط dstack مدیریت می‌شود، اجرا می‌شود. میزبان و کارکنان Phala نمی‌توانند حافظه آن را بخوانند و پردازنده، گواهی‌ای از آنچه ماشین بوت کرده است، امضا می‌کند. اعتبارسنج صرفاً به حرف Phala اکتفا نمی‌کند: `tgwitness.tdx` خودش هر گواهی را، تا ریشه CA Intel SGX پین‌شده، با فهرست‌های لغو اعتبار و داده‌های پلتفرم امضا شده اینتل بررسی می‌کند، و ماشین‌هایی را که قابل اشکال‌زدایی یا مهاجرت هستند، رد می‌کند. | گزارش ورود | آنچه نشان می‌دهد | | --- | --- | | `tdx_binding` | این گواهی، بیانیهٔ امضا شدهٔ گردآورنده و مقدار تصادفی این درخواست را پوشش می‌دهد. | | `tdx_quote` | اینتل برای تأیید اعتبار ضامن است؛ این اعتبار تنها زمانی اعطا می‌شود که اینتل پلتفرم را به‌روز ارزیابی کند. | | `tdx_compose_hash` | RTMR3 که از لاگ رویداد dstack بازپخش می‌شود، میزان app-compose را که گردآورنده گزارش می‌کند، اندازه‌گیری می‌کند. | | `tdx_compose` | آن کامپوز دقیقاً بایت‌به‌بايت همان چیزی است که کد commit مستقر شده می‌سازد: فایل‌های منبع پین‌شده با هَش، هر دو تصویر با دیجست، بدون هیچ کد دیگری | | `tdx_identity` | تصدیق از طریق اپلیکیشن و نمونهٔ استقرار یافته، با کلیدهای KMS فالا و یک دیسک رمزگذاری‌شده انجام می‌شود. | | `tdx_os` | MRTD و RTMR0-2 با مقادیری برابر هستند که اعتبارسنج از تصویر سیستم‌عامل dstack که Dstack-TEE منتشر می‌کند، هش تصویر سیستم‌عملی که CVM گزارش می‌دهد و از جدول‌های ACPI که QEMU برای شکل VM می‌سازد، محاسبه می‌کند: فریمور، کرنل، initrd، خط فرمان با هش فایل‌سیستم ریشه، حافظه، vCPUها و دستگاه‌ها. یک تصویر توسعه ناموفق است | The OS image (about 180 MB, of which 21 MB are kept) is downloaded once from [Dstack-TEE/meta-dstack](https://github.com/Dstack-TEE/meta-dstack/releases) into `dstack-images` beside the record; `--tdx-image FOLDER` uses another folder or an unpacked image, `--tdx-image none` skips the comparison. The measurement follows `dstack-mr` and the `qemu-acpi` crate of Dstack-TEE/dstack. Private measurement regressions compare QEMU's own ACPI output and a retained Phala Cloud quote; live qualification also needs the published image. `--tdx-measurements` still compares MRTD and RTMR0-2 given as JSON instead. هر شروعِ کالکتور که در ژورنال ثبت می‌شود، چنین گواهی‌ای را در خود دارد، بنابراین `verify --evidence` هر شروع و تصویر سیستم عاملی را که با آن بوت شده است بررسی می‌کند. بازنگری‌های اپلیکیشن Phala و عملیات‌های CVM به عنوان لاگ ارائه‌دهنده عمل می‌کنند: یک پیکربندی Docker Compose که پس از استقرار تغییر کرده باشد، گزارش خطا می‌دهد و راه‌اندازی‌های مجدد برای بازبینی فهرست می‌شوند. در پنل، در بخش **Extras** → **Server 24/7** گزینه **«ماشین مجازی محرمانه · Phala Cloud»** را انتخاب کرده و یک کلید API از Phala Cloud را الصاق کنید؛ تونل سریع مانند Hetzner کار می‌کند. از خط فرمان: ``` python -m tgwitness.cloud deploy --provider phala --name case-1 --server-type tdx.small \ --ref v0.8.0 --repository https://github.com/phishdestroy/TgWitness --quick-tunnel \ --provider-token-file phala-key.txt python -m tgwitness.cloud verify --record deployments/case-1/deployment.json \ --provider-token-file phala-key.txt --cloud-init deployments/case-1/docker-compose.yaml \ --source CHECKOUT_OF_COMMIT --fingerprint COLLECTOR_FINGERPRINT --report certificate.md python -m tgwitness.cloud check-report --report certificate.pdf --verifier-fingerprint VERIFIER_KEY ``` `--tdx-collateral` به جای دانلود گواهی‌نامه‌ها و فهرست‌های لغو اعتبار اینتل از خود اینتل، آن‌ها را از یک فایل می‌خواند. Gateway DNS در اینجا در دسترس نیست: Phala فاقد فایروال ارائه‌دهنده برای ترافیک خروجی است. ### گواهی اعتبارسنجی برای استقرار Phala، `verify --report certificate.md` همچنین گواهی را می‌نویسد: a `certificate.html` خودکفا و یک A4 `certificate.pdf` با نتیجه، زنجیره اعتماد از ریشه اینتل تا کلید گردآورنده، مقایسه‌ای با سرورهای معمولی و با تضمین بالا، اندازه‌گیری‌ها در کنار مقادیر محاسبه شده از تصویر منتشر شده، چه کسی برای هر بخش ضمانت می‌کند، زنجیره گواهی اینتل، هر بررسی، گزارش ارائه‌دهنده، و نحوه تکرار تأیید اعتبار. گزارش JSON سند معتبر باقی می‌ماند؛ صفحات آن را نمایش می‌دهند. این گزارش با امضاها و مهرهای زمانی به‌صورت دیجیتال در فایل‌های `certificate.seal.json` و `.tsq`/`.tsr` کنار آن مهر و موم شده است: | مهر و موم | آنچه اضافه می‌کند | | --- | --- | | مهر زمانی الکترونیکی معتبر، `http://tsa.belgium.be/connect` | امضای زمانی RFC 3161 بر روی بایت‌های دقیق `certificate.json` از ارائه‌دهنده خدمات اعتماد معتبر دولت فدرال بلژیک (FPS Policy and Support, BOSA). واحد آن به عنوان یک سرویس مهر زمانی معتبر با وضعیت اعطا شده در فهرست مورد اعتماد اتحادیه اروپا برای بلژیک فهرست شده است؛ ریشه (Belgium Root CA6) و موارد موجود در این فهرست، بر اساس فهرستی که در تاریخ ۲۰ اکتبر ۲۰۲۶ منتشر شده است، در `tgwitness/tsa_roots.py` پین شده‌اند. بر اساس مقررات (اتحادیه اروپا) شماره ۹۱۰/۲۰۱۴، ماده ۴۱، چنین مهر زمانی از نظر تاریخ و زمان و همچنین از نظر یکپارچگی داده‌ها در هر یک از کشورهای عضو اتحادیه اروپا معتبر فرض می‌شود. | | مهر زمانی RFC 3161، FreeTSA | یک نشانگر زمانی دوم و مستقل | | امضای اعتبارسنج | امضای Ed25519 بر روی گزاره‌ای که SHA-256 و هر زمان‌مهر گزارش را نام می‌برد، با کلید خود راستی‌آزما (`--sign-with FOLDER`، پیش‌فرض `~/.tgwitness/verifier`)؛ PDF دارای امضایی با همان کلید است | `--timestamp URL` (تکرارپذیر) مراجع دیگر را انتخاب می‌کند، `--timestamp none` هیچ‌کدام را، و `--sign-with none` مهر را بدون امضا رها می‌کند. `check-report` هش گزارش، امضای راستی‌آزما، هر نشانگر زمانی را به یک ریشه مورد اعتماد و وضعیت معتبر آن، و امضای PDF را بررسی می‌کند. اعتبار قانونی یک مهر زمانی معتبر خارج از اتحادیه اروپا، و کل گزارش، بر عهده دادگاه یا مرجعی است که آن را دریافت می‌کند؛ این مهر نشان می‌دهد که گزارش چه زمانی وجود داشته و تغییر نکرده است. یک گواهی‌نامه نمی‌تواند یک نقص در ماژول TDX یا میکروکد اینتل، یا دسترسی فیزیکی به گذرگاه حافظه را رد کند. هر کسی که کنترل برنامه در حساب فالا را در دست دارد می‌تواند یک کامپوز دیگر را مستقر کند؛ این کامپوز به عنوان یک بازنگری جدید با هش کامپوز جدید ظاهر می‌شود. میزبان منبع زمان و شبکه ماشین را کنترل می‌کند. عملیات استقرار، تأیید با `--evidence`، راه‌اندازی مجدد، مقایسه تصویر سیستم‌عامل، گواهی مهر و موم دیجیتال با امضاها و مهرهای زمانی و نابودسازی روی خود Phala Cloud اجرا شده‌اند؛ به اجرای [در تاریخ ۴ نوامبر ۲۰۲۶ و](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/#live-phala-cloud-deployment--4-november-2026) مراجعه کنید. ## قبل از شروع 1. یک زون Cloudflare، شناسه حساب آن و یک توکن API با قابلیت‌های **Cloudflare Tunnel Edit**، **Zone Read** و **DNS Edit**، که با `--cloudflare-token-file` یا `CLOUDFLARE_API_TOKEN`برای اعتبارسنج: **خواندن تونل کلودفلر**، **خواندن DNS** و، برای سوابق حسابرسی، **خواندن تنظیمات حساب**. بدون دامنه، یک [تونل سریع](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#quick-tunnel-without-a-domain) به هیچ‌کدام از این موارد نیاز ندارد. 2. اطلاعات اعتبار ارائه‌دهنده با دسترسی نوشتن به یک پروژه اختصاصی؛ `lock` از همان استفاده می‌کند: - Hetzner: توکن API با مجوز خواندن و نوشتن؛ - DigitalOcean: توکن دسترسی شخصی با دسترسی نوشتن؛ - Linode: توکن دسترسی شخصی با `linodes`, `firewall` و `events` دامنه‌های خواندن/نوشتن؛ - ولتر: کلید API یک حساب اختصاصی یا زیرحساب؛ - AWS: اعتبارنامه‌های IAM مجاز هستند `ec2:DescribeVpcs`, `ec2:DescribeImages`, `ec2:CreateSecurityGroup`, `ec2:AuthorizeSecurityGroupIngress`, `ec2:RunInstances`, `ec2:CreateTags`, `ec2:DescribeInstances`, `ec2:DescribeSecurityGroupRules` و `ec2:RevokeSecurityGroupIngress`. 3. کامیتی که باید اجرا شود. یک تگ انتشار یک‌بار به کامیت خود با `git ls-remote`; سرور تنها commit ۴۰ کاراکتری را دریافت می‌کند. ## از پنل روی کامپیوتر خود، مسیر **Extras → Server 24/7** همان را اجرا می‌کند `deploy` برای Hetzner در سه مرحله: اروپا یا ایالات متحده را انتخاب کنید، یک توکن Hetzner (خواندن و نوشتن) را الصاق کنید، سپس نوع سرور، قیمت ماهانه، آدرس و نسخه‌ای را که پنل با آن توکن پیدا کرده است بررسی کنید. هیچ چیزی قبل از تأیید شما ایجاد نمی‌شود. پنل هر مرحله را به صورت `deploy` گزارش می‌کند، سپس آدرس، توکن پنل و اثر انگشت کلید امضا را نشان می‌دهد. بدون دامنه، سرور یک [تونل سریع](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#quick-tunnel-without-a-domain) دریافت می‌کند؛ **سرورها ← آدرس فعلی را** پس از راه‌اندازی مجدد دوباره بررسی می‌کند. برای یک آدرس ثابت تحت دامنه خود، **گزینه‌های اختیاری · دامنه خود را** باز کرده و یک توکن کلودفلر اضافه کنید (لینک آماده‌شده، گزینه‌های «خواندن منطقه»، «ویرایش DNS» و «ویرایش تونل کلودفلر» را انتخاب می‌کند). توکن‌ها با هر درخواست از زبانه مرورگر به TgWitness در همان کامپیوتر جابجا می‌شوند و در هیچ‌کجا ذخیره نمی‌شوند؛ رکورد استقرار، cloud-init حذف‌شده، توکن پنل و، برای یک تونل سریع، کلید آدرس در نگهداری می‌شوند `deployments/NAME` داخل دایرکتوری داده. پنل این قابلیت را فقط به مدیر اصلی در یک اتصال لوپ‌بک مستقیم ارائه می‌دهد (`127.0.0.1`، بدون هیچ هدر پروکسی یا تونل)؛ پنلی که از طریق شبکه به آن دسترسی پیدا می‌شود، به جای آن دستورات را نمایش می‌دهد. نسخه به طور پیش‌فرض بر روی تگ انتشار پنل در حال اجرا تنظیم می‌شود که از طریق API گیت‌هاب حل شده است. مکان، نوع سرور و قیمت از API هتزنر دریافت می‌شوند: `cpx22` جایی که ارائه می‌شود، در غیر این صورت ارزان‌ترین نوع x86 با حداقل ۲ گیگابایت حافظه. ## تونل سریع بدون دامنه `--quick-tunnel` جایگزین می‌کند `--zone`, `--cloudflare-account` و `--panel-host`؛ هیچ حساب یا توکن Cloudflare درگیر نیست: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --quick-tunnel --provider-token-file hetzner.token ``` روی سرور، cloudflared یک [تونل سریع](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) به پنل باز می‌کند: یک ... تصادفی `https://….trycloudflare.com` آدرسی که هر زمان cloudflared یا سرور راه‌اندازی مجدد شود، تغییر می‌کند. یک سرویس کوچک روی سرور هر آدرس را در یک موضوع تصادفی ntfy.sh ارسال می‌کند، که با کلیدی که فقط در دایرکتوری استقرار موجود است (HMAC-SHA256) امضا شده است (`address-key.txt`)، و هر سه ساعت یک‌بار آن را تکرار می‌کند زیرا ntfy.sh پست‌ها را به مدت ۱۲ ساعت نگه می‌دارد. `deploy` و **Find the current address** فقط پست‌های امضا شده را می‌پذیرد، بنابراین یک پست جعل‌شده نمی‌تواند شما و توکن پنل‌تان را به آدرس شخص دیگری ارسال کند. این موضوع در رکورد و cloud-init منتشر شده وجود دارد: هر کسی که آن‌ها را داشته باشد می‌تواند آدرس فعلی را بخواند، که همچنان برای توکن پنل درخواست می‌کند. سرور به هر حال هیچ پورت ورودی‌ای را باز نگه نمی‌دارد. یک راستی‌آزما کلید آدرس ندارد و هر کسی که موضوع را بخواند می‌تواند در آن پست بگذارد. بنابراین گردآورنده همچنین خودِ آدرس را، امضا شده با کلید Ed25519 خود، پست می‌کند و `verify` جدیدترین پستی را که با کلید گردآورنده در رکورد استقرار امضا شده است، برمی‌دارد؛ پست‌ها بر اساس زمانی که ntfy.sh آن‌ها را دریافت کرده است مرتب می‌شوند، نه زمانی که ادعا می‌کنند. یک گردآورنده از قبل از این تغییر، هیچ چیزی را امضا نمی‌کند، و سپس `verify` جدیدترین پست را انتخاب کرده و در بررسی `statement` این موضوع را اعلام می‌کند؛ یک پست جعل‌شده تنها می‌تواند باعث شکست آن بررسی شود، زیرا آدرس همچنان باید با کلید گردآورنده پاسخ دهد. هزینه‌اش چیست: هیچ حساب Cloudflare رکورد تونل سریع را نگه نمی‌دارد، بنابراین `verify` تونل، کانکتور و بررسی DNS را به عنوان در دسترس نبودن گزارش می‌کند و نتیجه در بهترین حالت `incomplete` (روی Phala در عوض، بررسی Cloud با موفقیت انجام می‌شود: کانکتور در داخل پیکربندی اندازه‌گیری‌شده Docker Compose اجرا می‌شود؛ سوابق ارائه‌دهنده، فایروال، بیانیه امضا‌شده، اندازه‌گیری‌های میزبان و مقایسه نصب‌کننده طبق معمول بررسی می‌شوند. مقایسه بایت با نصب‌کننده مرجع به یک commit مستقر نیاز دارد که از قبل `--quick-tunnel` را بشناسد؛ یک checkout نسخه 0.7.0، نصب‌کننده دامنه را می‌سازد و تفاوت را گزارش می‌کند. کلودفلر به تونل‌های سریع هیچ تضمینی برای زمان بهره‌برداری (uptime) نمی‌دهد، اجازه می‌دهد ۲۰۰ درخواست در حال انجام (in-flight) داشته باشد و رویدادهای ارسال‌شده توسط سرور (Server-Sent Events) را منتقل نمی‌کند، بنابراین ممکن است به‌روزرسانی‌های زنده پنل (نسخه‌های بعد از 0.7.0) از طریق آن نرسند و نیاز به بارگذاری مجدد نما (view) باشد؛ این بخش آزمایش نشده است. برای موردی که باید پایدار بماند، از دامنه خود استفاده کنید. ## راه‌اندازی ابتدا به همه چیزهایی که ارسال خواهند شد نگاه کنید. `plan` درخواست ارائه‌دهنده یا Cloudflare انجام نمی‌دهد: ``` python -m tgwitness.cloud plan --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org ``` سپس با همان گزینه‌ها و اعتبارنامه‌ها مستقر کنید: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org \ --witness-host case-witness.example.org \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` انواع سرور برای شروع: `cpx22` (Hetzner)، `s-1vcpu-2gb` (DigitalOcean)، `g6-standard-1` (Linode)، `vc2-1c-2gb` (ولتر)، `t3.small` (AWS). `--location` و `--image` پیش‌فرض برای هر ارائه‌دهنده، اوبونتو ۲۴.۰۴ در یک منطقه اروپایی. `--repository` تغییرات را از یک مخزن Git دیگر با HTTPS دریافت می‌کند، بدون اعتبارنامه‌ها در URL (پیش‌فرض `https://github.com/phishdestroy/TgWitness.git`). `deploy` همچنین می‌پذیرد `--out` برای یک دایرکتوری استقرار دیگر (پیش‌فرض `deployments/NAME`؛ دایرکتوری که در حال حاضر یک استقرار در آن وجود دارد، رد می‌شود) و `--wait`، زمان انتظار برای بیانیه امضا شده جمع‌آوری‌کننده: ۱ تا ۲۴۰، پیش‌فرض ۲۰، یا ۶۰ برای `generic`. دستور: 1. یک تونل Cloudflare ایجاد می‌کند که ورودی آن نام میزبان پنل را به پنل و، در صورت ارائه، نام میزبان شاهد را به `/api/witness/head` و `/api/assurance` تنها؛ 2. برای آن نام‌های میزبان، رکوردهای CNAME پروکسی‌شده ایجاد می‌کند و از ثبت نام‌هایی که از قبل وجود دارند، خودداری می‌کند؛ 3. یک فایروال ارائه‌دهنده بدون قواعد ورودی و یک سرور پشت آن بدون کلید SSH، بدون پشتیبان، بدون عامل کنسول، و cloud-init که SSH را مخفی می‌کند، روت را قفل می‌کند، نصب می‌کند `cloudflared`، دقیقاً همان commit را دریافت می‌کند، آن را بررسی می‌کند و TgWitness را به عنوان یک سرویس systemd سخت‌شده راه‌اندازی می‌کند؛ 4. منتظر بیانیهٔ امضا‌شدهٔ کلکسیونر می‌ماند و بررسی می‌کند که آیا این بیانیه، این سرور و هَش این cloud-init را نام می‌برد. `deployments/case-2026-11/` سپس شامل است: | فایل | فهرست مطالب | اشتراک‌گذاری؟ | | --- | --- | --- | | `deployment.json` | شناسهها، هشها، فراخوانی‌های API انجام‌شده (متد، مسیر، وضعیت) و اولین عبارت امضا‌شده | بله، با اعتبارسنج | | `cloud-init.redacted.yaml` | نسخهٔ دقیق cloud-init که دو رمز آن با ... جایگزین شده‌اند `REDACTED` | بله | | `panel-token.txt` | توکن پنل | خیر | رمز عبور ریشهٔ ارائه‌دهنده، توکن تونل و توکن پنل هرگز در `deployment.json`. اثر انگشت کلکتیوری را که در انتها ثبت شده است، تنها از طریق کانالی که کنترل آن در دست شما نیست، مانند یک کانال شاهدی یا یک پیام به گیرنده، منتشر کنید. در تلگرام وارد شوید در `https://case.example.org` با توکن پنل، همان‌طور که در [راهنمای حساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/) کاربری آمده است. اقدامات پنل در دفترچه یادداشت امضا شده ثبت می‌شوند؛ آن‌ها جلسات SSH نیستند. یک [شاهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/) می‌تواند درخواست وضعیت بدهد `https://case-witness.example.org`. SSH وجود ندارد: اگر بوت‌استرپ شکست بخورد، کالکتور هرگز پاسخ نمی‌دهد. سرور را حذف کرده و دوباره مستقر کنید، یا از استقرار عیب‌یابی (debug deployment) برای یافتن علت استفاده کنید. ### رازها در داده‌های کاربر cloud-init دو رمز را در خود حمل می‌کند: توکن پنل و توکن تونل کلودفلر. کلید امضا در میان آن‌ها نیست؛ این کلید روی سرور ایجاد می‌شود. Hetzner، DigitalOcean و Linode داده‌های کاربر را از طریق API خود بازنمی‌گردانند. Vultr آن را به هر کلیدی که بتواند نمونه را بخواند بازمی‌گرداند، و EC2 از طریق `DescribeInstanceAttribute`. برای AWS، فقط سه اقدام جدول را به راستی‌آزما بدهید، هرگز `ec2:Describe*`. برای Vultr، فرض کنید کلید اعتبارسنج می‌تواند هر دو توکن را بخواند. یک توکن تونل به کسی اجازه می‌دهد یک کانکتور دوم را اجرا کند: `verify` گزارش می‌کند هر کانکتوری که روی سرور نیست، و بیانیه‌های جمع‌کننده را نمی‌توان به این شکل جعل کرد زیرا هر کدام یک چالش جدید را امضا می‌کنند. با `--quick-tunnel` راز دوم در عوض کلید آدرس است: هر کسی که آن را بخواند می‌تواند یک آدرس جعلی ارسال کند که پنل آن را می‌پذیرد. بیانیهٔ عمومی گردآورنده، آدرس سرور و منابع ورودها را حذف می‌کند؛ هر دو در دفترچهٔ ثبت امضا شده باقی می‌مانند. ## عیب‌یابی استقرار و قفل `--debug-ssh-key KEY --debug-ssh-from 198.51.100.4` کلید SSH را برای یک کلید از یک آدرس یا شبکه کوچک، حداکثر یک /24 برای IPv4 یا یک /48 برای IPv6، نگه می‌دارد. `KEY` از قبل با ارائه‌دهنده ثبت شده است: نام یا شناسه یک کلید SSH در پروژه Hetzner، شناسه یا اثر انگشت یک کلید SSH در تیم DigitalOcean، نام کاربری Linode که کلیدهای SSH پروفایل آن به ریشه اضافه شده‌اند، شناسه یک کلید SSH در حساب Vultr، یا نام یک جفت کلید EC2 در منطقه. این گزینه‌ها برای `generic`. چنین استقراری به عنوان `debug` و **هرگز** به عنوان دارای سطح اطمینان بالا گزارش نمی‌شود. وقتی کارتان تمام شد، اجرا کنید `sudo tgwitness-lock` را به‌عنوان آخرین دستور جلسه SSH اجرا کنید، سپس: ``` python -m tgwitness.cloud lock --record deployments/case-2026-11/deployment.json --provider-token-file hetzner.token ``` فایروال تمام قوانین ورودی را از دست می‌دهد. سپس گزارش‌ها نشان می‌دهند که SSH چه زمانی مجاز بوده و چه زمانی بسته شده است؛ آن بازه زمانی همچنان قابل مشاهده باقی می‌ماند. ## حذف یک استقرار `destroy` سرور و فایروال آن را که با برچسب استقرار پیدا شده‌اند، حذف می‌کند تا استقراری که در نیمه راه ناموفق بوده نیز حذف شود، سپس رکوردهای DNS که به تونل آن اشاره دارند و خود تونل را حذف می‌کند. مجله و کلید امضای سرور به همراه آن حذف می‌شوند: ابتدا شواهد را صادر کنید. رکورد باقی می‌ماند، با علامت `removed`، با فراخوانی‌های API حذف. ``` python -m tgwitness.cloud destroy --record deployments/case-2026-11/deployment.json --confirm case-2026-11 \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` حذف از طریق API برای Hetzner پیاده‌سازی شده است. برای سایر ارائه‌دهندگان `destroy` پیش از حذف هر چیزی متوقف می‌شود و برچسبی را که باید حذف شود در کنسول ارائه‌دهنده نام‌گذاری می‌کند. یک سرور دستی نصب‌شده (`generic`) تنها رکوردهای تونل و DNS خود را از دست می‌دهد. استقرار سریع تونل به توکن Cloudflare نیازی ندارد: تونل آن با سرور پایان می‌یابد و پست‌های آن ظرف ۱۲ ساعت از ntfy.sh منقضی می‌شوند. ## هر سرور (خودگواهی‌شده) `--provider generic` برای سروری است که خریداری شده یا به‌صورت دستی نصب شده باشد. `deploy` تونل و DNS را ایجاد می‌کند، می‌نویسد `install.sh` (خصوصی) و `install.redacted.sh` (برای انتشار)، و منتظر می‌ماند. کپی `install.sh` آن را در یک سرور تازه نصب‌شده اوبونتو ۲۴.۰۴ کپی کرده و در آنجا اجرا کنید: ``` sudo bash install.sh ``` این ابزار میزبان را همان‌گونه که بود ثبت می‌کند (ورودی‌ها، حساب‌ها، `authorized_keys`، سوکت‌های شنود، خدمات، کارهای زمان‌بندی‌شده، بسته‌ها)، commit را نصب می‌کند، فایروال میزبان را فعال می‌کند، خود را حذف می‌کند، SSH را مخفی می‌سازد و جلسه را پایان می‌دهد. گزارش چنین سروری در بهترین حالت **خودگواهی‌شده (SELF-ATTESTED)** است: هر کسی که نصب‌کننده را اجرا کرده قبلاً دسترسی روت داشته و هیچ رکورد ارائه‌دهنده‌ای برای راستی‌آزمایی‌کننده در دسترس نیست. این هنوز بهتر از یک سرور بدون توضیح است: موجودی، هش نصب‌کننده و هر ورود بعدی امضا شده‌اند. ## تأیید تأییدکننده نیاز دارد `deployment.json`، نصب‌کننده منتشر شده، اعتبارنامه‌های فقط-خواندنی و، به‌طور ایده‌آل، یک خروجی از commit و یک مدرک ZIP: ``` git clone -c core.autocrlf=false https://github.com/phishdestroy/TgWitness.git checkout git -C checkout checkout 0123456789abcdef0123456789abcdef01234567 python -m tgwitness.cloud verify --record deployment.json \ --provider-token-file read-only.token --cloudflare-token-file cloudflare-read.token \ --fingerprint COLLECTOR_FINGERPRINT --cloud-init cloud-init.redacted.yaml \ --source checkout --evidence tgwitness-evidence.zip --report report.md ``` هر ارائه‌دهنده و مقدار Cloudflare در آن لحظه توسط اعتبارسنج درخواست می‌شود؛ رکورد فقط شناسه‌هایی را که باید پرسیده شوند، فراهم می‌کند. کد خروج برای **PASS** برابر 0، برای **FAIL** برابر 1 و برای **REVIEW**، **INCOMPLETE** یا **SELF-ATTESTED** برابر 2 است. `--fingerprint` باید از یک کانال مستقل بیاید؛ بدون آن، کلید فقط با رکورد اپراتور مقایسه می‌شود. `python verify.py` هنوز خودِ ZIP، همانند بخش [Evidence](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/)، شواهد را تأیید می‌کند. اقدامات ارائه‌دهنده طبقه‌بندی می‌شوند: ایجاد و شروع در ۳۰ دقیقه پس از ایجاد، عبور؛ کنسول، بازیابی، بازنشانی رمز عبور، بازسازی، ISO، تصاویر، اسنپ‌شات‌ها، پشتیبان‌ها، مدیر سیستم، اتصال نمونه EC2 و باز کردن فایروال ناموفق هستند؛ اقدامات مربوط به برق و هر چیزی که غیرمنتظره است برای بازبینی علامت‌گذاری می‌شوند. یک اقدام ناشناخته هرگز بی‌سروصدا رد نمی‌شود. ## گزارش تحویل مدرک `--report report.md` گزارش مارک‌داون را می‌نویسد و `report.json` در کنار آن: 1. نتیجه، اثر انگشت کلید گردآورنده، استقرار، ارائه‌دهنده، کامیت، سرور، فایروال، تونل؛ 2. هر بررسی به همراه وضعیت و منبع آن (API ارائه‌دهنده، API کلودفلر، بیانیه گردآورنده، مجله شواهد)؛ 3. لاگ ارائه‌دهنده با ارزیابی هر اقدام و، در مواردی که ارائه‌دهنده آن را ثبت می‌کند، عامل؛ 4. نقطه‌های پایانی کلودفلر که اتصالات، پیکربندی و گزارش‌های حسابرسی تونل را در خود نگه می‌دارند؛ 5. بیانیهٔ امضا‌شدهٔ گردآورنده؛ 6. آنچه گزارش اثبات می‌کند و آنچه اثبات نمی‌کند؛ 7. دستورالعمل‌هایی برای بازتولید آن و SHA-256 هر فایلی که به آن داده شده است. گزارش را تحویل دهید، `report.json`, `deployment.json`، نصاب منتشرشده و مدرک ZIP را تحویل دهید. گزارش را زود تهیه کنید: لاگ‌های ارائه‌دهنده برای دوره‌های محدودی نگهداری می‌شوند. ## کلودفلر به‌عنوان شاهد بیرونی همه چیز در اینجا اختیاری است. بدون حساب Cloudflare، سرور همچنان اجرا می‌شود و دو مورد از این موارد امروز کار می‌کنند: | چه | آنچه نشان می‌دهد | در TgWitness | | --- | --- | --- | | تونل سریع یا تونل دامنه‌ی شما | پنل تنها از طریق تونل قابل دسترسی است | جادوگر سرور، به بالا مراجعه کنید | | drand relay `drand.cloudflare.com` | سوابق پس از یک دور drand جدیدتر از آن هستند: این دفترچه یادداشت همزمان با وقوع رویداد نوشته شده است. | حالت مدرک، **شاهدان بیشتر**، بدون حساب ([قالب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)) | | اعلان‌های وضعیت تونل | وقتی تونل قطع بود، از طریق ایمیل یا وب‌هوک از Cloudflare | آنها را در داشبورد کلودفلر تنظیم کنید | | DNS دروازه (`--gateway-dns`، یا **DNS دروازه‌ای کلودفلر** در جادوگر) | هر نامی که سرور جستجو کرد، توسط Cloudflare از طریق TLS پاسخ داده شد؛ فایروال Hetzner اجازه نمی‌دهد DNS به هیچ چیز دیگری دسترسی پیدا کند؛ اینکه آیا یک سیاست Gateway می‌تواند پاسخ‌ها را بازنویسی کند | Hetzner، طرح رایگان Zero Trust، بدون دامنه؛ `verify` فایروال، مکان، لاگ‌گیری، سیاست‌ها، پرس‌وجوهای سرور و لاگ حسابرسی را بررسی می‌کند؛ حالت شواهد، لاگ را در ژورنال کپی می‌کند | | Gateway با کلاینت Cloudflare One روی سرور، یک فایروال خروجی که تنها به Cloudflare اجازه عبور می‌دهد | هر اتصالِ سرور، نه فقط DNS | هنوز ساخته نشده است | | دسترسی در مقابل پنل | چه کسی وارد پنل شده و چه زمانی | ساخته نشده: به دامنهٔ شخصی شما نیاز دارد | | ثبت دستورات SSH | هر دستور در یک جلسه اشکال‌زدایی | هنوز ساخته نشده است | Logpush که نسخهٔ اختصاصی Cloudflare را در R2 نگه می‌دارد، یک ویژگی سازمانی است: در طرح رایگان، Cloudflare پاسخ می‌دهد `logpush is not enabled for this account`. لاگ گیت‌وی آن در آنجا ۲۴ ساعت دوام می‌آورد، بنابراین حالت شواهد آن را در دفترچه یادداشت امضا شده کپی می‌کند (**لاگ گیت‌وی کلودفلر از پرس‌وجوهای DNS این سرور،** یک توکن فقط-خواندنی با دسترسی به تحلیل حساب). بدون یک طرح اعتماد صفر، یک حساب یک مکان DNS دارد. هنگامی که Cloudflare مکان دیگری را رد می‌کند، سرور مکان موجود را به اشتراک می‌گذارد و پرس‌وجوهای آن بر اساس آدرسشان از هم متمایز می‌شوند؛ آن فیلتر نیاز به دسترسی خواندن PII اعتماد صفر نیز دارد، و `destroy` یک مکان مشترک را ترک می‌کند. یک پرس‌وجوی لاگ حداکثر سه ساعت را در بر می‌گیرد، بنابراین کپی و `verify` خواندن روز در بازه‌های ساعتی سه ساعته انجام می‌شود. DNS گیت‌وی، حل‌کننده سیستم را پوشش می‌دهد. DNS بر روی HTTPS در پورت ۴۴۳ به یک حل‌کننده دیگر، و اتصالات به آدرسی که در هیچ‌جا یافت نمی‌شود (برای مثال، مراکز داده تلگرام)، در لاگ آن ثبت نمی‌شوند. کلودفلر نمی‌تواند محتوای داخل رمزگذاری تلگرام، سایر دستگاه‌های متصل به حساب تلگرام (فهرست دستگاه‌های حالت مدرک، آن‌ها را از سمت تلگرام ثبت می‌کند) یا هایپروایزر ارائه‌دهنده را مشاهده کند. ## خواندن نتیجه استقرار برای یک ماشین مجازی معمولی، ارائه‌دهنده زیرساخت میزبان را کنترل می‌کند و موجودی محلی در کنار سوابق ارائه‌دهنده بررسی می‌شود. برای Intel TDX، راستی‌آزما علاوه بر این، استناد سخت‌افزاری، پیوند گردآورنده، ترکیب و اندازه‌گیری‌های سیستم‌عامل را بررسی می‌کند. نتایج فردی را بخوانید تا ببینید کدام بررسی‌ها با موفقیت انجام شده‌اند یا در دسترس نبوده‌اند. جزئیات فایروال تاریخی به ارائه‌دهنده بستگی دارد؛ لینود نسخه‌های قوانین را حفظ می‌کند. [سوابق اعتبارسنجی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/)، استقرارهای آزمایش‌شده و بررسی‌های زنده باقیمانده را فهرست می‌کند، و [دامنه تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope)، این بررسی‌های محیطی را به دریافت و یکپارچگی آرشیو متصل می‌سازد. --- # Telegram · راهنمای پنل Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/ هر صفحه از پنل: چت‌ها، دفترچه یادداشت، منابع، خروجی‌ها، موارد اضافی، حالت‌های حفاظتی و بررسی کد. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) هر صفحه از پنل: چت‌ها، دفترچه یادداشت، منابع، خروجی‌ها، موارد اضافی، حالت‌های حفاظتی و بررسی کد. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [شروع کار](https://phishdestroy.github.io/TgWitness/fa/docs/reference/quickstart/) ![شروع کار](https://phishdestroy.github.io/TgWitness/assets/chapter-start.svg) [راه‌اندازی اولیه و تنظیمات](https://phishdestroy.github.io/TgWitness/fa/docs/reference/settings/) · [حساب‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/) · [صادرات و تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) · [گزارش‌های موردی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-reports/) هر صفحه چه کاری انجام می‌دهد، چه چیزی را به دفترچه یادداشت امضا‌شده می‌نویسد و راهنمای دقیق در کجا قرار دارد. پنل هر بار یک فضای کاری را نشان می‌دهد: یک حساب تلگرام با منابع، دفترچه یادداشت و کلید امضای مخصوص به خود. انتخابگر در بالای نوار کناری، فضاهای کاری را جابجا می‌کند. آدرس، فضای کاری را در خود حمل می‌کند (`?ws=…`)؛ در حالی که آدرس، انتخابگر و حساب بارگذاری‌شده با هم اختلاف دارند، اقدامات مسدود باقی می‌مانند. برای انتخاب بین مشاهده زنده، تاریخچه کامل، خروجی‌های تازه حساب/چت و تحویل سوابق ذخیره شده، از [مقایسه روش‌های جمع‌آوری](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) استفاده کنید. صفحه خروجی‌ها شامل همین مقایسه در بالای کنترل‌های دانلود خود است. **در این صفحه** - [راه خود را پیدا کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#find-your-way) - [از اینجا شروع کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#start-here) - [چت‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#chats) - [مجله](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#journal) - [منابع](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#sources) - [خروجی‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#exports) - [تنظیمات، حساب‌ها و اتصال](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#settings-accounts-and-connection) - [اضافه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#extras) - [حالت‌های محافظت](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#protection-modes) - [ابزارهای بیشتر](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#more-tools) ## راه خود را بیابید بخش‌های روزانه در بالای نوار کناری قرار دارند، **«حساب‌ها»** زیر **«محیط کاری»** است و سایر موارد زیر **«ابزارها و تنظیمات بیشتر** » قرار دارند. کلید تغییر **سطح رابط کاربری** در نوار بالا مشخص می‌کند که چند بخش نمایش داده شوند: | سطح | بخش‌ها در نوار کناری | | --- | --- | | ساده | خانه، چت‌ها، تغییرات، آرشیوها و تنظیمات | | استاندارد | همچنین Case Board، حساب‌ها و دسترسی | | کارشناس | همچنین منابع، موارد اضافی، پرسش از آرشیو، پارامترها، حساب، گزارش سیستم و یکپارچه‌سازی‌ها | فراخوانی‌های ساده: از اینجا شروع کنید، دفترچه یادداشت و **خانه** خروجی‌ها، **تغییرات** و **بایگانی‌ها**. یک سطح فقط بخش‌ها را پنهان می‌کند. یک ویژگی پنهان به کار خود ادامه می‌دهد، و سرور هر مجوز را به طور مستقل بررسی می‌کند. سطح، زبان، تم و منطقه زمانی برای هر اپراتور و فضای کاری ذخیره می‌شوند؛ به [تنظیمات](https://phishdestroy.github.io/TgWitness/fa/docs/reference/settings/) مراجعه کنید. نوار بالایی همچنین دارای موارد زیر است: - **به یک بخش بروید** (Ctrl+K، یا ⌘K روی مک): یک چت، یک پارامتر یا یک رکورد ژورنال را پیدا کنید `#number`. با کلیدهای جهت‌نما حرکت کنید، Enter باز می‌کند و Esc می‌بندد. - **اعلان‌ها**: مشکل‌ها و تغییرات چت استخراج‌شده از ژورنال. **علامت‌گذاری همه به‌عنوان خوانده‌شده،** شمارشگر را پاک می‌کند و **قوانین اعلان** را باز می‌کند. ارسال به تلگرام، دیسکورد یا ایمیل در [افزودنی‌ها → اعلان‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#notifications) تنظیم می‌شود. - شاخص اتصال برای این فضای کاری. **وضعیت سلامت کلکسیونر** زیر نوار بالا آن را به اتصال تلگرام، دریافت رویدادها، منابع و صف پیوست‌ها تقسیم می‌کند. - **قفل**: پنل را در این مرورگر می‌بندد. مجموعه روی سرور به کار خود ادامه می‌دهد. - حالت محافظت در کنار شماره نسخه؛ به [حالت‌های محافظت](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#protection-modes) مراجعه کنید. فضای کاری نمایشی حاوی پیام‌های فرضی است و هرگز به تلگرام متصل نمی‌شود. اقداماتی که فضای کاری واقعی را تغییر می‌دهند، در آنجا رد می‌شوند. ## از اینجا شروع کنید یک وظیفه را انتخاب کنید. **«خروجی حساب من»** پیام‌هایی را که حساب می‌تواند در حال حاضر بخواند، دانلود می‌کند. **«پیگیری یک پرونده**» پیام‌های جدید، ویرایش‌های مشاهده‌شده و اعلان‌های حذف را از گفتگوهای انتخابی شما ثبت می‌کند. کارت تنظیمات سه مرحله را نشان می‌دهد: اتصال حساب، انتخاب منابع، شروع مشاهده. سؤال هدف تا زمانی که به آن پاسخ دهید یا آن را رد کنید، در این صفحه باقی می‌ماند. در عوض، یک فضای کاری جدید [اولین تنظیمات](https://phishdestroy.github.io/TgWitness/fa/docs/reference/settings/) را باز می‌کند. ## چت‌ها گفت‌وگوهای ذخیره‌شده، به‌طور پیش‌فرض فقط قابل‌خواندن. - فهرست را بر اساس نام یا شناسه جستجو کنید. چت‌های زیر نظر را اضافه یا حذف **کنید**. باز کردن **لینک تلگرام** یک نام کاربری یا لینک دعوت را می‌گیرد و پیش‌نمایشی را در ژورنال ذخیره می‌کند. **پیوستن / باز کردن و مشاهده** سپس به چت می‌پیوندد و آن را به منابع شما اضافه می‌کند؛ باز کردن یک ربات آن را ارسال می‌کند `/start`. - سربرگ چت تعداد پیام‌های **حذف‌شده، متن‌های نگه‌داشته‌شده**، پیام‌های **حذف‌شده پیش از ذخیره‌سازی** و **پیام‌های یافت‌نشدنی در بازبینی مجدد** را شمارش می‌کند. فهرست چت و اعلان‌ها از همین تعاریف استفاده می‌کنند. یک پیام حذف‌شده به رنگ قرمز است و متن ذخیره‌شده خود را حفظ می‌کند؛ یک پیام ویرایش‌شده هر نسخه ذخیره‌شده را حفظ می‌کند. هر حذف، آنچه را که مشخص است نشان می‌دهد: زمان مشاهده آن، اینکه تلگرام گزارش نمی‌دهد چه کسی آن را حذف کرده، یا اینکه فقط اطلاع‌رسانی دریافت شده است. - **بارگذاری تاریخچه**، ۱۰۰، ۲۵۰ یا ۵۰۰ پیام آخر را در این نما و ژورنال می‌آورد. برای بارگذاری تمام منابع فعال، از منوی [Sources → Full history](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#sources) استفاده کنید. - **صادرات چت** کل تاریخچهٔ قابل مشاهده را به‌عنوان یک سند امضا‌شده دانلود می‌کند `chat.json` و `chat.html`چندین حساب متصل می‌توانند کار را با هم به اشتراک بگذارند: هر کدام بازه شماره پیام‌های خود را دانلود کرده و بخش خود را امضا می‌کنند، و حسابی که خروجی‌گیری را شروع می‌کند، آرشیو را امضا می‌کند. به [«خروجی‌گیری یک چت](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md)» مراجعه کنید. - **قسمت «افراد»** همه کسانی را که پیام‌های ذخیره‌شده در این چت دارند، فهرست می‌کند. پروفایل‌های افراد به طور پیش‌فرض خاموش هستند زیرا داده‌های شخصی مربوط به اشخاص ثالث می‌باشند. هنگامی که برای یک چت روشن باشند، یک پروفایل تاریخچه نام و نام کاربری، پرچم‌های تلگرام، هش‌های آواتار، فعالیت، اینکه چه کسی به چه کسی پاسخ می‌دهد، سایر چت‌های مشاهده‌شده، و کیف‌پول‌ها، تلفن‌ها، نام‌های کاربری و لینک‌های ذکرشده را نشان می‌دهد. هر واقعیت به رکورد خود اشاره می‌کند. **پروفایل‌های خروجی** یک فایل امضا‌شده را ذخیره می‌کند، اختیاریاً در یک رمز عبور ZIP؛ غیرفعال کردن پروفایل‌ها، فایل پروفایل را حذف می‌کند. [پروفایل‌های افراد را](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#people-profiles) ببینید. - **حالا «ذخیره پروفایل»** یک نمای کلی از پروفایل چت یا ربات را ثبت می‌کند: توضیحات، اعضا، لینک دعوت، دستورات ربات. ### فقط خواندنی، ارسال و اسرار دو کلید بالای پیام‌ها از حساب کاربری و خواننده محافظت می‌کنند: - **فقط خواندنی** زمانی که یک چت باز می‌شود روشن است. برای ارسال پیام‌ها یا فشردن دکمه‌های بات آن را خاموش کنید. هر اقدام از **ارسال به عنوان @account؟** یا **این دکمهٔ بات را به‌عنوان @account فشار دهید؟** می‌پرسد، به شما می‌گوید که اعضای چت آن را می‌بینند و اینکه وارد دفترچه ثبت امضا شده می‌شود. **در این چت تا ۱۰ دقیقه دیگر دوباره سؤال نپرسید** برای مدتی این سؤال را نادیده می‌گیرد. ارسال برای هدف **مدارک یک پرونده** در پنل و در API غیرفعال است. - **ماسک اسرار** آنچه شبیه رمز عبور، کد ورود، کلید یا هش API، توکن بات، رشته جلسه، کلید خصوصی، JWT یا شماره کارت پرداخت است را پنهان می‌کند (شماره‌های کارت با جمع لون بررسی می‌شوند). **نمایش** یک مقدار را آشکار می‌کند؛ این آشکارسازی در مجله ثبت می‌شود. غیرفعال کردن ماسک برای این مرورگر نیز ثبت می‌شود. تنها نمایش تغییر می‌کند: سوابق اصلی و هرگونه خروجی‌گیری، متن کامل را حفظ می‌کنند. ## مجله هر رکوردی که فضای کاری امضا کرده، جدیدترین‌ها اول. - **مرور کلی** پیام‌های مشاهده‌شده، ویرایش‌های ثبت‌شده، اعلان‌های حذف و منابع منتخب را شمارش می‌کند. - **خط زمانی رویدادها** بر اساس نوع رویداد (تمام، ویرایش‌ها، حذف‌ها، واکنش‌ها، عضویت، پوشش)، متن و منبع فیلتر می‌کند. **بارگذاری رویدادهای قبلی** به صفحه قبل بازمی‌گردد. - یک رکورد را باز کنید تا جزئیات، هش و پेलود آن را ببینید. **لینک به این رکورد** یک آدرس است که همان رکورد را باز می‌کند. اسرار احتمالی در این پیش‌نمایش مخفی می‌شوند؛ خروجی‌ها نسخه اصلی را حفظ می‌کنند. - ژورنال فقط-پیوست است: هیچ‌چیز در پنل یک رکورد را ویرایش یا حذف نمی‌کند. آن را با **«صادرات → اعتبارسنجی ژورنال**» بررسی کنید یا `python -m tgwitness.verify`؛ به بخش‌های [«صادرات» و «تأیید»](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) مراجعه کنید. ## منابع این فضای کاری کدام گفتگوها را ضبط می‌کند و چه اطلاعاتی را از آن‌ها نگه می‌دارد. تغییرات بر فعالیت‌های آینده اعمال می‌شوند؛ سوابق ذخیره شده باقی می‌مانند. **«تازهسازی فهرست چت‌ها»** چت‌ها و پوشه‌های حساب را می‌خواند. این کار پیام‌ها را دانلود نمی‌کند. ### دامنه - **آنچه این حساب ضبط می‌کند** : **گفت‌وگوهای انتخاب‌شده** (فقط گفتگوهایی که شما اضافه می‌کنید)، **پوشه تلگرام** (یکی از پوشه‌های حساب کاربری، شامل گفتگوهای اضافه شده به آن بعداً) یا **کل حساب** (هر گفتگویی، و هر گفتگوی جدید، گروه، گفتگوی خصوصی یا ربات به محض ظاهر شدن). **حالت تحقیق** برای یک حساب کاربری اختصاصی است: این حساب هر چیزی را که می‌بیند، پیام‌های خود و فشردن دکمه‌ها را ضبط می‌کند و بلافاصله پروفایل هر گفتگوی جدید و پیام‌های قابل مشاهده قبلی را ذخیره می‌کند. [راهنمای حساب اختصاصی](https://phishdestroy.github.io/TgWitness/docs/dedicated-account/) توضیح می‌دهد که چرا هرگز نباید از حساب اصلی خود استفاده کنید. - **انواع منبع** حالت‌های پوشه و کل حساب را به کانال‌ها، گروه‌ها، چت‌های خصوصی و ربات‌ها محدود می‌کنند. **«اقدامات خود** حساب» پیام‌ها، ویرایش‌ها و فشارهای صفحه‌کلید پاسخ‌دادنِ خودِ حساب را اضافه می‌کند. - **وقتی یک چت یا ربات جدید ظاهر می‌شود**: پروفایل آن و تا تعداد انتخاب‌شده از جدیدترین پیام‌های قابل مشاهده‌اش را ذخیره کنید. محدودیت‌ها: کلکسیونر ابری منتشرشده، گفتگوهای مخفی را دریافت نمی‌کند. [رابط نیمه‌مخفی جداگانه و دمو آن](https://phishdestroy.github.io/TgWitness/fa/docs/reference/secret-chats/) به همراه وضعیت توسعه و نقص‌های باقی‌مانده‌شان مستندسازی شده‌اند. هیچ چیزی در حالی که TgWitness در حال اجرا نیست، ثبت نمی‌شود؛ پس از راه‌اندازی مجدد، فقط مواردی را که تلگرام همچنان برمی‌گرداند، ثبت می‌کند و گزارش این شکاف را نشان می‌دهد. گفتگوهایی که از حد مجاز لیست گفتگوها فراتر هستند (1,000 مکالمه مگر اینکه در پارامترها تغییر داده شود) هنگام فعال شدن بعدی اضافه می‌شوند. دکمه‌های بات درون‌خطی که در اپلیکیشن دیگری فشرده می‌شوند، نامرئی هستند؛ پاسخ بات ثبت می‌شود. ### چت‌های در محدوده بر اساس وضعیت (**فعال**، **متوقف**، **اولویت‌دار**، **مستثنی**، **دسترسی تأییدنشده**، **نادیده گرفته شده**) و نوع فیلتر کنید، سپس روی یک انتخاب اقدام کنید: فعال‌سازی، توقف، علامت‌گذاری یا حذف اولویت، مستثنی کردن از دامنه یا حذف. نشان وضعیت فقط وضعیت را نشان می‌دهد؛ اقدامات در منوی هر خط با توضیحی در مورد عملکردشان قرار دارند. تعلیق و حذف کردن نیاز به تأیید دارند، و این کار به صورت دسته‌ای نیز امکان‌پذیر است. حذف یک منبع، نام آن را می‌پرسد و پروفایل‌های افراد آن را حذف می‌کند؛ سوابق ذخیره‌شده آن در مجله باقی می‌ماند. منبعی که در فهرست چت‌های حساب نمایش داده نمی‌شود **دریافت به‌روزرسانی‌ها، نه در فهرست چت** است؛ در حالی که سوابق همچنان در حال دریافت هستند، در غیر این صورت **دسترسی تأییدنشده**. **گفت‌وگوهای در دسترس** چت‌ها را با **افزودن موارد انتخاب‌شده** یا **افزودن همهٔ موارد مطابق** اضافه می‌کند. ### تاریخچهٔ کامل تاریخچهٔ موجود هر منبع فعال را در چت‌ها و ژورنال بارگذاری می‌کند. پیشرفت پس از راه‌اندازی مجدد حفظ می‌شود؛ پیوست‌ها از تنظیمات رسانه‌ای شما پیروی می‌کنند. [تاریخچهٔ منبع را](https://phishdestroy.github.io/TgWitness/fa/docs/reference/history/) ببینید. ### ثبت - **انتخاب کنید کدام تغییرات را حفظ کنید**: پیام‌های جدید، ویرایش‌ها، اعلان‌های حذف، واکنش‌های قابل مشاهده، پیوست‌ها و ترک‌ها. یک پیش‌تنظیم فرم را تغییر می‌دهد؛ **«ذخیره تنظیمات ضبط»** آن را اعمال می‌کند. فعال‌سازی مجدد یک دسته‌بندی، رویدادهای از دست رفته را بازیابی نمی‌کند. - **ذخیرهٔ رسانه در صورت امکان**: دانلود پیوست‌ها تا اندازه‌ای به مگابایت در هر فایل، تنظیم برای هر نوع از ۱ تا ۲۰۰۰ مگابایت، و محدود کردن طول ویدیو به ثانیه (۰ به معنای بدون محدودیت است). هر تلاش دانلود نتیجه‌ای ثبت‌شده دارد. - **بازبینی مجدد**: چت‌های اولویت‌دار هر چند دقیقه یک‌بار، سایر چت‌ها به ندرت، تا حساب کاربری از محدودیت‌های FloodWait تلگرام دور بماند. عدد ۰ گروه را غیرفعال می‌کند. چت‌های اولویت‌دار را با ستاره در لیست علامت‌گذاری کنید؛ تعداد چت‌ها در هر نوبت و مکث بین چت‌ها در پارامترها تنظیم می‌شوند. به [بخش مجموعه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/) مراجعه کنید. ## صادرات **Downloads** فایل‌ها را آماده می‌کند؛ **Build report** نحوه نمایش گزارش‌ها را تعیین می‌کند. | چه | برای استفاده از | راهنما | | --- | --- | --- | | صادرات حساب | یک اسنپ‌شات تازه از آنچه حساب اکنون می‌تواند بخواند | [صادرات حساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/account-export/) | | اشتراک‌گذاری کپی | یک مشتق حداقلی از خروجی‌گیری حساب تکمیل‌شده | [افشا](https://phishdestroy.github.io/TgWitness/fa/docs/reference/account-export/#prepare-a-disclosure-for-a-lawyer-or-another-recipient) | | امضا شده ZIP | ژورنال، گزارش، پیوست‌ها و ابزارهای تأیید در محدودهٔ ثابت ژورنال | [صادرات و تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) | | گزارش HTML، PDF، JSON | گزارشی مهر و موم‌شده و قابل‌خواندن | [گزارش‌های موردی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-reports/) | | JSONL، CSV | سوابق اصلی همراه با امضاها؛ یک صفحه‌گسترده امن از نظر فرمول | [صادرات و تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) | | استخراج هاند‌اوور | فقط گفتگوها، و بس؛ و افرادی که گیرنده نیاز دارد | [مدرک](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#investigation-handoff) | | خروجی چت | یک گفتگوی امضا شده `chat.json` و `chat.html` | [صادرات یک چت](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md) | - **رمزگذاری دانلودهای بالا با یک رمز عبور** (۱۲ کاراکتر یا بیشتر) یک فایل AES-256 ZIP ذخیره می‌کند که 7-Zip یا WinRAR آن را باز می‌کند. فایل امضا شده داخل آن بدون تغییر باقی می‌ماند. رمز عبور ذخیره نمی‌شود. - **خروجی‌های آماده‌شده** تا ۲۰ فایل را در محدودهٔ ۲ گیگابایت به‌علاوهٔ جدیدترین فایل برای دانلودهای مکرر، هر یک با شناسهٔ SHA-256 خود نگه می‌دارد. آماده‌سازی یک فایل، تحویل آن را اثبات نمی‌کند. - وقتی مرورگر دیالوگ ذخیره را رد می‌کند، پنل به دانلود معمولی بازمی‌گردد. - **هویت امضای شما** اثر انگشت کلید را نمایش می‌دهد. **ذخیره نقطه کنترل** و دانلود **رسید اجرای امضا شده**، سوابقی را در اختیار شما قرار می‌دهد تا آن‌ها را خارج از گردآورنده نگه دارید. آماده‌سازی **درخواست مهر زمانی**، یک درخواست RFC 3161 را بدون تماس با هیچ سرویسی ایجاد می‌کند. ## تنظیمات، حساب‌ها و اتصال - **تنظیمات**: هدف، اتصال، آنچه باید ضبط شود و رابط کاربری. به [راه‌اندازی اولیه و تنظیمات](https://phishdestroy.github.io/TgWitness/fa/docs/reference/settings/) مراجعه کنید. - **حساب‌ها**: هر فضای کاری به همراه وضعیت، منابع، رویدادها و صف پیوست آن. فیلتر بر اساس **«نیازمند توجه**»، **«در حال جمع‌آوری**»، **«آفلاین یا متوقف شده»** یا **«وصل نیست**»، «توقف یا از سرگیری» یک انتخاب، وارد کردن انبوه فایل‌های حساب و مدیریت گروه‌ها. [حساب‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/) را ببینید. - **حساب**: ورود و مسیر اتصال این حساب. مستقیم، یک پروفایل WireGuard، پروکسی خودتان، استخر عمومی MTProto یا WARP؛ یک مسیر را آماده و بررسی کنید، سپس آن را برای این حساب، یک گروه یا همه حساب‌ها اعمال کنید. به [اتصال و پروکسی‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/) و [پروکسی‌ها](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md) مراجعه کنید. ## موارد اضافی اختیاری: یک حساب کاربری و منابع برای شروع جمع‌آوری کافی هستند. تنها گزینه‌ای که انتخاب می‌کنید، تنظیمات خود را باز می‌کند و هیچ‌چیز به‌طور خودکار متصل نمی‌شود. کارت **سطح حفاظت** در بالا، [حالت حفاظتی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#protection-modes) را نشان می‌دهد. | کارت | آنچه اضافه می‌کند | راهنما | | --- | --- | --- | | ذخیره‌سازی و فضای دیسک | نسخه‌برداری‌ها، انتقال فایل‌های قدیمی‌تر به فضای ابری شما، یک نسخهٔ مدرکی که قابل حذف نیست | [ذخیره‌سازی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/storage/) | | هدف و سطح حفاظت | تنظیمات پیشنهادی برای هدف شما و دو مقیاس | [زیر](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#goal-and-protection-level) | | اخطاریه‌ها | مشکلات، پیام‌های تغییر‌یافته و یک خلاصه روزانه؛ ربات کنترل اختصاصی شما | [زیر](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#notifications) | | شواهد و پشتیبان‌ها | برچسب‌های زمانی، شاهدان بیشتر و یک نسخهٔ خارج از محل رمزگذاری‌شده | [زیر](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#evidence-and-backups) | | سرور ۲۴/۷ | یک سرور ابری بدون SSH که از طریق پنل ایجاد و حذف می‌شود | [اطمینان بالا](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#from-the-panel) | | شاهد مستقل | چک‌های امضا شده ارسال‌شده به کانال تلگرام یا دیسکورد شما | [شاهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/) | | بررسی کد | برنامه در حال اجرا را با یک کامیت عمومی گیت‌هاب مقایسه می‌کند | [زیر](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#code-check) | ### هدف و سطح حفاظت چهار سؤال: 1. **کاربرد آن چیست؟** یک سوابق شخصی، یک تحقیق، یا مدرکی برای یک پرونده. 2. **چقدر را مشاهده خواهید کرد؟** چند چت (تا حدود ۵۰)، چت‌های زیاد (تا حدود ۵۰۰) یا کل حساب‌ها. این محدودیت فهرست چت را به ۱۰۰۰، ۳۰۰۰ یا ۲۰۰۰۰ تنظیم می‌کند. 3. **عکس‌ها و فایل‌ها؟** فقط متن، عکس‌ها و رسانه‌های کوتاه (عکس‌ها تا ۲۰ مگابایت، ویدیوها تا ۱۰۰ مگابایت)، یا همه چیز (ویدیوها و اسناد تا ۱ گیگابایت برای هر کدام). حالت «همه چیز» با حساب‌های کامل همچنین ۴ گیگابایت از دیسک را آزاد نگه می‌دارد. 4. **در کجا اجرا می‌شود؟ روی** این کامپیوتر، یا روی سروری که همیشه روشن است. این پیشنهاد، نشانگرهای زمانی مستقل، drand و لیست دستگاه‌های تلگرام را، هر یک به همراه سندی از موارد افزوده‌شده، فهرست می‌کند. نشانگرهای زمانی برای یک رکورد شخصی، یک تحقیق یا مدرک، هر ۶۰، ۳۰ یا ۱۰ دقیقه یک‌بار شروع می‌شوند؛ drand و لیست دستگاه‌ها به نشانگرهای زمانی نیاز دارند. تغییرات را فقط در این موارد، سیاست پیوست و دو پارامتر فوق **اعمال کنید**. هر تغییر یک رکورد ژورنال است، به‌علاوه `setup.applied`. اعلان‌ها، یک نسخهٔ خارج از محل، یک سرور، DNS دروازه‌ای، بررسی کد و یک شاهد به عنوان مراحل بعدی همراه با فرم‌های مخصوص به خود ارائه می‌شوند. دو مقیاس بر اساس تنظیمات موجود محاسبه می‌شوند، نه بر اساس هدف: | مقیاس | نقطه‌ها | | --- | --- | | اعتبار | دفترچه یادداشت امضا شده ۱، مهرهای زمانی ۳، drand ۱، فهرست دستگاه‌ها ۱، بررسی کد تطابق‌دار ۱، نظرسنجی شاهدی ۱، سرور تصدیق‌شده ۲، گزارش DNS دروازه ۱ | | اعتمادپذیری | سرور همیشه روشن ۳، نسخهٔ خارج از محل ۳، قفل شیء ۱، اعلان‌های مشکل ۱ | **حداکثر** ۸۰٪ یا بیشتر خواندنی، ۵۰٪ **سطح بالا**، ۲۵٪ **متوسط**، و کمتر از آن **سطح پایه**. قابلیت اطمینان در حال حاضر، یک سرور همیشه روشن را از پاسخ به سؤال ۴ در نظر می‌گیرد، قبل از اینکه هیچ سرور دیگری بررسی شود. ### اخطاریه‌ها اخطاریه‌ها از طریق Apprise به تلگرام، دیسکورد، اسلک، ntfy، ایمیل، ماترiks و بیش از ۱۰۰ سرویس دیگر ارسال می‌شوند. یک سرویس را انتخاب کنید، یک یا دو فیلد را پر کنید و یک تست ارسال کنید، یا آدرس‌های Apprise را مستقیماً الصاق کنید. - **مشکلات**: پر شدن دیسک، خروج از حساب، خطاهای جمع‌آوری، کپی یا زمان‌نگاری. روی یک سرور مهر و موم‌شده، باز بودن پورت SSH یا ورود نیز مشکل‌ساز است. - **تغییرات**: پیام‌های حذف‌شده، ویرایش‌شده و مفقود در چت‌های مشاهده‌شده، که در قالب یک اعلان به ازای هر بررسی (هر دقیقه، مگر اینکه در پارامترها تغییر داده شود) گروه‌بندی شده‌اند. - **وظایف انجام‌شده**: تاریخچه، خروجی‌ها و نسخه‌های ذخیره‌شده. - **خلاصه روزانه** در ساعت انتخاب‌شده، به وقت سرور. اخطاریه‌ها شامل نام چت‌ها و شمارش آن‌ها هستند. گزیده‌های پیام به‌صورت پیش‌فرض غیرفعال هستند؛ با فعال کردن آن‌ها، متن پیام از این دستگاه خارج می‌شود. **ربات اپراتور شما** رباتی از خودتان است که از @BotFather ایجاد شده و پاسخ می‌دهد `/status` و `/stats`، و اختیاریاً `/pause`, `/resume` و `/copy`. فقط چت و شناسه کاربری تلگرام فهرست‌شده می‌توانند از آن استفاده کنند؛ متن گفتگو در فضای کاری باقی می‌ماند. اگر برنامه دیگری از قبل دستورات آن را دریافت می‌کند، از یک ربات جداگانه استفاده کنید. به [اعلان‌ها](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Notifications.md) و [ربات اپراتور](https://phishdestroy.github.io/TgWitness/fa/docs/reference/storage/#operator-bot-and-completion-notices) مراجعه کنید. ### شواهد و پشتیبان‌ها - **تایم‌استمپ‌های مستقل** تنها هش (SHA-256) هر نقطهٔ کنترل امضا شده را به مراجع RFC 3161 و تقویم‌های OpenTimestamps، هر ۵ تا ۱۴۴۰ دقیقه ارسال می‌کنند. **Anchor اکنون** یک پاس اجرا می‌کند. به [تایم‌استمپ‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/timestamp/) مراجعه کنید. - **شاهدهای بیشتر**، که هر یک تا زمان انتخاب غیرفعال هستند: جدیدترین دور drand، فهرست دستگاه‌های واردشده تلگرام بدون آدرس IP، و گزارش پرس‌وجوهای DNS سرور در Cloudflare Gateway. [رکوردهای اختیاری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)را ببینید. - **نسخه پشتیبان رمزگذاری‌شده**، دفترچه یادداشت، فایل‌ها، نقاط کنترل و خروجی‌های چت را به ذخیره‌سازی سازگار با S3 (Wasabi، Amazon S3، Backblaze B2، Cloudflare R2، MinIO) کپی می‌کند. ابتدا همه چیز روی این دستگاه رمزگذاری می‌شود. **کلید رمزگذاری را دانلود کرده** و آن را جدا نگه دارید: بدون آن، نسخه کپی قابل خواندن نخواهد بود. قابلیت Object Lock در حالت Governance یا Compliance، اشیاء را برای مدت زمان مشخصی از حذف محافظت می‌کند. به [نسخه کپی خارج از محل](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Off-site-Copy.md) مراجعه کنید. ### بررسی کد بررسی می‌کند که آیا برنامه نصب‌شده با نسخه منتشرشده مطابقت دارد یا خیر. 1. یک مخزن گیت‌هاب (مخزن رسمی از پیش پر شده است) و یک تگ، شاخه یا کامیت را وارد کنید. 2. **Check now** از طریق مسیر این فضای کاری برای درخواست‌های خارجی، از API گیت‌هاب برای دریافت فهرست فایل‌های آن کامیت می‌پرسد. این ابزار شناسه بلاب گیت هر فایل برنامه‌سنجی‌شده را با کامیت مقایسه می‌کند. یک چک‌اوت ویندوزی با پایان‌خط‌های تبدیل‌شده همچنان مطابقت دارد. 3. نتیجه، فایل‌های تغییر یافته، اضافی و حذف شده (تا ۵۰ فایل از هر نوع) را فهرست می‌کند و به صورت یک a `source.checked` یک رکورد ژورنال. نتیجه تنها زمانی به‌عنوان «جاری» در نظر گرفته می‌شود که فایل‌های برنامه در حال اجرا بدون تغییر باقی بمانند: پس از یک به‌روزرسانی دوباره بررسی کنید. به هیچ توکنی نیاز نیست و فقط مخازن عمومی کار می‌کنند؛ گفت‌وگوها و اطلاعات ورود بارگذاری نمی‌شوند. یک تطبیق، کد روی دیسک را شناسایی می‌کند. این تصدیق سخت‌افزاری نیست؛ برای آن، به [Phala Cloud](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) مراجعه کنید. ## مودهای حفاظتی سوئیچر کنار شماره نسخه، حالت انتخاب‌شده و اینکه چند تا از ۱۸ لایه حفاظتی فعال هستند را نشان می‌دهد، برای مثال `🟠 Witnessed 9/18`. **تغییر حالت** در **«افزودنی‌ها → سطح محافظت**» گزینه‌ها را باز می‌کند. یک حالت، یک هدف را توصیف می‌کند و فهرست می‌کند که چه چیزهایی هنوز ناقص هستند؛ ضبط، امضا و تنظیمات ذخیره شده در هر حالتی یکسان هستند. | حالت | برای | افزودن | | --- | --- | --- | | 🟢 آسان | نظارت بر یک چت و نگهداری یک نسخه | چت‌ها، دفترچه یادداشت و خروجی‌های چت؛ امضاها در پس‌زمینه اجرا می‌شوند | | 🟡 امضا شده | گزارش‌دهی به یک پلتفرم، یک میزبان یا یک میز رسیدگی به سوءاستفاده | آرشیو امضا شده، بررسی دفترچه یادداشت، نقاط کنترل، استخراج واگذاری | | 🟠 گواهی‌شده | مواردی که ممکن است کسی ادعا کند رکورد تغییر کرده است | یک شاهد مستقل که سرتیترهای دفترچه یادداشت امضا شده را منتشر می‌کند | | 🔴 آماده دادگاه | مدرک برای وکیل، پلیس یا دادگاه | مهرهای زمانی، نسخهٔ رمزگذاری‌شدهٔ خارج از محل، جزئیات پرونده در گزارش‌ها | | 🟣 تأییدشده توسط گیت‌هاب | سوابقی که نرم‌افزار آن‌ها باید برای همه قابل بررسی باشد | بازبینی کد و ضبط GitHub Actions | | ⚫ موساد | پرونده‌های پرمخاطره علیه یک رقیب با بودجهٔ فراوان | سرور مهر و موم‌شدهٔ ۲۴ ساعته و ۷ روز هفته، آدرس IP مخفی، تمام ۱۸ لایه | لایه‌ها: هر رکورد امضا و زنجیره‌سازی شده؛ رسید اجرای امضا شده؛ پیوست‌های ذخیره شده با SHA-256؛ نقاط کنترل امضا شده؛ بازبینی‌ها؛ هشدارهای مشکل؛ دسترسی شاهدی فقط خواندنی؛ شاهدی که طبق برنامه بررسی می‌کند؛ برچسب‌های زمانی RFC 3161؛ اثبات‌های OpenTimestamps؛ جدیدترین برچسب زمانی تأییدشده؛ یک نسخه پشتیبان رمزگذاری‌شده خارج از محل؛ جزئیات پرونده در گزارش‌ها؛ بررسی کد تطبیقی؛ عدم مشاهده آی‌پی این دستگاه توسط تلگرام؛ درخواست‌های خارجی از طریق یک پروکسی؛ قفل شیء (Object Lock) بر روی نسخه؛ یک سرور مهر و موم‌شده با سوابق ارائه‌دهنده. لایه‌ای که غیرفعال است، دارای یک دکمه **راه‌اندازی** است که فرم آن را باز می‌کند. انتخاب حالت پایین‌تر، درخواست تأیید می‌کند و هیچ چیزی را حذف نمی‌کند. ## ابزارهای بیشتر **Extras → Independent capture**: connect a separate browser or AyuGram recorder, pin its signing key, select capture options, start/pause, take snapshots and download verified signed archives. Each recorder has its own manual login, route, journal and key. Both connections start disabled. See the English [Independent capture guide](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md). - **از آرشیو بپرسید**: مشاهدات ذخیره‌شده را جستجو کنید، منابع را بررسی کنید، سپس تصمیم بگیرید که آیا آن‌ها را به یک مدل هوش مصنوعی ارسال کنید. به [تحلیل آرشیو](https://phishdestroy.github.io/TgWitness/fa/docs/reference/analysis/) و [OCR و رونویسی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/media-analysis/) محلی مراجعه کنید. - **پارامترها**: محدودیت‌ها و سرعت جمع‌آوری، بازبینی‌ها، دانلودها، پروفایل‌ها، اعلان‌ها و خروجی‌ها. جستجو بر اساس نام، نمایش **فقط** مقادیر **تغییر یافته** و آماده کردن مقادیر پیش‌فرض به عنوان پیش‌نویس با **«بازیابی پیش‌فرض‌ها…». ذخیره پارامترها** مقادیر را از اولین استفاده بعدی اعمال می‌کند، و هر تغییر یک رکورد در ژورنال است. - **دسترسی**: توکن‌های جداگانه برای بازبینان، تحلیلگران و اپراتورها، محدود به فضاهای کاری، چت‌ها و حقوق انتخاب‌شده. به [بخش دسترسی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/) مراجعه کنید. - **گزارش سیستم** : این فرآیند از زمان شروع چه کارهایی انجام داده است (اتصالات، تغییرات پروکسی، ورودها، ردها، تغییرات تنظیمات) با آدرس‌های IP مخفی. **دنبال کردن خطوط جدید** ، جدیدترین خط را در دید نگه می‌دارد. پیام‌ها فقط در مجله باقی می‌مانند. - **یکپارچه‌سازی‌ها**: ارائه‌دهنده هوش مصنوعی، اتصالات [MCP فقط-خواندنی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/) و [وب‌هوک‌های امضا‌شده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/webhooks/). - **Case Board**: یادداشت‌های خصوصی تیم، نشانک‌ها و اسلایس‌ها در کنار مدرک. به [Case Board](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/) مراجعه کنید. - **GitHub Actions capture** در خروجی‌ها: یک چت برداشت‌شده از فورک شما. ببینید [ثبت مهر و موم‌شده](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). --- # Telegram · نحوهٔ کارکرد جمع‌آوری Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/ دامنهٔ مشاهده، به‌روزرسانی‌های زنده، بازبینی‌ها، پیوست‌ها، اقدامات خود و معنای یک شکاف، رکورد به رکورد. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) دامنهٔ مشاهده، به‌روزرسانی‌های زنده، بازبینی‌ها، پیوست‌ها، اقدامات خود و معنای یک شکاف، رکورد به رکورد. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [مجموعه](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) ![مجموعه](https://phishdestroy.github.io/TgWitness/assets/chapter-collect.svg) TgWitness آنچه را که یک حساب تلگرام متصل مشاهده می‌کند، ثبت می‌کند. این دفترچه مشاهدات، توالی آن‌ها و زمینه همراهشان را حفظ می‌کند. این ابزار از روی یک پیام حذف‌شده یا از متصل بودن یک حساب، به وجود اقدامات نامرئی پی نمی‌برد. **در این صفحه** - [از ورود تا ژورنال](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#from-login-to-a-journal) - [دامنهٔ مشاهده: چت‌های انتخاب‌شده، یک پوشه یا کل حساب کاربری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account) - [دامنه و انتخاب رویداد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#scope-and-event-selection) - [اقدامات خود](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#own-actions) - [حالت تحقیق: پیوستن به تیم‌ها و گفتگو با ربات‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#investigation-mode-joining-teams-and-talking-to-bots) - [بازبینی مجدد سطوح](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#recheck-tiers) - [تاریخچه پیام و انتساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#message-history-and-attribution) - [برش‌های تاریخی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#history-snapshots) - [مدیریت پیوست‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#attachment-handling) - [موقتی متوقف کردن، قفل کردن، قطع اتصال و راه‌اندازی مجدد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#pause-lock-disconnect-and-restart) - [انزوا و تأیید حساب کاربری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#account-isolation-and-verification) ## از ورود تا دفترچهٔ ثبت برای عکس‌ها و فایل‌های خودویرانگر، به [رسانه‌های خودویرانگر](https://github.com/phishdestroy/TgWitness/blob/main/docs/EPHEMERAL-MEDIA.md) مراجعه کنید. این بخش، کارگر اولویت‌دار، نتایج ذخیره‌شده و در دسترس نبودن، و محدودیت‌های مسدودسازی رسید خواندن در گردآورنده API را توضیح می‌دهد. نمودار جریان · مجوز دادن به یک حساب کاربری → گروه‌ها و کانال‌های قابل دسترسی را انتخاب کنید; گروه‌ها و کانال‌های قابل دسترسی را انتخاب کنید → ذخیرهٔ تنظیمات رویداد و پیوست; ذخیرهٔ تنظیمات رویداد و پیوست → شروع مشاهده; شروع مشاهده → دریافت به‌روزرسانی‌ها از کلاینت فعال; دریافت به‌روزرسانی‌ها از کلاینت فعال → اعمال سیاست منبع و رویداد; اعمال سیاست منبع و رویداد → ضمیمه یک مشاهدهٔ امضا شده; ضمیمه یک مشاهدهٔ امضا شده → بازبینی یا صدور مجله; ضمیمه یک مشاهدهٔ امضا شده → هر پیوست صف‌شده را پردازش کنید; هر پیوست صف‌شده را پردازش کنید → ضمیمه کردن نتیجه دانلود · مجوز دادن به یک حسابکاربری · گروه‌ها و کانال‌هایقابل دسترسی را انتخابکنید · ذخیرهٔ تنظیمات رویدادو پیوست · شروع مشاهده · دریافت به‌روزرسانی‌هااز کلاینت فعال · اعمال سیاست منبع ورویداد · ضمیمه یک مشاهدهٔ امضاشده · بازبینی یا صدور مجله · هر پیوست صف‌شده راپردازش کنید · ضمیمه کردن نتیجهدانلود **نمودار به صورت متن** 1. مجوز دادن به یک حساب کاربری → گروه‌ها و کانال‌های قابل دسترسی را انتخاب کنید 2. گروه‌ها و کانال‌های قابل دسترسی را انتخاب کنید → ذخیرهٔ تنظیمات رویداد و پیوست 3. ذخیرهٔ تنظیمات رویداد و پیوست → شروع مشاهده 4. شروع مشاهده → دریافت به‌روزرسانی‌ها از کلاینت فعال 5. دریافت به‌روزرسانی‌ها از کلاینت فعال → اعمال سیاست منبع و رویداد 6. اعمال سیاست منبع و رویداد → ضمیمه یک مشاهدهٔ امضا شده 7. ضمیمه یک مشاهدهٔ امضا شده → بازبینی یا صدور مجله 8. ضمیمه یک مشاهدهٔ امضا شده → هر پیوست صف‌شده را پردازش کنید 9. هر پیوست صف‌شده را پردازش کنید → ضمیمه کردن نتیجه دانلود مجازی‌سازی، دسترسی به منبع، یک جمع‌آور فعال و تحویل کامل، پرسش‌های متفاوتی هستند. ورود موفق، دسترسی به هر گروه را تضمین نمی‌کند. یک انتقال متصل، این را اثبات نمی‌کند که هر به‌روزرسانی مرتبط رسیده است. ## دامنهٔ مشاهده: چت‌های منتخب، یک پوشه یا کل حساب منابع → **دامنهٔ مشاهده** تعیین می‌کند که یک فضای کاری کدام چت‌ها را ضبط کند. | حالت | ثبت می‌کند | چت‌های جدید | | --- | --- | --- | | گفت‌وگوهای انتخاب‌شده (پیش‌فرض) | فقط گفتگوهایی که خودتان به‌صورت دستی اضافه می‌کنید | هرگز به‌طور خودکار اضافه نشده است | | پوشه تلگرام | گفت‌وگوها در یکی از پوشه‌های حساب: شامل گفت‌وگوها بر اساس نام، به‌علاوه دسته‌بندی‌های پوشه (تماس‌ها، غیرتماس‌ها، گروه‌ها، کانال‌ها، ربات‌ها)، منهای گفت‌وگوهای حذف‌شده و، در صورت وجود، گفت‌وگوهای بایگانی‌شده. | گفت‌وگوهای مطابقت‌دار به محض فعال شدن اضافه می‌شوند؛ گفت‌وگوهایی که در تلگرام به پوشه اضافه می‌کنید ظرف یک ساعت شناسایی می‌شوند | | کل حساب | هر چتی که حساب می‌بیند | هر چت جدید، گروه، گفتگوی خصوصی یا ربات به محض دریافت اولین به‌روزرسانی اضافه می‌شود | - **انواع منابع** (کانال‌ها، گروه‌ها، چت‌های خصوصی، ربات‌ها) پوشه و حالت‌های کل حساب را محدود می‌کنند. چت‌های انتخاب‌شده می‌توانند از هر نوعی باشند، از جمله چت‌های خصوصی و ربات‌ها. - **چت‌های حذف‌شده** هرگز در هیچ حالتی ضبط نمی‌شوند. در حالت پوشه و حالت کل حساب، *«حذف»* و *«برطرف کردن»* یک منبع، آن را در این لیست قرار می‌دهد، بنابراین دامنه دیگر آن را اضافه نمی‌کند. انتخاب مجدد چت به‌صورت دستی (در بخش منابع یا از بخش چت‌ها) آن را از لیست خارج می‌کند. این لیست تا ۵۰۰۰ چت را در خود جای می‌دهد؛ پس از آن، *گزینه «حذف»* رد می‌شود و در عوض می‌توان چت را متوقف کرد. - **اقدامات خود** (به‌طور پیش‌فرض فعال): پیام‌هایی که این حساب ارسال می‌کند، ویرایش‌های آن و فشردن دکمه‌های صفحه‌کلید پاسخ. در صورت غیرفعال بودن، پیام‌ها و ویرایش‌های ارسالی نادیده گرفته می‌شوند. - سوئیچ کردن به یک پوشه یا کل حساب نیازمند تأیید است: این حالت‌ها چت‌های خصوصی و پیام‌های اشخاص ثالث را ضبط می‌کنند و فقط باید در یک حساب اختصاصی استفاده شوند. تأیید و هر تغییر دامنه در سوابق امضاشونده `scope.changed` ثبت می‌شوند. - گفت‌وگوهای اضافه شده توسط دامنه به عنوان منابعی با برچسب *auto* ظاهر می‌شوند، ضبط شده با `scope.applied` (در شروع و هر ساعت) یا `source.discovered` (یک گفتگوی جدید در حین مشاهده). بازگشت به گفتگوی انتخاب‌شده، تمام منابع اضافه شده به صورت خودکار را متوقف می‌کند. کارهایی که این حالت‌ها نمی‌توانند انجام دهند: - **گفت‌وگوهای مخفی** خارج از این حالت‌های جمع‌آوری ابری قرار دارند. یک [پیاده‌سازی جداگانه از گفت‌وگوی مخفی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/secret-chats/) در حال توسعه است؛ این پیاده‌سازی در گردآورنده منتشرشده در بازنگری مستندشده در آنجا گنجانده نشده است. - **هیچ چیزی ضبط نمی‌شود در حالی که TgWitness در حال اجرا نیست.** پس از راه‌اندازی مجدد، از تلگرام درخواست به‌روزرسانی‌های از دست رفته می‌کند و چت‌ها را مجدداً بررسی می‌کند، اما تلگرام پس از قطعی‌های طولانی همه چیز را بازنمی‌گرداند. گزارش‌ها و `verify.py` چنین دوره‌هایی را به صورت شکاف نشان می‌دهند (به [پوشش](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids) مراجعه کنید). - فقط ۱۰۰۰ گفتگوی اول در شروع فهرست می‌شوند (محدودیت در بخش **پارامترها** تعریف شده است)؛ چت‌های قدیمی‌تر وقتی دوباره فعال شوند اضافه می‌شوند. تاریخچه قبلی یک چت اضافه شده بازیابی نمی‌شود — در صورت نیاز از اسنپ‌شات تاریخچه یا خروجی کامل چت استفاده کنید. - شرایط پوشه که مدام تغییر می‌کنند (بی‌صدا، خوانده شده) اعمال نمی‌شوند: چنین گفتگوهایی همچنان زیر نظر باقی می‌مانند. - **دکمه‌های بات درون‌خطی (callback) که** در اپلیکیشن دیگری فشرده می‌شوند برای جلسه دوم نامرئی هستند؛ پاسخ یا ویرایش بات ضبط می‌شود. فشردن دکمه‌های صفحه‌کلید پاسخ به صورت پیام‌های ارسالی ثبت شده و با برچسب `button_press` مشخص می‌شوند. - چت‌های بیشتر به معنای درخواست‌های بیشتر است. تلگرام حساب‌هایی را که حجم را بیش از حد می‌داند محدود می‌کند، که این خود دلیل دیگری برای استفاده از حساب‌های اختصاصی است. ## دامنه و انتخاب رویدادها هر فضای کاری، منابع خاص خود را دارد. TgWitness به گروه‌ها نمی‌پیوندد، دعوت‌نامه‌ها را قبول نمی‌کند، یا اعضای هر گروه را به طور خودکار فهرست نمی‌کند. منابع باید از قبل برای حساب کاربری قابل دسترسی باشند. در هنگام راه‌اندازی، گردآورنده منابع انتخاب‌شده را با دیالوگ‌های قابل مشاهده حساب بررسی می‌کند؛ ۱۰۰۰ دیالوگ اول بررسی می‌شوند، مگر اینکه **گزینه «پارامترها → گفتگوها» در لیست حساب** خلاف این را تعیین **کرده باشد**. یک منبع غایب با برچسب **«دسترسی تأیید نشده**» علامت‌گذاری می‌شود، نه اینکه فرض شود شما را حذف کرده است. | تنظیمات | جمع‌آوری می‌کند | اثر هنگام غیرفعال‌سازی | | --- | --- | --- | | پیام‌های جدید | پیام‌های ارسال‌شده عادی | ویرایش‌ها/حذف‌های بعدی ممکن است متن ضبط‌شده قبلی برای مقایسه نداشته باشند. | | ویرایش‌ها | ارائه نسخه‌های ویرایش‌شده پیام | تغییرات میانی بعداً بازسازی نمی‌شوند. | | حذف‌ها | اعلان‌های حذف محدود و اعلان‌های سطح حساب نامحدود | اعلان‌های حذف به دفترچه شواهد افزوده نمی‌شوند. | | واکنش‌ها | ارائهٔ اسنپ‌شات‌های واکنش | به‌روزرسانی‌های واکنش جداگانه اضافه نمی‌شوند. | | عضویت | ارسال پیام‌های خدمات عضویت و به‌روزرسانی‌های شرکت‌کنندگان | آن مشاهدات عضویت اضافه نشده‌اند. | تنظیمات بر تمام منابع انتخاب‌شده در فضای کاری اعمال می‌شوند. برای اعمال تغییرات، فرم را ذخیره کنید؛ تغییرات با مقادیر امضا‌شده قبل و بعد ثبت می‌شوند. غیرفعال کردن یک دسته‌بندی، سوابق قبلی را حذف نمی‌کند. فعال کردن مجدد آن، به‌روزرسانی‌های از دست رفته را بازپروری نمی‌کند. سوابق عملیاتی و سایر رویدادهای خدمات گروهی از این سوئیچ‌ها مجزا باقی می‌مانند. پیام‌های خدمات عضویت می‌توانند هنگام فعال بودن عضویت، سوابق پیام ایجاد کنند، حتی اگر ضبط معمولی پیام جدید غیرفعال باشد. اشیاء ضبط‌شده تلگرام، متادیتای جاسازی‌شده را حفظ می‌کنند؛ یک سوئیچ یک قاعده سانسور نیست. **حذف‌ها در چت‌های خصوصی و گروه‌های عادی** به صورت شناسه پیام بدون چت دریافت می‌شوند. این چت‌ها یک توالی شناسه پیام در سطح کل حساب را به اشتراک می‌گذارند، بنابراین وقتی پیامی با آن شناسه قبلاً ذخیره شده باشد، چت آن مشخص است: حذف در همان چت با `chat_resolution` ثبت می‌شود که چگونگی آن را توضیح می‌دهد. شناسه‌هایی که هرگز ذخیره نشده‌اند، یک **حذف بدون دامنه** با منبع صریحاً ناشناخته باقی می‌مانند؛ گردآورنده حدس نمی‌زند. تلگرام هرگز نمی‌گوید چه کسی یک پیام را حذف کرده است؛ زمانی که پیام حذف‌شده توسط این حساب ارسال شده باشد، سند به این موضوع اشاره می‌کند (`deleted_message_was_outgoing`) بدون اینکه نام حذفی را ذکر کند. ## اقدامات خود پیام‌های ارسال‌شده توسط حساب کاربری مورد مشاهده با برچسب `outgoing` علامت‌گذاری می‌شوند. ویرایش یک پیام ارسالی نشان می‌دهد که در چت‌های خصوصی و گروه‌ها فقط نویسنده آن می‌تواند آن را ویرایش کند، در حالی که پست‌های کانال را می‌توان توسط مدیران دیگر ویرایش کرد. وقتی یک پیام ارسالی، متن یک دکمه از جدیدترین صفحه‌کلید پاسخ‌های ذخیره‌شده در آن چت را تکرار می‌کند، حاوی شناسه `button_press` به همراه لینکی به سوابق آن صفحه‌کلید است. استثنای اقدامات خود کاربر همچنین برای بازپرونده‌سازی‌های پس‌زمینه و تاریخچه خودکار چت‌های جدید نیز اعمال می‌شود. پیام‌های خروجی ردشده، موقعیت بازپرونده‌سازی را جلو می‌برند تا نتوانند پیام‌های ورودی بعدی را مسدود کنند. اقدامات صریح پنل و اسنپ‌شات‌های تاریخچه که به‌صورت دستی درخواست شده‌اند، همچنان ثبت می‌مانند. ## حالت تحقیق: پیوستن به تیم‌ها و گفتگو با ربات‌ها **منابع → دامنه مشاهده → حالت تحقیق،** دامنه را برای یک حساب کاربری اختصاصی که به چت‌های تیمی می‌پیوندد، ربات‌ها را راه‌اندازی می‌کند و برای آن‌ها پیام می‌فرستد، آماده می‌سازد: کل حساب کاربری، هر نوع منبع، اقدامات خود، و برای هر چت یا رباتی که ظاهر می‌شود، پروفایل آن و ۲۰۰ پیام قابل مشاهده اخیر آن. فرم را مرور کرده و روی **«ذخیره دامنه» (Save scope**) کلیک کنید؛ سوئیچ به کل حساب کاربری، تأیید معمول را می‌طلبد. - **دکمه‌ها.** دکمه‌های زیر یک پیام همراه آن باقی می‌مانند و در **چت‌ها** نمایش داده می‌شوند: لینک‌ها، اپلیکیشن‌های وب، لینک‌های ورود، متن‌های قابل کپی، داده‌های فراخوانی مجدد، پرس‌وجوهای درون‌خطی، درخواست شماره تلفن یا موقعیت مکانی. لینک‌ها به صورت متن نمایش داده می‌شوند و هرگز توسط پنل باز نمی‌شوند. هنگامی که یک ربات فقط دکمه‌ها را تغییر می‌دهد (مثلاً یک لینک پرداخت جدید)، این یک نسخه جدید از پیام محسوب می‌شود، چه از طریق به‌روزرسانی‌های زنده و چه از طریق بازبینی‌ها. - **چت‌ها و ربات‌های جدید.** در حالت‌های پوشه و کل حساب، **وقتی یک چت یا ربات جدید ظاهر می‌شود**، بلافاصله پس از ظاهر شدن ذخیره می‌کند: - پروفایل آن به‌عنوان یک رکورد `source.profile`: توضیحات و دستورات ربات، متن دربارهٔ کاربر، گروه یا کانال، اعضا، چت مرتبط و لینک دعوت در صورتی که تلگرام بازگرداند؛ - آخرین پیام‌های قابل مشاهده آن (تا ۱۰۰۰ پیام) به عنوان یک نمای کلی تاریخچه با شناسه `new_chat`: پیام‌های قبلی یک گفتگوی تیمی که به تازگی به آن پیوسته‌اید، یا آنچه یک ربات قبل از اینکه چت تحت نظارت قرار گیرد، گفته است. پیام‌هایی که قبلاً به صورت زنده ذخیره شده‌اند، تکرار نمی‌شوند. گفتگوهایی که هنگام فعال کردن حالت در لیست هستند، بدون اسنپ‌شات اضافه می‌شوند. یک FloodWait این کار را متوقف می‌کند و پس از آن از سر می‌گیرد؛ خطاها ثبت می‌شوند و ضبط زنده گفتگو ادامه می‌یابد. این شامل انتظارها در حین حل هویت گفتگوی جدید نیز می‌شود: وظیفه معلق پروفایل/تاریخچه برای تلاش مجدد حفظ می‌شود، و انتظار طولانی‌تر موجود در سطح حساب کوتاه نمی‌شود. - **پروفایل‌ها به درخواست.** **چت‌ها → پروفایل → ذخیره پروفایل اکنون** پروفایل فعلی هر منبعی را ذخیره می‌کند؛ جدیدترین پروفایل بالای پیام‌ها نمایش داده می‌شود. - **اسنپ‌شات‌های وضعیت چت (پیش‌نمایش).** وضعیت خارج از جریان پیام بدون یک پیام تغییر می‌کند: جدا کردن هر پیام هیچ ردی در سطح پیام باقی نمی‌گذارد، یک ادمین حقوق خود را از دست می‌دهد، یک هدیه پنهان، تبدیل، ارتقا یا بازپرداخت می‌شود. در حین مشاهده، هر منبع فعال به صورت دوره‌ای خوانده شده و به عنوان یک رکورد امضا شده `chat.state` ذخیره می‌شود: عنوان، نام‌های کاربری، توضیحات، تعداد اعضا و مدیران، چت‌های مرتبط، حالت کند، شناسه پیام‌های سنجاق شده (تا 100)، مدیران با حقوق و عناوینشان، و هدایایی که در کانال‌ها و پروفایل‌های کاربری نمایش داده می‌شوند (تا 100). هر رکورد تفاوت‌ها را از اسنپ‌شات قبلی فهرست می‌کند: فیلدهای تغییر کرده با مقادیر قبل و بعد، پیام‌های سنجاق‌شده اضافه یا حذف‌شده، مدیران و هدایای اضافه، تغییر یا حذف‌شده. تلگرام نمی‌گوید چه کسی چیزی را تغییر داده یا بین اسنپ‌شات‌ها چه زمانی این تغییر رخ داده است. - بخشی که تلگرام رد می‌کند (برای مثال لیست مدیران یک کانال برای عضوی که مدیر نیست) در `errors` نام‌گذاری می‌شود؛ مقدار قبلی آن حفظ شده و در `carried_forward` فهرست می‌شود و هرگز به عنوان حذف‌شده گزارش نمی‌شود. - یک رکورد که تنها تغییرات آن شمارش‌ها هستند، و یک بررسی که هیچ تغییری را پیدا نکرده است، به آخرین وضعیت کامل با `state_seq` و `state_overrides` تجمعی ارجاع می‌دهند. یک وضعیت کامل حداقل هر هفت روز یک‌بار و هر زمان که چیزی غیر از یک شمارش تغییر کند، نوشته می‌شود. - `parts_complete` لیست‌های محدود را نشانه‌گذاری می‌کند. افزودن‌ها به یک لیست کامل قبلی نیاز دارند، حذف‌ها به یک لیست کامل فعلی نیاز دارند، و مقادیر خالی صریح، پاک‌سازی را ثبت می‌کنند. - **پارامترها → وضعیت چت،** بازه زمانی (به طور پیش‌فرض 12 ساعت، عدد 0 اسنپ‌شات‌ها را غیرفعال می‌کند)، مکث بین منابع، اینکه کدام بخش‌ها خوانده می‌شوند، و اینکه آیا بررسی‌هایی که تغییر یافته‌اند ثبت شوند یا خیر را تنظیم می‌کند. `FLOOD_WAIT` و `FLOOD_PREMIUM_WAIT` درخواست‌های اسنپ‌شات باقی‌مانده را متوقف می‌کنند، هر مهلت زمانی طولانی‌تر در سطح حساب را حفظ می‌کنند، و چت قطع‌شده را پس از آن مکث برای تلاش مجدد واجد شرایط می‌سازند. - **نامرئی.** دکمه‌های درون‌خطی (کال‌بک) که در اپلیکیشن دیگری از تلگرام فشرده می‌شوند، پاپ‌آپ یا لینکی که ربات به چنین فشاری پاسخ می‌دهد، و لینک‌های دعوت استفاده شده در اپلیکیشن دیگر به TgWitnessنمی‌رسند. آنچه ربات بعداً ارسال یا ویرایش می‌کند، ثبت می‌شود. ### اقدام از پنل **گفت‌وگوها** اکنون شامل یک مینی‌کلاینت است که از حساب تلگرام فضای کاری انتخاب‌شده استفاده می‌کند: - یک پیام متنی ساده بنویسید یا زیر یک پیام ذخیره‌شده **گزینه «پاسخ»** را انتخاب کنید. پیام ارسالی بازگردانده‌شده حتی زمانی که دامنه به‌روزرسانی‌های ارسالی را مستثنی می‌کند، ضبط می‌شود. - **دکمه را** در زیر کال‌بک فعلی یا دکمه متنی فشار **دهید**. سرور پیام را دوباره بازیابی می‌کند و اگر صفحه‌کلید با نسخهٔ ذخیره شده متفاوت باشد، اقدام را رد می‌کند. رسیدهای کال‌بک متن پاپ‌آپ، پرچم هشدار و URL تلگرام را حفظ می‌کنند؛ پاسخ نیز در زیر گفتگو نمایش داده می‌شود. URLها به صورت متن قابل انتخاب باقی می‌مانند و به طور خودکار باز نمی‌شوند. - **لینک تلگرام**را باز کنید، `@username`، یک لینک عمومی `https://t.me/name`، `https://t.me/+invite` / `joinchat/invite`، یا یک لینک بات با `?start=parameter` را وارد کنید و دکمه **«ذخیره پیش‌نمایش» (Save preview**) را فشار دهید. لینک اصلی و پیش‌نمایش تلگرام قبل از پیوستن امضا می‌شوند. **عضویت / باز کردن و مشاهده** سپس به گروه/کانال می‌پیوندد یا کاربر/ربات را باز می‌کند، چت را به عنوان یک منبع فعال اضافه می‌کند، و `/start` را به یک ربات ارسال می‌کند، شامل پارامتر شروع آن. یک درخواست عضویت که در انتظار تأیید مدیر است، به عنوان در انتظار ثبت می‌شود، نه به عنوان عضویت. گزینه **«شروع مشاهده»** را برای ضبط زنده پاسخ‌های دریافتی فعال کنید. اقدامات پنل در حالی که مشاهده متوقف شده است کار می‌کنند، اما در این صورت تنها پاسخ‌های مستقیم آن‌ها تضمین شده که ذخیره شوند. منابع تازه‌افزوده شده هنگام اجرای مشاهده، از ورودی پروفایل/تاریخچه پیکربندی‌شده استفاده می‌کنند. هنگامی که یک منبع متوقف شده است، قبل از ارسال یا فشردن دکمه‌های آن، آن را در **بخش «منابع»** فعال کنید. رویدادهای مجله‌ای امضا شده معمولی `interaction.preview`، `interaction.requested` و `interaction.result` در خروجی‌های شواهد گنجانده شده‌اند. درخواست‌ها، حساب کاربری، پیام/دکمه یا رکورد پیش‌نمایش و اینکه آیا مشاهده در حال اجرا بوده است را شناسایی می‌کنند. رسیدها بین موفقیت، رد، در انتظار تأیید و نتیجه نامشخص تمایز قائل می‌شوند. یک درخواست قطع شده ممکن است به تلگرام رسیده باشد: قبل از شروع یک اقدام جدید، چت را بررسی کنید. استفاده مجدد از شناسه درخواست، رسید ذخیره شده آن را بدون تکرار عمل، حتی پس از راه‌اندازی مجدد، بازیابی می‌کند. پنل پس از یک پاسخ مبهم برای همان عمل در طول جلسه صفحه جاری، شناسه را حفظ می‌کند. همچنین هنگامی که پس از یک عمل موفق، تازه‌سازی نمایانگر ناموفق باشد، آن شناسه را حفظ می‌کند: رسید قابل مشاهده باقی می‌ماند و با کلیک مجدد، بازیابی می‌شود. RPCهای Callback و join یک بار برای اجرا تلاش می‌کنند؛ خواندن‌های قابل تلاش (retryable reads) سیاست تلاش مجدد پیکربندی‌شده خود را حفظ می‌کنند. سوئیچ کردن بین چت‌ها بلافاصله پیش‌نویس و هدف پاسخ را پاک می‌کند و ارسال را تا زمانی که گفتگوی جدید بارگذاری شود، غیرفعال می‌نماید. این مینی‌کلاینت، متن و دکمه‌های کال‌بک را مدیریت می‌کند. اپلیکیشن‌های وب، درخواست‌های ورود/تلفن/مکان، پرداخت‌ها، پرس‌وجوهای درون‌خطی و ضمیمه‌ها همچنان به کلاینت تلگرام نیاز دارند؛ متادیتای دکمه‌های ذخیره‌شده‌ی آن‌ها همچنان قابل مشاهده باقی می‌ماند. کنترل‌های جدید از متن انگلیسی استفاده می‌کنند. ## بازبینی مجدد سطوح بازبینی مجدد، تلگرام را برای پیام‌های از دست رفته، ویرایش‌ها و پیام‌هایی که دیگر بازنمی‌گرداند، مجدداً بررسی می‌کند. منابعی که با ستاره علامت‌گذاری شده‌اند، منابع **اولویت‌دار** هستند که به طور پیش‌فرض هر ۱۵ دقیقه یک‌بار بازبینی می‌شوند؛ سایر منابع هر ۶ ساعت یک‌بار. چت‌های انتخاب‌شده به عنوان منابع اولویت‌دار شروع می‌شوند، در حالی که چت‌های اضافه شده از طریق یک پوشه یا کل حساب کاربری به عنوان منابع عادی در نظر گرفته می‌شوند. در هر نوبت حداکثر ۳۰ منبع مجدداً بررسی می‌شوند و بقیه تا دقیقه بعد منتظر می‌مانند؛ پس از برقراری مجدد اتصال، منابع اولویت‌دار در اولویت قرار می‌گیرند. هر دو بازه زمانی در مسیر «منابع → تنظیمات ضبط → بررسی مجدد» (Sources → Recording settings → Recheck) تنظیم می‌شوند (عدد ۰ یک سطح را غیرفعال می‌کند) و به صورت `recheck.changed` ثبت می‌گردند. پیام‌های از دست رفته از همان جایی که بررسی قبلی متوقف شده بود، به سمت بالا بازیابی می‌شوند. حداکثر در **بخش پارامترها → پیام‌های از دست رفته بازیابی شده در هر چت و هر بررسی** (به طور پیش‌فرض ۱۰۰۰). پس از یک توقف طولانی، بررسی مجدد در نتیجه کل فاصله را پر می‌کند، حتی زمانی که پیام‌های زنده جدیدتر از آن فاصله ابتدا ذخیره شده باشند. چتی که هنوز در حال جبران عقب‌ماندگی است، به جای انتظار برای فاصله زمانی لایه‌بندی‌اش، در دقیقه بعد دوباره بررسی می‌شود؛ `recheck.completed` نشان می‌دهد `continues_after` تا زمانی که کامل شود. مقایسه‌ها شامل متن پیام، اشیاء، صفحه‌کلیدها (شامل حذف)، و محتوای/هویت ضمیمه است. تغییر هش‌های دسترسی به فایل یا ارجاعات به فایل به تنهایی یک ویرایش ایجاد نمی‌کند، و همچنین مواردی که تلگرام خود به خود وارد می‌کند نیز ویرایش محسوب نمی‌شوند: پیش‌نمایش لینک، مشاهده استوری‌ها، رسانه‌های پولی که توسط این حساب باز شده‌اند، و رسید فاکتور. هر نسخهٔ ذخیره شده در چت‌ها به رکورد کامل دفترچهٔ خود، شامل متادیتای رسانه، لینک می‌شود. ## تاریخچه پیام و انتساب فرض کنید گردآورنده مشاهده «جلسه در ساعت ۱۰:۰۰» را ثبت می‌کند، بعداً «جلسه در ساعت ۱۱:۰۰» را می‌بیند، و سپس یک اعلان حذف دریافت می‌کند. این کار سه مشاهده متمایز را ضمیمه می‌کند. متن اصلی باقی می‌ماند، ویرایش یک نسخه جداگانه است، و اعلان ثبت می‌کند که یک حذف مشاهده شده است. اگر جمع‌آوری پس از ناپدید شدن نسخه اول شروع شده باشد، آن متن در دسترس نخواهد بود. اگر چندین ویرایش در حالی که فرآیند آفلاین بود انجام شده باشد، تنها نسخه‌هایی که بعداً مشاهده می‌شوند قابل ذخیره هستند. یک اعلان حذف، محتوایی را که هرگز ضبط نشده است، بازیابی نمی‌کند. فرستنده پیام لزوماً ویرایشگر نیست. تلگرام معمولاً شخص حذف‌کننده پیام یا زمان دقیق حذف را ارائه نمی‌دهد. عاملان ناشناس، ناشناس باقی می‌مانند. اسنپ‌شات‌های واکنش و به‌روزرسانی‌های شرکت‌کنندگان تنها شامل شمارش‌ها و هویت‌هایی هستند که تلگرام برای حساب کاربری قابل مشاهده می‌کند. اعداد توالی، ترتیب مشاهده را نشان می‌دهند. مهر زمانی UTC گردآورنده، ساعت محلی آن است؛ در صورت ارائه، مهر زمانی منبع تلگرام به طور جداگانه ذخیره می‌شود. هیچ‌کدام از این موارد یک مهر زمانی مستقل و معتبر نیستند. ## لحظه‌های تاریخی تصویر لحظه‌ای، تازه‌ترین پیام‌های قابل مشاهده را از یک منبع فعال درخواست می‌کند؛ حداکثر 500 پیام در هر درخواست. نتایج با عنوان مشاهدات تاریخچه ثبت می‌شوند. تصویرگیری دستی یک حساب آزاد را رزرو می‌کند؛ ابتدا پایش را صریحاً موقتاً متوقف کنید. مشاهدات تکراری به صورت رکوردهای جداگانه حفظ می‌شوند. اسنپ‌شات‌ها از سیاست پیوست‌ها پیروی می‌کنند اما از کلیدهای رویداد زنده جدا هستند. آنها پیام‌های حذف‌شده یا نسخه‌های میانی از دست رفته را بازسازی نمی‌کنند. شما می‌توانید در حالت مکث یک اسنپ‌شات درخواست کنید؛ هر پیوست که در صف قرار گیرد تا زمانی که مشاهده شروع شود و کارگر دانلود اجرا شود، منتظر می‌ماند. اجرای **تاریخچه** یک کار مستقل و انحصاری است: منابع انتخاب‌شده را می‌خواند و پیوست‌های در صف آن‌ها را به ترتیب و بدون شروع پایش دریافت می‌کند. توقف موقت حساب را آزاد می‌کند و ازسرگیری، اجرای ذخیره‌شده را ادامه می‌دهد. برای فیلتر تاریخ، زبان و پاسخ در چند حساب آزاد، به [خروجی توزیع‌شدهٔ گفتگو](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md) مراجعه کنید. ## مدیریت پیوست‌ها دانلود پیوست به‌صورت پیش‌فرض فعال است و در صورتی که فضای آزاد دیسک کمتر از ۱ گیگابایت باشد، متوقف می‌شود. گردآورنده، عملیات مشاهده پیام و دانلود را به‌طور همزمان انجام می‌دهد. این عملیات، شناسه‌ی رسانه‌ی اصلی و سیاست اندازه‌بندی را حفظ می‌کند، بنابراین پیوست ویرایش‌شده‌ی بعدی به‌صورت بی‌صدا جایگزین نمی‌شود. دانلودها پس از ضبط پیام انجام می‌شوند. یک دانلود کامل، یک رکورد `media.saved` با SHA-256 و تعداد بایت‌های آن ایجاد می‌کند. کارهای نادیده گرفته شده، ناموفق، مجدداً تلاش شده و قطع شده، نتایج متفاوتی دارند. یک کار صف‌شده، مدرکی بر حفظ فایل نیست. فایل تکمیل‌شده همچنین باید با تعداد بایت در توصیف‌کننده پیوست اصلی مشاهده‌شده مطابقت داشته باشد. یک پاسخ کوتاه یا غیرمنتظره طولانی، به‌عنوان رسانه حفظ‌شده ثبت نمی‌شود. محدودیت‌ها **به ازای هر نوع** تعیین می‌شوند: عکس‌ها، ویدیوها، گیف‌ها و انیمیشن‌ها، پیام‌های ویدیویی گرد، پیام‌های صوتی، موسیقی و صدا، استیکرها و فایل‌ها. هر نوع را می‌توان غیرفعال کرد و محدودیت اندازه خاص خود را از ۱ تا ۲۰۰۰ مگابایت (MiB) دارد؛ فضای کاری جدید با ۲۰ مگابایت برای عکس‌ها، ۱۰۰ مگابایت برای ویدیوها، ۵۰ مگابایت برای فایل‌ها، صدا و ویدیوهای گرد، ۲۰ مگابایت برای پیام‌های صوتی و گیف‌ها و ۵ مگابایت برای استیکرها. فضاهای کاری جدید، گیف‌ها و استیکرها را تا زمان فعال‌سازی، غیرفعال نگه می‌دارند. فضاهای کاری که سیاست‌هایشان قبل از محدودیت‌های نوع‌به‌نوع ذخیره شده باشد، تمام انواع را فعال نگه داشته و یک محدودیت واحد برای همه انواع حفظ می‌کنند. *حداکثر اندازه فایل،* همه انواع را به طور همزمان تنظیم می‌کند. نوعی که غیرفعال شده باشد، یک رکورد `media.skipped` تولید می‌کند؛ فایل‌های با اندازه نامشخص یا بزرگ دانلود نمی‌شوند. فایل‌های بزرگ بر اساس اندازه خود و سرعت پایه ۲۵۶ کیلوبایت بر ثانیه، زمان دانلود اضافی دریافت می‌کنند. جاب‌ها (وظایف) پس از راه‌اندازی مجدد نیز باقی می‌مانند، اما ارجاعات منقضی شده، از دست رفتن دسترسی، یا فایل‌های حذف شده همچنان می‌توانند مانع بازیابی شوند. وظایف در حال انتظار محدودیت را با خود ذخیره می‌کنند، بنابراین افزایش محدودیت فقط برای فایل‌های جدید اعمال می‌شود. غیرفعال کردن یک نوع یا کاهش محدودیت آن همچنین فایل‌های در حال انتظار را که از آنها حذف می‌کند، نادیده می‌گیرد، که هر کدام یک رکورد `media.skipped` دارند؛ غیرفعال کردن دانلودها صف را تا زمانی که دوباره فعال شوند، متوقف می‌کند. ## مکث، قفل، قطع اتصال و راه‌اندازی مجدد | اقدام یا وضعیت | اثر | | --- | --- | | جابجایی فضای کاری | نما پنل را تغییر می‌دهد؛ سایر گردآورنده‌ها وضعیت خود را حفظ می‌کنند. | | قفل کردن پنل یا بستن زبانه | سرور و مشاهده را در حال اجرا باقی می‌گذارد. | | مراقبه را متوقف کنید | آن گردآورنده را متوقف می‌کند و کار روی پیوست‌های صف‌شده را حفظ می‌کند. | | غیرفعال کردن یک منبع | از ضبط محدودهٔ زمانی آینده جلوگیری می‌کند؛ وظایف رسانه‌ای صف‌شده برای آن در حالی که غیرفعال است، منتظر می‌مانند. | | حذف یک منبع | آن را به‌عنوان منبع فراموش می‌کند و پروفایل‌های افراد را حذف می‌کند؛ پیام‌هایی که قبلاً ذخیره شده‌اند در دفترچه شواهد فقط-پیوست باقی می‌مانند. ضمیمه‌های در انتظار آن همچنان به‌عنوان ناموفق ثبت می‌شوند (`source_removed`). در حالت‌های پوشه و کل حساب نیز این موارد مستثنی هستند. | | مسیر اتصال را تغییر دهید | نیاز به مکث دارد، کلاینت‌های قدیمی را می‌بندد و ورود ناتمام را لغو می‌کند. | | متوقف کردن فرآیند پایتون | تمام فضاهای کاری را متوقف می‌کند؛ هیچ مشاهداتی در حالی که آفلاین است ثبت نمی‌شود. | | پس از مشاهدهٔ فعال، مجدداً راه‌اندازی کنید | تلاش برای از سرگیری محدودهٔ ذخیره‌شده با استفاده از جلسهٔ ذخیره‌شده. توقف دستی آن نیت را لغو می‌کند. | جمع‌کننده قطع اتصالات، تلاش‌های مجدد، خطاها، شروع/وقفه و تپش‌های قلب (heartbeats) را ثبت می‌کند. وقفه‌های کوتاه ممکن است توسط بررسی‌های دوره‌ای اتصال نادیده گرفته شوند. پس از راه‌اندازی مجدد، به‌روزرسانی‌های از دست رفته از موقعیت ذخیره شده درخواست می‌شوند و گفت‌وگوهای مشاهده شده به صورت دوره‌ای مجدداً بررسی می‌شوند؛ به [فرمت شواهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#durable-collection-and-process-receipts-02) مراجعه کنید. یک اسنپ‌شات زمینه را فراهم می‌کند؛ این امر ثابت نمی‌کند که یک شکاف برطرف شده است. ## ایزوله‌سازی و تأیید حساب هر فضای کاری دارای دفتر ثبت، کلید تأیید صلاحیت، کلید امضا، سیاست و صف خود است. تنها کلاینت فعال آن می‌تواند مشاهدات زنده را ثبت کند. کلاینت‌های ردشده، در انتظار، منسوخ‌شده و تست اتصال نمی‌توانند به‌روزرسانی‌های زنده را در دفتر ثبت آن بنویسند. حساب‌های مختلف می‌توانند یک گروه را مشاهده کنند، اما دفتر ثبت‌های آن‌ها جدا از هم باقی می‌ماند. هر رویداد شامل هش قبلی و یک امضای Ed25519 است. خروجی‌ها کل دفتر کار را از طریق یک شماره توالی ثابت پوشش می‌دهند. فیلترهای پنل، خروجی را فیلتر نمی‌کنند؛ جمع‌آوری ممکن است در حین آماده‌سازی، فراتر از محدوده آن ادامه یابد. **بررسی مجله،** زنجیره رویدادها و امضاها را از طریق مرز نمایش‌داده‌شده **اعتبارسنجی می‌کند**. نتیجه آن هنگام تغییر فضای کاری پاک می‌شود و پنل، سوابق جدید افزوده‌شده پس از بررسی را شناسایی می‌کند. خروجی‌گیری ZIP نیز رسانه‌های جمع‌آوری‌شده را اعتبارسنجی می‌کند. اثرانگشت‌ها و نقاط کنترل را به‌طور مستقل حفظ کنید. برای بررسی‌های اکتساب در هر حالت، به [محدوده تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope) و برای جمع‌آوری‌های روتین به [عملیات روزانه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/) مراجعه کنید. --- # Telegram · گفتگوهای مخفی: پیاده‌سازی و دمو Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/secret-chats/ پیاده‌سازی مجزای Secret Chat را درک کنید، رابط کاربری فرضی را امتحان کنید و نواقص باقی‌مانده را بررسی کنید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) پیاده‌سازی مجزای Secret Chat را درک کنید، رابط کاربری فرضی را امتحان کنید و نواقص باقی‌مانده را بررسی کنید. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) **وضعیت بررسی شده در 6 نوامبر 2026:** یک پیاده‌سازی جداگانه برای چت مخفی در حال توسعه وجود دارد. این با نسخه منتشر شده ادغام نشده است. `main` در `3d23e52b647b`. جمع‌کننده معمولی و خروجی Takeout، چت‌های مخفی را جمع‌آوری نمی‌کنند. سناریوی وب‌سایت تعاملی رابط کاربری را با داده‌های فرضی نشان می‌دهد؛ این سناریو ارتباط تلگرام را فعال نمی‌کند. ## محل استقرار پیاده‌سازی کامیت `0e60f88e` افزود **Sources → Pseudo-secret** در شاخه توسعه محلی `fix/panel-routes-sessions`. اسنپ‌شات بررسی‌شده `bb8788fb685c` است. پیاده‌سازی آن شامل `tgwitness/secret_chats.py`، مسیرهای برنامه، `tgwitness/static/views/secret-chats.js` و تست‌های اختصاصی است. خروجی اختیاری `secret-chats` در آن شاخه از [KiaroSama/Telethon-Secret-Chat](https://github.com/KiaroSama/Telethon-Secret-Chat) استفاده می‌کند که به `d87bf037b90060383c7b704d8a06ebb98c621c6f` متصل شده است. این کتابخانه پروتکل چت از سر تا سر تلگرام را بر روی مجوز Telethon موجود در حساب کاربری پیاده‌سازی می‌کند. نصب تنها این کتابخانه، یکپارچه‌سازی گمشده را به `main` اضافه نمی‌کند. ## کاربرد رابط توسعه | اقدام | رفتار ضبط‌شده | | --- | --- | | شروع گفتگو با نام کاربری یا شناسهٔ کاربر | درخواست ارسال کنید؛ شرکت‌کنندهٔ دیگر باید آن را بپذیرد. | | قبول درخواست ورودی | TgWitness به نقطهٔ پایانی دریافت‌کنندهٔ آن چت تبدیل می‌شود. پذیرش خودکار یک تنظیم جداگانه است که به‌صورت پیش‌فرض غیرفعال است. | | ارسال یا دریافت یک پیام | یک رکورد خروجی یا ورودی `secret_chat.message` اضافه کنید و آن را در نخ گفتگو نمایش دهید. | | دریافت یک پیوست | آن را رمزگشایی کنید، بایت‌های آن را با SHA-256 ذخیره کرده و `secret_chat.file` را ثبت کنید. | | دریافت اعلان تایمر یا حذف | اعلان را ثبت کنید و محتوای قبلاً ضبط‌شده را حفظ کنید. | | گفتگو را بازبینی کنید | پیام‌ها، فایل‌ها، اعلان‌ها و نمای اصلی را نمایش دهید. زبانهٔ باز هر چهار ثانیه یک‌بار تازه می‌شود. | در یک نسخهٔ توسعه شامل این یکپارچه‌سازی، اپراتور ماژول را برای حساب کاربری انتخاب‌شده فعال کرده و آن را متصل می‌کند. راه‌اندازی، پذیرش و ارسال نیازمند اجازه برای تعامل و غیرفعال بودن محافظت فقط-خواندن حساب کاربری است. شرکت‌کنندهٔ دیگر باید یک گفتگوی خروجی جدید را بپذیرد. این کنترل‌ها در اپلیکیشن منتشرشده در بازنگری بالا وجود ندارند. تنها چت‌هایی که توسط این جلسه TgWitness ایجاد یا پذیرفته شده‌اند، پوشش داده می‌شوند. چت‌های مخفی موجود روی یک گوشی در همان دستگاه باقی می‌مانند. وارد کردن یک جلسه، کلیدهای رمزگذاری جداگانه آن‌ها را فراهم نمی‌کند. مواد کلیدی و شمارنده‌های چت مخفی در گاوصندوق فضای کاری ذخیره می‌شوند؛ پیام‌های نگهداری‌شده و فایل‌های رمزگشایی‌شده از محافظت‌های معمول ذخیره‌سازی فضای کاری پیروی می‌کنند. ## نمایش وب‌سایت سناریوی «**Try Secret Chat**» وب‌سایت یک گفتگوی خیالی را باز می‌کند. این سناریو به خواننده اجازه می‌دهد یک درخواست را آغاز کند، پذیرش آن را شبیه‌سازی کند، یک پیام نمونه ارسال کند، یک پاسخ و فایل اسکریپتی دریافت کند و تایمر و اعلان حذف را بررسی کند. یک درخواست ورودی نیز می‌تواند پذیرفته شود. کنترل‌ها، اقدامات همتای شبیه‌سازی‌شده را به صراحت برچسب‌گذاری می‌کنند. این سناریو در حافظه‌ی مرورگر اجرا می‌شود. ریست یا بارگذاری مجدد آن را پاک می‌کند. این سناریو وارد تلگرام نمی‌شود، با آن تماس نمی‌گیرد، کلیدهای رمزگذاری واقعی ایجاد نمی‌کند یا دانلود نمونه‌های امضا شده را تغییر نمی‌دهد. پیام‌های نمایش داده شده توسط آن، شواهد امضا شده نیستند. این سناریو تعامل مورد نظر را نشان می‌دهد؛ اما تأیید نمی‌کند که پیاده‌سازی توسعه‌ای آماده است. ## بررسی‌ها و نقص‌های باقی‌مانده پنج تست موجود، پایداری کلید رمزگذاری‌شده، چرخه عمر و سوابق پیام، سیاست پذیرش ورودی، ارسال فقط-خواندنی و خروجی‌گیری پیوست را پوشش می‌دهند. آنها در طول بازبینی مورخ 6 نوامبر در برابر کتابخانه ثابت‌شده (pinned library) با موفقیت اجرا شدند. سه بررسی مصنوعی اضافی، نقص‌ها را در همان اسنپ‌شات بازتولید کردند: | یافته‌ها | پیامد | | --- | --- | | بستن دورزنی `read_only` | مسیر بسته می‌تواند در صورتی که تعاملات باید مسدود شوند، یک اقدام از راه دور را انجام دهد. | | جستجوی تشخیص تکراری فقط در سوابق اخیر 500 انجام می‌شود. | یک بازپخش قدیمی‌تر می‌تواند پس از راه‌اندازی مجدد یک نسخهٔ مشابه ایجاد کند. | | دانلود ناموفق پیوست، ورودی در انتظار آن را حذف می‌کند. | یک خطای موقت، وظیفهٔ تلاش مجدد را از دست می‌دهد. | این‌ها نقص‌های باز هستند که در [حسابرسی منتشرشده](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md) نیز ثبت شده‌اند. پنج تست گذرا این شکست‌ها را پوشش نمی‌دهند. بازبینی از فضاهای کاری مصنوعی و عملیات شبیه‌سازی‌شده تلگرام استفاده کرد؛ این بازبینی دست‌دادن زنده را تکرار نکرد و استقرار در محیط تولید را تأیید نکرد. --- # Telegram · بارگذاری تاریخچه منبع Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/history/ بارگذاری پیام‌های گذشته از منابع فعال، مکث و از سرگیری، و تأیید گزارش پیشرفت امضا شده. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) بارگذاری پیام‌های گذشته از منابع فعال، مکث و از سرگیری، و تأیید گزارش پیشرفت امضا شده. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [مجموعه](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) ![مجموعه](https://phishdestroy.github.io/TgWitness/assets/chapter-collect.svg) در بخش **منابع**، چت‌های فعال را مرور کنید، مشاهده را متوقف کنید، API استاندارد یا خروجی Takeout را انتخاب کرده، سپس **بارگذاری کل تاریخچه را** برگزینید. این فرایند آن فهرست منابع را تثبیت کرده و پیام‌های گذشتهٔ در دسترس آن‌ها را در چت‌ها و دفترچهٔ مشاهدهٔ امضا‌شده می‌خواند. بخش رسانه‌ها از تنظیمات پیوست موجود و صف دانلود پایدار استفاده می‌کند. این بخش از خروجی امضا‌شدهٔ JSON/HTML برای هر چت مجزا مستقل است. برای جمع‌آوری در سطح کل حساب، **کل حساب (Whole account)**را انتخاب کنید، مشاهده را برای بارگذاری لیست منبع آن شروع کنید و پیش از شروع تاریخچه، آن لیست را بررسی کنید. محدودیت لیست گفتگوها همچنان اعمال می‌شود (به طور پیش‌فرض 1,000، قابل تنظیم در پارامترها). اجرای موفقیت‌آمیز، اثبات نمی‌کند که تمام گفتگوهای حساب فهرست شده‌اند. چت‌هایی که بعداً کشف یا فعال می‌شوند، به اجرای مجدد نیاز دارند. پیش از شروع تاریخچه، مشاهده را متوقف کنید؛ هر بار فقط یک جمع‌آوری بر روی یک حساب انجام می‌شود. یک تا پنج کارگر پیوست را انتخاب کنید و مشخص کنید که آیا باید اقدامات اخیر موجود را حفظ کرده و نسخه‌های قبلاً ذخیره شده را مقایسه کنید. خروج ممکن است به تأیید در تلگرام و یک زمان انتظار مشخص‌شده توسط سرور نیاز داشته باشد. این گزینه‌ها هنگام از سرگیری ثابت باقی می‌مانند. برای جزئیات مربوط به انتقال، تلاش مجدد و اعتماد، به [رفتار تکمیل مجدد و قرارداد شواهد](https://github.com/phishdestroy/TgWitness/blob/main/docs/BACKFILL.md) مراجعه کنید. ## تعطیل، راه‌اندازی مجدد و نتایج جزئی - **تاریخچه توقف،** خواندن را متوقف می‌کند. **ادامه تاریخچه** از آخرین پیام ثبت‌شده در هر منبع از سر گرفته می‌شود؛ راه‌اندازی مجدد برنامه نیز اجرای آن را تا زمان از سرگیری متوقف می‌کند. از سرگیری نیازمند همان حساب تلگرام غیرفعال است. - مشاهده پیام، انجام عملیات پیوست و ثبت مکان نما در یک تراکنش واحد. اجرای از سر گرفته شده مشاهدات ثبت‌شده قبلی را تکرار نمی‌کند. ضبط زنده یا اجرای جداگانه و صراحتاً آغازشده می‌تواند به‌طور مستقل همان پیام را مشاهده کند. - هر منبع (هر بازهٔ تقسیم‌شدهٔ تلگرام در Takeout) در اولین خواندن خود یک شناسهٔ پیام بالا را تثبیت می‌کند. پیام‌های جدیدتر به مشاهدهٔ زنده تعلق دارند، نه به صفحات تاریخی باقی‌ماندهٔ آن منبع. - منابع غیرقابل‌دسترس و منابعی که در حین جمع‌آوری غیرفعال شده‌اند، همچنان به‌عنوان «ناموفق» یا «نادیده گرفته شده» قابل مشاهده‌اند. سایر منابع به کار خود ادامه می‌دهند؛ نتیجه کلی ناقص است. - تأخیرهای FloodWait به فاصله زمانی افزایش‌یافته حساب ذخیره شده احترام می‌گذارند. خطاهای موقت تا پنج بار مجدداً تلاش می‌کنند؛ در صورت اتمام تلاش‌ها و کمبود فضای دیسک، عملیات متوقف می‌شود اما مکان‌نما دست‌نخورده باقی می‌ماند. - **پایان این اجرای تاریخچه** مشاهدات ذخیره‌شده را حفظ می‌کند. این کار آن‌ها را حذف نمی‌کند یا وظایف پیوست استاندارد-API را لغو نمی‌کند. پایان Takeout فایل‌های Takeout باقی‌مانده را به‌عنوان ردشده علامت‌گذاری می‌کند؛ مکث آن‌ها را قابل ازسرگیری نگه می‌دارد. یک اجرای جدید منابع فعال‌شده را دوباره می‌خواند. تکمیل تاریخچه، فقط خواندنی است. ضمیمه‌ها ممکن است در حالت انتظار باقی بمانند، ناموفق باشند، یا توسط سیاست پیکربندی‌شده مستثنی شوند. رسیدهای رسانه را در دفترچه و صف ضمیمه‌ها بررسی کنید؛ تنها یک رسید تکمیل‌شده با بایت‌های حفظ‌شده، یک ضمیمه ذخیره‌شده را تشکیل می‌دهد. عملیات تاریخچه یک درخواست اسنپ‌شات صریح است و از سوئیچ‌هایی که دسته‌های رویدادهای زنده آینده را انتخاب می‌کنند، مستقل است. ## انتقال و تأیید **گزارش پیشرفت امضا شده** را ذخیره کنید، سپس از **«صادرات شواهد»** برای دانلود دفترچه و پیوست‌های ذخیره شده استفاده کنید. یک صادرات شواهد بعدی ممکن است شامل سوابق اضافی باشد؛ گزارش شمارشگرهای خود را به پیشوند دفترچه در زمان ایجاد آن متصل می‌کند. راستابار را از یک نسخه برداری معتبر از این نسخه اجرا کنید: ``` python tgwitness/verify.py tgwitness-history-report.json --evidence evidence.zip --fingerprint TRUSTED_FINGERPRINT ``` اثر انگشت کلید امضای مورد انتظار را به صورت مستقل حفظ کنید. اعتبارسنج، امضای گزارش، آرشیو شواهد، نقطه کنترل گزارش، طرح منبع، حساب کاربری و شمارش پیام‌های ذخیره شده/در دسترس نبوده را بررسی می‌کند. اجراهای جدید همچنین پیشرفت منبع و گزینه‌ها را به رویدادهای نشانگر امضا شده متصل می‌کنند. بدون گزینه `--evidence`، فقط گزارش امضا شده و سازگاری داخلی آن بررسی می‌شود. فیلدهای پیشرفت قدیمی و خلاصه‌های پیوست، همچنان بیانیه‌های امضا شده گردآورنده باقی می‌مانند. اعتبارسنج شواهد، بایت‌های رسانه‌ای آرشیو شده را بررسی می‌کند. نه امضا کردن و نه تکمیل تاریخچه موجود، اصالت تلگرام، یک نمای کلی آنی، یا جامعیت تاریخی را اثبات نمی‌کند. پیام‌ها می‌توانند هنگام خواندن تغییر کنند؛ پیام‌های حذف‌شده و ویرایش‌های میانی خارج از اقدامات اخیر (Recent Actions) موجود و چت‌های مخفی (Secret Chats)، بازیابی نمی‌شوند. یک اپراتور که کنترل کلید امضا را در دست دارد، می‌تواند پیش از وجود تعهدات خارجی، یک ژورنال جعلی بسازد. برای ویژگی‌های مستندشده تشخیص دستکاری، از نقاط کنترل (checkpoints) جداگانه نگهداری‌شده یا یک شاهد مستقل استفاده کنید. نشانگر اکتشاف وضعیت فضای کاری محلی است. بازیابی یک فایل ZIP مدرک به تنهایی، شغل اکتشافی در حال انتظار یا جلسه تلگرام را بازیابی نمی‌کند. اگر ادامه شغل اصلی لازم است، از پشتیبان فضای کاری نگهداری کنید. --- # Telegram · روندها و عملیات‌ها Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/ عملیات روزانه پنل: حالت‌ها، دسته‌بندی‌های نظارت، پارامترها، اعلان‌ها، خروجی‌ها، پشتیبان‌گیری و ظرفیت. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) عملیات روزانه پنل: حالت‌ها، دسته‌بندی‌های نظارت، پارامترها، اعلان‌ها، خروجی‌ها، پشتیبان‌گیری و ظرفیت. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/deployment/) ![راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/assets/chapter-operate.svg) برای اولین اتصال، از [حساب‌ها و قالب‌های جلسه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/) استفاده کنید. برای توضیح نسخه‌های ذخیره شده، سیاست‌های رویداد و فواصل، به بخش [نحوه کارکرد جمع‌آوری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/) مراجعه کنید. این راهنما عملیات روزانه و بازیابی را پوشش می‌دهد. یک نصب مدیریت‌شده شامل فایل‌های **START-HERE.html** و **START-HERE.txt** در کنار لانچر آن است، همراه با لینک مخزن و دستوراتی که برای مسیر نصب آن سفارشی شده‌اند. `tgwitness guide --print` را از طریق SSH اجرا کنید، یا `tgwitness paths` را برای یافتن دایرکتوری داده واقعی اجرا کنید. یک نصب root systemd وضعیت خصوصی را زیر `/var/lib/tgwitness-…` ذخیره می‌کند؛ `/opt/tgwitness` برنامه را در خود جای داده است. برای یک تونل موقت مدیریت‌شده Cloudflare، `tgwitness tunnel off` دسترسی عمومی را قطع می‌کند در حالی که پنل محلی و مجموعه به کار خود ادامه می‌دهند. `tgwitness tunnel on` آن را فعال می‌کند؛ `tgwitness tunnel restart` یک اتصال تونل جدید ایجاد می‌کند. برای مشاهده آدرس فعلی آن از `tgwitness open` استفاده کنید. یک تنظیم خاموش صریح پس از راه‌اندازی مجدد سرویس باقی می‌ماند. `tgwitness stop` هم پنل و هم مجموعه را متوقف می‌کند. **در این صفحه** - [جریان کاری اپراتور](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/#operator-workflow) - [کار را بدون اشتراک‌گذاری کلید اصلی به اشتراک بگذارید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/#share-work-without-sharing-the-main-key) - [حالت‌های زمان اجرا](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/#runtime-modes) - [دسته‌بندی‌های نظارت](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/#monitoring-categories) - [اخطاریه‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/#notifications) - [چیدمان پنل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/#panel-layout) - [محیط‌های استقرار](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/#deployment-environments) - [بررسی‌ها و خروجی‌های راه‌اندازی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/#startup-checks-and-exports) - [نسخه‌برداری، بازیابی و وقفه‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/#backup-restore-and-interruptions) - [ظرفیت و نگهداری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/#capacity-and-retention) ## روند کاری اپراتور نمودار جریان · انتخاب ذخیره‌سازی و حفاظت از کلید → پنل را با توکن مربوطه باز کنید; پنل را با توکن مربوطه باز کنید → یک فضای کاری را انتخاب کنید; یک فضای کاری را انتخاب کنید → راه‌اندازی مسیر مستقیم یا پروکسی; راه‌اندازی مسیر مستقیم یا پروکسی → شماره تلفن را وارد کنید یا فایل‌ها/QR را انتخاب کنید; شماره تلفن را وارد کنید یا فایل‌ها/QR را انتخاب کنید → هویت حساب کاربری را بررسی کرده و گروه‌های قابل دسترسی را انتخاب کنید; هویت حساب کاربری را بررسی کرده و گروه‌های قابل دسترسی را انتخاب کنید → سیاست‌های ذخیره‌سازی رویداد و پیوست را ذخیره کنید، سپس مشاهده را آغاز کنید; سیاست‌های ذخیره‌سازی رویداد و پیوست را ذخیره کنید، سپس مشاهده را آغاز کنید → نظارت بر خطاها، دسترسی، صف‌ها و دیسک; نظارت بر خطاها، دسترسی، صف‌ها و دیسک → نگهداری نقاط کنترل مستقل; نگهداری نقاط کنترل مستقل → صادرات و تأیید محتوا · انتخاب ذخیره‌سازی وحفاظت از کلید · پنل را با توکن مربوطهباز کنید · یک فضای کاری را انتخابکنید · راه‌اندازی مسیر مستقیمیا پروکسی · شماره تلفن را واردکنید یا فایل‌ها/QR راانتخاب کنید · هویت حساب کاربری رابررسی کرده و گروه‌هایقابل دسترسی را انتخابکنید · سیاست‌های ذخیره‌سازیرویداد و پیوست راذخیره کنید، سپس مشاهدهرا آغاز کنید · نظارت بر خطاها،دسترسی، صف‌ها و دیسک · نگهداری نقاط کنترلمستقل · صادرات و تأیید محتوا **نمودار به صورت متن** 1. انتخاب ذخیره‌سازی و حفاظت از کلید → پنل را با توکن مربوطه باز کنید 2. پنل را با توکن مربوطه باز کنید → یک فضای کاری را انتخاب کنید 3. یک فضای کاری را انتخاب کنید → راه‌اندازی مسیر مستقیم یا پروکسی 4. راه‌اندازی مسیر مستقیم یا پروکسی → شماره تلفن را وارد کنید یا فایل‌ها/QR را انتخاب کنید 5. شماره تلفن را وارد کنید یا فایل‌ها/QR را انتخاب کنید → هویت حساب کاربری را بررسی کرده و گروه‌های قابل دسترسی را انتخاب کنید 6. هویت حساب کاربری را بررسی کرده و گروه‌های قابل دسترسی را انتخاب کنید → سیاست‌های ذخیره‌سازی رویداد و پیوست را ذخیره کنید، سپس مشاهده را آغاز کنید 7. سیاست‌های ذخیره‌سازی رویداد و پیوست را ذخیره کنید، سپس مشاهده را آغاز کنید → نظارت بر خطاها، دسترسی، صف‌ها و دیسک 8. نظارت بر خطاها، دسترسی، صف‌ها و دیسک → نگهداری نقاط کنترل مستقل 9. نگهداری نقاط کنترل مستقل → صادرات و تأیید محتوا مجازی‌سازی، اتصال حمل‌ونقل، دسترسی به گروه و کامل بودن تحویل، ویژگی‌های متفاوتی هستند. وضعیت اتصال سبز به این معنا نیست که همه رویدادها ضبط شده‌اند. ## اشتراک‌گذاری کار بدون اشتراک‌گذاری کلید اصلی **دسترسی** آزاد برای اعطای توکن اختصاصی به بازبین یا تحلیلگر. حساب‌ها و چت‌هایی را که می‌توانند باز کنند انتخاب کنید، سپس مشاهده، خروجی‌گیری یا اقدامات عملیاتی را مجاز سازید. اپراتوری که شروع/توقف جمع‌آوری را انجام می‌دهد به دسترسی کل فضای کاری نیاز دارد؛ یک بازبین می‌تواند به یک چت واحد محدود شود. محدودیت‌های جلسه، انقضا و قوانین IP از مجوز حساب تلگرام جدا هستند. [دسترسی‌ها و مجوزها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/) را ببینید. برای قطع یک اتصال یا لغو دسترسی، از **Open sessions** برای پایان دادن به تمام جلسات آن استفاده کنید. کنسول مدیر، فعالیت‌های فرآیند جاری را در سراسر فضاهای کاری ترکیب می‌کند. بستن جلسه، روند جمع‌آوری را متوقف نمی‌کند. ## حالت‌های اجرا | حالت | اقدام | رفتار | | --- | --- | --- | | دمو | scripts\Demo.cmd یا `--demo` | داده‌های ساختگی؛ ارتباطات حساب‌های واقعی غیرفعال شده | | مشاهده | شروع مشاهده | ثبت به‌روزرسانی‌های ارائه‌شده برای منابع منتخب | | لحظه‌نگاری تاریخچه | منابع → نمای کلی تاریخچه | حداکثر ۵۰۰ پیام فعلی؛ بدون بازسازی تمام تغییرات گذشته | | وقفه | مراقبه را متوقف کنید | متوقف کردن جمع‌آوری در حالی که داده‌ها و کارهای صف‌شده حفظ می‌شوند | | بازبینی/واگذاری | صادرات | ZIP، JSONL/CSV/HTML، نقطهٔ کنترل، رسید فرایند و درخواست مهر زمانی | | حساب‌های متعدد | فضاهای کاری یا دکمهٔ بالای **+** | هر تعداد فضای کاری مجزا در یک فرایند | دسترسی به دمو محلی به طور خودکار و بدون وارد کردن دستی توکن باز می‌شود. این قابلیت برای کل دوره عمر فرآیند استفاده می‌شود که فقط برای دسترسی مستقیم لوپ‌بک به یک دمو ایزوله و مصنوعی معتبر است؛ توکن پنل اصلی فاش نمی‌شود. فضاهای کاری واقعی و دسترسی از راه دور یا پروکسی‌شده به دمو، احراز هویت توکن را حفظ می‌کنند. ورود به دمو هیچ مجوز تلگرامی را اعطا نمی‌کند. ## دسته‌بندی‌های نظارت ![تنظیمات نظارت بر هر حساب با داده‌های منبع مصنوعی](https://phishdestroy.github.io/TgWitness/assets/sources.png) در بخش **منابع → ضبط، در قسمت «انتخاب تغییرات قابل نگهداری**»، پیام‌های جدید، ویرایش‌ها، اعلان‌های حذف، به‌روزرسانی‌های واکنش و رویدادهای عضویت را به‌طور مستقل انتخاب کنید. حالت پیش‌فرض همه دسته‌بندی‌ها را حفظ می‌کند. گزینه **«پیام‌ها، ویرایش‌ها و حذف‌ها»** متن اصلی را حفظ می‌کند، در حالی که به‌روزرسانی‌های جداگانه واکنش و اعضا را غیرفعال می‌نماید. گزینه **«تمام فعالیت‌های قابل مشاهده**» هر پنج مورد را بازیابی می‌کند. حالت‌های از پیش تعیین‌شده فرم را تغییر می‌دهند؛ برای اعمال، روی **«ذخیره تنظیمات ضبط**» کلیک کنید. سیاست ذخیره شده برای تمام منابع انتخاب‌شده در آن فضای کاری اعمال می‌شود. سایر فضاهای کاری تنظیمات خاص خود را حفظ می‌کنند. هر تغییر واقعی، مقادیر امضا شده قبل و بعد را ثبت می‌کند؛ سیاست فعلی نیز در رسیدهای فرآیند و سوابق شروع مشاهده گنجانده می‌شود. غیرفعال کردن یک دسته‌بندی، مشاهدات قبلی را حذف نمی‌کند. فعال کردن مجدد، تغییرات از دست رفته را بازیابی نمی‌کند. در این نسخه، امکان اولویت‌دهی دسته‌بندی بر اساس گروه وجود ندارد. وقتی محتوای قبلی اهمیت دارد، ثبت پیام‌های جدید را فعال نگه دارید: اعلان حذف نمی‌تواند متنی را که هرگز ثبت نشده است بازیابی کند. سوابق عملیاتی/پوشش و سایر رویدادهای خدمات گروهی همیشه حفظ می‌شوند. اسکرین‌شات‌های صریح تاریخچه از انتخاب دسته‌بندی زنده جدا هستند و ممکن است شامل پیام‌های خدماتی باشند. این سوئیچ‌ها، متادیتای واکنش/عضو را که در یک شیء تلگرام ضبط‌شده دیگر نهفته است، سانسور نمی‌کنند. یک اسنپ‌شات تاریخی ممکن است در حین توقف، پیوست‌ها را در صف قرار دهد. برای پردازش آن‌ها، مشاهده را آغاز کنید. قرار گرفتن در صف به معنای دانلود شدن نیست. یک فایل اصلی در دسترس نیست با نسخه ویرایش‌شده جدیدتر جایگزین نمی‌شود؛ نتایج به صورت جداگانه ثبت می‌شوند. **حالت قفل** دسترسی مرورگر و فیلدهای مخفی را قطع می‌کند اما جمع‌آوری را همچنان فعال نگه می‌دارد. بستن یک تب نیز فرآیند را فعال نگه می‌دارد. متوقف کردن فرآیند یا سرویس پایتون، جمع‌آوری را صرف‌نظر از وضعیت مرورگر متوقف می‌کند. حذف یک فضای کاری اضافی، گردآورنده آن را متوقف کرده و داده‌های محلی آن را حذف می‌کند. اگر یک خطای فایل قفل شده یا سیستم فایل، فرآیند حذف را قطع کند، پنل این خطا را گزارش داده و فضای کاری را همچنان به عنوان «در دسترس نیست» (`DeletionPending`) فهرست می‌کند. برنامه‌هایی را که فایل‌های آن را در اختیار دارند ببندید و **عملیات حذف را** دوباره امتحان کنید. راه‌اندازی مجدد TgWitness، آن فضای کاری را متوقف‌شده باقی می‌گذارد و دفترچه یادداشت یا کلیدهای نیمه‌حذف‌شده آن را بازسازی نمی‌کند. حذف موفقیت‌آمیز تنها پس از حذف دایرکتوری ثبت می‌شود؛ نسخه‌های صادرشده یا پشتیبان‌گیری‌شده جداگانه تحت سیاست نگهداری خود باقی می‌مانند. ## اخطاریه‌ها **افزونه‌ها → اخطاریه‌ها → پیکربندی** را باز کنید. TgWitness از Apprise برای ارسال اعلان‌ها به Matrix، Telegram، Discord، Slack، ntfy، ایمیل و سایر سرویس‌های پشتیبانی‌شده استفاده می‌کند. شما می‌توانید چندین مقصد را به یک فضای کاری اضافه کنید. 1. در هر خط یک URL مقصد Apprise را وارد کنید. از [کاتالوگ سرویس و فرمت‌های URL](https://appriseit.com/services/) برای سرویس خود استفاده کنید. 2. گزینه **«ارسال اعلان‌ها»** را فعال کنید، سپس هشدارهای مشکل، تغییرات در چت‌های مشاهده‌شده و یک خلاصه روزانه را انتخاب کنید. ساعت خلاصه بر اساس زمان سرور است. 3. اگر می‌خواهید متن ذخیره شده از پیام‌های حذف‌شده و ویرایش‌شده در هشدارها نمایش داده شود، گزینه «**شامل گزیده‌های کوتاه**» را فعال کنید. 4. روی **«ذخیره اعلان‌ها»** کلیک کنید، سپس **«ارسال آزمایشی» را** برای بررسی تحویل ارسال کنید. برای گیرنده خودتان، از [وب‌هوک JSON](https://appriseit.com/services/json/) اپرایز استفاده کنید. برای مثال، `jsons://notify.example.org/tgwitness` JSON را از طریق HTTPS به آن نقطه پایانی ارسال می‌کند. این یک مثال فرضی است؛ آن را با مقصد خود جایگزین کنید. مقاصد و تنظیمات به فضای کاری انتخاب‌شده تعلق دارند. تغییر اعلان‌ها منابع تحت نظر آن، از جمله چت‌های جدیداً اضافه شده را پوشش می‌دهد. زنگ در نوار بالا همچنین مشکلات اخیر و تغییرات چت را فهرست می‌کند. در نسخه نمایشی، کنترل‌های اعلان قابل مشاهده هستند اما ارسال غیرفعال است. تحویل را در یک فضای کاری واقعی پیکربندی کنید. اعلان‌ها از مسیر مستقیم، SOCKS5 یا HTTP آن فضای کاری استفاده می‌کنند؛ MTProxy قادر به انتقال آن‌ها نیست. مقاصد غیر HTTP مانند SMTP به یک مسیر مستقیم نیاز دارند. ## چیدمان پنل ![فضای کاری اتصال با استفاده از داده‌های مصنوعی](https://phishdestroy.github.io/TgWitness/assets/connection.png) **ژورنال** مشاهدات، جستجو و فیلترها را نشان می‌دهد. ویرایش، نسخه‌های ضبط‌شده را باز می‌کند؛ حذف، در صورت موجود بودن، محتوای قبلی را باز می‌کند. انتساب ناشناخته صراحتاً مشخص باقی می‌ماند. شمارش‌ها در **بخش «نمای کلی»** موجود هستند؛ جزئیات به‌دست‌آوردن در راهنمای محلی باقی می‌ماند. یک پیام ویرایش‌شده را باز کنید تا نسخه‌های آن را با **تغییرات در متن** یا **کنار هم** مقایسه کنید؛ **دادهٔ خام** فیلدهای ذخیره‌شده را نشان می‌دهد. تغییرات در پیوندهای مخفی و دکمه‌های ربات به‌صورت جداگانه نمایش داده می‌شوند. برای بررسی تصاویر، صداها یا ویدیوهای ذخیره‌شده، پیش‌نمایش پیوست را باز کنید؛ دکمهٔ دانلود، فایل اصلی حفظ‌شده را در دسترس نگه می‌دارد. وضعیت **Live** با رسیدن رکوردها، گزارش وقایع و گفتگوها را به‌روزرسانی می‌کند. هنگام بررسی آن را متوقف کنید، یا زمانی که آماده بودید از دکمهٔ رویدادهای جدید استفاده کنید؛ گردآوری داده‌ها همچنان ادامه می‌یابد. میانبر **Ctrl/Cmd+K** اقدامات پنل را پیدا کرده و در گزارش وقایع جستجو می‌کند. **منابع** شامل دامنه مشاهده (گفت‌وگوهای انتخاب‌شده، یک پوشه تلگرام یا کل حساب)، گفت‌وگوهای قابل دسترسی از هر نوع، منابع منتخب با ستاره‌های اولویت‌بندی، تنظیمات پیوست و بازبینی مجدد و نمایه‌های تاریخچه هستند. منابع خصوصی با دیالوگ/ID بدون لینک عمومی انتخاب می‌شوند. وضعیت دسترسی، جدیدترین بررسی را توصیف می‌کند، نه مجوزهای دائمی. منابع را فیلتر کنید، کادرهای انتخاب آن‌ها را علامت بزنید، سپس همه را با هم فعال، متوقف یا به‌عنوان اولویت‌دار علامت‌گذاری کنید. در فهرست گفتگوهای موجود، **افزودن موارد انتخاب‌شده** از انتخاب شما استفاده می‌کند؛ **افزودن همهٔ موارد مطابق** از فیلتر جستجو و نوع فعلی استفاده می‌کند. **چت‌ها → افراد،** همه کسانی را که پیام‌های ذخیره‌شده دارند فهرست می‌کند؛ با فعال بودن پروفایل افراد برای چت، یک کلیک پروفایل آن شخص را با لینک‌هایی به سوابق دفترچه یادداشت باز می‌کند. **ویژنس** توکن‌های ویژنس فقط-خواندنی ایجاد می‌کند، نشان می‌دهد هر ویژنس آخرین بار چه زمانی بررسی شده و دستورات و گزینه‌های لازم برای اجرای یک ویژنس ([ویژنس مستقل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/)) را ارائه می‌دهد. **پارامترها** تمام محدودیت‌ها و سرعت‌های فضای کاری را که در صفحه دیگری قرار ندارند، در خود جای می‌دهند: چند دیالوگ خوانده می‌شود، لیست چت‌ها هر چند وقت یک‌بار دوباره خوانده می‌شود، فواصل زمانی تپش قلب و نقطه‌کنترل، بافر راه‌اندازی، نحوه پخش درخواست‌های بازپروژه (اولین تأخیر، چت‌ها در هر pass، مکث بین چت‌ها، پیام‌های بازیابی‌شده و مجدداً درخواست‌شده)، رزرو دیسک، زمان‌های اتمام صبر و تلاش‌های مجدد دانلودها، پروفایل افرادی که جستجو می‌شوند (شامل عبارت‌های منظم خودتان)، اندازه و سرعت اعلان‌ها، محدودیت‌های اسنپ‌شات، زیپ و دانلود از مرورگر، و زمان‌های اتمام صبر و تلاش‌های مجدد کلاینت تلگرام. هر فیلد بازه و مقدار پیش‌فرض خود را نشان می‌دهد؛ فیلدهای تغییر یافته علامت‌گذاری شده و می‌توان آن‌ها را تک‌تک یا همگی با هم بازگرداند. هر تغییر به صورت `parameters.changed` به همراه مقادیر قبل و بعد از آن ثبت می‌شود، و سوابق شروع مشاهده، مقادیر اعمال شده را نام می‌برند. مقادیر از اولین استفاده بعدی اعمال می‌شوند؛ تایم‌اوت‌ها و تلاش‌های مجدد کلاینت از اتصال بعدی. بازه‌های بازبینی مجدد، انواع و اندازه‌های پیوست، شواهد و بازه‌های کپی خارج از سایت در صفحات مخصوص به خود باقی می‌مانند و می‌توانند هر مقداری را در بازه خود بپذیرند، نه فقط مقادیر از پیش تعیین‌شده. زنگوله در نوار بالا، مشکلات و تغییرات اخیر در چت‌های مشاهده‌شده را فهرست می‌کند؛ پیام‌های نخوانده تا زمانی که به‌عنوان خوانده‌شده علامت‌گذاری نشوند، شمارش می‌شوند. تغییرات بر اساس هر چت و ساعت گروه‌بندی می‌شوند («۱۲ پیام حذف‌شده، ۱ پیام ویرایش‌شده، ۰ پیام یافت‌نشده») و مشکلاتی مانند خروج از سیستم یا پر شدن دیسک، صرف‌نظر از میزان شلوغی چت‌ها، در لیست باقی می‌مانند. **بخش حساب کاربری** از فیلد شماره تلفن شروع می‌شود. **ادامه دادن** مستقیماً به وارد کردن کد می‌انجامد و فقط در صورت عدم وجود، برای ورود اطلاعات اعتبارنامه API درخواست می‌کند. تب‌های وارد کردن کد QR و فایل، گزینه‌های جایگزین هستند. اعتبارنامه‌های API ذخیره شده فقط در فضای کاری خود قابل استفاده مجدد هستند. صفحه ورود، نوار کناری، آمار یا بخش‌های راه‌اندازی ندارد. آیکون تنظیمات، کنترل‌های API، پروکسی، ذخیره‌سازی و حساب‌های اضافی را باز می‌کند. نصب‌های جدید از اینجا شروع می‌شوند؛ حساب‌های متصل بدون منابع انتخاب‌شده از صفحه **«انتخاب چت‌ها**» شروع می‌شوند. تغییر مسیر نیازمند توقف مشاهده است و ورود ناکامل را لغو می‌کند. یک ژورنال موجود را نمی‌توان بی‌سروصدا به حساب تلگرام دیگری پیوند داد. **عملیات خروجی،** یکپارچگی دفترچه را بررسی کرده و فایل‌های قابل حمل تولید می‌کند. شناسه فضای کاری آن را می‌توان به خط فرمان دانلود (CLI) ارسال کرد. هر عملیات خروجی یک پیش‌وند کامل برای دفترچه ثبت می‌کند؛ رویدادهای بعدی در یک عملیات خروجی بعدی وارد می‌شوند. فیلترهای جستجو، دامنه بسته را تغییر نمی‌دهند. اطلاعات دقیق امضا و پوشش در بخش **«تأیید و محدودیت‌ها»** موجود است. پنل، وضعیت کلکتور، رسانه‌های صف‌شده/ناموفق، قدیمی‌ترین رسانه در انتظار، فضای آزاد دیسک، مکث‌های درخواست و منابعی را که دسترسی‌شان تأیید نشده است، تحت عنوان **«وضعیت سلامت کلکتور»** گزارش می‌دهد. این جزئیات در ابتدا جمع‌شده و در بخش «حساب» پنهان هستند. یک کارت تنظیمات، گام بعدی را نشان می‌دهد: اتصال یک حساب، انتخاب منابع یا شروع مشاهده. فهرست حساب‌ها یک نمای مقطعی در زمان بارگذاری است؛ فضای کاری انتخاب‌شده به‌طور دوره‌ای تازه‌سازی می‌شود. این یک مانیتور SLA چندفرآیندی نیست. رابط کاربری از دارایی‌های محلی و رندر متن برای محتوای منبع استفاده می‌کند. نسخه‌های دسکتاپ و باریک کرومیم آزمایش شده‌اند. این یک گواهی کامل دسترسی‌پذیری نیست؛ ارزیابی قابلیت استفاده برای خواناهای صفحه و انسان‌ها به صورت کارهای جداگانه‌ای باقی می‌مانند. ## محیط‌های استقرار | محیط | نصب | وضعیت تأیید | | --- | --- | --- | | رایانهٔ رومیزی/سرور ویندوز | پایتون ۳.۱۱+، scripts\Setup.cmd/Start.cmd، دایرکتوری داده‌های خصوصی | محلی بررسی‌شده روی ویندوز/پایتون ۳.۱۲ | | سرور لینوکس/VPS | محیط مجازی پایتون (venv)، کاربر سرویس اختصاصی، HTTPS/SSH | نمونهٔ کد، CI و systemd ارائه شده؛ روی این میزبان اجرا نشده است | | macOS | محیط مجازی پایتون (venv)، فرآیند پیش‌زمینه یا عامل کاربر | نمونه‌ای از launchd ارائه شده؛ نیاز به بررسی نصب جداگانه دارد | | داکر/کامپوز | حجم پایدار، یک کارگر | تعریف و بررسی زمان اجرای CI ارائه شده؛ Docker به‌صورت محلی در دسترس نیست | | مرورگر تلفن | اتصال به پنل محافظت‌شده روی یک سرور در حال اجرا | قالب باریک کرومیم آزمایش شده؛ جمع‌آورنده روی iOS/Android اجرا نمی‌شود | قابلیت حمل به این معنی است که هیچ سرویس ابری اجباری یا ساخت فرانت‌اند لازم نیست. هر هدف همچنان به وابستگی‌های سازگار پایتون/رمزنگاری، دسترسی به درایو محلی و شبکه نیاز دارد. به [DEPLOYMENT.md](https://phishdestroy.github.io/TgWitness/fa/docs/reference/deployment/) و [قالب‌های سرویس](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) مراجعه کنید. محیط‌های کاری CPU، حافظه و حلقه رویداد را به اشتراک می‌گذارند. برای جداسازی فرآیندها، از نسخه‌های مجزا، پورت‌ها، دایرکتوری‌های داده و مجوزهای حساب کاربری متمایز استفاده کنید. هیچ پنل یکپارچه‌ای در میان نسخه‌های جداگانه وجود ندارد. هرگز چندین کارگر را به یک پایگاه داده متصل نکنید. ## بررسی‌ها و خروجی‌های استارتاپ قبل از راه‌اندازی یک محیط آماده، دستور `python start.py --check` را اجرا کنید. برای بررسی‌های قابل خواندن توسط ماشین، `--json` را اضافه کنید یا مقادیر `--data-dir`، `--host` و `--port` مورد نظر را ارسال کنید. این دستور، بدون نیاز به ورود به تلگرام یا ایجاد یک ژورنال، پیش‌نیازها را بررسی می‌کند. این دستور، ژورنال را تأیید اعتبار نمی‌کند و آمادگی برای ضبط را اثبات نمی‌کند؛ تأیید اعتبار ژورنال در حین راه‌اندازی برنامه انجام می‌شود. یک پورت اشغالی ممکن است صرفاً یک نمونه موجود باشد. مرورگرهایی که از API دسترسی به سیستم فایل پشتیبانی می‌کنند، خروجی‌ها را از طریق یک جریان قابل نوشتن ذخیره می‌کنند. سایر مرورگرها حداکثر ۱۲۸ مگابایت بافر می‌کنند. برای خروجی‌های بزرگ‌تر یا مرورگرهایی که فاقد پخش فایل هستند، از CLI پخش استفاده کنید: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` برای یک فضای کاری فرزند، `--profile ID` را از خروجی‌ها اضافه کنید. برای دسترسی از راه دور از `--url https://server` استفاده کنید. HTTP ساده فقط برای مقاصد لوپ‌بک پذیرفته می‌شود. توکن از یک فایل خوانده شده و در یک هدر ارسال می‌شود، نه اینکه چاپ شود یا در URL قرار گیرد. هدایت‌ها رد می‌شوند. مقاصد موجود بازنویسی نمی‌شوند. انتقالات ناموفق، فایل موقت بخش خود را حذف می‌کنند. SHA-256 گزارش‌شده یک چک‌سام انتقال است؛ فایل ZIP امضا شده را به‌طور جداگانه با یک اثر انگشت/نقطه کنترل مورد اعتماد تأیید کنید. ## پشتیبان‌گیری، بازیابی و وقفه‌ها 1. مشاهده را متوقف کرده و فرایند را به‌طور تمیز متوقف کنید. 2. کل دایرکتوری داده را کپی کنید: پایگاه‌های داده، WAL/SHM در صورت وجود، رسانه، `credentials.enc`، `signing.enc`، `network.enc`، کلیدها/متادیتای گاوصندوق، توکن، نقاط کنترل و هر دایرکتوری `profiles/`. 3. برای حالت کلید خارجی، کلید اصلی را به‌طور جداگانه حفظ کرده و هر `vault.external.json` را نگه دارید. تولید کلید جدید امکان بازیابی اسرار قدیمی را فراهم نمی‌کند. 4. حین توقف مقصد بازیابی کنید؛ کلید اصلی را پیکربندی کنید، دسترسی را محدود کنید و پیش از ازسرگیری، یکپارچگی را تأیید کنید. 5. ثبت زمان‌های از کار افتادگی و نتایج تأیید. یک نمای کلی از تاریخچه نمی‌تواند اثبات کند که هیچ حذفی در طول وقفه رخ نداده است. فایل‌های فشرده Evidence شامل جلسات/کلیدهای خصوصی نیستند و پشتیبان‌گیری کامل سرویس نیستند. چهار مورد به شیوه‌ای متفاوت محافظت می‌شوند: | چه | حفاظت | | --- | --- | | فایل‌های خروجی بدون رمز عبور (پیش‌فرض) | رمزگذاری نشده است. امضا شده است، بنابراین تغییرات قابل تشخیص هستند، اما هر کسی که فایل را در اختیار داشته باشد می‌تواند آن را بخواند. | | فایل‌های خروجی با رمز عبور | اگر رمز عبور تعیین کنید، خروجی نهایی بدون تغییر در یک فایل ZIP با رمزگذاری AES-256 WinZip ذخیره می‌شود که توسط 7-Zip و WinRAR باز می‌شود؛ رمز عبور ذخیره نمی‌شود ([مدیریت شواهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/)) | | پایگاه دادهٔ ژورنال و پیوست‌های ذخیره‌شده روی دیسک | توسط TgWitness رمزگذاری نشده است؛ از دیسک یا حجم رمزگذاری‌شده استفاده کنید | | جلسات تلگرام و کلیدهای امضا | رمزگذاری‌شده در دایرکتوری داده‌ها (`credentials.enc`، `signing.enc`، `network.enc`) | یک پشتیبان‌گیری کامل سرویس، همان دایرکتوری داده‌های متوقف‌شده‌ای است که در بالا توضیح داده شد، نه یک خروجی (export). برای هر دو از ذخیره‌سازی محافظت‌شده و یک مکانیزم انتقال سنجیده استفاده کنید. خروجی‌های موقت سرور در `temporary-exports/` هر فضای کاری قرار دارند؛ پاسخ‌های تکمیل‌شده پاک می‌شوند و فایل‌های خروجی قطع‌شده هنگام راه‌اندازی بعدی، در حالی که قفل نمونه آن فضای کاری فعال است، حذف می‌گردند. رویداد بازیابی اتصال، بازیابی تغییرات میانی را تضمین نمی‌کند. وظایف رسانه‌ای پایدار و موقعیت به‌روزرسانی تلگرام پس از راه‌اندازی مجدد باقی می‌مانند؛ به [فرمت شواهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#durable-collection-and-process-receipts-02) مراجعه کنید. ## ظرفیت و نگهداری محدودیت‌های پیش‌فرض، همگی قابل تغییر در **بخش پارامترها**: ۱۰۰۰ دیالوگ اول، ۵۰۰ پیام در هر اسنپ‌شات، ۴ گیگابایت محتوای فشرده‌نشده ZIP امضا شده (آرشیوهای بزرگ‌تر به `verify.py --max-gib N` نیاز دارند) و یک پشتیبان ۱۲۸ مگابایتی مرورگر. پیوست‌ها به ازای هر نوع در **بخش Sources → Attachments،** بین ۱ تا ۲٬۰۰۰ مگابایت (MiB) فضا اشغال می‌کنند. خط فرمان دانلود (CLI) به طور پیش‌فرض ۵ گیگابایت (GiB) انتقال داده را تنظیم می‌کند. فضای در دسترس دیسک می‌تواند محدودیت کمتری داشته باشد. فضایی را برای ژورنال‌ها، رسانه‌ها، WAL، خروجی‌های موقت و پشتیبان‌ها رزرو کنید. خروجی‌ها به جای `/tmp`، از حجم داده استفاده می‌کنند. رویدادها در ثانیه، سن صف، بایت‌های رسانه و تأخیر دیسک را اندازه‌گیری کنید، نه صرفاً شمارش گروه‌ها. بنچمارک‌های محلی مصنوعی تحویل تلگرام را تضمین نمی‌کنند. هیچ حذف خودکار نگهداری‌شده‌ای وجود ندارد. حذف انتهای ژورنال، رابطه آن را با نقاط کنترل نگهداری‌شده باطل می‌کند. بازبینی‌های اولویت‌دار از پیش وجود دارند: منابع ستاره‌دار به طور پیش‌فرض هر ۱۵ دقیقه یک‌بار بازبینی مجدد می‌شوند، سایر منابع هر ۶ ساعت یک‌بار (به [سطوح بازبینی مجدد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#recheck-tiers) مراجعه کنید). خروجی‌های محافظت‌شده با رمز عبور همان‌طور که در بالا توضیح داده شد، وجود دارند. پذیرش زنده تلگرام/پراکسی، بازپخش پایدار، سوابق مدیر و نظرسنجی واکنش، کارگران ایزوله، رمزگذاری دفترچه محلی و رسانه‌ها توسط خود TgWitness و بازبینی مستقل، کارهای جداگانه‌ای باقی می‌مانند. دسترسی محدود در [بخش دسترسی‌ها و مجوزها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/) مستندسازی شده است. به [فایل‌های READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md)، [LIVE_ACCEPTANCE.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md) و [VERIFICATION.md](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/) مراجعه کنید. --- # Telegram · حالت تحقیق Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/ تحقیقات کل حساب در سراسر کانال‌ها، گروه‌ها، چت‌های خصوصی و ربات‌ها، از دامنه تا بستهٔ پروندهٔ تأییدشده. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) تحقیقات کل حساب در سراسر کانال‌ها، گروه‌ها، چت‌های خصوصی و ربات‌ها، از دامنه تا بستهٔ پروندهٔ تأییدشده. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![تحقیق](https://phishdestroy.github.io/TgWitness/assets/chapter-investigate.svg) یک پرونده را در سراسر کانال‌ها، گروه‌ها، چت‌های خصوصی و ربات‌ها، از دریافت اولیه تا یک خط زمانی مستند و تحویل قابل تأیید دنبال کنید. نسخه وب‌سایت تعاملی در `/docs/cases/` موجود است؛ [دستورالعمل‌های پیش‌نمایش](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally). **در این صفحه** - [مورد بررسی: مقصد در چهار گفتگو تغییر می‌کند](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/#worked-case-a-destination-changes-across-four-conversations) - [1. تعریف مورد و جمع‌آوری کل پرونده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/#1-define-the-case-and-collect-the-whole-account) - [2. فهرست هر منبع را تهیه کرده و زمینهٔ تاریخی آن را به‌دست آور](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/#2-inventory-every-source-and-acquire-historical-context) - [3. حفظ حالت در حال تحول و تعاملات عمدی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/#3-preserve-the-evolving-case-and-deliberate-interactions) - [4. اتصال مشاهدات در سراسر چت‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/#4-connect-observations-across-chats) - [5. خط زمانی میان‌گفتگو را بسازید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/#5-build-the-cross-chat-timeline) - [6. افزودن دیدگاه‌های حساب کاربری بدون از دست دادن منشأ آن‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/#6-add-account-perspectives-without-losing-their-origin) - [7. مونتاژ و تأیید انتقال پرونده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/#7-assemble-and-verify-the-case-handoff) - [تحقیق را تطبیق دهید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/#adapt-the-investigation) ## مورد بررسی: تغییر مقصد در چهار گفتگو یک اعلان به یک ربات اشاره می‌کند. یک گروه عملیاتی یک مقصد پرداخت جدید را مورد بحث قرار می‌دهد و صفحه‌کلید ربات آن را نمایش می‌دهد. اعلان ویرایش می‌شود، یک پیام خصوصی پیگیری مقصد را تکرار می‌کند و یک پیام گروهی ناپدید می‌شود. سؤالات این هستند: چه چیزهایی قبل و بعد از تغییر مشاهده شد، کدام حساب‌های تلگرام هر مورد را ارسال کردند، مقصد در کجا ظاهر شد، کدام بایت‌های ضمیمه حفظ شدند و چه بازه‌های زمانی هنوز نامشخص هستند؟ تمام نام‌ها، شناسه‌ها، زمان‌ها و ارجاعات دفترچه در این مثال فرضی هستند. گردش کار از ویژگی‌های فعلی استفاده می‌کند؛ نقشه پرونده یک تصویر است، نه یک گراف خودکار تولیدشده توسط برنامه. نمودار جریان · کانال‌ها → مجلهٔ فضای کاری; گروه‌ها → مجلهٔ فضای کاری; چت‌های خصوصی → مجلهٔ فضای کاری; ربات‌ها → مجلهٔ فضای کاری; مجلهٔ فضای کاری → جستجو در همه منابع; مجلهٔ فضای کاری → پروفایل افراد همراه با ارجاعات سوابق; مجلهٔ فضای کاری → نسخه‌های ذخیره شده و رسیدهای پیوست; جستجو در همه منابع → خط زمانی تحلیلگر و ثبت منابع; پروفایل افراد همراه با ارجاعات سوابق → خط زمانی تحلیلگر و ثبت منابع; نسخه‌های ذخیره شده و رسیدهای پیوست → خط زمانی تحلیلگر و ثبت منابع; مجلهٔ فضای کاری → فایل ZIP شواهد امضا شده; خط زمانی تحلیلگر و ثبت منابع → واگذاری پرونده همراه با شواهد جداگانهٔ تأییدشده; فایل ZIP شواهد امضا شده → واگذاری پرونده همراه با شواهد جداگانهٔ تأییدشده · کانال‌ها · گروه‌ها · چت‌های خصوصی · ربات‌ها · مجلهٔ فضای کاری · جستجو در همه منابع · پروفایل افراد همراه باارجاعات سوابق · نسخه‌های ذخیره شده ورسیدهای پیوست · فایل ZIP شواهد امضا شده · خط زمانی تحلیلگر و ثبتمنابع · واگذاری پرونده همراه باشواهد جداگانهٔ تأییدشده **نمودار به صورت متن** 1. کانال‌ها → مجلهٔ فضای کاری 2. گروه‌ها → مجلهٔ فضای کاری 3. چت‌های خصوصی → مجلهٔ فضای کاری 4. ربات‌ها → مجلهٔ فضای کاری 5. مجلهٔ فضای کاری → جستجو در همه منابع 6. مجلهٔ فضای کاری → پروفایل افراد همراه با ارجاعات سوابق 7. مجلهٔ فضای کاری → نسخه‌های ذخیره شده و رسیدهای پیوست 8. جستجو در همه منابع → خط زمانی تحلیلگر و ثبت منابع 9. پروفایل افراد همراه با ارجاعات سوابق → خط زمانی تحلیلگر و ثبت منابع 10. نسخه‌های ذخیره شده و رسیدهای پیوست → خط زمانی تحلیلگر و ثبت منابع 11. مجلهٔ فضای کاری → فایل ZIP شواهد امضا شده 12. خط زمانی تحلیلگر و ثبت منابع → واگذاری پرونده همراه با شواهد جداگانهٔ تأییدشده 13. فایل ZIP شواهد امضا شده → واگذاری پرونده همراه با شواهد جداگانهٔ تأییدشده ## ۱. پرونده را تعریف کنید و کل حساب را جمع‌آوری کنید 1. حساب جمع‌آوری را در فضای کاری اختصاصی خود متصل کنید. در [Case Board](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/) یا دفتر پرونده خود، مرجع پرونده، شناسه حساب، فضای کاری و شروع مشاهده را ثبت کنید. اثر انگشت کلید امضای مورد اعتماد را به‌طور مستقل نگهداری کنید. 2. برای یک حساب جمع‌آوری اختصاصی، **Sources → Observation scope → Investigation mode** را باز کنید. پیش‌تنظیم، **کل حساب**، کانال‌ها/گروه‌ها/چت‌های خصوصی/ربات‌ها، اقدامات خود، پروفایل‌های منبع و ۲۰۰ پیام قابل مشاهده اخیر را برای منابع تازه‌کشف‌شده انتخاب می‌کند. آن را بررسی کنید، دکمه **«ذخیره محدوده**» (**Save scope**) را فشار دهید و تأیید محدوده را تکمیل کنید. حساب‌های اصلی از چت‌های انتخاب‌شده یا یک پوشه استفاده می‌کنند؛ جمع‌آوری کل حساب برای حساب‌هایی که برای تحقیق علامت‌گذاری شده‌اند، در دسترس است. 3. **گفت‌وگوها را بارگذاری کرده** و منابع را با فهرست دیالوگ حساب کاربری مقایسه کنید. موارد مستثنی را بررسی کنید. **پارامترها → چت‌های خوانده‌شده از لیست حساب** به‌طور پیش‌فرض روی 1000 تنظیم شده و تا 20000 را مجاز می‌داند. منابعی که فراتر از حد لیست هستند، هنگام فعال شدن اضافه می‌شوند. آنچه واقعاً فهرست شده را ثبت کنید. 4. در **تنظیمات ضبط**، **«تمام فعالیت‌های قابل مشاهده**» را انتخاب کرده و تنظیمات نظارت را ذخیره کنید. انواع/محدودیت‌های پیوست‌ها و فضای آزاد دیسک را بررسی کنید. 5. شروع مشاهده. یک پیام جدید کنترل‌شده، ویرایش و حذف را اعتبارسنجی کنید، سپس مراجع آزمایشی و هرگونه خطا را نگهداری کنید. دامنه کل حساب، فعالیت‌های قابل مشاهده در حساب را مطابق با تنظیمات ذخیره‌شده ثبت می‌کند. این ابزار به چت‌های مخفی دسترسی ندارد یا به طور خودکار به همه گروه‌های مرتبط نمی‌پیوندد. همچنین همه گفتگوهای موجود را به صورت کامل ثبت نمی‌کند. [دامنه جمع‌آوری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account)را ببینید. ## ۲. فهرست کردن هر منبع و به‌دست آوردن زمینهٔ تاریخی یک دفتر ثبت منابع را با یک سطر برای هر گفتگو نگهداری کنید: | میدان | ثبت | | --- | --- | | هویت | فضای کاری، شناسه حساب، شناسه عددی چت، عنوان و نوع | | دیده‌شدن | عضویت/نقش، دسترسی تأییدشده یا تأییدنشده، استثناها | | ضبط زنده | زمان شروع، انواع رویدادهای انتخاب‌شده و تغییرات بعدی سیاست‌ها | | تاریخچه ژورنال | اسنپ‌شات درخواست/تکمیل‌شده، محدودیت، زمان و ارجاعات سوابق | | تاریخچهٔ کامل | نام فایل خروجی امضا شده برای هر گفتگو، مرز و تکمیل/عدم تکمیل | | پیوست‌ها | رسیدهای کامل رسانه، هش‌ها، اندازه‌ها و نتایج ردشده/ناموفق | | پوشش | قطعی‌ها، دریافت ناقص، FloodWait، پیام‌های در دسترس نبوده و سایر شکاف‌ها | برای هر منبع، روش ضبط مناسب را به‌کار ببرید: - **بارگذاری کامل تاریخچه** در **«منابع**»، پیام‌های گذشتهٔ موجود از منابع فعال را در دفتر کار بارگذاری می‌کند. این قابلیت از توقف/ادامه و گزارش پیشرفت امضا‌شده پشتیبانی می‌کند. به [بخش «تأمین تاریخچه»](https://phishdestroy.github.io/TgWitness/fa/docs/reference/history/) مراجعه کنید. - **اسنپ‌شات تاریخچه** پیام‌های قابل مشاهده اخیر را در دفتر مشاهدات ذخیره می‌کند. حداکثر پیش‌فرض آن ۵۰۰ است؛ در بخش **پارامترها → بزرگ‌ترین اسنپ‌شات تاریخچه** می‌توان آن را تا ۱۰٬۰۰۰ افزایش داد. این‌ها مشاهدات تاریخچه جاری هستند، نه ویرایش‌های بازسازی‌شده. - **صادرات کامل چت → خروجی گرفتن کل چت**، یا **چت‌ها → خروجی گرفتن چت**، تاریخچهٔ در حال حاضر قابل مشاهدهٔ یک چت را در یک بستهٔ جداگانهٔ امضا شده با کلید `chat.json` / `chat.html` فراخوانی می‌کند. این کار را برای منابع پرونده تکرار کرده و هر نتیجه را نگه دارید. - **وقتی یک چت یا ربات جدید ظاهر می‌شود**، می‌تواند پروفایل آن و تا ۱۰۰۰ پیام اخیر را ذخیره کند؛ حالت تحقیقاتی ۲۰۰ پیام را انتخاب می‌کند. چت‌های موجود هنگام فعال‌سازی این حالت به‌صورت گذشته‌نگر این حجم را دریافت نمی‌کنند. - **دانلود پیوست‌های قابل مشاهده،** بایت‌ها را طبق سیاست پیکربندی‌شده حفظ می‌کند. نیاز به یک رسید تکمیل‌شده `media.saved` با SHA-256 و شمارش بایت دارد. یک job صف‌شده، تصویر بندانگشتی یا نام فایل، پیوست حفظ‌شده نیست. خروجی کامل چت، دفترچه یادداشت یا پروفایل افراد را با تمام پیام‌های آن پر نمی‌کند. برای تاریخچه‌ای که نیاز به تحلیل آن در داخل TgWitness دارید، از **«بارگذاری تاریخچه کامل»** یا «اسنپ‌شات‌های محدود دفترچه یادداشت» استفاده کنید. پیش از شروع اجرای تاریخچه، فهرست منابع فعال را بررسی کنید. هیچ‌یک از این دو روش، محتوایی را که تلگرام دیگر بازنمی‌گرداند، بازیابی نمی‌کنند. ## ۳. حفظ روند پرونده در حال تحول و تعاملات سنجیده چت‌های فعال پرونده‌های ستاره دار را به عنوان منابع اولویت‌دار در نظر بگیرید. فواصل بازبینی مجدد، پیگیری مداوم و نتایج رسانه‌ای را بررسی کنید. هنگام استفاده از حساب کاربری، گردآورنده را در حال مشاهده نگه دارید. از مسیر **چت‌ها → پروفایل → ذخیره کردن پروفایل اکنون** استفاده کنید تا متادیتای منبع مانند توضیحات و دستورات ربات را حفظ کنید. این کار با پروفایل‌های افراد که از پیام‌های ذخیره شده استخراج می‌شوند، متفاوت است. در مواردی که پرونده شامل دنبال کردن یک منبع یا تعامل با یک ربات باشد: 1. **باز کردن لینک تلگرام ← ذخیره پیش‌نمایش** لینک ارائه‌شده و پیش‌نمایش بازگردانده‌شده را پیش از انجام عملیات ذخیره می‌کند. 2. **دستور /open و observe** عمل join/open را انجام می‌دهد و در صورت ارائه پارامتر start، آن را برای بات ارسال می‌کند. یک درخواست پیوست که در انتظار تأیید است، به‌عنوان در انتظار ثبت می‌شود. 3. پاسخ‌های متنی صادرشده توسط پنل و دکمه‌های پشتیبانی‌شده، `interaction.requested` و `interaction.result` را حفظ می‌کنند. رسیدهای تماس بازگشتی می‌توانند متن پاپ‌آپ بازگشتی، وضعیت هشدار و URL را حفظ کنند. این‌ها اقدامات واقعی حساب کاربری هستند. فشردن دکمه‌های کال‌بک در اپلیکیشن تلگرام دیگر برای گردآورنده قابل مشاهده نیست، هرچند پیام‌ها یا ویرایش‌های حاصل از آن ممکن است قابل مشاهده باشند. مینی-کلاینت گردش کارهای وب‌اپلیکیشن، پرداخت، تماس تلفنی یا مکان‌یابی را انجام نمی‌دهد. برای رفتار دقیق، به [تعاملات پنل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/#act-from-the-panel) مراجعه کنید. ## ۴. پیوند مشاهدات در سراسر چت‌ها در **«ژورنال**»، **«تمام منابع»** را انتخاب کرده و محتوای ضبط‌شده را جستجو کنید. سوابق مطابقت‌یافته را باز کرده و فضای کاری، چت، شناسه پیام، توالی و هش رکورد را حفظ کنید. در یک چت مرتبط، **«افراد» را** باز کنید **→ «پروفایل‌ها» را روشن کنید** و یک شخص را بررسی کنید: - نام‌ها/نام‌های کاربری مشاهده‌شده در طول زمان و شناسه عددی تلگرام. - پاسخ با روابط مرجع به رکورد منبع. - **همچنین در…** سایر گفتگوهای این دفترچهٔ کاری که آن شناسه در آن‌ها نوشته است. - فعالیت‌ها، ویرایش‌ها/حذف‌ها و کیف‌پول‌ها، تلفن‌ها، نام‌های کاربری و لینک‌های ذکرشده. - متادیتای آواتارهای ذخیره شده و آواتارهای کش‌شده مشابه، با منشأ جداگانهٔ هر یک. پیش از استفاده از یک پروفایل استنتاج‌شده در یک یافته، سوابق استنادشده را باز کنید. پروفایل‌ها شامل افرادی می‌شوند که پیام‌های ذخیره‌شده دارند، نه هر عضو گروه. **پارامترها → سوابق استنادشده بر اساس هر واقعیت**، فهرست ارجاعات را محدود می‌کند، نه تعداد فعالیت‌های زمینه‌ای را. اشاره‌ها و شباهت آواتار سرنخ هستند؛ آن‌ها مالکیت یا هویت را اثبات نمی‌کنند. در مثال عملی: | لینک | ثبت می‌کند | مشاهده پشتیبانی‌شده | | --- | --- | --- | | همان حساب فرستنده | گروه #۱۴۶ و پیگیری خصوصی #۲۰۵ | هر دو شناسه فرستنده تلگرام 71001 را ارائه می‌دهند | | همان مقصد | #146، ربات کیبورد #173، ویرایش کانال #188، پیام خصوصی #205 | همگی حاوی `pay.example.invalid/new` هستند؛ مالکیت/کنترل مشخص نشده است | | همان فایل ذخیره شده | رسیدهای رسانه‌ای تکمیل‌شده #۱۵۱ و #۲۰۹ | مقادیر کامل SHA-256 برای بایت‌های نگهداری‌شده مطابقت دارند | | نسبت‌دهی کانال | #۱۰۱ و #۱۸۸ | بدون ذکر فرستندهٔ معتبر، یک پست کانال را به کاربر ۷۱۰۰۱ نسبت ندهید | هش‌های پیوست‌ها و ارجاعات پیام مرتبط با آن‌ها را مقایسه کرده و خط زمانی حساب را که بر اساس شناسه‌های تلگرام ارائه‌شده در آن سوابق گروه‌بندی شده است، حفظ کنید. یادداشت‌های کاری تیم را در [Case Board](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/) حفظ کنید: سوابقی را که به آنها استناد می‌کنید، مانند #146، #188 و #205، بوکمارک کنید، رشته مقصد دقیق را برجسته کنید و یک برش از هر اقدام ثبت‌شده بین دو رکورد یا در یک بازه زمانی را ذخیره کنید. یادداشت‌ها و وضعیت‌ها بازبینی تیم را در تاریخچه امضا شده خود، به گونه‌ای که به طور جداگانه از مشاهدات منبع قابل تشخیص است، حفظ می‌کنند. ## ۵. ساخت خط زمانی میان‌گفتگوها از نسخه‌های ذخیره‌شده در چت‌ها و لینک‌های #… در سوابق ژورنال استفاده کنید. در ژورنال، «تمام منابع» را با «ویرایش‌ها»، «حذف‌ها» و «پوشش» ترکیب کنید. هم `source_at` (در صورت ارائه) و هم `observed_at` را حفظ کنید. | زمان مشاهدهٔ نمونه‌وار | منبع | مشاهده | | --- | --- | --- | | 09:00 | کانال #۱۰۱ | مقصد اصلی ضبط شد | | 09:12 | گروه #146؛ رسانه #151 | مقصد جدید ارسال شد؛ دانلود فایل تکمیل شد | | 09:16 | ربات شماره ۱۷۳ | کلیدبورد به مقصد جدید اشاره می‌کند | | 09:20 | کانال #۱۸۸ | اعلان ویرایش شد؛ هر دو نسخهٔ ذخیره شده باقی می‌مانند | | 09:24 | خصوصی #205؛ رسانه #209 | شناسه فرستنده یکسان مقصد را تکرار می‌کند؛ بایت‌های فایل یکسان حفظ شده‌اند | | 09:28 | گروه #۲۳۱ | اطلاعیه حذف دریافت شد؛ حذفی و زمان دقیق حذف نامشخص | سوابق دیگری بین این مراجع نمونه وجود دارد. شماره‌های توالی، مشاهدات را مرتب می‌کنند؛ اسنپ‌شات‌های تاریخچه می‌توانند شامل تاریخ‌های منبع قدیمی‌تر باشند و دیرتر از رویدادهای زنده برسند. بین اسنپ‌شات‌ها، پیام‌های بازیابی‌شده، اعلان‌های حذف و نتایج «در بازبینی مجدد موجود نبودن» تمایز قائل شوید. فواصل پوشش را به عنوان بازه‌های ناشناخته علامت‌گذاری کنید. به‌دست‌آوردن تاریخچه در مراحل بعدی به صورت عطف به ماسبق، مشاهده‌ی بی‌وقفه را اثبات نمی‌کند. ## ۶. افزودن دیدگاه‌های حساب کاربری بدون از دست دادن منشأ آن‌ها برای هر حساب کاربری متمایز از یک فضای کاری جداگانه استفاده کنید و فهرست آن را تکرار کنید. شناسه حساب، نقش، اثر انگشت کلید امضا و مراجع منبع را در هر مقایسه همراه داشته باشید. شماره‌های پیام در سراسر چت‌ها/حساب‌ها شناسه جهانی نیستند. کیس‌بورد یادداشت‌ها و مجموعه‌های مرتبط با منبع را در هر فضای کاری حفظ می‌کند. صفحه گروه وضعیت حساب‌ها را به صورت یکجا بررسی می‌کند و می‌تواند خروجی‌های جداگانه فضای کاری را در یک بسته قرار دهد. آن منابع را در یادداشت‌های پرونده یا ابزارهای تحلیلی خود مرتبط سازید؛ هر دفترچه یادداشت، کلید منشأ و امضای خود را حفظ می‌کند. جستجوی جهانی یا خط زمانی ادغام‌شده بین فضاهای کاری ایجاد نمی‌شود. صادرات چندحساب یک کانال/فراگروه، تاریخچه آن چت را با استفاده از حساب‌های واجد شرایط به دست می‌آورد. برای کارهای طولانی‌تر، مرزها را با یک [شاهد مستقل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/) حفظ کنید. از بررسی‌های تحویل کنترل‌شده برای اعتبارسنجی مسیر ضبط و دید هر حساب کاربری استفاده کنید. ## ۷. تحویل پرونده را مونتاژ و تأیید کنید این موارد را در یک پوشهٔ پرونده که توسط تحلیلگر گردآوری شده است، کنار هم نگه دارید: | مطالب | هدف | | --- | --- | | یادداشت‌های پرونده و ثبت منابع | پرسش، سیاست جمع‌آوری، دسترسی/نقش، یافته‌ها، توضیحات جایگزین و شکاف‌ها | | خط زمانی | زمان‌ها و ارجاعات به فضای کاری/گفتگو/پیام/ترتیب برای هر مورد | | صادرات Case Board و اسلایس‌ها، در صورت استفاده | نشانک‌های مرتبط با منبع، نقل‌قول‌ها، یادداشت‌های تیم، مجموعه‌ها، تاریخچهٔ بازنگری و سوابق منتخب در مقابل فایل ZIP شواهد بررسی می‌شوند. | | فایل ZIP شواهد امضا‌شده برای هر فضای کاری | کل مجله ضبط‌شده، مانیفست و رسانه‌های نگهداری‌شده ضمیمه‌شده؛ فیلترهای پنل، خروجی مجله را محدود نمی‌کنند | | فایل‌های پروفایل افراد که به‌طور جداگانه امضا شده‌اند | مرجع‌های استخراج‌شده با شواهد فضای کاری مطابقت داده شده‌اند | | خروجی‌های کامل چت امضا شده | جمع‌آوری تاریخچهٔ قابل مشاهدهٔ فعلی، جدا از دفترچهٔ مشاهده | | اثرانگشت‌های مورد اعتماد و نقاط کنترل قبلی | هویت کلیدی و مرزهای حفظ‌شدهٔ دفترچهٔ شواهد | | شواهد ابزار، در صورت پیکربندی | روزنامه جداگانه، پست‌های امضا شده و اثر انگشت شاهد | | نتایج تأیید و هش‌های فایل تحویل‌شده | چه چیزی بررسی شد، کدام بایت‌ها منتقل شدند و به چه کسی | از یک نصب مورد اعتماد، با نام‌های فایل و اثر انگشت واقعی هر فضای کاری: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --checkpoint retained-checkpoint.json python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` نتایج تأیید اعتبار واقعی و شواهد اصلی را حفظ کنید. یادداشت‌های فضای کاری را از Case Board به همراه مطالب منبع استنادشده صادر کنید. یافته‌های بین‌فضای کاری را در پوشه اصلی پرونده گردآوری کنید؛ هر شواهد TgWitness دارای امضا و رویه تأیید اعتبار خاص خود است. ## تطبیق با تحقیق | مورد | ردیابی | ارسال | | --- | --- | --- | | منازعهٔ سفارش/پرداخت توسط ربات | اعلان ورود → پیش‌نمایش لینک ذخیره شده → پارامتر شروع ربات → نسخه‌های پیام و صفحه‌کلید → رسیدهای فراخوانی پنل → پیگیری خصوصی/گروهی | خط زمانی مشاهده‌شده پیشنهاد/پاسخ و منابع تأییدشده؛ یک لینک پرداخت به‌تنهایی اثبات پرداخت نیست | | پیام‌های حذف‌شده پس از یک رویداد | تمام چت‌های درگیر → نسخه‌های اصلی/ویرایش‌های ذخیره شده → نتایج حذف یا عدم‌موجود در بازبینی مجدد → رسانه‌های حفظ‌شده → پوشش و دیدگاه‌های دیگر حساب‌ها | نسخه‌های نگهداری‌شده و بازه‌های زمانی نامشخص صریح؛ بدون عامل حذف ساختگی | | یک شرکت‌کننده در چت‌های مختلف نام‌های خود را تغییر می‌دهد | شناسه عددی فرستنده ← تاریخچه نام/نام کاربری ← پاسخ‌ها ← سایر چت‌های مشاهده‌شده ← مقاصد/فایل‌های استنادشده | خط زمانی فعالیت حساب تلگرام با پیوندهایی به سوابق منبع آن | [مرجع جمع‌آوری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/) · [تأیید پروفایل افراد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#people-profiles) · [واگذاری شواهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#investigation-handoff) · [اعتبارسنجی کامل شد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/) --- # Telegram · ویژگی‌ها و محدودیت‌ها Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/ مدل جمع‌آوری فعلی، گردش کارهای چندحساب، خروجی‌ها و مرزهای عملیاتی TgWitness. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) مدل جمع‌آوری فعلی، گردش کارهای چندحساب، خروجی‌ها و مرزهای عملیاتی TgWitness. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [مرجع پروژه](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![مرجع پروژه](https://phishdestroy.github.io/TgWitness/assets/chapter-project.svg) TgWitness گفتگوهای تلگرام را که برای حساب‌های متصل قابل دسترسی هستند، حفظ می‌کند، تغییرات مشاهده‌شده را ثبت می‌کند و خروجی‌های قابل تأیید را آماده می‌سازد. این مرجع مدل جمع‌آوری، گردش کارهای فعلی و محدودیت‌های آن‌ها را توصیف می‌کند. **در این صفحه** - [برنامهٔ مستقل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/#standalone-application) - [تحقیقات مشترک](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/#shared-investigations) - [ابزارهای بایگانی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/#archive-tools) - [افزودنی‌های اختیاری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/#optional-extras) - [پروتکل و منابع خصوصی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/#protocol-and-private-sources) - [حساب‌های متعدد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/#multiple-accounts) - [ثبت و انتساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/#capture-and-attribution) - [ظرفیت و محدودیت‌های تلگرام](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/#capacity-and-telegram-limits) - [اعتمادپذیری و بازیابی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/#reliability-and-recovery) - [مدل شواهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/#evidence-model) - [صادرات، استقرار و تحویل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/#export-deployment-and-handoff) - [معیارهای انتشار پایدار](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/#stable-release-criteria) ## برنامهٔ مستقل TgWitness دارای فرایند نصب، دایرکتوری داده و چرخهٔ انتشار مستقل است. رابط کاربری وب همراه، پیکربندی و بازبینی را مدیریت می‌کند؛ سوابق صادرشده را می‌توان به‌طور مستقل استفاده کرد. اپراتور حساب‌های خود را متصل می‌کند، منابعی را که برای هر یک قابل مشاهده هستند انتخاب می‌کند و یک دفترچه مشاهدات ذخیره‌شده دریافت می‌نماید. پنل محتوا، تغییرات ذخیره‌شده، منشأ مشاهده و شکاف‌های شناخته‌شده را نمایش می‌دهد. یک محقق دیگر می‌تواند محتوای صادرشده را تأیید کند. پنل بین تأیید حساب، دسترسی به منبع، فعالیت گردآورنده و پوشش ثبت‌شده تمایز قائل می‌شود. هنگام ارزیابی یک بازه با پیام‌های اندک یا مشکل اتصال، این وضعیت‌ها را با هم بررسی کنید. ## تحقیقات مشترک یک مدیر می‌تواند [توکن‌های دسترسی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/)را که محدود به فضاهای کاری و چت‌های فردی هستند، با مجوزهای هر اقدام، محدودیت‌های آی‌پی، انقضا، محدودیت‌های ورود و کنترل جلسه صادر کند. یک بازبین فقط-خوانش می‌تواند یک پرونده را بدون دریافت مجوز تلگرام یا کلید پنل اصلی بررسی کند. دسترسی محدود به چت، از تنظیمات کل حساب و خروجی‌های کامل ژورنال مجزا باقی می‌ماند. MTProxy خودکار، مسیرهای فعال تلگرام را از چهار منبع عمومی یا یک کاتالوگ اپراتور حفظ می‌کند. [حالت‌های آی‌پی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/#ip-modes) تعیین می‌کنند که آیا خرابی باید منتظر پروکسی دیگری بماند یا می‌تواند از یک مسیر مستقیم صریحاً مجاز استفاده کند. درخواست‌های HTTP خارجی دارای یک مسیر جداگانه و دکمه خاموش هستند. ## ابزارهای بایگانی [تولید تاریخچه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/history/)، [جست‌وجوی آرشیو و تحلیل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/analysis/)،[MCP فقط-خواندنی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/)، [OCR/استنساخ محلی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/media-analysis/) و[وب‌هوک‌های خروجی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/webhooks/) در نسخهٔ پیش‌نمایش 0.7.1 گنجانده شده‌اند. گزارش‌های تحلیلی و متن‌های شناسایی‌شده از رویدادهای ضبط‌شده جدا می‌مانند. [کیس‌بورد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/) نشانک‌ها، نقل‌قول‌ها، یادداشت‌ها و مجموعه‌های مرتبط با منبع را در یک فضای کاری اضافه می‌کند. [سازنده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-reports/) [گزارش](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-reports/)، محتوا، بخش‌ها و یکی از هشت طرح را برای خروجی‌های پشتیبانی‌شده HTML/PDF انتخاب می‌کند. ## افزودنی‌های اختیاری راه‌اندازی روزانه عبارت است از: حساب کاربری → منابع → مشاهده. **بخش اضافی** یک مقصد جداگانه با یک ربات شاهد تلگرام و پیش‌نمایش ضبط در گیت‌هاب است. هر بخش قبل از نمایش تنظیمات، در دسترس بودن و نیازمندی‌های خود را اعلام می‌کند. انتخاب یک کارت، دستورالعمل‌ها را باز می‌کند؛ این کار باعث ثبت‌نام یا راه‌اندازی هیچ سرویسی نمی‌شود. راه‌اندازی ربات سه مرحله دارد: ایجاد دسترسی فقط-خواندنی، انتخاب تنظیمات انتشار، و راه‌اندازی روی میزبان شاهد. گزینه‌های شبکه و انتشار، اتصالات موجود و دستورات تأیید هویت بنا به درخواست افشا می‌شوند. پیکربندی دانلود شده با یک شاهد در حال اجرا متفاوت است. سوئیچینگ اضافی، پیش‌نویس را حفظ می‌کند؛ تغییرات حساب کاربری و قفل کردن، توکن و فرم موقت را پاک می‌کند. راهنمای داخلی شامل دستورالعمل‌های راه‌اندازی است. [اقدامی که توسط GitHub Actions ضبط می‌شود](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md)، یک جمع‌آورنده پین‌شده را از فورک شما راه‌اندازی می‌کند، یک چت را ضبط کرده و یک انتقال رمزگذاری‌شده با منشأ گردش کار تولید می‌کند. ## پروتکل و منابع خصوصی **MTProto پروتکل تلگرام است؛ Telethon کتابخانه پایتونی است که TgWitness برای ارتباط با MTProto از آن استفاده می‌کند.** آن‌ها روش‌های اتصال جایگزین نیستند. Collection از MTProto استفاده می‌کند؛ Witness اختیاری از طریق Bot API چک‌های امضا شده را منتشر می‌کند. هر فضای کاری دارای جریان به‌روزرسانی حساب کاربری و کلاینت مجاز خود است. TgWitness مشاهدات را از منابع پیکربندی‌شده انتخاب کرده و برای عملکردهایی مانند اسنپ‌شات‌های تاریخچه و دانلود رسانه‌ها، درخواست‌های صریح و جداگانه‌ای ارسال می‌کند. یک منبع خصوصی به نام کاربری عمومی نیازی ندارد. نوع همتا و شناسه عددی تلگرام، شناسه‌ها هستند؛ عناوین و نام‌های کاربری می‌توانند تغییر کنند. دسترسی به عضویت و مجوزهای موجود بستگی دارد. TgWitness به طور خودکار به منابع ملحق نمی‌شود یا تأیید عضویت را دور نمی‌زند. یک هش دسترسی از حساب دیگر، توکن دسترسی جهانی نیست. مدل جمع‌آوری باید تاریخچه پنهان پیش از پیوستن، نقش‌های شرکت‌کننده/مدیر، لغو جلسه، حذف یا تغییر مجوزها، مهاجرت از گروه به ابرگروه، موضوعات/انجمن‌ها، بحث‌های مرتبط، هویت کانال‌ها و پیوست‌های در دسترس نبوده را در نظر بگیرد. هر ترکیبی به صورت زنده تأیید نشده است. در دسترس بودن منبع در شروع کار جمع‌آورنده بررسی می‌شود. عدم وجود یک منبع در نتیجهٔ دیالوگ محدود به معنای **تأیید نشدن دسترسی**است، نه اثبات حذف. یک منبع در دسترس نبوده مانع مشاهده سایر منابع قابل دسترسی نمی‌شود. هرگز لینک‌های دعوت یا جلسات واقعی را در مکان‌های عمومی قرار ندهید. ## حساب‌های متعدد پنل از هر تعداد **فضای کاری** پشتیبانی می‌کند، هر کدام با ویژگی‌های خاص خود: - مجازی‌سازی، گاوصندوق رمزگذاری‌شده و مسیر اتصال. - ژورنال SQLite و هویت امضای Ed25519. - منابع منتخب، صف رسانه‌ای و تنظیمات ضبط. - وضعیت مشاهده، خطاها، نقاط کنترل و خروجی‌ها. تغییر فضای کاری نمایش‌داده‌شده، جمع‌آوری‌کننده دیگری را متوقف نمی‌کند. تأیید مجوز حساب تکراری در فضاهای کاری مختلف رد می‌شود. ژورنالی که قبلاً به یک حساب تلگرام متصل شده است را نمی‌توان به حساب دیگری اختصاص داد؛ اما اتصال مجدد به همان حساب مجاز است. این کار هویت حساب و دامنه مرتبط با شناسه پیام را حفظ می‌کند. این برنامه تعداد فضای کاری ثابتی را تعیین نمی‌کند. هر فضای کاری وظایف گردآورنده خود را برای نظارت بر اتصال، دانلود رسانه‌ها، بازبینی مجدد و دریافت چت‌های جدید در یک فرآیند پایتون و حلقه رویداد مشترک، اجرا می‌کند. توان عملیاتی به بار کاری بستگی دارد. برای جداسازی فرآیندها، از نصب‌ها، پورت‌ها و دایرکتوری‌های داده جداگانه استفاده کنید. به هر حساب منابعی را که می‌تواند به آنها دسترسی داشته باشد، اختصاص دهید. حساب‌های مختلف ممکن است یک گروه را مشاهده کنند، اما مشاهدات آنها جداگانه باقی می‌ماند و منشأ خود را حفظ می‌کنند. دو حساب روی یک دستگاه کنترل‌شده توسط یک اپراتور، دو شاهد مستقل محسوب نمی‌شوند. **خروجی گروه،** فایل‌های ZIP فضای کاری را که به صورت جداگانه امضا شده‌اند، با یک فهرست فایل امضا‌شده که حاوی شناسه‌های فضای کاری، هش‌ها و اثرانگشت‌های کلید امضای آنهاست، در یک بسته ترکیب می‌کند. هر دفترچه یادداشت مرز خود را حفظ می‌کند. یک خط زمانی ترکیبی بین‌فضاهای کاری در یادداشت‌های موردی یا ابزارهای تحلیلی بسازید و به ارجاعات منبعی که حفظ شده‌اند، پایبند بمانید. ## ثبت و انتساب منابع، کلیدهای تغییر برای هر حساب کاربری در مورد پیام‌های جدید، ویرایش‌ها، حذف‌ها، واکنش‌ها و عضویت را فراهم می‌کند. تنظیمات از پیش تعیین‌شده، یا تمام دسته‌بندی‌ها یا پیام‌ها/ویرایش‌ها/حذف‌ها را حفظ می‌کنند. این سیاست برای گروه‌های انتخاب‌شده در فضای کاری اعمال می‌شود، پس از راه‌اندازی مجدد نیز باقی می‌ماند و با تغییرات قبل و بعد امضا می‌شود. تنظیمات پیش‌فرض تمام دسته‌بندی‌ها را حفظ می‌کنند. غیرفعال کردن یک دسته‌بندی، سوابق قدیمی را حذف نمی‌کند؛ فعال کردن مجدد آن نیز رویدادهای از دست رفته را بازسازی نمی‌کند. سوابق عملیاتی، سایر رویدادهای خدمات گروه و اسنپ‌شات‌های صریح تاریخچه، جدا هستند. اشیاء تلگرام ضبط‌شده ممکن است صرف‌نظر از سوئیچ‌های به‌روزرسانی جداگانه، متادیتای جاسازی‌شده را حفظ کنند. هنوز هیچ اولویت‌بندی دسته‌بندی بر اساس گروه وجود ندارد. | مطالب | اکنون ضبط شد | مرز | | --- | --- | --- | | پیام | متن، شناسه‌های هم‌پیش/پیام، متادیتای فرستنده، پاسخ‌ها و پاکت به‌روزرسانی اصلی | حفظ شده به‌عنوان یک مشاهده قابل مشاهده برای حساب که توسط گردآورنده امضا شده است | | ویرایش | نسخهٔ جدید مشاهده‌شده و هر نسخهٔ قبلی ذخیره‌شده | ویرایش‌های میانی در طول زمان توقف ممکن است از دست بروند؛ فرستنده لزوماً ویراستار نیست | | حذف | اطلاع‌رسانی و محتوای ضبط‌شده قبلی (در صورت وجود) | معمولاً زمان دقیق اقدام یا حذف‌کننده مشخص نیست | | اطلاعیه حذف در سطح حساب | اخطار اصلی؛ سوابق حل‌شده شامل چت ذخیره شده و روش همبستگی هستند | نیاز به دقیقاً یک تطابق پیش‌تر ذخیره شده از گفتگوی خصوصی یا گروه عادی در محدوده دارد؛ سایر شناسه‌ها در حالت `deletion.unscoped` باقی می‌مانند. شناسه‌های کانال و ابرگروه از این همبستگی مستثنی هستند. | | واکنش | شمارنده‌های تحویل‌شده و هویت‌های اخیر قابل مشاهده | برای دریافت فهرست کامل راکتورها باید پرس‌وجوهای جداگانه‌ای انجام داد؛ کانال‌ها ممکن است هویت‌ها را پنهان کنند | | عضویت | پیام‌های سرویس و به‌روزرسانی‌های تحویل‌شده به شرکت‌کنندگان | دیده‌شدن بستگی به نقش و نوع چت دارد؛ رویدادهای از دست رفته دلیلی بر عدم حضور نیستند | | اقدامات ادمین | به‌روزرسانی‌های مرتبط تحویل‌شده و یک نمای کلی از لاگ ادمین در خروجی‌های چت کانال/ابر‌گروه | خروجی، در صورت موجود بودن، لاگ را برای حساب ادمین صادرکننده می‌خواند؛ بررسی مداوم لاگ ادمین خارج از این مسیر است. | | پیوست | توضیح‌دهنده نسخه اصلی، بایت‌های دانلودشده/SHA-256 و نتایج تلاش‌ها | یک فایل ناپدیدشده ممکن است بازیابی‌ناپذیر باشد؛ آخرین نسخه جایگزین نمی‌شود | | تاریخچه | اسکرین‌شات صریح پیام‌های قابل مشاهدهٔ فعلی | تمام ویرایش‌ها یا محتوای حذف‌شده را بازسازی نمی‌کند | | فرآیند جمع‌آوری | شروع/توقف، ضربان قلب، خطاها، تنظیمات، دامنه و رسید اجرای امضا شده | فهرست محلی؛ گیت‌هاب و TDX [بررسی‌های مستقل محیط را](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope) اضافه می‌کنند | رابط کاربری نام حساب ارائه‌شده در رویداد منبع را نام‌گذاری می‌کند و نام‌های مشاهده‌شده و نام‌های کاربری را حفظ می‌کند. وقتی رویداد عامل خود را حذف کند، گزارش آن فیلد را نامشخص باقی می‌گذارد. ## ظرفیت و محدودیت‌های تلگرام تعداد چت‌های یکسانی که بتوان با کیفیت تضمین‌شده نظارت کرد، وجود ندارد. ظرفیت بستگی به حداکثر رویدادها در ثانیه، حجم و اندازه پیوست‌ها، RPCهای اضافی، حساب‌های فعال، تأخیر/فضای خالی دیسک، شرایط شبکه، محدودیت‌های تلگرام، تأخیر قابل قبول و عمق صف دارد. تلگرام بین تحویل غیرفعال و استعلام کوتاه فعال تمایز قائل می‌شود. مستندات به‌روزرسانی آن، فراخوانی‌های اضافی `updates.getChannelDifference` را برای کانال‌های باز/ابرگروه‌ها توصیف می‌کند و حداکثر **ده منبع استعلام‌شده کوتاه همزمان را** توصیه می‌کند. این محدودیت ده‌تایی برای گروه‌های منتخب نیست و تضمینی برای جامعیت نیز ارائه نمی‌دهد. | حالت | هدف | وضعیت | | --- | --- | --- | | مشاهده استاندارد | ثبت به‌روزرسانی‌های ارائه‌شده از منابع منتخب | پیاده‌سازی شد | | بازبینی‌های اولویت‌دار | منابع ستاره‌دار از بازه زمانی قابل‌تنظیم خود استفاده می‌کنند و در هر چرخه بازبینی محدود اولویت دارند. | پیاده‌سازی شده با پرس‌وجوهای تاریخچه و پیام | ستاره اولویت این بازپروه‌ها را کنترل می‌کند. فراخوانی کوتاه اضافی `updates.getChannelDifference` به‌عنوان یک حالت کاربری جداگانه در دسترس نیست. نظرسنجی با فرکانس بالا و دلخواه، نادیده گرفتن FloodWait یا فرض ظرفیت خطی از حساب‌های اضافی، یک مدل اندازه‌گیری معتبر نیست. محدودیت‌های پیش‌فرض عبارتند از ۱۰۰۰ دیالوگ اول فهرست‌شده، تا ۵۰۰ پیام در هر اسنپ‌شات تاریخچه، ۱–۲۰۰۰ مگابایت برای هر فایل جمع‌آوری‌شده بر اساس نوع، و ۴ گیگابایت برای محتوای فشرده‌شده ZIP بدون فشرده‌سازی؛ هر یک از این مقادیر در هر فضای کاری تحت **«پارامترها»** قابل تغییر است. خروجی‌ها محدودیت ثابت تعداد رویداد ندارند. حالت پشتیبان مرورگر به طور پیش‌فرض به ۱۲۸ مگابایت محدود است؛ CLI پخش دارای محدودیت انتقال قابل پیکربندی است که به طور پیش‌فرض ۵ گیگابایت است. ## اعتمادپذیری و بازیابی رفتار پیاده‌سازی‌شده شامل تراکنش‌های همزمان WAL در SQLite؛ نوشتارهای اتمی پیام و وظایف رسانه‌ای؛ وظایف پایدار و تأخیرهای تلاش مجدد؛ توصیه‌گرهای نسخه اصلی؛ تلاش‌های مجدد محدود؛ منتظر ماندن (FloodWait) پایدار برای رسانه‌ها؛ دانلود رسانه‌ها خارج از زمان انتظار شبکه‌ای رویداد متنی؛ خروجی‌های پیش‌وند ثابت در حالی که نوشتارهای بعدی ادامه دارند؛ تنظیمات اتمی و سوابق حسابرسی؛ حفظ مجوز فعال پس از ورود مجدد ناموفق؛ ایزوله‌سازی یک فضای کاری اضافی آسیب‌دیده؛ تلاش‌های صریح برای اتصال مجدد؛ گزارش‌دهی متمایز از از دست رفتن مجوز؛ و تشخیص تغییر بر اساس زمان واقعی با استفاده از یک ساعت مونوتونیک. موقعیت‌های حساب کاربری و کانال (pts/qts/seq) پس از راه‌اندازی مجدد ذخیره و از سر گرفته می‌شوند، و چت‌های مشاهده‌شده به‌طور دوره‌ای مجدداً بررسی می‌شوند؛ به [فرمت شواهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#durable-collection-and-process-receipts-02) مراجعه کنید. ذخیره دوره‌ای موقعیت، یک تأیید اتمی و بدون‌از‌دست‌رفتن پذیرش دفترچه شواهد نیست. هر شروع فرآیند، رکوردهای قبلی و مرز آفلاین را ثبت می‌کند. تاریخچهٔ جاری به عنوان ترمیم شکاف در نظر گرفته نمی‌شود. نگهداری تفاوت‌ها در تلگرام محدود است؛ `differenceTooLong` نمی‌تواند تمام محتوای ناپدید شده را بازسازی کند. شکاف‌های غیرقابل بازیابی باید حتی اگر یک اسنپ‌شات بعدی از تاریخچه موفق شود، صریح باقی بمانند. ## مدل مدرک هر رویداد یک توالی، زمان مشاهده محلی UTC، زمان منبع در صورت ارائه، نوع، منبع، عامل در صورت ارائه، بار باری اصلی، هش و امضای قبلی را ثبت می‌کند. مشاهدات پیام همچنین زمینه حساب/اجرای گردآورنده را نیز حفظ می‌کنند. رسید فرایند امضا شده حاوی شناسه اجرای تصادفی؛ نسخه‌های وابستگی TgWitness/Python/OS؛ مقادیر SHA-256 و اثر انگشت تجمیعی فایل منبع؛ حساب کاربری اولیه، دامنه و تنظیمات؛ خوانش‌های مونوتونیک UTC؛ و سرآیند ژورنال قبلی است. تغییرات تنظیمات، شروع/توقف و خطاها در همان دفترچه ثبت می‌شوند. نقاط کنترل در هنگام راه‌اندازی، هر پنج دقیقه در حین مشاهده (قابل تغییر) و در هنگام توقف منظم، حفظ می‌شوند. یک نقطه کنترل محلی حفظ‌شده می‌تواند بازگشت به یک پیشوند دفترچه قبلی را تشخیص دهد. | مکانیزم | آنچه اثبات می‌کند | | --- | --- | | SHA-256 فایل | بایت‌ها با هَش شناخته‌شده مطابقت دارند | | زنجیره هش رویداد | ثبت ترتیب/ارتباط نسبت به یک مرز شناخته‌شده | | Ed25519 | امضا زیر یک کلید خاص | | نقطهٔ کنترل مستقل نگهداری‌شده | مطالب بعدی با مرز حفظ‌شده مطابقت دارد | | اندازه‌گیری فایل برنامه | گزارش خوداظهاری جمع‌آورنده دربارهٔ فایل‌های اندازه‌گیری‌شده | | پاسخ معتبر و مستقل TSA | وجود بایت‌های خاص در زمان TSA تحت فرضیات اعتماد صریح | آماده‌سازی درخواست RFC 3161 و تأیید اعتبار پاسخ OpenSSL پیاده‌سازی شده‌اند. حالت شواهد همچنین هش‌های نقطه‌کنترلی را به سرویس‌های مهر زمانی پیکربندی‌شده ارسال می‌کند. پاسخ مرجع را برای ایجاد یک لنگر زمانی مستقل نگهداری و تأیید کنید. به [TIMESTAMP.md](https://phishdestroy.github.io/TgWitness/fa/docs/reference/timestamp/) مراجعه کنید. نقطه‌های کنترل را به‌طور مستقل حفظ کنید، دسترسی به کلیدهای امضا را کنترل کنید، سوابق انتقال را نگهداری کرده و خروجی‌ها را با نرم‌افزار مورد اعتماد تأیید کنید. [دامنه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope) [اعتبارسنجی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope) توضیح می‌دهد که چگونه این بررسی‌ها یکدیگر را تکمیل می‌کنند و کدام فرضیات اعتماد اعمال می‌شوند. ## صادرات، استقرار و تحویل یک فایل ZIP امضا شده حاوی JSONL، CSV، HTML اصلی، پیوست‌های حفظ‌شده، هش‌ها، یک مانیفست امضا شده و یک اعتبارسنجی‌کنندهٔ آسان است. این فایل یک فضای کاری و یک پیش‌وند ثابت و کامل برای دفترچه را پوشش می‌دهد. فیلترهای جستجو در پنل، رکوردها را به‌صورت پنهان حذف نمی‌کنند. کلیدهای مخفی، توکن‌ها و جلسات تلگرام حذف می‌شوند؛ مشاهدات اصلی همچنان می‌توانند حاوی اطلاعات شخصی و متادیتای تلگرام باشند. هَش زیپ، اثر انگشت مورد اعتماد، نقطه کنترل، رسید فرآیند و سوابق تحویل را جداگانه نگهداری کنید. به جای اعتماد صرف به کد اجرایی صرفاً به این دلیل که در فایل زیپ بررسی‌شده وجود دارد، از یک اعتبارسنج از یک نصب مورد اعتماد استفاده کنید. رابط کاربری مرورگر به‌صورت محلی و بدون Node.js، CDNها یا فونت‌های خارجی عرضه می‌شود. یک توکن اپراتور نصب را کنترل می‌کند. دسترسی از راه دور به HTTPS یا تونل SSH نیاز دارد. تعاریف بومی پایتون و کانتینر فراهم شده است، همراه با نمونه‌های سرویس در [پوشه deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md)؛ بررسی‌های پلتفرم اجراشده به‌طور جداگانه فهرست شده‌اند. فضای کاری پیش‌فرض از ریشه داده‌ها استفاده می‌کند؛ فضاهای کاری اضافی از `profiles//` استفاده می‌کنند. برای پشتیبان‌گیری، متوقف شدن فرآیند و مجموعه کامل داده‌ها/کلیدها لازم است. فایل‌های فشرده (ZIP) شواهد، پشتیبان‌گیری از برنامه نیستند. اسرار می‌توانند از یک کلید اصلی خارجی برای یک دایرکتوری داده جدید استفاده کنند؛ رمزگذاری دفترچه/رسانه توسط دیسک/حجم اپراتور فراهم می‌شود. به [CONNECTION-SECURITY.md](https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/) و [OPERATIONS.md](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/) مراجعه کنید. ## معیارهای انتشار پایدار پیش از انتشار پایدار، مشخص کنید: 1. گروه‌های خصوصی واقعی، ابرگروه‌ها، انجمن‌ها و کانال‌ها با نقش‌های اعضا/مدیر و تاریخچه پنهان/نمایان، شامل ورود/احراز هویت دو مرحله‌ای، لغو دسترسی و از دست دادن دسترسی. 2. ویرایش‌ها، حذف‌ها، واکنش‌ها، عضویت و رسانه‌ها کنترل‌شده در برابر اقدامات شناخته‌شده. 3. خرابی/قطعی فرایند/میزبان، خرابی دیسک/پر شدن دیسک، ارجاعات فایل منقضی‌شده، FloodWait، از دست رفتن شبکه، فایل‌های خراب و بازگشت پایگاه داده به نسخه قبلی. 4. استفادهٔ مستمر از چندین حساب با تأخیر اندازه‌گیری‌شده، صف‌ها، حافظه و دیسک، شامل منابع بی‌صدا و پرصدا به‌طور همزمان. 5. وقفه بین پیشرفت وضعیت MTProto و پذیرش دفترچه. 6. نصب تمیز روی ماتریس سیستم‌عامل/کانتینر هدف و بازیابی پشتیبان تأییدشده. 7. بازبینی مستقل ادعاهای امنیتی، امضاها و انتساب/شواهد. دسترسی پنل محدود در بخش [دسترسی و مجوزها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/) توضیح داده شده است. نسخه ۰.۶ از TData حساب واحد محدود و وارد کردن فایل حساب که در [ACCOUNTS.md](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/) توضیح داده شده است، پشتیبانی می‌کند. پیش از انتشار، شرایط API تلگرام را مرور کنید. تحقیقات، مراجع و یافته‌های پلتفرم در [RESEARCH.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/RESEARCH.md) قرار دارند. --- # Telegram · مرجع Case Board Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/ نشانک‌ها، برجسته‌سازی‌های دقیق، برش‌های عملیاتی، بحث‌ها، دسترسی محدودشده و تاریخچه حاشیه‌نویسی امضا‌شده مورد استفاده در Case Board. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) نشانک‌ها، برجسته‌سازی‌های دقیق، برش‌های عملیاتی، بحث‌ها، دسترسی محدودشده و تاریخچه حاشیه‌نویسی امضا‌شده مورد استفاده در Case Board. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [تحقیق](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/) ![تحقیق](https://phishdestroy.github.io/TgWitness/assets/chapter-investigate.svg) کیس‌بورد یک نمای کاری مشترک از مطالب ذخیره‌شده را در اختیار تیم تحقیق قرار می‌دهد. یک مشاهده را بوکمارک کنید، یک بخش دقیق را برجسته کنید، یک مجموعه از اقدامات را ذخیره کنید و آن را با همکاران خود بحث کنید. کارت‌ها ارجاع منابع و تاریخچه بازبینی امضا شده خود را حفظ می‌کنند. حاشیه‌نویسی‌های تیمی در فضای کاری باقی می‌مانند و به طور جداگانه از مشاهدات اصلی تلگرام قابل تشخیص هستند. [مدل مدرک](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) · [دسترسی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/) · [گزارش‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-reports/) ![جریان کاوش مصنوعی](https://phishdestroy.github.io/TgWitness/assets/case-board.png) **در این صفحه** - [کار با یک پرونده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/#work-with-a-case) - [مجوزها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/#permissions) - [قراردادهای ذخیره‌شده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/#stored-contracts) - [API و خروجی‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/#api-and-exports) - [محدودیت‌های عملیاتی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/#operating-limits) ## کار با یک پرونده **پرونده را** در حالت استاندارد یا حرفه‌ای باز کنید. زبان با پنل مطابقت دارد. از **دکمه «To»** در کنار یک رکورد دفترچه یادداشت یا پیام چت ذخیره شده استفاده کنید، یا روی آن تمرکز کرده و **کلید B را** فشار دهید. نشانک با یک کلیک به صندوق ورودی اضافه می‌شود. عنوان، برچسب‌ها و یادداشت آن را ویرایش کنید، یا آن را به یک مجموعه منتقل کنید. یک کارت تغییر یافته، یک نسخه اصلاح‌شده امضا شده را ضمیمه می‌کند؛ حذف آن، تاریخچه را حفظ می‌کند. برای اولین مورد، یک مجموعه را انتخاب کرده و سوابق پاسخ‌دهنده به یک سؤال را اضافه کنید. از نظرات برای بازبینی تفسیر و سپس از **Presentation** برای مرور کارت‌ها و زمینه منبع استفاده کنید. هنگام آماده‌سازی محصول نهایی، موارد Case Board را به طور جداگانه در [Report Studio](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-reports/) انتخاب کنید. ذخیره یک برش (slice)، فیلترهای داده گزارش را به طور خودکار پیکربندی نمی‌کند. برای باز کردن **هایلایت در بورد**، متن داخل یک پیام چت ذخیره شده را انتخاب کنید. رنگ آن را انتخاب کرده و یک یادداشت اضافه کنید. سرور نقل‌قول دقیق و نسخه ذخیره شده را، شامل ایموجی، متن راست‌خوان و علائم الحاق، بررسی می‌کند. رابط کاربری انتخاب را از طریق متن‌های مخفی‌شده یا تغییر یافته اعمال نمی‌کند. برای **برش بین** دو رکورد در یک چت، دو رکورد را با کلید Shift کلیک کنید تا از **برش بر اساس زمان** استفاده کنید، یا فیلترهای فعلی چت، دوره و نوع رویداد ژورنال را ذخیره کنید. یک برش ذخیره شده، گزاره معتبر خود را دارد: باز کردن آن در ژورنال، چندین چت، محدودیت‌های شماره پیام و فیلترهای بازیگر را نیز اعمال می‌کند. **نمایش سوابق اضافه شده از زمان نشانک**، افزوده‌های بعدی را جدا می‌کند. تغییر فیلترهای ژورنال، اسلایس را خروجی می‌دهد. از بخش افراد، **اسلایس کردن «اقدامات این شخص»** از شناسه بازیگر ثبت‌شده استفاده می‌کند؛ این اسلایس فرض نمی‌کند که نویسنده پیام، پیامی را ویرایش، حذف یا به آن واکنش نشان داده است. پیش‌نمایش کادر محاوره‌ای، پیش از اجازه دادن به ایجاد، شمارش‌ها را نمایش می‌دهد. `all` شامل هر نوع رکورد شده است، از جمله اسنپ‌شات‌ها، ویرایش‌ها، حذف‌ها، واکنش‌ها، به‌روزرسانی‌های عضویت/سرویس، اقدامات خود، دکمه‌ها، خروجی‌های رسانه‌ای، پیام‌های بازیابی‌شده و انواع رویدادهای آینده. این انتخاب، مشاهدات ذخیره‌شده را توصیف می‌کند. اخطاریه‌های حذف چت‌های ناشناس در زمینه‌ای جداگانه قرار دارند، فقط برای دسترسی به کل فضای کاری در دسترس هستند و هرگز به یکی از چت‌های انتخاب‌شده نسبت داده نمی‌شوند. مجموعه‌ها دارای دامنه چت اعلام‌شده‌ای هستند. دامنه خالی به معنای کل فضای کاری است. یک مجموعه نمی‌تواند شامل کارت‌هایی خارج از دامنه خود باشد؛ یک شرکت‌کننده محدود به چت نمی‌تواند مجموعه‌ای گسترده‌تر را بخواند. اینباکس یک مجموعه مجازی برای کارت‌های تخصیص‌نیافته است. جستجو و فیلترها فقط کارت‌های قابل مشاهده را پوشش می‌دهند؛ رشته‌ها و @ذکرها دسترسی کارت والد را به ارث می‌برند. نظرات حذف‌شده یک نشانگر حذف در بحث خواهند داشت. هیچ تاریخچه مشاهده‌کننده‌ای ثبت نمی‌شود. **نمایش،** تمام کارت‌ها را در مجموعهٔ انتخاب‌شده با نماهای کارت، زمینهٔ منبع و نظرات تیم و کنترل‌های صفحه‌کلید قبلی/بعدی باز می‌کند. این حالت هیچ کنترل ویرایشگری ارائه نمی‌دهد. فید عادی صفحه‌بندی شده است؛ نمایش، فهرست خود را در صفحات بارگذاری می‌کند و جزئیات هر کارت را یکی‌یکی بازیابی می‌کند. ## مجوزها تمام عملیات به دسترسی `view`، محدوده فضای کاری/چت و `board.read` نیاز دارند. دسترسی `board.write` کارت‌ها، نظرات، جابجایی و وضعیت‌های باز/بازبینی را اضافه می‌کند. دسترسی `board.manage` مدیریت مجموعه، وضعیت‌های تأیید شده/رد شده، بازنگری/حذف کارت شخص دیگر را مجاز می‌سازد. یک وضعیت یک تصمیم تیمی است، نه نتیجه تأیید رمزنگاری. پیش‌تنظیمات فرم دسترسی: بازبین = خواندن؛ تحلیلگر = خواندن/نوشتن؛ اپراتور = خواندن/نوشتن/مدیریت، علاوه بر مجوزهای موجودشان. اعطای مجوزهای موجود به‌طور خودکار حقوق جدید را به‌دست نمی‌آورد. مدیر اصلی تمام حقوق را دارد و با عنوان **«مدیر اصلی**» پست می‌کند. برای انتساب، از اعطای نام‌گذاری‌شده استفاده کنید. لیست اشاره‌ها فقط دسترسی‌های فعلی را که قادر به خواندن کامل کارت والد هستند، فهرست می‌کند. مجوز چت A نمی‌تواند کارت یا اسلایسی برای A+B دریافت کند، حتی با حدس زدن شناسه آن یا ارائه یک `target.chat_id` نادرست. متادیتای هدف از هش رویداد امضا شده روی سرور استخراج می‌شود. کلکسیون‌ها، تعداد بحث‌ها، کارت‌های مرتبط و اعلان‌های زنده قبل از پاسخ فیلتر می‌شوند. خروجی‌ها به مجوز `export` و همچنین `board.read` نیاز دارند؛ یک صادرکننده موجود بدون دسترسی به برد، آرشیو شواهد عادی را بدون یادداشت‌های تیمی دریافت می‌کند. SSE قبل از هر دسته، مجوزهای فعلی را مجدداً بررسی می‌کند. ## قراردادهای ذخیره‌شده مانند مشاهدات، حاشیه‌نویسی‌ها به‌صورت تراکنشی در یک جدول SQLite فقط-افزایشی در فضای کاری نوشته می‌شوند. فایل`annotations.jsonl` خروجی کانونیک دقیق آن از همان اسنپ‌شات خواندنی مشابه با فایل`events.jsonl` است. هیچ مخزن حاشیه‌نویسی دوم رقابتی وجود ندارد و هیچ رویداد ژورنال `board.activity` نیز وجود ندارد. هر خط دقیقاً شامل: ``` { "seq": 1, "at": "2026-11-02T14:00:00.000+00:00", "access_id": "admin", "access_label": "Main administrator", "kind": "board.bookmark", "payload": {"id": "32 lowercase hex digits", "target": {"event_hash": "64 lowercase hex digits"}}, "previous_hash": "64 zeroes for the first record", "hash": "SHA-256 described below", "signature": "base64 Ed25519 signature" } ``` مثال مختصر بالا، پاکت را نشان می‌دهد؛ بارهای واقعی شامل مقادیر پیش‌فرض مدل و فیلدهای مقصد حل‌شده توسط سرور هستند. اسکیماهای درخواست API در مسیر [`tgwitness/schemas`](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/schemas/board-bookmark.json) قرار دارند که توسط `python tools/build_board_schemas.py` از مدل‌های Pydantic زمان اجرا تولید می‌شوند. فیلدهای اضافی در درخواست رد می‌شوند. شناسه‌ها در صورت حذف، در سمت سرور تولید می‌شوند. نویسنده، زمان، اسنپ‌شات و امضا را نمی‌توان از سوی فراخواننده تأمین کرد. شناسه‌های اعطای نام‌گذاری‌شده از فرمت ۱۶ هگزادسیمال موجود Access پیروی می‌کنند؛ شناسه‌های کارت ۳۲ هگزادسیمال هستند. JSON مرجع (Canonical JSON) شامل UTF-8، کلیدهای شیء مرتب‌شده، بدون فضای خالی بین توکن‌ها، یونیکد بدون فرار (unescaped)، و بدون NaN/بی‌نهایت‌ها است. هش حاشیه‌نویسی (annotation hash) عبارت است از SHA-256 شیء مرجع حاوی `format: "tgwitness-annotations-v1"` و تمام هفت فیلد پاکت (envelope) تا `previous_hash`. این تگ فرمت، دامنه هش خود را از مشاهدات جدا می‌کند. امضا بر روی ۳۲ بایت خام هش، از نوع Ed25519 است. توالی از ۱ شروع می‌شود. بازنگری‌ها شناسه کارت را حفظ می‌کنند و هش حاشیه قبلی را در فیلد `supersedes` (منسوخ می‌کند) نام‌گذاری می‌کنند؛ آنها نمی‌توانند دامنه چت را تغییر دهند. جابجایی‌ها، وضعیت‌ها و حذف، رکوردهای جداگانه‌ای هستند. جدول SQLite، دستورهای UPDATE و DELETE را رد می‌کند. فایل `case-board.json` شامل `{statement, signature}` است. بیانیه کانونیکال توسط کلید فضای کاری امضا شده و شامل `format: "tgwitness-case-board-v1"`، `public_key`، `created_at`، `journal_head`، `meaning` و `state` است. وضعیت، بازگشت (replay) تعیین‌کننده است: `annotations_head`، یک آرایه مرتب از `items` (مجموعه‌ها، کارت‌ها، نظرات شامل سنگ‌قبرها)، و `status_history`. موارد، هش، توالی، نویسنده و زمان آخرین حاشیه‌نویسی خود را، و همچنین سازنده اصلی و زمان ایجاد را در طول بازنگری‌ها حفظ می‌کنند. بازپخش، بازنگری‌ها، والدین، ارجاعات مجموعه و شناسه‌های اقدام تکراری را بررسی می‌کند. فایل‌های `manifest.json` و نقاط کنترل جدید نیز `annotations_head` را پیوند می‌دهند. یک نقطه کنترل را به طور مستقل حفظ کنید تا قطع یا بازنویسی با یک کلید امضای کپی‌شده را تشخیص دهید. ### نسخه‌های متنی `range.start` یک آفست نقطه کد یونیکد با مبدا صفر است، `length` یک شمارش نقطه کد مثبت است، و `quote` باید با زیر رشته‌ی دقیق `payload.text` یا `payload.caption` در رویداد هدف یکسان باشد. هیچ‌گونه NFC/NFKC، تبدیل حروف بزرگ و کوچک یا نرمال‌سازی گرافم اعمال نمی‌شود. برش‌های رشته‌ای پایتون و `Array.from(text)` در جاوا اسکریپت همین ایندکس‌گذاری را پیاده‌سازی می‌کنند. ترکیب علائم و ایموجی ZWJ ممکن است چندین کدپوینت را اشغال کند. `range.version` هش رویداد هدف است، نه نسخه فعلی پیام یا آفست واحد UTF-16 تلگرام. ویرایش‌های بعدی هرگز به طور خودکار یک هایلایت را جابجا نمی‌کنند. ### هویت و زمان را برش دهید `query` دقیقاً یک `chat_id` یا یک مجموعه غیرخالی از `chat_ids` را می‌پذیرد، به همراه `from`/`to` اختیاری (شامل)، محدوده‌های شامل شناسه-پیام (برای یک چت)، انواع `kinds: "all"` یا وایلدکارد دقیق/پیشوندی، `actors` صریح، `search`، `hide_system`، و `include_unscoped`. گروه‌های نوع ژورنال به گزاره‌های دقیق خود گسترش می‌یابند. جستجو از جستجوی بار مفید (payload) دفترچه یادداشت با حالت NFC/case-folded استفاده می‌کند، بدون تغییر در متن منبع امضا شده. تاریخ‌ها به یک منطقه زمانی نیاز دارند و به UTC نرمال‌سازی می‌شوند. تاریخ‌ها فیلتر **مشاهده‌شده در (observed_at) را** اعمال می‌کنند. تاریخ `source_at` در تلگرام به صورت جداگانه نمایش داده می‌شود. یک حذف بدون مهر زمانی منبع، زمان حذف فرضی ندارد. یک رکورد دیرهنگام که خارج از یک بازه زمانی مشاهده شود، وارد آن بازه نمی‌شود؛ یک برش شناسه پیام می‌تواند شامل یک حذف بعدی برای آن شناسه پیام‌ها باشد. `snapshot` زمان ایجاد، مرز توالی/هش دفترچه خاطرات، تعداد تطابق، اولین/آخرین توالی و `result_hash` را تثبیت می‌کند. مورد آخر، هش SHA-256 آرایه JSON کانونیکال UTF-8 از هش‌های رویدادهای مطابقت‌یافته است که به صورت واژه‌شناختی مرتب شده‌اند، و شامل `[]` برای یک اسلایس خالی نیز می‌باشد. همچنین شامل شمارش دقیق انواع و یک نمای کوچک ۲۴-بینی از زمان مشاهده است. یک اسلایس یک پرس‌وجو را ذخیره می‌کند، نه رکوردهای منبعی تکراری. هنگام خروجی‌گیری، فایل `board/slices/.json`، هش‌های فعلی و توالی‌های اضافه/حذف‌شده را فهرست می‌کند. اعتبارسنج، ابتدا نتیجهٔ اصلی را در مرز ایجاد، و سپس نتیجهٔ کنونی را بازسازی می‌کند. رکوردهای اضافه شده به عنوان یک واقعیت تغییر گزارش می‌شوند. حذف یک رویداد اصلی، زنجیرهٔ شواهد تغییرناپذیر را می‌شکند؛ این کار به صورت بی‌صدا به عنوان یک حذف معمولی از یک اسلایس پذیرفته نمی‌شود. اسنپ‌شات‌های واکنش دارای فهرست‌های ناقص بازیگران اخیر هستند. اکسپلورر اسنپ‌شات‌های مجاور یک چت/پیام را، از جمله یک اسنپ‌شات قبلی خارج از بازه زمانی، با هم مقایسه می‌کند و تغییرات در تعداد کل **بین مشاهدات** را گزارش می‌دهد. ادعا نمی‌شود که بازیگران اخیر غایب، واکنشی را حذف کرده‌اند. اولین اسنپ‌شات هیچ وضعیت قبلی استنتاج‌شده‌ای ندارد. مشاهدات بازیگران به اسنپ‌شاتی که در آن ارائه شده‌اند نسبت داده می‌شوند، نه به یک زمان اقدام فرضی. ## API و صادرات دستور `GET /api/board` پارامترهای collection/chat/author/label/state/from/to/q/kind/comments، offset/limit و مرتب‌سازی newest/oldest را می‌پذیرد. دستور `GET /api/board/card/{id}` یک کارت، پیش‌نمایش منبع، رشته گفتگو، تاریخچه وضعیت و کارت‌های مرتبط را بازمی‌گرداند. زیرمسیر participants گزینه‌های ذکر (mention) مناسب را بازمی‌گرداند. روش `POST /api/board/{bookmark|highlight|slice|collection|comment|status|move|remove}` یک رکورد را الحاق می‌کند. روش `POST /api/board/slice-preview` یک پرس‌وجو را محاسبه می‌کند. رکوردهای اسلایس در `GET /api/board/slice/{id}/records` صفحه‌بندی می‌شوند؛ بازمحاسبه همیشه از اسنپ‌شات خواندن پایدار فعلی استفاده می‌کند. روش زنده `/api/stream` اعلان‌های `board` بدون بار مفید را، به‌طور جداگانه از نشانگرهای ژورنال، صادر می‌کند. endpoint `GET /api/board/export` یک سند امضا شده را بازمی‌گرداند. دسترسی محدود به چت، یک **افشانامه** امضا شده با برچسب واضح دریافت می‌کند، هرگز حاشیه‌نویسی‌های چت دیگر یا کل زنجیره را دریافت نمی‌کند. فایل‌های فشرده کامل مدرک حاوی `annotations.jsonl`، `case-board.json` امضا شده و ضمیمه‌های JSON برش (slice) هستند. گزارش HTML/PDF/JSON تنظیمات را برای انتخاب عدم وجود برد، نشانک‌ها/برش‌ها بدون بحث، یا کارت‌ها با نظرات تنظیم می‌کند. این بخش صراحتاً نظرات تیم را از مشاهدات جدا می‌کند. فیلترهای داده‌های گزارش، یادداشت‌های قابل خواندن را نیز محدود می‌کنند؛ فایل‌های منبع امضا شده کامل در زیپ شواهد، کامل باقی می‌مانند. `GET /api/board/slice/{id}/export` یک گزیدهٔ JSON امضا‌شده از `tgwitness-board-selection-v1` تولید می‌کند؛ `?format=csv` یک جدول مناسب بدون امضای مستقل تولید می‌کند. JSON و ZIP را حفظ کنید: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_KEY_SHA256 --board python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 python -m tgwitness.verify case-board.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 ``` بررسی انتخاب، صحت بیانیه امضا شده، سوابق دقیق منبع و کامل بودن پرس‌وجوی آن را در مرز مشخص شده تأیید می‌کند. فایل ZIP مدرک ممکن است جدیدتر باشد اما باید شامل آن پیشوند باشد. یک هدف معلق به صراحت گزارش می‌شود. اسنپ‌شات برش اصلی متفاوت، حاشیه نویسی تغییر یافته، وضعیت پخش مجدد نامطابق یا منبع تغییر یافته منجر به شکست می‌شود. آرشیوهای قدیمی بدون حاشیه‌نویسی، رفتار تأیید موجود خود را حفظ می‌کنند. گزینه پیش‌فرض در بخش تحویل **«شامل نکن»** است. شامل کردن صریح، کارت‌ها را از میان سوابق از پیش به حداقل رسیده عبور می‌دهد، اهداف غیرقابل دسترسی/حذف‌شده را نادیده می‌گیرد، موارد برجسته‌شده‌ای را که متن منبعشان به حداقل رسیده است، پنهان می‌کند، متن تیم را با همان قوانین ذکر/تماس پاک‌سازی می‌کند، و به صورت اختیاری برچسب‌های محقق را در متادیتا و موارد شناخته‌شده در یادداشت‌ها با R01، R02… جایگزین می‌کند. هیچ فایل اصلی `annotations.jsonl` افشا نمی‌شود. فایل جانبی امضا شده `tgwitness-case-board-handover-v1` و گزارش حاوی همان محتوای خلاصه‌شده هستند. شمارش اسلایس‌ها فقط سوابق افشا شده را توصیف می‌کند و جزئیات اصلی بازیگر اسنپ‌شات/پرس‌وجو پنهان می‌ماند. نام‌های متنی آزاد که برای کم‌حجم‌کننده ناشناخته هستند، همچنان نیازمند بازبینی هستند، همان‌طور که در واگذاری‌های معمولی نیز چنین است. این نسخه مشتق ادعا نمی‌کند که پس از سانسور، امضاهای حاشیه‌نویسی اصلی را حفظ می‌کند. ## محدودیت‌های عملیاتی پارامترها شامل محدودیت‌های نرم ۱۰٬۰۰۰ کارت و ۵۰٬۰۰۰ نظر، یک صفحه برش (slice) با حداکثر ۵٬۰۰۰ رکورد، و کنترل پیش‌نمایش رسانه هستند. محدودیت‌های نرم بدون حذف تاریخچه، هشدار می‌دهند. صفحات فید حداکثر ۲۰۰ کارت دارند. گزیده‌های مستقل JSON به ۶۴ مگابایت محدود شده‌اند؛ برای پرس‌وجوی دقیق‌تر یا استفاده از فایل ZIP امضا شده برای محتوای بزرگ‌تر، از آن بهره ببرید. اعتبارسنج مستقل، بازپخش حاشیه‌نویسی‌ها را در ۲۵۶ مگابایت محدود می‌کند. هیچ‌گونه اعلان نظرات خارجی توسط کیس برد فعال یا پیاده‌سازی نشده است. پذیرش خودکار این ویژگی از داده‌های فرضی و یک انتقال تلگرام شبیه‌سازی‌شده برای بررسی ذخیره‌سازی، دسترسی، رندرینگ و خروجی‌ها استفاده می‌کند. برای دامنه بررسی‌های شواهد، به بخش «دامنه [اعتبارسنجی»](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope) مراجعه کنید. --- # Telegram · تحلیل بایگانی Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/analysis/ جستجوی پیام‌های ذخیره‌شده، بازبینی ورودی‌های هوش مصنوعی و نگهداری گزارش‌های تحلیلی همراه با ارجاعات منبع. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) جستجوی پیام‌های ذخیره‌شده، بازبینی ورودی‌های هوش مصنوعی و نگهداری گزارش‌های تحلیلی همراه با ارجاعات منبع. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [تحقیق](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/) ![تحقیق](https://phishdestroy.github.io/TgWitness/assets/chapter-investigate.svg) [راهنمای گردش کار](https://phishdestroy.github.io/TgWitness/docs/archive/) · [ویکی](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) از **«ژورنال»** برای جستجوی محلی بدون هوش مصنوعی استفاده کنید؛ [جستجوی تمام‌متن](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/) (پیش‌نمایش) فرم‌های کلمات، عبارات، دامنه‌ها و @نام_کاربری‌ها را مطابقت می‌دهد. برای **«پرسش از آرشیو**»، ابتدا یک ارائه‌دهنده را در بخش **«ادغام‌ها»** فعال و پیکربندی کنید. انتخابگر فضای کاری، حساب کاربری را انتخاب می‌کند؛ فرم، چت‌ها و دوره مشاهده را انتخاب می‌کند. فرآیند بازیابی به‌صورت محلی اجرا می‌شود. یک عبارت یا دامنه دقیق، بازیابی را محدود می‌کند؛ یک شناسه پیام، نسخه‌های ذخیره شده را درخواست می‌کند. گزیده‌ها را مرور کرده و سوابق ژورنال یا زمینه آن‌ها را باز کنید. هیچ پایگاه داده برداری یا اقدام خودکار تلگرامی وجود ندارد. ## ارائه‌دهندگان و رضایت AI در هر فضای کاری غیرفعال است. فقط مدیر اصلی می‌تواند مدل، نقطه پایانی، کلید API رمزگذاری‌شده، محدودیت‌های زمینه/خروجی، زمان‌سرد و بودجه درخواست روزانه را پیکربندی کند. کلید هرگز به مرورگر بازگردانده نمی‌شود. برای حفظ کلید فعلی، فیلد کلید را خالی نگه دارید یا آن را به صراحت حذف کنید. اولاما از [نقطه پایانی مستندشده خود با آدرس `/api/chat`](https://docs.ollama.com/api/chat) با خروجی JSON غیرجریانی استفاده می‌کند. آدرس پیش‌فرض آن `http://127.0.0.1:11434` روی سرور TgWitness است. اپراتور می‌تواند آن را با استفاده از `TGWITNESS_AI_LOCAL_ENDPOINT` تغییر دهد؛ این آدرس تحت کنترل مدل نیست. مدل انتخابی را خودتان نصب کنید. TgWitness آن را به‌طور خودکار دانلود نمی‌کند. پروکسی سازگار انتظار یک URL پایه را دارد که با `/v1` پایان یابد و همچنین [پروتکل‌های Chat Completions](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create): `messages`، حالت پاسخ JSON، `max_completion_tokens` و `choices[0].message.content`. سرویس‌هایی که فاقد این فیلدها هستند پشتیبانی نمی‌شوند. آزمایش اتصال متن مصنوعی ارسال می‌کند و در بودجه درخواست‌ها محاسبه می‌شود. هر درخواست از مسیر خارجی پیکربندی‌شده فضای کاری استفاده می‌کند. یک مسیر مسدود شده یا MTProxy فقط برای تلگرام یک خطا است؛ هیچ تلاش مجدد مستقیمی وجود ندارد. یک آدرس محلی Ollama که عمداً پیکربندی شده باشد، یک مقصد خصوصی را مجاز می‌سازد. یک نقطه پایانی هوش مصنوعی لوپ‌بک به مسیر خارجی مستقیم فضای کاری نیاز دارد؛ مسیرهای پروکسی قبل از ارسال رد می‌شوند. برای سایر خدمات خصوصی، گزینه فعال‌سازی مقصد خصوصی در سطح سرور موجود اعمال می‌شود. پیش‌نمایش، نقطه پایانی و مسیر خارجی را، شامل میزبان پروکسی در صورت لزوم، نشان می‌دهد. تغییر آن مسیر به یک پیش‌نمایش جدید نیاز دارد. پیش از تولید، **داده‌های ارسال‌شده به مدل،** درخواست را نشان می‌دهد: سؤال، گزیده‌های بررسی‌شده، انواع رویدادها، زمان‌های مشاهده و نشانگرهای پوشش. جلسات تلگرام، فیلدهای خام، کلیدهای ارائه‌دهنده، بایت‌های پیوست و کل دفترچه وقایع بخشی از آن زمینه نیستند. منابع ناخواسته را از حالت انتخاب خارج کرده، سپس صراحتاً پردازش را تأیید کنید. ارائه‌دهندگان خارجی ممکن است محتوای ارسال‌شده را طبق سیاست‌های خود حفظ کنند. اجرای محلی به این معناست که نقطه پایانی محلی است؛ این امر تضمینی در مورد رفتار یک سرویس که به طور مستقل پیکربندی شده است، نیست. حداکثر دو درخواست همزمان از ارائه‌دهنده در سطح جهانی و یک درخواست در هر فضای کاری وجود دارد. پیش‌نمایش پس از ده دقیقه منقضی می‌شود و می‌تواند یک پاسخ تولید کند. تعداد توکن‌های گزارش‌شده توسط ارائه‌دهنده نمایش داده می‌شود؛ یک برآورد هزینه تنها زمانی ظاهر می‌شود که هر دو تعرفه ورودی و خروجی پیکربندی شده باشند. تلاش‌های ناموفق نیز از بودجه درخواست روزانه مصرف می‌کنند. هیچ تلاش مجدد خودکار، بودجه اضافی مصرف نمی‌کند. ## منابع و محدودیت‌ها عملیات بازیابی هنگامی که [نمایه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#ask-the-archive-and-mcp) [متن کامل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#ask-the-archive-and-mcp) تکمیل شود، از آن استفاده می‌کند: بهترین تطابق‌ها در سراسر چت‌های انتخاب‌شده، با اشکال واژه‌ای. سؤالات در مورد تغییرات اخیر یا نسخه‌های یک پیام، و جستجوها در حین ساخت نمایه، از جستجوی واژگانی محدود در جدیدترین رکوردها استفاده می‌کنند. پیش‌نمایش نام روش را ذکر می‌کند. عملیات بازیابی تا ۲۴ منبع را بازمی‌گرداند؛ متن‌های طولانی در اطراف تطابق خود بریده می‌شوند. گزیده‌های ناقص و مجموعه‌های نتیجه‌ی نامکمل علامت‌گذاری می‌شوند. این دوره به **زمان مشاهده** اشاره دارد، نه ادعایی مبنی بر کامل بودن تاریخچه‌ی تلگرام. رویدادهای پوشش‌دهی در سطح فضای کاری از دسترسی در محدوده‌ی چت پنهان می‌مانند. داده‌های گمشده به عنوان یافته‌نشده در آرشیو موجود توصیف می‌شوند. مدل هیچ ابزاری دریافت نمی‌کند. شناسه‌های منبع آن در مقابل رکوردهای انتخاب‌شده بررسی می‌شوند، هش‌ها مجدداً بررسی می‌شوند و رشته‌های نقل‌شده باید در آن رکوردها وجود داشته باشند. شناسههای ناشناخته، نقل‌قول‌های تغییر یافته و ادعاهای بدون منبع، پاسخ را رد می‌کنند. این برنامه لینک‌هایی ایجاد می‌کند؛ از URLهای تولید شده توسط مدل به عنوان منبع استناد استفاده نمی‌شود. این بررسی‌ها وجود منبع و صحت نقل‌قول را تأیید می‌کنند، نه درستی یک استنتاج را. پیش از اتکا به استنتاج‌ها، آن‌ها را با سوابق بررسی کنید. ## گزارش‌ها یک پاسخ بررسی‌شده را به عنوان یک گزارش تحلیلی جداگانه ذخیره کنید. این شامل خلاصه مدل، توالی زمانی مشاهده‌شده، لینک‌ها و نام‌های کاربری استخراج‌شده، سوابق ویرایش/حذف، محدودیت‌های پوشش و هش‌های رویداد منبع است. نسخه ارائه‌دهنده، مدل، نقطه پایانی، زمان و قالب-پرومپت نیز آن را همراهی می‌کنند. هیچ هویتی به طور خودکار ادغام نمی‌شود. اصلاحات و یادداشت‌های تحلیلگر به طور جداگانه‌ای از خلاصه مدل ذخیره می‌شوند. گزارش‌ها در فایل‌های مشتق رمزگذاری‌شده نگهداری می‌شوند، با یک نمایه در خارج از جریان رویدادهای امضا شده؛ رویدادها و رسانه‌های اصلی تغییر نمی‌کنند. فقط مالک یا مدیر می‌تواند یک گزارش را باز کند، و دسترسی به منبع دوباره بررسی می‌شود. دانلود نیز به مجوز صدور (export) نیاز دارد. نسخه ۱ گزارش‌ها را امضا نمی‌کند و تلویحاً بیان نمی‌کند که نتیجه‌گیری‌های مدل شواهد تأییدشده هستند. محدودیت‌ها: ۱۰۰ گزارش در هر فضای کاری و ۱۰۰ بازنگری تحلیلگر در هر گزارش. برای OCR دستی و رونوشت‌ها، به [پردازش رسانه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/media-analysis/) مراجعه کنید. برای دسترسی به کلاینت، به [MCP](https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/) مراجعه کنید. --- # Telegram · جستجوی متن کامل Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/ پیام‌های ذخیره‌شده را بر اساس شکل‌های واژه‌ای، عبارات دقیق، دامنه‌ها و نام‌های کاربری @ پیدا کنید، بهترین تطابق‌ها در اولویت، با شاخص متصل به دفترچهٔ امضا‌شده. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) پیام‌های ذخیره‌شده را بر اساس شکل‌های واژه‌ای، عبارات دقیق، دامنه‌ها و نام‌های کاربری @ پیدا کنید، بهترین تطابق‌ها در اولویت، با شاخص متصل به دفترچهٔ امضا‌شده. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [تحقیق](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/) ![تحقیق](https://phishdestroy.github.io/TgWitness/assets/chapter-investigate.svg) [تحلیل بایگانی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/analysis/) · [شناسایی نوری حروف (OCR) و رونویسی محلی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/media-analysis/) · [ویکی](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **پیش‌نمایش.** در **«ژورنال**»، **«بهترین تطابق · اشکال واژه‌ای» را** در کنار کادر جستجو انتخاب کنید. نتایج با BM25 رتبه‌بندی می‌شوند و با سایر اشکال همان کلمه مطابقت دارند: *«перевод» کلمات* *«переводом»* و *«переводы» را* پیدا می‌کند، *«transfer» کلماتی مانند* *«transfers» را* پیدا می‌کند و یک عبارت چینی بدون فاصله پیدا می‌شود. **«جدیدترین‌ها اول · متن دقیق»** جستجوی زیر رشته‌ای قبلی را بر روی کل رکورد حفظ می‌کند. این شاخص داده‌ای مشتق‌شده است. این شاخص از دفترچهٔ امضا‌شده بازسازی می‌شود، خود هرگز امضا نمی‌شود و هرگز صادر نمی‌گردد. سوابق اصلی تغییر نمی‌کنند. **در این صفحه** - [سینتکس جستجو](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#search-syntax) - [زبان‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#languages) - [محل قرارگیری ایندکس](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#where-the-index-lives) - [نتایج و دفترچهٔ ثبت‌شدهٔ امضاشده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#results-and-the-signed-journal) - [متن شناسایی‌شده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#recognized-text) - [دسترسی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#access) - [از آرشیو و MCP بپرسید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#ask-the-archive-and-mcp) - [وابستگی‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#dependencies) - [معیار سنجی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#benchmark) ## سینتکس جستجو | نوشتن | یافته‌ها | | --- | --- | | `перевод карта` | سوابقی که هر دو کلمه را به هر شکلی در خود دارند | | `"переводом на карту"` | عبارت دقیق، به همین ترتیب | | `бонус OR подарок` | هر یک از کلمات | | `перевод -казино` | سوابق بدون کلمهٔ مستثنی‌شده | | `example.com` | دامنه و زیردامنه‌های آن، همچنین در لینک‌های مخفی و آدرس‌های دکمه‌ها | | `@username`, `t.me/username` | ذکرها و لینک‌های حساب کاربری و پیام‌هایی که ارسال کرده است | | `#tag` | هشتگ | | `+79991234567`، یک آدرس کیف‌پول، یک آدرس ایمیل | همان مقدار در متن یا پیوندها | | `from:@username`, `from:123456` | پیام‌ها از آن فرستنده | | `chat:-1001234567890` | یک چت؛ این فقط می‌تواند دسترسی شما را محدود کند | | `id:42` | نسخه‌های ذخیره شده پیام ۴۲ | | `since:2026-01-01 until:2026-01-31` | دورهٔ مشاهده؛ یک تاریخ بدون زمان کل روز را در بر می‌گیرد | | `kind:edited` | فقط ویرایش‌ها (`new`, `snapshot`, `edited`, `recovered`) | | `source:ocr`, `source:transcription`, `source:all` | متن شناسایی‌شده به‌جای پیام‌ها یا همراه با آن‌ها | حروف اضافه و سایر کلمات وظیفه‌ای (function words) در صورت وجود کلمات دیگر نادیده گرفته می‌شوند. حروف مشابه که در یک کلمه آمیخته شده‌اند (مانند حرف *a* لاتین در یک کلمه سیریلیک)، حروف پهن‌عرض و تزئینی یونیکد و کاراکترهای نامرئی نرمال‌سازی می‌شوند. ## زبان‌ها زبان هر رکورد بر اساس خط و حروف آن شناسایی می‌شود: | اسکریپت | مطابقت | | --- | --- | | سیریلیک | لماهای روسی و اوکراینی با [pymorphy3](https://github.com/no-plagiarism/pymorphy3). بدون فرهنگ لغت اختیاری اوکراینی، از یک استمر سبک اوکراینی استفاده می‌شود. | | لاتین | ریشه‌گیر انگلیسی Snowball؛ نشانه‌های diakritik نادیده گرفته می‌شوند | | چینی، ژاپنی، کره‌ای، تایلندی، لائوسی، خمر، میانماری | جفت‌های کاراکتری هم‌پوشان: هر عبارت بدون فاصله یافت می‌شود. پرس‌وجوهای چینی با jieba به کلمات تقسیم می‌شوند. | | سایر اسکریپت‌ها | واژه‌های دقیق | واژه‌نامه اوکراینی (`pymorphy3-dicts-uk`) تحت مجوز GPL-3.0 توزیع می‌شود، بنابراین به‌صورت پیش‌فرض نصب نمی‌شود. آن را با `pip install "tgwitness[uk-dictionary]"`؛ ایندکس تحلیلگر جدید را تشخیص داده و خود را مجدداً ساخت می‌کند. ## محل قرارگیری ایندکس | حالت | ذخیره‌سازی | استفاده | | --- | --- | --- | | روی دیسک (پیش‌فرض) | `search/fulltext.sqlite3` در دایرکتوری فضای کاری | آرشیوهای بزرگ؛ پس از راه‌اندازی مجدد باقی می‌ماند | | فقط در حافظه | هیچ چیزی روی دیسک نیست؛ در هر بار راه‌اندازی دوباره ساخته می‌شود | هیچ نسخهٔ مشتق‌شده‌ای از متن پیام روی دیسک وجود ندارد | | خاموش | بدون فهرست؛ **جدیدترین‌ها اول · متن دقیق** باقی می‌ماند | نصب‌های حداقلی | مدیر اصلی برای هر فضای کاری، حالت را در مسیر **دفترچه یادداشت → فیلترها → نمایه جستجو** انتخاب می‌کند. `TGWITNESS_FULLTEXT=disk|memory|off` مقدار پیش‌فرض را برای فضاهای کاری که انتخاب خاص خود را ندارند، تعیین می‌کند. سوئیچ کردن به حافظه یا حالت خاموش، فایل را حذف می‌کند. فایل نمایه همان حفاظت را دارد که دفترچه یادداشت دارد: در دایرکتوری داده‌های خصوصی قرار دارد. این فایل رمزگذاری نشده و بخشی از پشتیبان‌گیری‌ها یا نسخه‌های خارج از محل نیست. سوابق جدید در پس‌زمینه و ظرف چند ثانیه نمایه می‌شوند؛ جستجو نیز ابتدا یک پیش‌نمایه کوتاه را نمایه می‌کند، بنابراین سوابق ذخیره شده در لحظاتی پیش یافت می‌شوند. یک دفترچه موجود پس از به‌روزرسانی و بدون مسدود کردن پنل نمایه می‌شود؛ تا آن زمان، نتایج شامل سوابق نمایه‌شده می‌شوند و دفترچه پیشرفت را نشان می‌دهد. **بازسازی نمایه** از ابتدا از اولین سابقه شروع می‌شود. ``` python -m tgwitness index status --data-dir data/live python -m tgwitness index rebuild --data-dir data/live --json ``` `rebuild` نیاز دارد پنل متوقف شود (در غیر این صورت کد خروج ۳). با `--json`، خروجی استاندارد فقط نتیجه را در بر می‌گیرد؛ پیشرفت به خطای استاندارد فرستاده می‌شود. ## نتایج و دفترچهٔ امضا شده ایندکس، شماره ترتیبی و هش آخرین رکورد ژورنال را که پوشش می‌دهد ذخیره می‌کند و هنگام باز شدن ژورنال، آن‌ها را با خود ژورنال مطابقت می‌دهد. یک ژورنال جایگزین‌شده، بازیابی‌شده یا ویرایش‌شده باعث بازسازی می‌شود. هر پاسخ، این موقعیت را گزارش می‌کند و هر هیت (hit) از طریق شماره ترتیبی‌اش از ژورنال امضا شده خوانده می‌شود: ایندکس تصمیم می‌گیرد کدام رکوردها را و به چه ترتیبی نمایش دهد، نه محتوای آن‌ها را. دسترسی به چت بر روی فیلد چت خود ژورنال اعمال می‌شود، نه محتوای ایندکس. ## متن شناسایی‌شده حروف‌نگاری نوری (OCR) و رونوشت‌ها در آثار رمزگذاری‌شدهٔ خود باقی می‌مانند. نمایهٔ آن‌ها تنها در حافظه وجود دارد و هنگام اتمام یک کار شناسایی بازسازی می‌شود. یک تطابق در نمایه‌اش ظاهر می‌شود که همچنان زیرمجموعه‌های ساده را نیز تطبیق می‌دهد. `media.saved` سوابق، برچسب‌گذاری شده به عنوان تشخیص ماشین به همراه موتور، مدل و یک گزیده؛ هرگز به عنوان متنی که در تلگرام ارسال شده است ارائه نمی‌شود. همین نمایه برای **جستجوی متن‌های تشخیص داده شده** نیز استفاده می‌شود، که همچنان با زیر رشته‌های ساده نیز مطابقت دارد. ## دسترسی دسترسی محدود به چت تنها رکوردهای مربوط به چت‌های خود را، از جمله متن‌های شناخته‌شده پیوست‌هایشان، پیدا می‌کند. `chat:` و سایر فیلترها فقط می‌توانند آن مجموعه را محدودتر کنند. وضعیت نمایه‌ای که به دسترسی محدودشده نشان داده می‌شود، آمار کل دفترچه را حذف می‌کند. فقط مدیر اصلی می‌تواند حالت را تغییر دهد یا نمایه را بازسازی کند. ## از آرشیو و MCP بپرسید زمانی که ایندکس کامل شد، **ابزار Ask the archive** منابع خود را از آن بازیابی می‌کند: بهترین تطابق‌ها در میان چت‌های انتخاب‌شده، به‌طوری‌که هر متن ذخیره‌شده فقط یک بار شمارش می‌شود. تا ۲۴ منبع ارسال می‌شود؛ متن‌های طولانی در اطراف تطابق خود بریده شده و به‌عنوان ناقص علامت‌گذاری می‌شوند. سوالات در مورد تغییرات اخیر، نسخه‌های ذخیره‌شده یک پیام، و جستجوها در حالی که ایندکس هنوز در حال ساخت است، از بازیابی زمانی قبلی استفاده می‌کنند. پیش‌نمایش نشان می‌دهد که از کدام روش استفاده شده است. کلاینت‌های MCP می‌توانند فراخوانی کنند `search_messages` با `ranked=true` و صفحه با `next_offset`اتصالات محدود‌دامنه تنها چت‌های خود را دریافت می‌کنند. پagination رتبه‌بندی‌شده حداکثر شامل اولین 1,000 نتیجه است، صرف‌نظر از اندازه صفحه. برای بررسی نتایج بیشتر، پرس‌وجو، گفتگو یا دوره را محدود کنید. جستجوها بر اساس جدیدترین-ابتدا، پیام‌ها، نتایج OCR و رونویسی را قبل از انتخاب هر صفحه مرتب می‌کنند. ## وابستگی‌ها | پکیج | مجوز | چرا | | --- | --- | --- | | pymorphy3، pymorphy3-dicts-ru، DAWG2-Python | ام‌آی‌تی | لماهای روسی و اوکراینی؛ فرهنگ‌ها به‌صورت محلی بارگذاری شده‌اند | | snowballstemmer | بند ۳ BSD | ریشه‌های انگلیسی، پایتون خالص | | جیبا | ام‌آی‌تی | بخش‌بندی پرس‌وجوی چینی، پایتون خالص (فقط توزیع منبع) | | pymorphy3-dicts-uk (اختیاری) | GPL-3.0 | واژه‌نامه کامل اوکراینی | SQLite FTS5 با `unicode61` تک‌پارچه‌ساز (tokenizer) مورد نیاز است؛ این بخش بخشی از SQLite در نسخه‌های فعلی پایتون است. بدون آن، جستجو بر اساس بهترین تطابق گزارش می‌دهد که در دسترس نیست. ## معیار سنجی `python tools/bench_fulltext.py --messages 1000000 --work `یک ژورنال امضاشده‌ی تعیین‌کننده‌ای از پیام‌های ترکیبی روسی، اوکراینی، انگلیسی، چینی و ژاپنی با لینک‌ها و هندل‌ها در ۲۰۰ چت ایجاد می‌کند، نمایه را می‌سازد و جستجوهای معمول را زمان‌بندی می‌کند (۵۰ نتیجه، میانه از ۷ اجرا). اندازه‌گیری شده بر روی ویندوز ۱۱، اینتل Core i9-13900K، ۱۲۸ گیگابایت رم، پایتون ۳.۱۲.۱۰، SQLite ۳.۴۹.۱، داده‌ها بر روی یک درایو exFAT، تحلیلگر `fulltext-v1+pymorphy3-ru+light-uk+snowball-en`: | اندازه‌گیری | نتیجه | | --- | --- | | ژورنال امضا‌شده | ۱٬۰۰۰٬۰۰۰ پیام، ۱٫۵۰ گیگابایت، نوشته شده در ۱۹ دقیقه | | فهرست‌سازی بر اساس ژورنال | ۷۱ ثانیه، حدود ۱۴٬۱۴۱ پیام در ثانیه | | فایل نمایه | ۵۸ مگابایت، ۳٫۸٪ از دفترچه یادداشت | | پس از ثبت یک رکورد جدید، جستجو کنید | میانگین ۸ میلی‌ثانیه، p95 برابر ۹ میلی‌ثانیه | | جستجوی زیر رشته‌ی قبلی، همان دفترچه یادداشت | `перевод` ۳.۲ ثانیه، `银行转账` ۲.۶ ثانیه، `verify-account.example` 2.6 ثانیه | | جستجو | سوابق تطبیق‌یافته | بهترین تطابق، میانه | p95 | جدیدترین‌ها اول، میانه | | --- | --- | --- | --- | --- | | واژهٔ مشترک، اشکال واژه: `перевод` | 134,403 | ۸۲ میلی‌ثانیه | ۸۵ میلی‌ثانیه | ۷ میلی‌ثانیه | | دو کلمه: `оплата карта` | 28,996 | ۴۳ میلی‌ثانیه | ۴۳ میلی‌ثانیه | ۱۴ میلی‌ثانیه | | واژهٔ نادر: `розыгрыш подарок` | 28,881 | ۴۲ میلی‌ثانیه | ۴۷ میلی‌ثانیه | ۱۳ میلی‌ثانیه | | عبارت دقیق: `"переказ коштів на картку"` | شمرده نشده | ۳۵ میلی‌ثانیه | ۳۶ میلی‌ثانیه | ۶ میلی‌ثانیه | | دامنه با زیردامنه‌ها: `verify-account.example` | 12,435 | ۱۷ میلی‌ثانیه | ۱۷ میلی‌ثانیه | ۳ میلی‌ثانیه | | @نام_کاربری: `@support_desk_bot` | 10,331 | ۱۵ میلی‌ثانیه | ۱۶ میلی‌ثانیه | ۳ میلی‌ثانیه | | چینی بدون فاصله: `银行转账` | 17,691 | ۲۳ میلی‌ثانیه | ۲۴ میلی‌ثانیه | ۳ میلی‌ثانیه | | ژاپنی: `リンク` | 16,603 | ۲۳ میلی‌ثانیه | ۲۵ میلی‌ثانیه | ۳ میلی‌ثانیه | | ریشهٔ انگلیسی: `withdrawal` | 27,775 | ۲۶ میلی‌ثانیه | ۲۶ میلی‌ثانیه | ۲ میلی‌ثانیه | | یا و استثناء: `бонус OR подарок -казино` | 268,034 | ۱۹۰ میلی‌ثانیه | ۱۹۳ میلی‌ثانیه | ۱۹ میلی‌ثانیه | | فیلتر چت: `chat:-1000000000007 перевод` | 652 | ۹ میلی‌ثانیه | ۹ میلی‌ثانیه | ۶ میلی‌ثانیه | | فیلتر دوره: `since:2026-01-01 until:2026-01-31 выплата` | 115,732 | ۱۵۵ میلی‌ثانیه | ۱۵۶ میلی‌ثانیه | ۸۱ میلی‌ثانیه | یک عبارت دقیق به صورت تحت‌اللفظی روی کاندیداها به ترتیب رتبه‌بندی بررسی می‌شود تا زمانی که صفحه پر شود، بنابراین مجموع آن شمارش نمی‌شود. زمان‌ها با تعداد سوابق مطابقت‌یافته افزایش می‌یابند؛ محدود کردن چت یا دوره، جستجوهای گسترده را سریع‌تر می‌کند. مجموعه داده‌های مصنوعی واژگان کمی را تکرار می‌کند، بنابراین کلمات رایج با سوابق بسیار بیشتری مطابقت دارند تا در چت‌های واقعی. --- # Telegram · MCP فقط-خواندنی Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/ یک کلاینت MCP را به فضاهای کاری و چت‌های منتخب با دسترسی منقضی‌شونده و قابل فسخ متصل کنید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) یک کلاینت MCP را به فضاهای کاری و چت‌های منتخب با دسترسی منقضی‌شونده و قابل فسخ متصل کنید. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [یکپارچه‌سازی‌های آرشیو](https://phishdestroy.github.io/TgWitness/fa/docs/reference/cli/) ![یکپارچه‌سازی‌های آرشیو](https://phishdestroy.github.io/TgWitness/assets/chapter-integrations.svg) یک کلاینت تحلیلگر را به فضاهای کاری و چت‌های منتخب متصل کنید. TgWitness **در فرآیند پنل، HTTP قابل جریانی‌سازی را در `/mcp`** ارائه می‌دهد. هر اتصال دارای توکن، تاریخ انقضا و ابزارهای مجاز خاص خود است. MCP نمی‌تواند پیام‌های تلگرام ارسال کند، تنظیمات را تغییر دهد یا دفترچه یادداشت امضا شده را اصلاح کند. همین اتصالات با [خط فرمان](https://phishdestroy.github.io/TgWitness/fa/docs/reference/cli/)نیز کار می‌کنند. [راهنمای گردش کار](https://phishdestroy.github.io/TgWitness/docs/archive/) · [ویکی](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **در این صفحه** - [نصب و بررسی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/#install-and-check) - [ایجاد یک اتصال](https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/#issue-a-connection) - [کلاینت خود را وصل کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/#connect-your-client) - [تونل کلودفلر](https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/#cloudflare-tunnel) - [ابزارها و مرزها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/#tools-and-boundaries) ## نصب و بررسی از محیط پایتونی استفاده کنید که پنل را اجرا می‌کند. از یک نسخه دریافت‌شده از سورس: ``` # Windows PowerShell & .\.venv\Scripts\python.exe -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' & .\.venv\Scripts\python.exe start.py --check ``` ``` # Linux / macOS .venv/bin/python -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' .venv/bin/python start.py --check ``` پس از نصب، پنل را با دایرکتوری داده و آرگومان‌های راه‌اندازی همیشگی آن مجدداً راه‌اندازی کنید. بررسی آمادگی باید شامل `[PASS] mcp: streamable-http available` باشد. مسیر **Integrations → MCP** وضعیت زمان اجرا و دستور نصب را با استفاده از فایل اجرایی واقعی پایتون آن سرور نشان می‌دهد. گزینه **Re-check** این وضعیت را بدون بارگذاری مجدد صفحه به‌روزرسانی می‌کند؛ این گزینه بسته‌ها را نصب نمی‌کند و سرور را مجدداً راه‌اندازی نمی‌کند. MCP extra از [SDK رسمی MCP Python](https://github.com/modelcontextprotocol/python-sdk) استفاده می‌کند.`deploy/constraints-mcp.txt` SDK آزمایش‌شده و وابستگی‌ها را ثابت می‌کند. ## صدور یک اتصال 1. یک برچسب وارد کنید و محیط‌های کاری و چت‌هایی را که کلاینت مجاز به خواندن آن‌هاست انتخاب کنید. 2. ابزارها را به‌صورت تکی انتخاب کنید یا از یک پیش‌تنظیم استفاده کنید. تنها ابزارهای پیاده‌سازی‌شده ارائه می‌شوند. 3. مدت 1، 7، 30 یا 90 روز، یا یک زمان انقضای سفارشی بین یک دقیقه تا 90 روز را انتخاب کنید. 4. دکمه **Create connection** را فشار دهید. توکن یک بار در کنار پیکربندی کلاینت ظاهر می‌شود. 5. توکن و پیکربندی را کپی کنید، سپس **Check connection** را اجرا کنید. این کار MCP را مقداردهی اولیه کرده و ابزارهای مجاز را فهرست می‌کند؛ **هیچ پیامی خوانده نمی‌شود**. نتیجه، نسخه پروتکل، نام ابزارها، تعداد و زمان سپری‌شده را نشان می‌دهد. 6. زمانی که اطلاعات احراز هویت ذخیره شد، **Done** را فشار دهید. بررسی دوره‌ای (Polling) فرم و کارت یک‌بارمصرف نمایش‌داده‌شده را حفظ می‌کند. قفل کردن پنل، اطلاعات محرمانه نمایش‌داده‌شده را پاک می‌کند. این فهرست استفاده اخیر، آخرین ابزار، آدرس و درخواست‌ها در دقیقه گذشته را نشان می‌دهد. گزینه **Revoke** دسترسی را پایان می‌دهد. گزینه **Rotate token** اعتبارنامه قدیمی را باطل کرده و یک جایگزین با همان محدوده، ابزارها و تاریخ انقضا صادر می‌کند؛ جایگزین را یک بار کپی کنید. توکن‌های ورود به پنل و اعتبارنامه‌های تلگرام به‌عنوان توکن‌های MCP کار نمی‌کنند. ## اتصال کلاینت شما کلاینت را در پنل انتخاب کنید و پیکربندی تولیدشده آن را کپی کنید. پیکربندی‌ها از ارجاعات محرمانه یا متغیرهای جایگزین صریح استفاده می‌کنند؛ توکن به‌صورت جداگانه کپی می‌شود. | کلاینت | پیکربندی | اتصال | | --- | --- | --- | | کد کلاود | `.mcp.json` | HTTP، `type: "http"`، هدر bearer | | کلود دسکتاپ | `claude_desktop_config.json` | پل محلی stdio | | Cursor | `.cursor/mcp.json` | HTTP با یک هدر متغیر محیطی | | کد محلی VS Code | `.vscode/mcp.json` | HTTP با یک ورودی رمز عبور `promptString` | | Windsurf | `mcp_config.json` | HTTP با یک متغیر جایگزین هدر bearer | | سایر کلاینت‌ها | URL و هدر Authorization | HTTP قابل پخش | TgWitness از توکن‌های bearer بدون اکتشاف OAuth استفاده می‌کند. برای کلاینت‌هایی که اتصال‌دهنده راه‌دور آن‌ها نیازمند OAuth است، از پل محلی stdio استفاده کنید. برای VS Code، متغیرهای ورودی روی بستر **Local** اعمال می‌شوند و به نشست‌های Copilot ارسال نمی‌گردند. مراجع پیکربندی: [Claude Code](https://code.claude.com/docs/en/mcp)، [Cursor](https://prod.cursor.com/docs/mcp)، [VS Code](https://code.visualstudio.com/docs/agents/reference/mcp-configuration). نقطه ورود استاندارد برای یک پل محلی عبارت است از: ``` python -m tgwitness.mcp_server --url https://your-panel.example/mcp ``` از پایتون محلی کلاینت که افزونه MCP روی آن نصب شده است استفاده کنید. متغیر `TGWITNESS_MCP_TOKEN` را در محیط حفاظت‌شده آن تنظیم کنید. اطلاعات احراز هویت را خارج از آرگومان‌های دستور و URLها نگه دارید. دستور `tgwitness-mcp` همان نقطه ورود است. ماژول قدیمی `tgwitness.mcp_bridge` و نام `TGWITNESS_ARCHIVE_TOKEN` به‌عنوان مسیرهای سازگاری همراه با یک هشدار باقی می‌مانند؛ پیکربندی‌های جدید از `mcp_server` و `TGWITNESS_MCP_TOKEN` استفاده می‌کنند. ## تونل کلودفلر مسیر `/mcp` پنل را فوروارد کرده و هدر bearer را حفظ کنید. باز کردن تنظیمات MCP به‌عنوان مدیر، مبدأ (Origin) فعلی پنل را برای این نوبت اجرا ثبت می‌کند. برای داشتن یک آدرس پایدار که بلافاصله پس از راه‌اندازی مجدد در دسترس باشد، پیش از شروع پنل، متغیر `TGWITNESS_PUBLIC_URL` را با مبدأ HTTPS پنل پیکربندی کنید. هدرهای دلخواه Host و فورواردشده، یک آدرس مورد اعتماد را ثبت نمی‌کنند. بررسی‌های Host و Origin، مبدأهای مرورگر نامرتبط را رد می‌کنند. پاسخ‌ها از `Cache-Control: no-store` استفاده می‌کنند؛ مقادیر احراز هویت هرگز در گزارش‌ها (لاگ) ثبت نمی‌شوند. یک آدرس `*.trycloudflare.com` موقتی است. هنگامی که راه‌اندازی مجدد تونل نام میزبان (hostname) را تغییر می‌دهد، URL عمومی پیکربندی‌شده و URL مربوط به MCP هر کلاینت را به‌روزرسانی کنید. برای پیکربندی‌های ذخیره‌شده کلاینت، از یک نام میزبان پایدار استفاده کنید. ## ابزارها و مرزها | ابزار | موارد قابل خواندن | | --- | --- | | `list_workspaces` | محیط‌های کاری مجاز | | `list_chats` | چت‌های مجاز | | `search_messages` | متن پیام‌های ذخیره شده در بازهٔ زمانی انتخاب‌شده؛ `ranked=true` از [جستجوی تمام‌متنی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/) استفاده می‌کند (شکل‌های کلمات، بهترین تطابق‌ها در اولویت، `next_offset` صفحه‌بندی) | | `get_message_versions` | نسخه‌های ثبت‌شده و مشاهدات مربوط به حذف | | `get_message_context` | شناسه‌های پیام‌های ثبت‌شده در مجاورت | | `get_journal_event` | یک رکورد پاک‌سازی‌شده به همراه مرجع منبع آن | | `get_capture_status` | وضعیت جمع‌آوری، سوابق پوشش مجاز و `gap_summary`: شماره‌های پیام‌هایی که هرگز مشاهده نشده‌اند، به تفکیک کانال یا ابرگروه و برای توالی در سطح حساب ([جزئیات](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#missing-message-numbers-gap_summary))؛ یک چت را انتخاب کنید تا فواصل فهرست‌شده آن را ببینید | | `get_activity_stats` | پیام‌ها بر اساس ساعت UTC و روز هفته، روزهای اوج، اشتراک‌گذاری ویرایش و حذف، فرستندگان، دامنه‌ها و `@handles`، همراه با پوشش ([جزئیات](https://phishdestroy.github.io/TgWitness/fa/docs/reference/cli/#activity-statistics)) | | `get_messages_by_date` | پیام‌های ذخیره‌شده یک روز تقویمی در یک منطقه زمانی نام‌گذاری‌شده IANA (`Europe/Kyiv`, `UTC`)، تا زمانی که تلگرام گزارش می‌دهد؛ `from_utc` و `until_utc` روز محاسبه شده را مشخص کنید، شامل ساعت تابستانی | | `get_pinned_messages` | پیام‌های سنجاق‌شده در آخرین اسنپ‌شات وضعیت چت همراه با نسخه‌های ذخیره‌شده‌شان، و اعلان‌های سنجاق‌کردن و بازکردن سنجاق به‌صورت زنده مشاهده می‌شوند | | `get_chat_stats` | شمارش‌های ارزان‌قیمت سوابق ذخیره‌شده برای یک چت یا هر چت در محدوده، اولین و آخرین مشاهده، و `gap_summary`؛ قبل از یک خوانش بزرگ از آن استفاده کنید | | `get_topics` | موضوعات انجمن از پیام‌های سرویس موضوعات ذخیره شده: تاریخچه عنوان، بسته‌شده یا مخفی، تعداد پیام‌های ذخیره شده | | `get_media` | یک تصویر حفظ‌شده به‌عنوان پیش‌نمایش JPEG با کاهش وضوح (حداکثر ۳۶ کیلوبایت)، که همراه با SHA-256 خود و `media.saved` ثبت؛ فایل ابتدا با هش ثبت‌شده خود مطابقت داده می‌شود، سایر فایل‌ها فقط متادیتا را بازمی‌گردانند | | `export_messages` | فقط خط فرمان، به‌صورت پیش‌فرض انتخاب نشده است: جریان‌ها مشاهدات ضبط‌شده را به‌صورت JSON Lines ذخیره می‌کنند ([جزئیات](https://phishdestroy.github.io/TgWitness/fa/docs/reference/cli/#export))؛ از طریق MCP ارائه نمی‌شود | هر ابزار فقط-خواندنی است (`readOnlyHint`) و یک طرح‌بندی خروجی را اعلام می‌کند؛ فیلدهایی فراتر از موارد اعلام‌شده همان‌طور که هستند بازگردانده می‌شوند. `tools/list` فقط ابزارهایی را بازمی‌گرداند که به آن اتصال اعطا شده‌اند. فراخوانی ابزارهای دیگر رد می‌شود. ابزارهای زمینه گروه، اپیزود، اصطلاح‌شناسی و زنجیره پاسخ در این نسخه ارائه نمی‌شوند؛ بک‌اند جداگانه بسته‌بندی زمینه آنها گنجانده نشده است. هر عملیات خواندن، توکن، ابزار و محدوده محیط کاری/چت را بررسی می‌کند، از جمله پس از پایان کار پایگاه داده. محدودیت‌ها شامل 60 درخواست در دقیقه، 50 رکورد در هر صفحه، 64 KiB برای هر نتیجه و مهلت زمانی هشت ثانیه‌ای آرشیو است. یک فراخوانی MCP که مهلت زمانی آن به پایان رسیده باشد، خطای ابزاری را برمی‌گرداند که درخواست بازه زمانی کوتاه‌تر یا محدودیت کمتری دارد. نتایج پیام شامل `untrusted_content: true`، شناسه‌های محیط کاری/چت/پیام، توالی رویداد، هش ذخیره‌شده و یک لینک به پنل هستند. اشیاء خام تلگرام، هش‌های دسترسی، نشست‌ها و کلیدها حذف می‌شوند. کوتاه شدن متن علامت‌گذاری می‌شود. ویرایش‌ها، اعلان‌های حذف و `missing_on_recheck` مشاهداتی متمایز هستند. نبود رکوردها ثابت نمی‌کند که یک رویداد هرگز رخ نداده است. با دستورالعمل‌های موجود در پیام‌های ثبت‌شده به‌عنوان مدرک رفتار کنید، نه هرگز به‌عنوان دستورالعمل‌های کلاینت. دسترسی فقط-خواندنی از تغییرات آرشیو جلوگیری می‌کند؛ با این حال کلاینت همچنان می‌تواند محتوایی را که مجاز به خواندن آن است، نزد خود نگه دارد. هش‌ها رکوردهای ذخیره‌شده را شناسایی کرده و از بررسی‌های یکپارچگی پشتیبانی می‌کنند؛ آن‌ها انتساب به تلگرام یا ثبت کامل را اثبات نمی‌کنند. --- # Telegram · خط فرمان Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/cli/ جستجو، خواندن زمینه، شمارش فعالیت و صادر کردن پیام‌های ذخیره‌شده از اسکریپت‌ها و ایجنت‌ها، با خروجی --json، کدهای خروجی پایدار و توکن‌های محدودخوانی. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) جستجو، خواندن زمینه، شمارش فعالیت و صادر کردن پیام‌های ذخیره‌شده از اسکریپت‌ها و ایجنت‌ها، با خروجی --json، کدهای خروجی پایدار و توکن‌های محدودخوانی. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![یکپارچه‌سازی‌های آرشیو](https://phishdestroy.github.io/TgWitness/assets/chapter-integrations.svg) [MCP فقط-خواندنی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/mcp/) · [جستجوی متن کامل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/) · [ویکی](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **پیش‌نمایش.** `tgwitness search`, `context`, `messages`, `stats` و `export` خواندن مشاهدات ذخیره شده برای اسکریپت‌ها و عامل‌های هوش مصنوعی. آنها نمی‌توانند هیچ چیزی را به تلگرام ارسال کنند، تنظیمات را تغییر دهند یا مجله امضا شده را اصلاح کنند. با `--json`، stdout دقیقاً یک سند JSON را منتقل می‌کند (`export` خطوط JSON را می‌نویسد). پیشرفت، سرنخ‌ها و خطاها به stderr ارسال می‌شوند. کدهای خروجی پایدار هستند: | کد | معنی | | --- | --- | | `0` | موفقیت، شامل یک نتیجهٔ خالی | | `1` | خطا: پنل غیرقابل دسترسی، داده‌های غیرقابل خواندن، خروجی‌گیری قطع‌شده | | `2` | خطای استفاده یا درخواست نامعتبر: تاریخ نامعتبر، گزینهٔ ناشناخته، نمایهٔ جستجو نامناسب | | `3` | فعلاً در دسترس نیست: فضای کاری در یک پنل در حال اجرا باز است، یا پنل درخواست می‌کند بعداً دوباره تلاش کنید (محدودیت نرخ، اتمام زمان) | | `4` | دسترسی رد شد: توکن مفقود، منقضی یا لغو شده، چتی خارج از محدودهٔ آن، ابزاری که اجازه نمی‌دهد | ## دو روش برای خواندن **از طریق پنل (`--url`).** این فرمان از همان API آرشیو محدود (scoped archive API) که در MCP استفاده می‌شود بهره می‌برد. یک اتصال در **بخش** **Integrations → MCP** ایجاد کنید: فضاهای کاری و چت‌ها، ابزارها و یک تاریخ انقضا را انتخاب کرده و سپس توکن را یک‌بار کپی کنید. این اتصال فقط برای خواندن است، به همان چت‌ها محدود است، با نرخ ۶۰ درخواست در دقیقه محدود شده و می‌توان آن را در هر زمان لغو یا چرخاند. توکن‌های ورود به پنل و اطلاعات کاربری تلگرام در اینجا کار نمی‌کنند. ``` export TGWITNESS_URL=https://panel.example.org # default http://127.0.0.1:8787 export TGWITNESS_MCP_TOKEN=tgw_mcp_... # or --token-file path tgwitness search 'перевод карта' --json ``` یک پنل از راه دور به HTTPS نیاز دارد؛ HTTP ساده تنها برای `127.0.0.1`, `localhost` و `::1`متغیرهای محیطی پروکسی نادیده گرفته می‌شوند و هدایت‌ها (redirects) رد می‌شوند، بنابراین توکن فقط به آدرسی که شما وارد می‌کنید می‌رسد. **مستقیماً از یک فضای کاری متوقف‌شده (`--data-dir`).** دایرکتوری داده را با دسترسی کامل محلی، بدون توکن می‌خواند. از آن روی یک کپی از دایرکتوری داده یا زمانی که جمع‌آوری متوقف است استفاده کنید. رکوردهای امضا‌شده هرگز تغییر نمی‌کنند؛ مانند پنل، باز کردن یک فضای کاری ممکن است شاخص‌های مشتق‌شده آن را به‌روزرسانی کند. هنگامی که پنل فضای کاری را باز دارد، فرمان با کد `3`؛ در عوض از طریق پنل بخوانید. بدون `--data-dir`, `TGWITNESS_DATA`, `./data/live` یا از دایرکتوری داده نصبه‌ای که دستور را اجرا می‌کند استفاده می‌شود. `--workspace ID` یک فضای کاری را انتخاب می‌کند (پیش‌فرض `default`). `tgwitness messages --workspaces` فهرست فضاهای کاری را که می‌توانید آن‌ها را بخوانید، نمایش می‌دهد. ## دستورالعمل‌ها | فرمان | نتیجه | | --- | --- | | `tgwitness search QUERY [--chat ID] [--since] [--until] [--any] [--limit N] [--offset N]` | مطابقت‌های برتر ابتدا، همراه با اشکال واژه‌ها، عبارات دقیق در گیومه، دامنه‌ها و `@username` ([سینتکس](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#search-syntax)) | | `tgwitness search QUERY --exact [--before SEQ]` | متن دقیق، جدیدترین‌ها اول، بدون نمایه | | `tgwitness context CHAT_ID MESSAGE_ID` | پیام‌های ذخیره شده در ده شناسه پیام در هر دو طرف | | `tgwitness messages` | گفت‌وگوهایی که می‌توانید بخوانید | | `tgwitness messages CHAT_ID [--since] [--until] [--before SEQ]` | پیام‌های ذخیره‌شده‌ی چت، جدیدترین‌ها اول | | `tgwitness messages CHAT_ID --message ID` | هر نسخهٔ ذخیره‌شده و هر رکورد حذف یک پیام | | `tgwitness stats [--chat ID] [--sender ID] [--since] [--until] [--top N]` | آمار فعالیت، در زیر | | `tgwitness export [--chat ID] [--since] [--until] [--output FILE]` | مشاهدات ذخیره شده به صورت JSON Lines در ترتیب دفترچه یادداشت | تاریخ‌ها هستند `2026-10-01` (نیمه‌شب به وقت UTC) یا زمان‌های ISO با منطقه زمانی، `2026-10-01T09:00+03:00`. برای `search`, `messages` و `export` آنها زمان مشاهده را انتخاب می‌کنند. صفحات تا ۵۰ رکورد را در خود جای می‌دهند: دنبال کنید `next_offset` (`--offset`) برای جستجوی رتبه‌بندی‌شده و `next_before` (`--before`) در جاهای دیگر. جستجوی رتبه‌بندی‌شده در 1,000 نتیجه متوقف می‌شود. صفحهٔ نهایی ممکن است کوتاه‌تر از `--limit` باشد؛ در صورتی که مشاهدات تطابق‌دار بیشتری وجود داشته باشد، عبارت جستجو، گفتگوی یا دورهٔ زمانی را محدود کنید. هر نتیجه پیام شامل `untrusted_content: true`، فضای کاری، چت و شناسه پیام‌ها، توالی دفترچه، هش رکورد ذخیره شده و یک لینک پنل. ویرایش‌ها، اعلان‌های حذف و `missing_on_recheck` سوابق جداگانه‌ای هستند. عدم وجود یک سابقه، اثبات نمی‌کند که یک رویداد هرگز رخ نداده است. ### آمار فعالیت `stats` شمارش مشاهدات ذخیره‌شده برای یک چت، یک فرستنده، یا همه چت‌های در محدوده: - پیام‌ها بر اساس ساعت جهانی (UTC) و روز هفته (دوشنبه اول)، شلوغ‌ترین ساعت‌ها و روزها؛ - ویرایش‌شده، حذف‌شده و `missing_on_recheck` اشتراک‌گذاری‌ها؛ - فرستندگان با تعداد پیام‌ها و زمان‌های ارسال اولین و آخرین پیام؛ - پربازدیدترین دامنه‌ها و `@handles`، که در هر پیام یک بار در نسخه‌های ذخیره‌شدهٔ آن شمرده شده است؛ - پوشش: `coverage.gap` ثبت و، برای دسترسی به کل فضای کاری، دوره‌هایی بدون ضربان قلب جمع‌آوری‌کننده متصل (`collector_liveness`). این دوره، **زمان پیام گزارش‌شده توسط تلگرام** را انتخاب می‌کند. شمارش ساعت و روز هفته می‌تواند به تخمین منطقه زمانی فرستنده کمک کند؛ اما آن را تعیین نمی‌کند. اعداد در صورت درخواست از دفترچه یادداشت محاسبه می‌شوند و ذخیره نمی‌شوند. هر نتیجه، سربرگ دفترچه یادداشتی را که در صورت گستردگی دسترسی شما در فضای کاری پوشش می‌دهد، نام می‌برد. خواندن از طریق پنل پس از پنج ثانیه متوقف می‌شود، یا `--timeout` ثانیه به‌صورت محلی (پیش‌فرض ۳۰)؛ سپس `complete` نابود و `partial` نام اولین رکوردی را که خوانده نشده است مشخص می‌کند. در این صورت فقط جدیدترین رکوردها شمرده می‌شوند. ### صادرات `export` برای هر مشاهدهٔ ذخیره شده یک شی JSON می‌نویسد (پیام‌های جدید، اسنپ‌شات‌ها، ویرایش‌ها، پیام‌های بازیابی‌شده، اعلان‌های حذف، `missing_on_recheck` و رکوردهای رسانهٔ ذخیره شده) به ترتیب دفترچه خاطرات. هر خط دارای همان فیلدهای سایر نتایج است، به همراه متن کامل. با `--output`، فایل تحت یک `.partial` نام و نام‌گذاری مجدد تنها پس از ثبت رکورد تکمیل پنل انجام می‌شود؛ یک خروجی‌گیری ناتمام هیچ فایلی را باقی نمی‌گذارد و با کد `1`. `--output` هرگز یک فایل موجود را بازنویسی نمی‌کند. با `--output` و `--json`، خروجی استاندارد (stdout) یک خلاصه را در بر می‌گیرد: تعداد رکوردها، آخرین توالی ژورنال و، برای دسترسی به کل فضای کاری، سرژورنال. صادرات از طریق پنل نیاز به ارتباطی دارد که امکان **«صادرات پیام‌ها» (فقط خط فرمان)** را فراهم کند؛ این گزینه به‌صورت پیش‌فرض انتخاب نشده است. این فایل یک نسخهٔ کاری است، نه مدرک: برای تحویل قابل تأیید، از صادرات امضا شده در **بخش** **«صادرات»** استفاده کنید، که `python -m tgwitness.verify`بررسی می‌کند. پنل پیش از ارسال هر رکورد، از جمله رکورد تکمیل، دسترسی را مجدداً بررسی می‌کند. دسترسی لغو شده یا منقضی شده منجر به خروجی ناقص می‌شود. خوانش‌های تنبل صفحه، محدودیت کارگر بایگانی را با سایر پرس‌وجوها به اشتراک می‌گذارند و دارای زمان انتظار محدودی هستند. ## مهارت عامل [`.agents/skills/tgwitness-cli/SKILL.md`](https://github.com/phishdestroy/TgWitness/blob/main/.agents/skills/tgwitness-cli/SKILL.md) به یک عامل می‌گوید چگونه از این دستورات استفاده کند، چگونه به سوابق ارجاع دهد و چگونه با متن ضبط‌شده برخورد کند. عامل‌هایی که می‌خوانند `.agents/skills` آن را از یک چک‌اوت مخزن بارگذاری کنید. برای Claude Code، آن را کپی کنید `tgwitness-cli` پوشه `.claude/skills/` در پروژه خود کپی کنید یا `~/.claude/skills/`. ## MCP و خط فرمان هر دو از اتصالات، بررسی‌های دامنه و محدودیت‌های یکسان استفاده می‌کنند. نتایج MCP به یک صفحه ۶۴ کیلوبایتی محدود است، بنابراین MCP هیچ‌گونه خروجی انبوهی ارائه نمی‌دهد؛ خط فرمان آن را استریم می‌کند. `get_activity_stats` برای هر دو در دسترس است. --- # Telegram · شناسایی نوری حروف (OCR) و رونویسی محلی Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/media-analysis/ تصاویر و فایل‌های صوتی ضبط‌شده را با یک کارگر محلی شناسایی کنید؛ متن استخراج‌شده را به فایل منبع آن پیوند دهید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) تصاویر و فایل‌های صوتی ضبط‌شده را با یک کارگر محلی شناسایی کنید؛ متن استخراج‌شده را به فایل منبع آن پیوند دهید. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [تحقیق](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/) ![تحقیق](https://phishdestroy.github.io/TgWitness/assets/chapter-investigate.svg) [راهنمای گردش کار](https://phishdestroy.github.io/TgWitness/docs/archive/) · [ویکی](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) یک رکورد دفترچه یادداشت `media.saved` را باز کنید، **«شناسایی پیوست**» (**Recognize attachment**) را انتخاب کنید، سپس در بخش **«از آرشیو بپرس» (Ask the archive**) گزینه OCR یا رونویسی را برگزینید. پردازش به‌صورت دستی و محلی انجام می‌شود. حالت ابری یا بارگذاری خودکار وجود ندارد. بایت‌های اصلی پیوست و `media_sha256` بدون تغییر باقی می‌مانند؛ متن شناسایی‌شده صراحتاً به عنوان شناسایی ماشینی علامت‌گذاری شده و به طور جداگانه به همراه هش منبع، نسخه موتور/مدل، زبان، پارامترها و زمان تکمیل ذخیره می‌شود. رونوشت‌ها مهرهای زمانی بازگشتی را حفظ می‌کنند. این نتایج را با استفاده از **متن شناسایی‌شده** و فیلتر OCR/پیاده‌نویسی جستجو کنید، یا متن شناسایی‌شده را به عنوان منبع جستجوی بهترین تطابق **ژورنال** انتخاب کنید. هر دو از طریق یک [نمایه در حافظه‌سنجان](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#recognized-text)، اشکال کلمات را تطبیق می‌دهند. این یک جستجوی داده‌های مشتق‌شده جداگانه است؛ این جستجو به‌طور بی‌صدا شناسایی ماشینی را به متن اصلی تلگرام تبدیل نمی‌کند یا آن را به رویدادهای امضا‌شده اضافه نمی‌کند. ## راه‌اندازی کارگر اختیاری نسخه ۱ به یک میزبان لینوکس با یک دیمون محلی داکر نیاز دارد. نصب‌های ویندوز می‌توانند TgWitness را در یک محیط VM/WSL لینوکس با دیمون محلی خود اجرا کنند. پنل هرگز خودِ فایل پیوست ناامن را رمزگشایی نمی‌کند. ``` docker build -f deploy/media-worker/Dockerfile -t tgwitness-media:local . export TGWITNESS_MEDIA_IMAGE=tgwitness-media:local ``` این متغیرها را در محیط سرویس TgWitness تنظیم کرده و آن را مجدداً راه‌اندازی کنید. ساکت دیمون به طور پیش‌فرض روی `/var/run/docker.sock` تنظیم است؛ استقرارهای بدون روت می‌توانند `TGWITNESS_DOCKER_SOCKET` را تنظیم کنند. کارگر به صراحت از آن ساکت یونیکس استفاده می‌کند تا از یک زمینه دوکر (Docker) از راه دور. یک API دوکر را در اختیار کاربران پنل قرار ندهید یا ساکت آن را در داخل کانتینر شناسایی (recognition) مونت نکنید. برای رونویسی، یک مدل Whisper سازگار با CTranslate2 را به طور جداگانه نصب کنید، سپس `TGWITNESS_WHISPER_MODEL_DIR` را به دایرکتوری آن تنظیم کنید. worker آن را با `local_files_only=True` بارگذاری می‌کند؛ مدل انتخاب‌شده و ورودی به صورت فقط-خواندنی mount می‌شوند. به [مستندات بارگذاری](https://github.com/SYSTRAN/faster-whisper) مدل این موتور مراجعه کنید. تصویر OCR ارائه‌شده شامل داده‌های آموزش‌دیده برای زبان‌های انگلیسی و روسی است. در صورت نیاز، زبان دیگری را به تصویر خود اضافه کنید؛ کدهای زبان مطابق با [CLI تسرَکت](https://tesseract-ocr.github.io/tessdoc/Command-Line-Usage.html) هستند. هیچ مدلی در حین پردازش بارگیری نمی‌شود. فرایند ساخت/دانلود ممکن است از شبکه استفاده کند؛ هر کانتینر تشخیص واقعی، شبکه را غیرفعال دارد. پیش از فعال‌سازی، ایمیج را نصب کنید؛ محیط اجرا از `--pull=never` استفاده می‌کند. ## محدودیت‌ها و بازیابی کانتینر با کاربری فاقد امتیاز (unprivileged) و روت فقط-خواندنی (read-only)، با قابلیت‌های محدودشده (dropped capabilities)، `no-new-privileges` ، یک پردازنده (CPU)، ۲ گیگابایت حافظه، محدودیت PID و یک سیستم فایل موقت محدود اجرا می‌شود. تنها یک نسخه تأییدشده از فایل انتخاب‌شده و یک دایرکتوری مدل اختیاری مونت می‌شوند. پایگاه داده، گاوصندوق و جلسهٔ گردآورنده مونت نمی‌شوند. [پرچم‌های زمان اجرای Docker](https://docs.docker.com/reference/cli/docker/container/run/) این محدودیت‌ها را اعمال می‌کنند؛ این همچنان یک مرز کانتینر است، نه یک انکلوی سخت‌افزاری. حجم فایل‌ها به ۵۰ مگابایت، تصاویر به ۲۰ میلیون پیکسل، فایل‌های صوتی با مدت‌زمان مشخص به ۳۰ دقیقه، و پردازش به پنج دقیقه محدود است. در هر زمان یک کارگر (worker) اجرا می‌شود، و در هر فضای کاری حداکثر ۲۰ کار در صف/در حال اجرا و ۱۰۰ کار ذخیره‌شده وجود دارد. لغو، کانتینر را متوقف می‌کند؛ و تلاش مجدد، یک کار جدید مرتبط با تلاش قبلی ایجاد می‌کند. کارهای متوقف‌شده پس از راه‌اندازی مجدد علامت‌گذاری می‌شوند. پردازش زمانی که یک مدل نتواند با محدودیت‌های پیکربندی‌شده مطابقت داشته باشد، ممکن است با شکست مواجه شود؛ این کار به‌صورت بی‌صدا و بدون ایزوله‌سازی اجرا نمی‌شود. --- # Telegram · وب‌هوک‌های خروجی Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/webhooks/ ارسال رویدادهای محدودشده به گیرندگان HTTPS با امضاهای HMAC، تلاش‌های مجدد و وضعیت تحویل. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) ارسال رویدادهای محدودشده به گیرندگان HTTPS با امضاهای HMAC، تلاش‌های مجدد و وضعیت تحویل. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [یکپارچه‌سازی‌های آرشیو](https://phishdestroy.github.io/TgWitness/fa/docs/reference/cli/) ![یکپارچه‌سازی‌های آرشیو](https://phishdestroy.github.io/TgWitness/assets/chapter-integrations.svg) [راهنمای گردش کار](https://phishdestroy.github.io/TgWitness/docs/archive/) · [ویکی](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) در فضای کاری انتخاب‌شده، **«ادغام‌ها» → «وب‌هوک‌های خروجی»** را باز کنید. یک گیرنده HTTPS اضافه کنید، رویدادهای جمع‌آوری‌کننده/رسانه/خروجی را انتخاب کنید و اختیاریاً چت‌ها را برای مشاهدات جدید و تغییرات برگزینید. متن پیام به طور پیش‌فرض غیرفعال است. فعال‌سازی گزیده‌ها حداکثر ۱۰۰۰ کاراکتر به رویدادهای تغییر پیام اضافه می‌کند؛ فیلدهای خام تلگرام و اطلاعات هویتی هرگز ارسال نمی‌شوند. یک‌بار کلید مخفی HMAC را در پیکربندی محافظت‌شده گیرنده کپی کنید. این کلید در گاوصندوق TgWitness رمزگذاری شده و از طریق پنل قابل بازیابی نیست. برای چرخاندن کلید، یک مقصد را حذف کرده و دوباره ایجاد کنید. یک تست بدون محتوای چت را به صف‌های **آزمایشی مصنوعی ارسال کنید**؛ وضعیت تحویل را برای مشاهده نتیجه آن، تازه کنید. امکان ارسال، حلقه اعلان موجود را در کنار Apprise گسترش می‌دهد. این قابلیت از مسیر خارجی فضای کاری و محدودیت‌های مقصد خصوصی موجود استفاده می‌کند. هیچ بازگشتی (fallback) یا هدایت (redirect) مستقیمی پس از آن صورت نمی‌گیرد. آدرس‌های اینترنتی نباید حاوی اطلاعات ورود به سیستم، رشته‌های پرس‌وجو (query strings) یا قطعات (fragments) باشند؛ آدرس‌های خصوصی نیازمند تأیید شبکه در سطح سرور هستند، نه تنظیمی که کاربر پنل بتواند آن را دور بزند. ## بار مفید و امضا اسکما: [`tgwitness.webhook/1`](https://github.com/phishdestroy/TgWitness/blob/main/integrations/webhook.schema.json). هر بارگذاری حاوی `event_id`، `timestamp`، `workspace`، `type`، `synthetic` و شمارنده‌ها است. رویدادهای مبتنی بر ژورنال، توالی و هش خود را شامل می‌شوند. تکمیل خروجی‌گیری کامل و تست‌های مصنوعی، رویدادهای تحویل هستند و هیچ مرجع ژورنال امضا شده ساختگی ندارند. اعلان‌های حذف تلگرام و `missing_on_recheck` همچنان انواع متمایزی باقی می‌مانند. سربرگ `X-TgWitness-Signature`، `t=UNIX_SECONDS,v1=HEX_HMAC_SHA256` است. HMAC را بر روی بایت‌های دقیق `timestamp + "." + raw_request_body` محاسبه کنید، با استفاده از کلید مخفی نمایش‌داده‌شده به صورت بایت‌های UTF-8. امضاها را در زمان ثابت قبل از پردازش یا اقدام روی بدنه مقایسه کنید. مهرهای زمانی را که بیش از پنج دقیقه با ساعت شما اختلاف دارند، رد کنید. مهر زمانی در هر تلاش برای تحویل، تازه می‌شود. از `event_id` به عنوان یک کلید ایدمپوتنسی در ذخیره‌سازی پایدار، با یک قید یکتایی اتمی قبل از اثرات جانبی استفاده کنید. یک امضای معتبر به تنهایی از تکرار یک درخواست اخیر جلوگیری نمی‌کند. شناسه‌های پردازش‌شده را حداقل برای تمام دورهٔ پنجرهٔ تلاش مجدد نگه دارید؛ در صورتی که گیرنده بتواند رویدادهای ذخیره‌شده را مجدداً پردازش کند، آنها را برای مدت طولانی‌تری حفظ کنید. ## تکرار تلاش‌ها ارسال‌ها به‌طور پایدار قبل از درخواست‌های HTTP در صف قرار می‌گیرند. آن‌ها از معناشناسی «حداقل یک‌بار» استفاده می‌کنند: یک تأیید از دست رفته یا راه‌اندازی مجدد ممکن است یک رویداد را با همان شناسه دوباره ارسال کند. هشت تلاش با فاصله زمانی نمایی وجود دارد که از ۱۵ ثانیه شروع شده و حداکثر یک ساعت است. موفقیت نیازمند پاسخ 2xx است. وظایف ناموفق یک خطای قابل مشاهده به جا می‌گذارند؛ تحویل پس از پایان تلاش‌های مجدد تضمین نمی‌شود. صف قادر به نگهداری ۱۰۰۰ تحویل است. هنگامی که پر شود، اسکن رویدادهای دفترچه وقایع متوقف شده و پس از آزاد شدن فضا از سر گرفته می‌شود. تکمیل یک خروجی‌گیری کامل که قابل صف‌بندی نیست، یک خطای صف قابل مشاهده را ایجاد می‌کند. در هر گذر اطلاع‌رسانی، حداکثر پنج تحویل تلاش می‌شود و ۱۰۰ رکورد اخیر تلاش‌ها نگهداری می‌شوند. حذف یک مقصد، تحویل‌های در انتظار آن را نیز حذف می‌کند. ## نمونه‌ی n8n [جریان کاری نمونه را](https://github.com/phishdestroy/TgWitness/blob/main/integrations/n8n-tgwitness.json) وارد کنید. این جریان غیرفعال است و هیچ راز یا اقدام بعدی ندارد. `TGWITNESS_WEBHOOK_SECRET` را در محیط کارگر n8n تنظیم کنید، به آن محیط دسترسی بدهید و برای گره کد، افزونه داخلی `crypto` را مجاز کنید. این مثال از گزینه raw-body گره Webhook استفاده می‌کند، امضا/تازگی را بررسی می‌کند و رویدادهای تأییدشده را تأیید می‌نماید. این با [پیاده‌سازی مستندشده](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/nodes/Webhook/Webhook.node.ts) این گره مطابقت دارد. پیش از افزودن خروجی‌های SIEM یا اعلان‌ها، یک ذخیره‌سازی پایدار و ایزوپوتنت با کلیدگذاری بر پای`event_id` اضافه کنید. ویرایش گردش کار n8n و نگهداری گزارش اجرای آن را بر اساس داده‌هایی که برای ارسال انتخاب کرده‌اید، محدود کنید. TgWitness هیچ فرمان ورودی‌ای اضافه نمی‌کند. --- # Telegram · نمایشگاه عمومی Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/showcase/ انتشار پیام‌های ذخیره‌شده‌ی کانال‌های عمومی منتخب و اسنپ‌شات‌های امضاشده از طریق لینک‌های منقضی‌شونده و قابل‌ابطال. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) انتشار پیام‌های ذخیره‌شده‌ی کانال‌های عمومی منتخب و اسنپ‌شات‌های امضاشده از طریق لینک‌های منقضی‌شونده و قابل‌ابطال. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/deployment/) ![راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/assets/chapter-operate.svg) **دسترسی → ویترین عمومی** با استفاده از سیستم توکن دسترسی موجود، یک صفحهٔ مجزا و فقط-خواندنی ایجاد می‌کند. این صفحه مشاهدات ذخیره‌شدهٔ نصب را می‌خواند. این کار هیچ گردآورنده‌ای را راه‌اندازی نمی‌کند، به تلگرام وارد نمی‌شود و برای بازدیدکننده کانالی تهیه نمی‌کند. ## انتشار یک صفحه 1. برای هر کانال عمومی که می‌خواهید نمایش دهید، یک پروفایل منبع ذخیره کنید. یک کانال باید در آخرین پروفایل ذخیره‌شده خود یک نام کاربری عمومی داشته باشد؛ گروه‌ها و چت‌های خصوصی واجد شرایط نیستند. 2. **دسترسی → نمایشگاه عمومی** را باز کنید (یا `/showcase-manage.html`) را به‌عنوان مدیر باز کنید. 3. کانال‌ها را از میان حداکثر ۱۶ فضای کاری انتخاب کنید، عنوان صفحه عمومی را وارد کنید و مدت زمان عمر لینک را ۱، ۷ یا ۳۰ روز انتخاب کنید. برچسب‌های داخلی فضای کاری منتشر نمی‌شوند. حداکثر ۶۴ کانال می‌توانند گنجانده شوند. 4. متن کانال‌های انتخاب‌شده را برای انتشار بازبینی کنید، سپس روی **«پیش‌نمایش رکوردهای انتخاب‌شده»** کلیک کنید. پیش‌نمایش از همان پیش‌نمایش سمت سرور صفحه بازدیدکننده استفاده می‌کند. 5. روی **لینک «ایجاد نمایش»** کلیک کنید. لینک را در حالی که قابل مشاهده است کپی کنید. آن را در یک مرورگر جداگانه باز کنید تا صفحهٔ گیرنده را پیش از توزیع بررسی کنید. این لینک حاوی یک توکن دسترسی در بخش نشانی (fragment) نشانی اینترنتی خود است. صفحه این بخش را پیش از ارسال درخواست‌های API حذف کرده و آن را با یک جلسه مرورگر معاوضه می‌کند. هر کسی که این لینک را در اختیار داشته باشد می‌تواند تا زمان انقضا یا لغو، مطالب انتخاب‌شده را باز کند. لینک‌های جدید ۱۰۰ جلسه همزمان را مجاز می‌سازند که هر کدام حداکثر یک ساعت دوام دارند. کنترل‌های دسترسی موجود همچنین می‌توانند از طریق API اعطای دسترسی، محدودیت‌های آدرس و محدودیت‌های ورود را اعمال کنند. دسترسی معمول بازبینان یک حالت متفاوت است و همچنان شامل پیام‌ها و فایل‌های اصلی مجاز می‌شود. ## آنچه بازدیدکنندگان می‌بینند | نمایان | خصوصی نگه داشته شده | | --- | --- | | عنوان‌های منتخب کانال‌های عمومی، نام‌های کاربری و تاریخ‌های مشاهده پروفایل | هویت حساب‌ها، برچسب‌های داخلی فضای کاری و منابع انتخاب‌نشده | | متن ضبط‌شده و هر ویرایش ذخیره‌شده | شناسه‌های ساختاریافتهٔ فرستنده، نام‌ها، نام‌های کاربری، شماره‌های تلفن و مقادیر پروفایل | | مشاهده حذف‌ها همراه با متن قبلاً ذخیره شده، در صورت وجود | پیوست‌ها، آواتارها، تصاویر بندانگشتی، نام فایل‌ها و بارهای اصلی | | نشانگرهایی که نشان می‌دهند یک نویسنده/پروفایل یا پیوست ضبط شده است | مَتادیتای فوروارد و پاسخ، مسیرهای شبکه، آدرس‌های IP و اعتبارنامه‌ها | | شمارش رویدادهای کانال‌های منتخب، کلیدهای فعلی جمع‌آوری، ضربان قلب و فاصله زمانی نقطه‌کنترل | کنترل‌های جمع‌آوری و رابط‌های برنامه‌نویسی کاربردی معمولی برای صدور شواهد | | امضای اثر انگشتی، نقطهٔ کنترل ژورنال و اثبات سازگاری | کلیدهای امضا و جلسات تلگرام | **متن پیام عمومی به طور خودکار ناشناس‌سازی نمی‌شود.** نام، ذکر، شماره تلفن یا لینکی که در پیام نوشته شده باشد، همچنان بخشی از آن متن باقی می‌ماند. `Redacted`این امر در مورد فیلدهای ساختاریافته نویسنده/پروفایل نیز صدق می‌کند. پیش از انتشار، محتوای واقعی انتخاب‌شده را، از جمله ویرایش‌ها و حذف‌های حفظ‌شده، بازبینی کنید. شایستگی، **آخرین پروفایل منبع ذخیره شده** را منعکس می‌کند، نه یک جستجوی زنده در تلگرام. اگر پروفایل بعدی دیگر نام کاربری کانال عمومی نداشته باشد، درخواست‌های جدید آن کانال را حذف می‌کنند. با تغییر دیده‌شدن عمومی، پروفایل‌های منبع را تازه کنید. ممکن است خوانندگان از قبل مطالبی را که قبلاً دریافت کرده‌اند ذخیره کرده باشند. سوابق اصلی امضا شده دست‌نخورده باقی می‌مانند. پیش‌نمایش نمایش‌داده‌شده به‌طور جداگانه امضا می‌شود و هش‌هایی را شامل می‌شود که به سوابق اصلی خود ارجاع می‌دهند. امضای پیش‌نمایش، صحت بیانیه نمایش‌داده‌شده را تأیید می‌کند؛ این امضا، امضای رویداد اصلی بر روی بایت‌های حذف‌شده نیست. ## امضاها و پیوستگی را بررسی کنید **«اثر انگشت و نقطه کنترل امضا شده» را** گسترش دهید و یک اسنپ‌شات دانلود کنید. پس از تازه‌سازی صفحه، دانلود شامل اسنپ‌شات قبلی مرورگر و یک اثبات سازگاری مرکل بین مرزهای دفترچه خاطرات آن‌ها است. تازه‌سازی خودکار زمانی که صفحه قابل مشاهده است و صفحه اول مشاهدات خود را نمایش می‌دهد، هر دقیقه یک بار انجام می‌شود. با نصب TgWitness، فایل دانلودی را به‌صورت آفلاین تأیید کنید: ``` python -m tgwitness.showcase_verify showcase.json --fingerprint TRUSTED_COLLECTOR_SHA256 ``` اثر انگشت باید از یک مرجع جداگانه مورد اعتماد حاصل شود. برای مقایسه با یک اسنپ‌شات که خودتان نگه داشته‌اید، از ... استفاده کنید. `--previous earlier.json`؛ این بر اسنپ‌شات قبلی که در دانلود گنجانده شده است، اولویت دارد. اثبات فعلی باید از آن مرز نگهداری‌شده آغاز شود. کلاینت‌های احراز شده می‌توانند با استفاده از `GET /api/showcase/{workspace_id}?challenge=<32-hex-random>&from_count=`. یک ژورنال کوتاه‌تر به جای ریست کردن بی‌صدا مرز، کد HTTP 409 را برمی‌گرداند. نقطه کنترل امضا شده، **کل دفترچه کل (journal) گردآورنده** را ثبت می‌کند، شامل تعداد رکوردها و هش سر غیرشفاف آن. تعداد پیام‌های نمایش داده شده فقط برای کانال‌های عمومی انتخاب‌شده اعمال می‌شود. این صفحه هرگز محتوای سایر دفترچه‌های کل را فهرست نمی‌کند. این‌ها تعداد رویدادها هستند، نه تعداد پیام‌های منحصربه‌فرد. تنظیمات، پیکربندی فعلی را توصیف می‌کنند، نه هر بازه ضبط قبلی را. تأیید امضا و سازگاری می‌تواند تغییرات را نسبت به یک مرز نگهداری‌شده تشخیص دهد. این قابلیت به‌طور مستقل شمارنده‌های امضا را دوباره شمارش نمی‌کند، اصالت تلگرام را تأیید نمی‌کند، ضبط بی‌وقفه را نشان نمی‌دهد، یا جایگزین یک شاهد مستقل نمی‌شود. برای آن بررسی، از [اعتبارسنج شواهد](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md)، [شاهد مستقل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/) و [سوابق مقیاس‌آزمایی‌شده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/) استفاده کنید. نصب‌های مصنوعی به‌وضوح برچسب «مصنوعی» دارند. ## صفحه را لغو یا میزبانی کنید برای بستن لینک و پایان دادن به تمام جلسات آن، از **گزینه «Revoke»** در مدیر نمایش یا بخش **دسترسی** موجود استفاده کنید. بازدیدکننده، سوابق نمایش‌داده‌شده را زمانی پاک می‌کند که یک درخواست تشخیص دهد دسترسی پایان یافته است. انقضا و مجوزها در هر درخواست بررسی می‌شوند. دسترسی‌های اعطا شده در نمایش نمی‌توانند به دسترسی معمولی پنل تبدیل شوند؛ برای تغییر حالت‌ها، یک دسترسی جدید ایجاد کنید. صفحه را از طریق آدرس HTTPS موجود در نصب ارائه دهید. انتشار یک لینک، پورت جدیدی باز نمی‌کند، تونلی ایجاد نمی‌کند و DNS را تغییر نمی‌دهد. HTML و API روی نصب کاربر باقی می‌مانند. یک بازدیدکننده نمایشگاهی نمی‌تواند با این دسترسی از APIهای معمولی پیام، پروفایل، رسانه، خروجی یا مدیریت استفاده کند. --- # Telegram · چگونگی کارکرد شواهد Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/how-it-works/ زنجیره هش، امضاها، نقاط کنترل و شاهدان با فرمول‌های دقیقی که اعتبارسنج استفاده می‌کند توضیح داده شده‌اند. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) زنجیره هش، امضاها، نقاط کنترل و شاهدان با فرمول‌های دقیقی که اعتبارسنج استفاده می‌کند توضیح داده شده‌اند. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [شواهد و تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) ![شواهد و تأیید](https://phishdestroy.github.io/TgWitness/assets/chapter-evidence.svg) TgWitness آنچه را که یک حساب گردآورنده مشاهده کرده است حفظ می‌کند، این مشاهدات را به یک دفترچه ثبت امضا شده پیوند می‌دهد و به شخص دیگری اجازه می‌دهد تا یک خروجی را با استفاده از یک کلید مورد اعتماد و یک نقطه کنترل قبلی که نگهداری شده است، تأیید کند. [وب‌سایت مستندات](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally) [محلی](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally)، نمونه‌های تعاملی را در `/docs/concepts/`، یک کاوشگر تصمیم‌گیری نقطه‌کنترل را در `/docs/witness/`، و راهنماهای گام‌به‌گام برای [Case Board](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/)، [طراحی گزارش](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-reports/) و [خروجی‌های handover](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#handover-extract)را اضافه می‌کند. تمام پیام‌های نمونه، شمارش‌ها و تأخیرها فرضی هستند. هش‌ها در محیط شبیه‌سازی زنجیره با SHA-256 در مرورگر محاسبه می‌شوند. هیچ چیزی به تلگرام ارسال نمی‌شود. **در این صفحه** - [یک پیام تغییر می‌کند؛ مشاهدات انباشته می‌شوند](https://phishdestroy.github.io/TgWitness/fa/docs/reference/how-it-works/#a-message-changes-observations-accumulate) - [آنچه یک هش پوشش می‌دهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/how-it-works/#what-a-hash-covers) - [آنچه یک نقطهٔ کنترل قبلی اضافه می‌کند](https://phishdestroy.github.io/TgWitness/fa/docs/reference/how-it-works/#what-an-earlier-checkpoint-adds) - [جایی که شاهد تعلق دارد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/how-it-works/#where-a-witness-belongs) - [تحویل تست در مقابل اقدامات شناخته‌شده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/how-it-works/#test-delivery-against-known-actions) - [یک گردش کار را انتخاب کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/how-it-works/#pick-a-workflow) ## پیامی تغییر می‌کند؛ مشاهدات انباشته می‌شوند نمودار توالی · تلگرام → جمع‌آور: پیام جدید: ساعت ۱۰:۰۰ ملاقات کنیم; جمع‌آور → دفترچه ثبت‌شده: پیوست: message.new; تلگرام → جمع‌آور: ویرایش: ساعت ۱۱:۰۰ ملاقات; جمع‌آور → دفترچه ثبت‌شده: پیام را ضمیمه کنید. ویرایش‌شده; تلگرام → جمع‌آور: اطلاعیه حذف; جمع‌آور → دفترچه ثبت‌شده: پیوست: پیام حذف‌شده; یادداشتی دربارهٔ دفترچه ثبت‌شده: مشاهدهٔ اصل + ویرایش + حذف باقی می‌ماند · تلگرام · جمع‌آور · دفترچه ثبت‌شده · پیام جدید: ساعت ۱۰:۰۰ ملاقات کنیم · پیوست: message.new · ویرایش: ساعت ۱۱:۰۰ ملاقات · پیام را ضمیمه کنید. ویرایش‌شده · اطلاعیه حذف · پیوست: پیام حذف‌شده · مشاهدهٔ اصل + ویرایش + حذف باقی می‌ماند **نمودار به صورت متن** 1. تلگرام → جمع‌آور: پیام جدید: ساعت ۱۰:۰۰ ملاقات کنیم 2. جمع‌آور → دفترچه ثبت‌شده: پیوست: message.new 3. تلگرام → جمع‌آور: ویرایش: ساعت ۱۱:۰۰ ملاقات 4. جمع‌آور → دفترچه ثبت‌شده: پیام را ضمیمه کنید. ویرایش‌شده 5. تلگرام → جمع‌آور: اطلاعیه حذف 6. جمع‌آور → دفترچه ثبت‌شده: پیوست: پیام حذف‌شده 7. یادداشتی دربارهٔ دفترچه ثبت‌شده: مشاهدهٔ اصل + ویرایش + حذف باقی می‌ماند این توالی ساده‌شده فرض می‌کند که تلگرام هر به‌روزرسانی را تحویل داده و حساب انتخاب‌شده قادر به مشاهده آن بوده است. رویدادهای عملیاتی نیز ژورنال را به اشتراک می‌گذارند. یک اعلان حذف، حذف‌کننده یا زمان دقیق حذف را ارائه نمی‌دهد. تحویل‌های تکراری مشاهدات جداگانه‌ای هستند؛ هیچ حذف تکراری در سطح کل ژورنال انجام نمی‌شود. ## آنچه یک هش پوشش می‌دهد ![مشاهده، رمزگذاری، هش‌گیری و امضا: هر رویداد جدید شامل هش رویداد قبلی است.](https://phishdestroy.github.io/TgWitness/assets/evidence-chain-animated.svg) فرمول را از داخل به بیرون بخوانید: **C** نُه فیلد را به بایت‌های دقیق تبدیل می‌کند؛ **SHA-256** هش آن‌ها را تولید می‌کند؛ **هگز** روشی است که آن هش با آن ذخیره می‌شود. هش قبلی از قبل در رویداد وجود دارد. **unhex** هش ذخیره‌شده را دوباره به ۳۲ بایت که Ed25519 امضا می‌کند، تبدیل می‌کند. [نمودار ثابت زنجیره](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-chain-static.svg) بگذارید C(ei) نشان‌دهندهٔ JSON استاندارد UTF-8 از نه فیلد رویداد باشد. اولین `previous_hash` شامل ۶۴ کاراکتر صفر است. هر رکورد بعدی شامل هش هگزادسیمال رکورد قبلی است: hi = hex(SHA256(C(ei))) σi = Ed25519.Sign(sk,unhex(hi)) امضا، ۳۲ بایت هش خام را پوشش می‌دهد. ورودی هش دقیقاً حاوی `seq`، `observed_at`، `source_at`، `kind`، `chat_id`، `message_id`، `actor_id`، `payload` و `previous_hash` است. کلیدهای شیء مرتب شده‌اند؛ فاصله‌های خالی و فرار ASCII حذف شده‌اند؛ NaN و بی‌نهایت رد شده‌اند. [رمزگذاری دقیق](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#event-canonicalization) را ببینید. نمودار جریان · ۶۴ کاراکتر صفر → ثبت ۱ / هَش h1; ثبت ۱ / هَش h1 → رکورد ۲ شامل h1 / هَش h2; رکورد ۲ شامل h1 / هَش h2 → رکورد ۳ شامل h2 / هَش h3; رکورد ۳ شامل h2 / هَش h3 → نقطهٔ کنترل امضا شده: شمارش ۳، سربرگ h3 (در جای دیگری نگهداری کنید) · ۶۴ کاراکتر صفر · ثبت ۱ / هَش h1 · رکورد ۲ شامل h1 / هَشh2 · رکورد ۳ شامل h2 / هَشh3 · نقطهٔ کنترل امضا شده:شمارش ۳، سربرگ h3 · در جای دیگری نگهداری کنید **نمودار به صورت متن** 1. ۶۴ کاراکتر صفر → ثبت ۱ / هَش h1 2. ثبت ۱ / هَش h1 → رکورد ۲ شامل h1 / هَش h2 3. رکورد ۲ شامل h1 / هَش h2 → رکورد ۳ شامل h2 / هَش h3 4. رکورد ۳ شامل h2 / هَش h3 → نقطهٔ کنترل امضا شده: شمارش ۳، سربرگ h3 (در جای دیگری نگهداری کنید) | تغییر به ژورنال ارائه‌شده | چه چیزی آن را تشخیص می‌دهد | | --- | --- | | سوابق رکورد ۲ را تغییر دهید در حالی که هش ذخیره‌شدهٔ آن دست‌نخورده باقی می‌ماند | هَش رویداد بازمحاسبه‌شده متفاوت است؛ امضای آن دیگر رویداد تغییر یافته را پوشش نمی‌دهد | | سوابق تغییر یافته و هر هش بعدی را بازسازی کنید | امضاهای اصلی ناموفق هستند؛ یک نقطهٔ کنترل نگه‌داشته‌شده در مرز آسیب‌دیده نیز با آن اختلاف دارد | | دم را حذف کنید اما پیش‌وند باقی‌مانده را دست‌نخورده نگه دارید | یک نقطه‌کنترل نگه‌داشته‌شده‌ی قبلی که فراتر از پیشوند ارائه‌شده قرار دارد نشان می‌دهد که خروجی بیش از حد کوتاه است | | روزنامه جایگزین را با کلید دیگری مجدداً امضا کنید | اثر انگشت کلید مورد اعتماد جداگانه، هویت جایگزین را رد می‌کند | ![تغییر یک فیلد ذخیره‌شده هش آن را تغییر می‌دهد؛ بازسازی هش‌ها امضاهای اصلی را بازیابی نمی‌کند.](https://phishdestroy.github.io/TgWitness/assets/evidence-tamper-animated.svg) **منطق را روی رکورد ۲ امتحان کنید:** در رویداد ذخیره شده، `Meet at 11:00` را به `Meet at 12:00` تغییر دهید. هش بازمحاسبه‌شده آن دیگر مطابقت ندارد. بازمحاسبه زنجیره بعدی می‌تواند پیوندهای آن را ترمیم کند، اما نمی‌تواند باعث شود امضاهای اصلی، هش‌های جدید را پوشش دهند. در مقابل، یک ویرایش مشاهده‌شده در تلگرام به یک رکورد جدید در دفترچه تبدیل می‌شود. [نمودار تغییرات ایستا](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-tamper-static.svg) فقط لینک‌های هش مانع از محاسبه مجدد یک زنجیره جایگزین توسط شخص دیگری نمی‌شوند. اعتماد از طریق بررسی امضاها با استفاده از یک کلید مورد اعتماد مستقل و مقایسه آن‌ها با مراجع نگهداری‌شده خارج از گردآورنده حاصل می‌شود. ## آنچه یک نقطه کنترل قبلی اضافه می‌کند ![شمارش ۳ را حفظ کنید و سرفصل h3 را نگه دارید؛ خروجی بعدی شامل ۴ رکورد در موقعیت ۳ بررسی می‌شود.](https://phishdestroy.github.io/TgWitness/assets/evidence-checkpoint-animated.svg) **مرجع ثابت می‌ماند در حالی که مجله در حال رشد است.** اگر نقطه کنترل بگوید «۳ رکورد، سر h3»، یک خروجی چهار رکوردی می‌تواند با تطبیق h3 در موقعیت ۳ عبور کند. سر جدیدتر آن h4 است که انتظار می‌رود متفاوت باشد. یک خروجی شامل فقط دو رکورد با شکست مواجه می‌شود. [نمودار نقطه‌کنترل ایستا](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-checkpoint-static.svg) پس از تأیید امضای نقطه کنترل، الزامی است: Nexport ≥ Ncheckpoint and hexport[Ncheckpoint] = Hcheckpoint یک خروجی ممکن است از یک نقطه کنترل فراتر رود. این خروجی باید در مرز حفظ‌شده با آن مطابقت داشته باشد. اعتبارسنج واقعی همچنین توالی، لینک قبلی، هش و امضای هر رویداد را بررسی می‌کند. مقایسه تنها با سرخط نهایی ذخیره‌شده، یک رکورد داخلی تغییر یافته را که هش ذخیره‌شده‌اش به‌روزرسانی نشده است، نادیده می‌گیرد. ## جایی که شاهد به آن تعلق دارد نمودار جریان · جمع‌آورنده / جلسه حساب / کلید A → نقطه پایانی نقطه‌کنترل فقط-خواندنی; شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B → روزنامه شاهد امضا شده جداگانه; شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B → نقطه پایانی نقطه‌کنترل فقط-خواندنی (درخواست بررسی); نقطه پایانی نقطه‌کنترل فقط-خواندنی → شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B (پاسخ امضا شده); شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B → کانالی با پست‌های امضا‌شده TGW1 (رابط برنامه‌نویسی ربات / توکن اختصاصی) · میزبان A · میزبان B · جمع‌آورنده / جلسه حساب /کلید A · نقطه پایانی نقطه‌کنترلفقط-خواندنی · شاهد / کلید جمع‌آوریثابت‌شده / کلید خود B · روزنامه شاهد امضا شدهجداگانه · کانالی با پست‌های امضا‌شدهTGW1 · درخواست بررسی · پاسخ امضا شده · رابط برنامه‌نویسی ربات / · توکن اختصاصی **نمودار به صورت متن** 1. جمع‌آورنده / جلسه حساب / کلید A → نقطه پایانی نقطه‌کنترل فقط-خواندنی 2. شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B → روزنامه شاهد امضا شده جداگانه 3. شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B → نقطه پایانی نقطه‌کنترل فقط-خواندنی (درخواست بررسی) 4. نقطه پایانی نقطه‌کنترل فقط-خواندنی → شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B (پاسخ امضا شده) 5. شاهد / کلید جمع‌آوری ثابت‌شده / کلید خود B → کانالی با پست‌های امضا‌شده TGW1 (رابط برنامه‌نویسی ربات / توکن اختصاصی) این شاهد بازپخش، یک سر دیگر در همان شمارش، کلیدهای تغییر یافته، پاسخ‌های نامعتبر و پاسخ‌های از دست رفته را ثبت می‌کند. صرفاً یک شمارش بزرگتر ثابت نمی‌کند که هر رکورد قبلی بدون تغییر باقی مانده است؛ خروجی را با نقاط کنترل نگهداری‌شده مقایسه کنید. یک شاهد روی میزبان دیگر از به اشتراک گذاشتن قطعی میزبان گردآورنده جلوگیری می‌کند؛ یک اپراتور جداگانه استقلال بیشتری فراهم می‌کند. شاهد به وضعیت گزارش‌شده دفترچه یادداشت گردآورنده گواهی می‌دهد. از یک آزمون تحویل کنترل‌شده برای اندازه‌گیری اینکه کدام اقدامات تلگرام به یک حساب گردآورنده رسیده‌اند، استفاده کنید. به [بخش راه‌اندازی شاهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/) مراجعه کنید. ## ارسال را در برابر اقدامات شناخته‌شده آزمایش کنید از یک گروه کنترل‌شده، حساب‌های جمع‌آوری مجزا و یک نشانگر جدید استفاده کنید. پیام‌ها را عمداً ارسال، ویرایش و حذف کنید و در فواصل مراحل، ضبط را بررسی نمایید. اقدامات مورد انتظار و یک نقطه قطع را تعریف کنید و سپس نتایج را بازرسی کنید. R = |observed∩expected| / |expected| Δ t = treceipt - taction تنها اقدامات مطابقت‌یافته با انتظار شمرده می‌شوند؛ رسیدهای تکراری مخرج را افزایش نمی‌دهند. مخرج باید غیرصفر باشد. یک رسید مفقود، تأخیر اندازه‌گیری‌شده‌ای ندارد. عدم قطعیت ساعت سند را مستند کنید؛ از زمان اقدام حذف کنترل‌شده خود استفاده کنید، زیرا تلگرام زمان دقیق حذف را ارائه نمی‌دهد. نتایجه‌ای مانند ۵/۶ (۸۳.۳٪) اقدامات آزمایشی را توصیف می‌کند، نه کامل بودن کل ترافیک تلگرام را. ## یک گردش کار را انتخاب کنید [راهنمای کامل تحقیق](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/)، یک رویداد را در یک کانال، گروه، ربات و چت خصوصی دنبال می‌کند: 1. در یک حساب جمع‌آوری اختصاصی، حالت تحقیق کل حساب را فعال کرده و فهرست چت‌های قابل دسترسی را ایجاد کنید. از چت‌های منتخب یا یک پوشه برای حساب اصلی استفاده کنید. 2. دریافت اسنپ‌شات‌های ژورنال، تاریخچه کامل هر چت و پیوست‌های نگهداری‌شده. 3. تغییرات زنده و هرگونه تعامل عمدی با پنل را همراه با رسیدهایشان حفظ کنید. 4. شناسه‌های عددی فرستنده، روابط پاسخ‌گویی، مقاصد تکراری و هش‌های فایل را در سوابق استنادشده و پروفایل‌های افراد دنبال کنید. 5. افزودن یادداشت‌ها و مجموعه‌های مرتبط با منبع در Case Board. بازسازی خط زمانی میان‌گفتگوها با هر دو زمان‌بندی و فواصل صریح. 6. فضای کاری سایر حساب‌ها را مقایسه کنید، در حالی که منشأ و کلیدهای آن‌ها را جدا نگه می‌دارید. 7. ژورنال‌های امضا شده، پروفایل‌ها و خروجی‌های تاریخچه را همراه با یادداشت‌های پرونده گردآوری و تأیید کنید. راهنمای وب‌سایت به آدرس `/docs/cases/` شامل یک نقشه مورد تعاملی و گزینه‌های مختلف برای اختلافات ربات، پیام‌های حذف‌شده و تغییر نام شرکت‌کنندگان است. Case Board یادداشت‌ها و مجموعه‌ها را در یک فضای کاری نگه می‌دارد. خروجی‌های گروهی، بسته‌های مجزای فضای کاری را جمع‌آوری می‌کنند؛ همبستگی بین فضاهای کاری و خط زمانی ترکیبی همچنان به عنوان وظیفه تحلیلگر باقی می‌ماند. [اعتبارسنجی انجام‌شده و کارهای باقیمانده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/) · [صادرات و تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#investigation-handoff) · [با یک حساب کاربری شروع کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/quickstart/) --- # Telegram · پیکربندی و اعتبارسنجی گزارش Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-reports/ فیلترهای گزارش، هشت طرح، پیش‌تنظیم‌های محتوا، سوابق تغییرات ذخیره‌شده و ارزیابی گنجانده‌شده در صادرات امضا‌شده. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) فیلترهای گزارش، هشت طرح، پیش‌تنظیم‌های محتوا، سوابق تغییرات ذخیره‌شده و ارزیابی گنجانده‌شده در صادرات امضا‌شده. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [تحقیق](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/) ![تحقیق](https://phishdestroy.github.io/TgWitness/assets/chapter-investigate.svg) مشاهدات منتخب را به گزارشی خوانا از پرونده تبدیل کنید: شامل پرسش، دامنه، تغییرات ذخیره‌شده، نمودارها، یافته‌ها و ارجاعات منابع آن. هر گزارش به دریافت‌کننده راهی برای بررسی مطالب تحویل‌شده و بازرسی پوشش جمع‌آوری آن می‌دهد. بخش **«بنیاد اعتماد و محدودیت‌ها**» در گزارش‌های دفترچه خاطرات، تحویل، چت، حساب کاربری و اشتراک‌گذاری ظاهر می‌شود. فایل‌های PDF دفترچه خاطرات و تحویل از همان ارزیابی موجود در `report.json` امضا شده خود استفاده می‌کنند. فایل‌های فشرده ZIP، `case_assessment` را در فایل فشرده امضا شده حمل می‌کنند. این ارزیابی به همراه محتوای صادر شده منتقل می‌شود. مشاهدات اصلی امضاهای موجود خود را حفظ می‌کنند. ## فرمت‌های سند و ترتیب خواندن ### استودیوی گزارش **Exports را** باز کنید **→ پیکربندی و پیش‌نمایش**. در مسیر **Data → Design & contents → Preview** پیش بروید: 1. از کل فضای کاری استفاده کنید یا چت‌ها، نویسندگان، تاریخ‌های مشاهده شامل UTC و انواع رویدادها را انتخاب کنید. کاتالوگ را برای جستجو در چت‌ها و نویسندگان بارگذاری کنید، یا شناسه تلگرام آن‌ها را وارد کنید. فیلترهای نویسنده با شناسه فرستنده ثبت‌شده مطابقت دارند؛ یک اطلاعیه حذف بدون فرستنده با فیلتر نویسنده مطابقت ندارد. 2. یک طرح صفحه را انتخاب کنید، سپس نمودارها، برچسب‌های شرکت‌کنندگان، متن پیاده‌سازی‌شده و یافته‌های مکتوب خود را برگزینید. تغییر طرح، این انتخاب‌ها را حفظ می‌کند. 3. پیش‌نمایش را بسازید. این تعداد واقعی، فعالیت، شرکت‌کنندگان، سوابق نمونه، تغییرات ذخیره‌شده و بازه‌های شماره‌ی پیام‌های مفقود را نشان می‌دهد. تغییر یک انتخاب، پیش‌نمایش را منقضی نشان می‌دهد. قبل از دانلود HTML، PDF امضا‌شده، JSON امضا‌شده یا فایل ZIP مدرک، ذخیره کنید. پیش‌نمایش داده‌ها کل پیش‌وند ثابت دفترچه را می‌شمارد، نه یک نمونه اولیه. تنها سطرهای نمونه نمایش داده شده و لیست‌های بلند محدود شده‌اند؛ شمارش‌های حذف شده آنها نشان داده می‌شود. یک خروجی‌گیری بعدی یک اسنپ‌شات پایدار جدید می‌گیرد، بنابراین جمع‌آوری در حال انجام ممکن است اعداد را افزایش دهد. دامنه، شمارش‌ها و هویت منبع در گزارش امضا شده گنجانده شده‌اند. باز کردن یا پیش‌نمایش فرم، آن را ذخیره نمی‌کند. **راهنمای حوزه قضایی.** در بخش جزئیات سند، **راهنمای حوزه قضایی را باز کنید · اختیاری است** تا یک حوزه قضایی و رویه مدنی/تجاری یا کیفری را انتخاب کنید. پیوست حاوی مبنای قانونی، پیوندهای منبع، یادداشت‌های آماده‌سازی و وضعیت تحقیق است. خلاصه‌ها و توضیحات به زبان محلی در مورد تضمین‌های جمع‌آوری اختیاری هستند. هیچ حوزه قضایی به‌طور پیش‌فرض انتخاب نمی‌شود. این انتخاب‌ها به فضای کاری تعلق دارند و از پیکربندی‌های طرح‌بندی ذخیره شده و پیش‌فرض‌های ضمنی اشتراک‌گذاری/کپی مستثنی هستند. [پیش‌فرض‌ها، گزارش‌های پشتیبانی‌شده و محدودیت‌های تحقیق](https://github.com/phishdestroy/TgWitness/blob/main/docs/JURISDICTION_GUIDANCE.md) را ببینید. **نسخه دریافت‌کننده را انتخاب کنید.** نمودارها و متن رونوشت از رکوردهای انتخاب‌شده استفاده می‌کنند. یکپارچگی، نگهداری و پوشش، دفترچه منبع کامل را توصیف می‌کنند. فایل فشرده (ZIP) مدرک حاوی رکوردهای اصلی و پیوست‌های آن است. در صورتی که دریافت‌کننده باید فقط داده‌های انتخاب‌شده و مجاز را دریافت کند، از [تحویل‌دهی حداقلی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#handover-extract) استفاده کنید. ### ویرایش‌ها، حذف‌ها و شناسه‌های از دست رفته را بخوانید ویرایش، متن‌های ذخیره شده **قبل** و **بعد** از آن را نمایش داده و کلمات تغییر یافته را برجسته می‌کند. حذف، آخرین نسخه ذخیره شده قبل از هشدار را نشان می‌دهد. اگر هیچ محتوای قبلی ضبط نشده باشد، گزارش این موضوع را اعلام می‌کند. هنگامی که فقط ویرایش‌ها یا حذف‌ها را انتخاب می‌کنید، نسخه‌های قبلی به عنوان زمینه‌ای با برچسب واضح در خارج از فیلترها در دسترس باقی می‌مانند. پیام‌های نامرتبط به این سوابق اضافه نمی‌شوند. **شناسه پیام‌های مشاهده‌نشده،** فاصله‌هایی هستند بین شماره‌های شناخته‌شده در چت‌های انتخاب‌شده و بازه شناسه استخراج‌شده از تاریخ. هر رکورد منبع شناخته‌شده قبل از اعلام یک شماره به‌عنوان مشاهده‌نشده بررسی می‌شود: فیلتر کردن نویسنده دیگر، نوع رویداد یا تاریخ نمی‌تواند یک فاصله کاذب ایجاد کند. پیام‌های ذخیره شده مجاور به عنوان زمینه برچسب‌گذاری می‌شوند. یک شماره مفقود، وجود یا حذف شدن یک پیام را اثبات نمی‌کند؛ اعلان‌های حذف و بازرسی‌های ناموفق، انواع رویدادهای جداگانه‌ای باقی می‌مانند. ### طرحی را انتخاب کنید طرح‌های هشت صفحه‌ای برای گزارش‌های HTML دفترچه یادداشت و چت تکی و PDF امضا شده موجود است. این طرح‌ها از سوابق و محاسبات یکسانی استفاده می‌کنند، اما جلد، تایپوگرافی، عناوین فصل، جداول و فاصله‌گذاری متفاوتی دارند. | طراحی | سبک خواندن | | --- | --- | | کلاسیک | یک دایرهٔ سنتی با جلد تیره و بخش‌های شماره‌گذاری‌شده. | | ویراستاری | صفحه عنوان با حاشیهٔ قاب‌دار سریف، حاشیه‌های پهن و نوار فصل باریک. | | برگه توجیهی | جلدی جمع‌وجور با ستون فقرات سرمه‌ای، عناوین کوتاه و جداول چیده‌شده نزدیک به هم. | | تحلیل‌ها | جلد به سبک نظرسنجی، صفحات نمودار ماژولار و شکل‌های تک‌فاصله‌ای. | | فنی | دفتر ثبت خط‌دار، ریل مرجع شماره‌گذاری‌شده و جداول مقایسه دقیق. | | مرور کلی | جلد پانورامیک، فاصله‌گذاری مناسب و نمودارهای خلاصه برجسته. | | مجموعهٔ خواندن | یک نوار بخش‌بندی و فصل‌های گروه‌بندی‌شده برای یافته‌ها، دامنه، تغییرات و دفترچه مشاهدات. | | دفتر کل و حاشیه | فصول شماره‌گذاری‌شده با حاشیهٔ وسیع، نمودارهای دقیق و جداول و متن جداگانهٔ پیام‌ها. | طرح‌بندی به ازای هر فضای کاری ذخیره شده و در مانیفست خروجی امضا شده ثبت می‌شود. HTML به‌صورت آفلاین کار می‌کند، از تم‌های روشن و تاریک پشتیبانی می‌کند و خود را با صفحه‌نمایش‌های باریک و زبان‌های راست‌به‌چپ تطبیق می‌دهد. PDFهای بومی از فونت‌های همراه استفاده می‌کنند؛ طراحی ویرایشگاهی شامل Noto Serif تحت مجوز SIL Open Font همراه خود است. شماره‌گذاری صفحات و حاشیه و حاشیه نیز برای نمای کلی حساب، چت‌های حساب و نسخه‌های اشتراکی اعمال می‌شوند. PDFهای چینی، ژاپنی و کره‌ای علاوه بر این به یک فونت مناسب روی سرور، مانند Noto Sans CJK، نیاز دارند که باید در کل سیستم نصب شود یا در پوشه `TGWITNESS_FONT_DIR` قرار داده شود. در صورت عدم دسترسی به آن، فایل فشرده (ZIP) گزارش‌های HTML و JSON را نگه می‌دارد. این دو طرح شامل یک گزارش خوانا بدون جاوا اسکریپت هستند. برای خروجی‌های بزرگ، این نما تا ۵۰۰ رکورد کامل را در یک بودجه ورودی ۸ مگابایتی (MiB) در خود جای می‌دهد؛ گزارش این محدودیت را برچسب‌گذاری کرده و به ویور کامل و رکوردهای منبع لینک می‌دهد. دایرکتوری حساب کاربری و شاخص روابط، همان نمونه خواندنی را توصیف می‌کنند، نه همه شرکت‌کنندگان را. نمودارهای کل ژورنال، دامنهٔ اعلام‌شدهٔ جداگانهٔ خود را حفظ می‌کنند. ### انتخاب محتوا | محتویات از پیش تنظیم‌شده | به‌طور پیش‌فرض گنجانده شده | | --- | --- | | پرونده موردی | فعالیت، زمان‌های مشاهده، شرکت‌کنندگان، چت‌ها و متن رونوشت رکورد. | | برگه توجیهی | نمای کلی فعالیت بدون رتبه‌بندی شرکت‌کنندگان یا متن پیاده‌شده. | | بازبینی فعالیت | فعالیت‌ها، زمان‌های مشاهده، شرکت‌کنندگان، چت‌ها و ترکیب آن‌ها، همراه با ارجاعات منبع و اعداد دقیق. | | گزارش سفارشی | ترکیب اختصاصی نمودارها، متن پیاده‌سازی‌شده و پیش‌نمایش‌ها. | تغییر یک پیش‌تنظیم، طرح، جزئیات پرونده و تحلیل‌های مکتوب شما را حفظ می‌کند. بررسی‌های یکپارچگی، پوشش، محدودیت‌ها و دستورالعمل‌های تأیید اعتبار در هر طرح باقی می‌مانند. سوابق منشأ در فایل ZIP هنگام پنهان کردن یک نمودار یا رونوشت، دست‌نخورده باقی می‌مانند. **یادداشت‌های** اختیاری **«بررسی»** شامل سؤال، روش، یافته‌ها و نتیجه‌گیری نوشته شده توسط نویسنده گزارش است. در بخش یافته‌ها به فایل منبع و شماره‌های سوابق اشاره کنید. امضا این اظهارات نویسنده را در کنار گزارش حفظ می‌کند؛ مشاهدات منبع و تفسیر نویسنده قابل تشخیص باقی می‌مانند. واگذاری‌های بهینه‌شده این یادداشت‌های خصوصی و نمودارهای کامل دفترچه را حذف می‌کنند. گزینه‌های نمودار و بررسی برای گزارش‌های دفترچه اعمال می‌شوند. فعالیت را در طول زمان، نقشه حرارتی روزهای هفته/ساعت به وقت جهانی (UTC)، رتبه‌بندی شرکت‌کنندگان، رتبه‌بندی چت‌ها و ترکیب سوابق انتخاب کنید. ۵ تا ۳۰ گروه رتبه‌بندی‌شده و نام‌های مستعار خنثی یا شناسه حساب کاربری شرکت‌کنندگان را انتخاب کنید. فرستندگان ناشناس و شرکت‌کنندگان باقی‌مانده در ردیف‌های جداگانه‌ای قرار می‌گیرند. نام‌های مستعار فقط بر نمودارها تأثیر می‌گذارند؛ سوابق منبع همچنان حاوی هویت آن‌ها هستند. پیش‌نمایش طرح از روی پیش‌نویس نجات‌نشدنی با استفاده از اجزای جلد، بررسی و نمودار تولید به‌روزرسانی می‌شود و به تطبیق‌های موجود در ۵۰٬۰۰۰ رکورد اول منبع محدود است. پیش‌نمایش داده در زیر، کل انتخاب را محاسبه می‌کند. این پیش‌نمایش صراحتاً امضا نشده است و ویرایش‌ها را ذخیره نمی‌کند. دکمه‌های جلد و نمودارها بخش آن را جابجا می‌کنند. این یک پیش‌نمایش کامل PDF نیست. **«ذخیره تنظیمات گزارش»** انتخاب‌ها را برای خروجی‌های آینده اعمال می‌کند؛ فایل‌های امضا شده موجود تغییرناپذیر هستند. PDF از جلد، تایپوگرافی، چیدمان فصل و همین داده‌های تجمیعی منتخبِ HTML و JSON امضا شده استفاده می‌کند. ارزیابی اعتماد، محدودیت‌های پوشش و دستورالعمل‌های تأیید اعتبار همچنان حفظ می‌شوند. پنهان کردن نمودارها یا متن رونوشت خوانا، سطرهای منابع معتبر را از فایل ZIP حذف نمی‌کند. سری‌های نمودار غیرفعال‌شده از JSON تحلیلی حذف می‌شوند؛ برای محدود کردن افشای سوابق منابع، از یک خروجی‌گیری بهینه‌شده استفاده کنید. فیلترهای انتخاب داده بر گزارش‌های دفترچه اعمال می‌شوند؛ خروجی‌های حساب کاربری و اشتراک‌گذاری، دامنهٔ کسب و افشای خود را حفظ می‌کنند. ترجیحات مشترک طراحی/نمودار در خروجی‌های جدید چت/حساب و پیش‌نمایش‌های اشتراک‌گذاری حساب، ثابت باقی می‌مانند. زبان حساب/اشتراک‌گذاری و تنظیمات حریم خصوصی مستقل باقی می‌مانند؛ یادداشت‌های خصوصی پرونده و بررسی در این خروجی‌ها کپی نمی‌شوند. گزارش‌های حساب و اشتراک‌گذاری توسط مانیفست آرشیو امضا شده خود، محافظت‌شده به صورت HTML باقی می‌مانند. ژورنال، تحویل ژورنال به حداقل‌رسانی‌شده و کیت‌های تک‌چت نیز PDFهای امضا‌شده را ارائه می‌دهند. ### آنچه نمودارها می‌شمارند فعالیت ژورنال و نقشه‌های حرارتی، **مشاهدات** جدید، تاریخی، بازیابی‌شده، ویرایش‌شده، حذف‌شده و مفقود در بازبینی مجدد را بر اساس زمان مشاهده توسط گردآورنده در UTC شمارش می‌کنند. تپش‌های قلب و رسیدهای پیوست در نظر گرفته نمی‌شوند. رتبه‌بندی شرکت‌کنندگان فقط مشاهدات پیام جدید، تاریخی و بازیابی‌شده را می‌شمارد: یک فرستنده به‌عنوان ویرایشگر یا حذف‌کننده اعلام نمی‌شود. مشاهدات تکراری می‌توانند همان پیام تلگرام را توصیف کنند. تحلیل‌های مجله، شمارش‌ها را بر اساس نوع، ارجاع به رکورد اول/آخر و SHA-256 منبع `events.jsonl` حفظ می‌کنند. نمودارها شامل مقادیر دقیق در HTML و PDF هستند. باکت‌های روزانه پس از ۳۶۶ روز ثبت‌شده، به ماه‌ها تغییر می‌کنند؛ نمودارها این موارد را در حداکثر ۳۶ بازه با عرض یکسان ترکیب می‌کنند. بیش از ۱۰۰,۰۰۰ شناسه‌ی یکتا یا ۱۲۰۰ ماه، نمودار مربوطه را غیرقابل دسترس می‌کند، در حالی که شمارش‌های کلی دقیق همچنان در دسترس هستند. نمودارهای اسنپ‌شات و اشتراک‌گذاری حساب، فقط ردیف‌های پیام غیرخدماتی گنجانده‌شده را با استفاده از زمان ثبت‌شده پیامشان، محاسبه می‌کنند. تجمیعات اشتراک‌گذاری پس از سانسور و فیلترسازی محاسبه می‌شوند. این نمودارها حداکثر از ۹۰ بازه زمانی تاریخ UTC با عرض یکسان استفاده می‌کنند و تا ۱۰٬۰۰۰ مقدار گروه‌بندی را حفظ می‌کنند؛ شمارش‌های اضافی به صراحت اعلام و تطبیق داده می‌شوند. آخرین بازه زمانی ممکن است کوتاه‌تر باشد. تاریخ‌های نامشخص یا ساده وارد نمودارهای زمانی نمی‌شوند. یک بازه خالی به معنای عدم وجود مشاهدات شامل است؛ برای بررسی شکاف‌ها به پوشش مراجعه کنید. این نمودارها فعالیت‌های ذخیره شده را توصیف می‌کنند. فرستندگان ناشناس به عنوان یک دسته مجزا باقی می‌مانند و هر چک به صورت جداگانه گزارش می‌شود. هنگامی که گنجانده شود، فایل `analytics.json` توسط هش‌های فایل امضا شده آرشیو محافظت می‌شود. ژورنال `report.json` همان مجموعه انتخابی را جاسازی می‌کند. تأیید امضا بایت‌های تغییر یافته را تشخیص می‌دهد. برای بررسی ارقام، مجموعه‌های ژورنال را با `report_analytics.Analytics` و `selected` مجدداً محاسبه کنید، یا مجموعه‌های اسنپ‌شات را با `snapshot_analytics.collect` و `project` تهیه کنید. ### شاخص‌های ناهنجاری **پیش‌نمایش.** گزارش‌های شواهد بخشی با عنوان**شاخص‌های ناهنجاری** را اضافه می‌کنند که توسط پردازنده‌های ثبت‌شده (`tgwitness/metrics/`، یک فایل برای هر معیار) محاسبه می‌شود. این گزارش نام هر پردازنده‌ای را که اجرا شده به همراه نسخه آن ذکر می‌کند و روش آن را زیر جدولش چاپ می‌کند، تا محاسبه را بتوان از طریق `events.jsonl` با `tgwitness.metrics.run` تکرار کرد. | پردازنده | آنچه نشان می‌دهد | | --- | --- | | `first_time_posters_over_time` v1 | تعداد ارسال‌کنندگان برای اولین بار و پیام‌ها در هر روز UTC. یک پرچم نیازمند حداقل پنج ارسال‌کننده برای اولین بار و سه برابر میانه تعداد پیام‌های آن‌ها است، به‌طوری‌که حجم پیام‌ها حداکثر 1.5 برابر میانه باشد. خط پایه از حداقل هفت روز مشاهده‌شده در میان 14 روز تقویمی گذشته استفاده می‌کند، پس از هفت روز گرم‌کردن. | | `service_vs_message_ratio` v1 | شماره‌های پیام‌های ذخیره‌شده متمایز برای هر چت و سهمی که پیام‌های سرویس استفاده می‌کنند. این یک شماره‌گذاری را توصیف می‌کند؛ یک شمارهٔ خاص گمشده را توضیح نمی‌دهد. | | `join_leave_per_month` v1 | پیوست‌ها، ترک‌ها و حذف‌ها یا ممنوعیت‌ها به‌ازای هر ماه، یک مورد به‌ازای هر شخص، گفتگو، تغییر و روز. | | `pinned_per_month` v1 | پیام‌های سرویس پین‌شده، اعلان‌های رفع پین و پیام‌های پین‌شده که بین اسنپ‌شات‌های وضعیت چت در هر ماه اضافه یا حذف شده‌اند. | **پارامترها → گزارش معیارها،** پردازنده‌ها و تعداد سطرهای نمایش‌داده‌شده را انتخاب می‌کند، از جمله در گزارش‌های فیلترشده. جداول روزانه و ماهانه سطرهای اخیر را نشان می‌دهند، جداول سهم سرویس چت‌ها را بر اساس تعداد پیام‌های ذخیره‌شده رتبه‌بندی می‌کنند. مجموع‌ها تمام سطرها را پوشش می‌دهند. از یک چک‌اوت منبع، هر هشت طرح فهرست‌شده در بالا را از همان مجلهٔ خیالی بسازید: ``` python tools/build_report_styles.py --output test-results/report-styles ``` فایل `index.html` حاصل را باز کنید تا گزارش‌های کامل HTML، PDFهای امضا شده و فایل‌های ZIP را مقایسه کنید. هر طرح از همان مجله منبع استفاده می‌کند. برای هر اجرا از یک دایرکتوری خروجی جدید استفاده کنید تا نمونه‌های امضا شده قبلی حفظ شوند. ![دایرهٔالمعارف ساختگی HTML](https://phishdestroy.github.io/TgWitness/assets/dossier-en.png) HTML با یک صفحه عنوان پرونده و افراد کلیدی آغاز می‌شود. نقشه شواهد شماره‌گذاری‌شده به هر یافته، حقایق پشتیبان، محدودیت‌ها و بازبینی مستقل آن لینک می‌دهد. سوابق قابل جستجو و ارجاعات پایدار به سوابق در ویوئر آفلاین در دسترس باقی می‌مانند. طراحی خود را با صفحه‌های باریک، هر دو تم و مرورگرهای بدون جاوااسکریپت تطبیق می‌دهد. فایل PDF امضا شده دارای یک جلد اختصاصی A4، مرجع گزارش و QR، یک خلاصه اجرایی، یک نقشه شواهد، یافته‌های شماره‌گذاری‌شده و نشانک‌های سند است. سربرگ‌ها و پاورقی‌های صفحات آن، گزارش را شناسایی می‌کنند. یک QR، محتوا را شناسایی می‌کند؛ این یک نتیجه تأیید مستقل نیست. خروجی‌های چاپ‌شده از مرورگر، از این فایل PDF امضا شده با رمزنگاری جدا هستند. خط زمانی مشاهده، دوره‌های مشاهده ضبط‌شده و وقفه‌ها را بر روی یک محور UTC قرار می‌دهد. فضای خالی به معنای پوشش‌دهی استنباط‌شده نیست؛ جداول دقیق، بازه‌های زمانی دقیق را حفظ می‌کنند. فایل ZIP حاوی گزارش‌های قابل‌خواندن، JSON امضا‌شده، سوابق منبع و دستورالعمل‌های تأیید است. یک دایرهٔ جدید و خیالی انگلیسی/روسی/آلمانی را با محیط توسعهٔ نصب‌شده تولید کنید: ``` python tools/build_dossier_example.py --output test-results/my-new-dossier ``` هر پوشه زبان حاوی فایل‌های `report.html`، `report.pdf`، `report.json` و `dossier.zip` است. پوشه‌های نمونه موجود هرگز بازنویسی نمی‌شوند. برای ایجاد آن از هیچ حساب تلگرام، سرویس زمان‌گذاری خارجی یا اتصال شبکه استفاده نمی‌شود. ![سه صفحهٔ اول PDF فرضی امضا شده](https://phishdestroy.github.io/TgWitness/assets/dossier-pdf.png) ## خواندن یک پروندهٔ مشخص برای یک ژورنال ۱۲۰۰ ورودی که دارای یک مهر زمانی معتبر در ورودی ۱۰۰۰ است، گزارش ۲۰۰ ورودی بعدی را که خارج از محدوده آن مهر زمانی قرار دارند، شناسایی می‌کند. این یک حد بالایی برای وجود یک نقطه کنترل است، نه اثبات زمان ارسال هر پیام. اگر سه فایل تاریخ‌مصرف دیگر در اعتبارسنجی ناموفق باشند یا قابل اعتبارسنجی نباشند، به صورت جداگانه شمارش می‌شوند و نمی‌توانند نتیجه‌گیری مثبتی ارائه دهند. یک مهر زمانی قابل استفاده باید تمام این بررسی‌ها را برآورده کند: اثر انگشت آن با نقطه کنترل مطابقت دارد، امضای آن در زمان مهر شده به یک ریشه TSA مورد اعتماد زنجیر می‌شود، و امضا، کلید، شمارش و سرِ نقطه کنترل با پیشوند دقیق دفترچه یادداشت مطابقت دارد. صرفاً تجزیه یک مهر زمانی یا داشتن رسید OTS کافی نیست. خواننده باید به طور مستقل ریشه TSA مورد اعتماد را انتخاب کرده و تأیید را تکرار کند. OTS به بررسی تأیید بیت‌کوین خود نیاز دارد. | وضعیت گزارش | معنی | | --- | --- | | در حین صدور بررسی شده است | صادرکننده بررسی اعلام‌شده را انجام داد؛ تکرار مستقل همچنان لازم است. | | ثبت شد؛ نیازمند بازبینی | مشاهده یا بیانیهٔ اپراتور زیربنایی ثبت می‌شود؛ این تأیید مستقل نیست. | | در این نسخه گنجانده نشده است | این متن هیچ مدرک پشتیبان برای این ادعا ندارد. در آن گفته نشده که چنین چیزی در جای دیگری وجود ندارد. | | به‌طور مستقل بررسی نشده است | گزارش نتیجهٔ تأیید مستقل را ارائه نمی‌دهد. | | نامکمل یا در دسترس نیست | ماده یا بررسی مورد نیاز وجود ندارد، ناقص است یا ناموفق بوده است. | هر چک را به‌طور جداگانه همراه با پوشش جمع‌آوری ثبت‌شده بررسی کنید. ## آنچه یک پیکربندی قوی باید حفظ کند 1. قبل از اتکا به جمع‌آوری، اثر انگشت کلید گردآورنده را از طریق یک کانال امن جداگانه حفظ کنید. آن مرجع را با کلید امضای خروجی مقایسه کنید. 2. نقاط کنترل دارای مهر زمانی مستقل را حفظ کنید و در صورت استفاده، دفترچه شاهد را خارج از کنترل اداری گردآورنده نگه دارید. آن‌ها را با دفترچه صادرشده مقایسه کنید تا مرزهای قبلی آن را بررسی کنید. 3. دامنهٔ اکتساب سوابق، شکاف‌ها، فیلترها، محدودیت‌ها و تغییرات در جمع‌آوری. توضیح دوره‌های گمشده مرتبط با ادعای واقعی، با حفظ تمایز بین شناسه‌های پیام نادیده، اعلان‌های حذف و بازبینی‌های ناموفق. 4. فایل‌های ZIP اصلی و هش‌های آن‌ها را حفظ کنید. هر دارنده، انتقال، تاریخ و هدف را ثبت کنید. بیانیه‌های اپراتور منسوب و یادداشت‌های پرونده را همراه آن‌ها نگهداری کنید. 5. برای ماشین‌های مجازی محرمانه، نقل‌قول، چالش، زنجیره گواهی اینتل، اندازه‌گیری‌ها، منبع دقیق و شرایط مدیریت کلید را حفظ کرده و به‌طور مستقل تأیید کنید. نتیجه تأیید اعتبار را همراه با مصنوعات بازبینی‌شده نگه دارید. برای بررسی‌های مربوط به اکتساب، یکپارچگی آرشیو، زمان و پوشش جمع‌آوری در هر حالت، به [دامنه تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope) مراجعه کنید. ## بازبینی دریافت‌کننده از یک نصب معتبر TgWitness و یک اثر انگشت به‌طور مستقل به‌دست‌آمده استفاده کنید: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca tsa-root.pem python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --witness witness.zip --witness-fingerprint WITNESS_SHA256 --require-witness python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --check-drand ``` فایل ZIP شاهدی باید از یک منبع مستقل و مورد اعتماد تهیه شود؛ کلید و منشأ آن نیز باید حفظ شود. دستورات، نسخه ابزار، خروجی‌ها، هش‌های ورودی بررسی‌شده و سؤالات حل‌نشده را نگهداری کنید. تأیید بیکن یک بررسی آنلاین جداگانه است؛ رندرکننده گزارش هرگز صرفاً برای نمایش یک گزارش با هیچ سرویسی تماس نمی‌گیرد. برای اختلاف بر سر یک پیام خاص، به مرجع آرشیو، فایل معتبر و مرجع رکورد اشاره کنید، سپس پوشش‌های زمانی مرتبط، شکاف‌های پوشش، انتخاب و مطالب تأییدکننده را توصیف کنید. برای یک نسخه به اشتراک‌گذاری شده، همچنین تغییرات ثبت‌شده و ارجاعات آن به آرشیو اصلی را بررسی کنید. فیلترهای خصوصی و نگاشت هویت خارج از ارزیابی عمومی آن باقی می‌مانند. تأیید صحت PDF امضا شده، تغییرات بایت‌های پوشش‌داده‌شده را تشخیص می‌دهد. فایل دیجیتال اصلی و نتیجه تأیید صحت را در کنار هرگونه اسکرین‌شات یا نسخه‌های چاپی خواندنی نگه دارید. --- # Telegram · صادرات حساب Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/account-export/ صادرات آنچه یک حساب اکنون می‌تواند بخواند: دامنه، کارهای قابل از سرگیری، یک آرشیو امضا شده و نسخه‌های اشتراک‌گذاری‌شدهٔ به حداقل‌رسیده. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) صادرات آنچه یک حساب اکنون می‌تواند بخواند: دامنه، کارهای قابل از سرگیری، یک آرشیو امضا شده و نسخه‌های اشتراک‌گذاری‌شدهٔ به حداقل‌رسیده. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [شواهد و تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) ![شواهد و تأیید](https://phishdestroy.github.io/TgWitness/assets/chapter-evidence.svg) خروجی حساب، آن حساب را انحصاری رزرو می‌کند. پیش از شروع یا ازسرگیری، پایش یا گردآوری دیگر را صریحاً موقتاً متوقف کنید؛ برنامه هرگز آن را خودکار متوقف نمی‌کند. به‌عنوان مدیر نصب، **«از اینجا شروع کنید» → «حسابم را صادر کن**» یا **«صادرات‌ها» → «حساب تلگرام» → «تنظیم صادرات حساب»** را انتخاب کنید. در صورت لزوم وارد شوید، دامنه را بررسی کنید و خروجی‌گیری را به صراحت آغاز کنید. نظارت مداوم ضروری نیست. **مشاهدات ذخیره‌شده**، یک خروجی‌گیری جداگانه از ژورنال موجود است؛ ZIP آن شامل تمام منابع، صرف‌نظر از فیلترهای ژورنال می‌شود. هر فضای کاری دارای جاب‌ها، هویت امضا و ذخیره‌سازی خاص خود است. دسترسی به پنل صادرشده، از جمله مجوز خروجی‌گیری عادی نامحدود، نمی‌تواند این مسیرهای در سطح حساب را باز کند. فیلترهای فرستنده و متن زیر **«فیلتر بر اساس فرستنده» یا «متن پیام**» باز می‌شوند. **بخش «داده‌های حساب و روش اتصال»** شامل دسته‌بندی‌های اختیاری حساب و گزینه «خروج/جلسه عادی» است؛ خلاصه آن حتی وقتی بسته است، گزینه‌های فعال را نشان می‌دهد. بستن این بخش‌ها تنظیمات آن‌ها را حفظ می‌کند. پیش‌نویس‌های خروج و گزارش در جلسه پنل جاری باقی می‌مانند و با تغییر نما ذخیره نمی‌شوند. کارهای موجود از هر دو گزینه خروج قابل دسترسی هستند. این گردش کار داده‌های در حال حاضر قابل دسترسی به حساب متصل را صادر می‌کند. پیش‌فرض از [Telegram Takeout](https://core.telegram.org/api/takeout) استفاده می‌کند؛ این یک نسخه پشتیبان از داده‌های در دسترس نبوده یا حذف‌شده تلگرام نیست. چت‌های مخفی، تاریخچه غیرقابل دسترسی و ویرایش‌های قبلی بازیابی نمی‌شوند. تلگرام می‌تواند قبل از شروع Takeout یک دوره انتظار تعیین کند. پنل آن دوره انتظار را نمایش می‌دهد؛ به‌طور بی‌صدا روش انتقال را تغییر نمی‌دهد. گزینه صریح regular-API پوشش متفاوتی دارد و دسته‌بندی‌های پشتیبانی‌نشده را ثبت می‌کند. Takeout، API رسمی خروجی است که تلگرام دسکتاپ نیز از آن استفاده می‌کند. TgWitness می‌تواند مستقیماً از طریق جمع‌آوری داده‌های خود، JSON سازگار با دسکتاپ بنویسد؛ وارد کردن آرشیو شخص دیگر الزامی نیست. شناسه‌های چت و پیام از طریق هر دو روش انتقال در دسترس هستند. یک چت عمومی یا اجازه فوروارد کردن، تضمین‌کننده خروجی سریع‌تر نیست و تأخیر تأیید Takeout را از بین نمی‌برد. قبل از مقایسه سرعت، دامنه و تنظیمات رسانه را یکسان در نظر بگیرید. برای حداکثر 20 شناسه چت صریحاً انتخاب‌شده، خروجی‌گیری با API معمولی، آن همتایان را مستقیماً قبل از در نظر گرفتن کل فهرست مکالمات حساب کاربری، حل می‌کند. بنابراین، یک کانال عمومی قابل‌خواندن را می‌توان بدون پیوستن به آن، حتی زمانی که در فهرست مکالمات وجود ندارد، صادر کرد. همکاران (peers) بدون کش به موجودی عادی بازمی‌گردند. فیلتر بایگانی همچنان اعمال می‌شود: اگر تلگرام یک گفتگوی جدید را بازنمی‌گرداند و چت‌های بایگانی‌شده حذف شده‌اند، وضعیت بایگانی نامشخص به عنوان یک حذف ثبت می‌شود. Takeout روش موجودی بازه-تقسیم‌شده خود را حفظ می‌کند. هیچ‌یک از مسیرها چت‌ها را به هم متصل نمی‌کنند یا مجوزهای فوروارد را تغییر نمی‌دهند. در JSON سازگار با دسکتاپ، کانال‌هایی که تلگرام به عنوان `left` علامت‌گذاری می‌کند، در زیر `left_chats` ظاهر می‌شوند، از جمله کانال‌های عمومی قابل خواندن که حساب کاربری به آن‌ها نپیوسته است. هم `FLOOD_WAIT` و هم `FLOOD_PREMIUM_WAIT` درخواست‌ها را برای کل دورهٔ درخواستی سرور متوقف می‌کنند. مهلت حساب کاربری در طول اتصال مجددها و راه‌اندازی مجددها حفظ می‌شود؛ یک انتظار کوتاه‌تر بعدی نمی‌تواند آن را کوتاه‌تر کند. تلاش‌های مجدد محدود هستند، لغو، صفحات مهر و موم شده را حفظ می‌کند، و اعتبارنامه‌های API برای دور زدن محدودیت نرخ چرخانده نمی‌شوند. هیچ خرید پریمیومی انجام نمی‌شود. ## انتخاب کنید چه اطلاعاتی جمع‌آوری شود | تنظیمات | معنی | | --- | --- | | هدف | ثبت کنید که چرا این اکتساب ضروری است. نام‌های غیرضروری یا جزئیات حساس پرونده را اینجا وارد نکنید. | | زبان گزارش | زبان برچسب‌های گزارش قابل‌خواندن را انتخاب کنید. متن پیام اصلی بدون تغییر باقی می‌ماند؛ برچسب‌های قالب بدون ترجمه از انگلیسی استفاده می‌کنند. زبان با گزینه‌های شغل امضا شده ثابت می‌شود. | | انواع چت / شناسه‌های چت | تمام انواع انتخاب‌شده، یا فقط چت‌های فهرست‌شده؛ پیام‌های ذخیره‌شده مربوط به چت‌های خصوصی هستند. چت‌های بایگانی‌شده به‌طور جداگانه قابل انتخاب‌اند. | | تاریخ‌ها | UTC. تاریخ‌های تقویمی From و Through پنل هر دو لحاظ می‌شوند. API از مقادیر شامل استفاده می‌کند `from_utc` و انحصاری `to_utc`؛ پنل شروع روز بعد از Through را ارسال می‌کند. یک محدوده خالی آن سمت را بدون محدودیت باقی می‌گذارد. | | شناسه فرستنده‌ها | فقط پیام‌های ارسال‌کنندگان فهرست‌شده؛ یک فهرست خالی شامل همه ارسال‌کنندگان است. | | متن شامل | عبارات تحت‌اللفظی بدون توجه به حروف بزرگ/کوچک که با OR مطابقت داده می‌شوند. شرایط فرستنده/تاریخ/پیام-خود با AND ترکیب می‌شوند. | | پیام‌های خود | فقط پیام‌های ارسالی را نگه دارید. | | انواع رسانه | دسته‌بندی‌های پیوست را انتخاب کنید، یا همه را پاک کنید تا از دانلود فایل‌های پیام جلوگیری شود. | | فایل / محدودیت‌های کلی رسانه | میگابایت (MiB) برای هر فایل و گیگابایت (GiB) کل رسانه‌های دانلودشده. متن، رسیدها، گزارش‌های قابل‌خواندن و سربار ZIP به فضای دیسک اضافی نیاز دارند. | | دسته‌بندی‌های حساب | پروفایل، مخاطبین، عکس‌های پروفایل، استوری‌ها، متادیتای جلسه و سایر داده‌های Takeout کنترل‌های جداگانه‌ای دارند. | پیش‌تنظیم **«Minimize collection**» متادیتای فایل‌ها و حساب‌ها را غیرفعال می‌کند. فیلترهای فرستنده/محتوا پیش از نگهداری صفحات پیام و دانلود رسانه‌ها اعمال می‌شوند. تلگرام همچنان صفحات تاریخچه API حاوی پیام‌های لازم برای ارزیابی آن فیلترها را منتقل می‌کند: فیلتر کردن تضمین نمی‌کند که پیام‌های انتخاب‌نشده هرگز وارد حافظه پردازش نشوند. سایر مشاهدات جاری در فضای کاری دارای دامنه و تنظیمات نگهداری خاص خود هستند. تاریخچه عکس پروفایل و استوری‌ها به‌صورت پیش‌فرض انتخاب نمی‌شوند. همچنین وقتی پرونده تنها به پیام‌ها نیاز دارد، پروفایل و مخاطبین را غیرفعال کنید. اگر پیوست‌ها یا متادیتا غیرضروری هستند، حذف آن‌ها در حین جمع‌آوری از نگهداری یک نسخه خصوصی دیگر در این خروجی جلوگیری می‌کند. حمله‌های تصویری از نوع تصویر ثابت شناسایی‌شده در متادیتا و هش مانیفست‌های خود استفاده می‌کنند، از جمله عکس‌هایی با نوع آواتار متحرک. آن انیمیشن جایگزین تصویر ثابت انتخاب‌شده نمی‌شود. یک حمله‌ی کوتاه‌تر یا بلندتر از اندازه مشاهده‌شده به‌عنوان یک پیوست ناموفق ثبت می‌شود و نمایش تغییر‌یافته در هنگام تمدید ارجاع فایل رد می‌گردد. این خطاها آرشیو را ناقص باقی می‌گذارند، در حالی که سوابق پیام‌ها را حفظ می‌کنند. تأیید مستقل همچنین پیوست‌های ذخیره‌شده‌ای را که طول امضا شده‌شان با اندازه یا نمایش مشاهده‌شده‌شان تناقض دارد، رد می‌کند، حتی در آرشیوهای قدیمی‌تر. ## خلاصه، پوشش و تأیید هر کار، گزینه‌ها و هویت حساب کاربری خود را منجمد می‌کند. موجودی و صفحات ضبط‌شده امضا می‌شوند؛ رسیدهای صفحات، هش‌ها، مکان‌نماها، زمان‌ها، نتایج پیوست‌ها و رسید قبلی آن‌ها را ثبت می‌کنند. تنها صفحات ارسال‌شده پیشرفت را جلو می‌برند. عملیات ازسرگیری/ادامه، پیش از ادامه، آن سوابق را بررسی می‌کند. حساب تغییر‌یافته، صفحه امضا‌شده تغییر‌یافته یا زنجیره رسید ناسازگار رد می‌شوند. گزینه‌ها را نمی‌توان در میانه یک عملیات ضبط ویرایش کرد: برای دامنه دیگر، کار دیگری را آغاز کنید. توقف، عملیات حساب در حال اجرا را متوقف می‌کند. راه‌اندازی مجدد برنامه، کارهای ناتمام را برای از سرگیری صریح در دسترس قرار می‌دهد. یک جلسه Takeout منقضی‌شده نیازمند از سرگیری صریح است؛ تغییر بازه‌های تقسیم‌شده تلگرام ممکن است نیازمند یک اکتساب جدید باشد. از سرگیری، مشاهدات قبلی را حفظ می‌کند، بنابراین یک خروجی‌گیری طولانی‌مدت یک نمای کلی اتمی نیست. سایر عملیات‌های تغییر حساب و خروجی‌گیری‌های متضاد در حین اکتساب مسدود می‌شوند. پیش از حذف یک فضای کاری، منتظر اتمام بسته‌بندی باشید. Resume پیش از ادامه، محتوای قبلاً ضبط‌شده را تأیید می‌کند. آرشیوهای بزرگ روی حافظهٔ کند ممکن است از زمان پیکربندی‌شده برای بررسی یکپارچگی (**پارامترها → انقضای زمان اقدام پنل**) (به‌طور پیش‌فرض ۱۲۰ ثانیه) فراتر روند. پیش از تلاش مجدد، آن تنظیم را افزایش دهید؛ لغو یا قطع ذخیره‌سازی، کار را در حالت مکث باقی می‌گذارد و بررسی‌های یکپارچگی ناموفق، کار را با توضیحی ناموفق اعلام می‌کنند. بررسی باید به‌طور ایمن پایان یابد یا متوقف شود تا فایل‌های آن بسته شوند. هیچ ادعایی دربارهٔ توان عملیاتی حساب‌های بزرگ توسط بررسی‌های مصنوعی تأیید نشده است. پنل بین یک دامنهٔ انتخابی تکمیل‌شده و یک آرشیو جزئی تمایز قائل می‌شود و حذف‌ها و خوانش‌های ناموفق را ثبت می‌کند. فایل‌های عمداً حذف‌شده با فایل‌های ناموفق یا در دسترس نبوده متفاوت‌اند. پوشش را حتی زمانی که تأیید یکپارچگی موفق است بررسی کنید. هیچ خوانندهٔ محلی نمی‌تواند اثبات کند که تلگرام همهٔ پیام‌هایی را که تاکنون وجود داشته‌اند بازگردانده است. ZIPهای تکمیل‌شده همچنان برای دانلودهای مکرر و دانلود با محدوده HTTP در دسترس هستند. یک آرشیو حساب شامل `manifest.json`, `manifest.sig`، امضا شده `job.json`, `inventory.json`, `receipts/`، معتبر `data/*.jsonl`، انتخاب‌شده `media/`، قابل خواندن HTML و یک اعتبارسنج. اثر انگشت گردآورنده را از طریق یک کانال مستقل پین کنید، سپس با استفاده از یک نصب مورد اعتماد تأیید کنید: ``` python -m tgwitness.verify account-export.zip --fingerprint TRUSTED_SHA256 ``` برای آرشیوهایی که محتوای توسعه‌یافتهٔ آن‌ها از ۴ گیگابایت فراتر می‌رود، یک مقدار صریح و کافی تنظیم کنید `--max-gib`. این پنل آرشیوهای محلی احراز هویت‌شده و تکمیل‌شده را با استفاده از اندازه توسعه‌یافته اعلام‌شده و هَش منتشرشدهٔ ZIP آنها تأیید می‌کند؛ CLI خارجی محدودیت اندازه مستقل خود را حفظ می‌کند. پیش از باز کردن HTML قابل‌خواندن، آن را تأیید کنید. اعتبارسنج همراه آرشیو مناسب است، اما استفاده از یک اعتبارسنج مستقل، از اعتماد به کد اجرایی ارائه‌شده همراه با مدرک جلوگیری می‌کند. امضای Ed25519 و هش‌های SHA-256 تغییرات را پس از اینکه گردآورنده بایت‌های مربوطه را ثبت کرد، تشخیص می‌دهند. این هش‌ها**نه** اثبات می‌کنند که تلگرام آن پیام‌ها را امضا کرده است، اپراتور گردآورنده صادق بوده است، تاریخچه حساب کامل است، یا دادگاه این مواد را خواهد پذیرفت. زمان‌های ضبط بر اساس ساعت گردآورنده هستند. مهرهای زمانی مستقل و منشأ مستقل اکتساب باید به‌طور جداگانه ارزیابی شوند. ## یک افشا را برای یک وکیل یا گیرندهٔ دیگر آماده کنید پس از دانلود یک خروجی نهایی، ZIP اصلی را نگه دارید و باز کنید `index.html` را از یک نسخه استخراج‌شده باز کنید. این گزارش، دامنه، پوشش موجود و محدودیت‌های خود را توضیح می‌دهد. ارجاعات سوابق آن، مرجع آرشیو، مسیر سند و شماره سوابق را ترکیب می‌کنند، تا دریافت‌کننده بتواند همان مورد را در HTML یا نسخه چاپی پیدا کند. برای یک مثال کاربردی، به [گزارش خیالی را باز کنید](https://phishdestroy.github.io/TgWitness/demo/report/) مراجعه کنید. از خروجی حساب آماده، گزینه **«آماده‌سازی یک نسخه اشتراکی» را** انتخاب کنید. این کار یک مشتق امضا‌شدهٔ جداگانه ایجاد می‌کند. منبع ZIP بدون تغییر و خصوصی باقی می‌ماند؛ آن را همراه با مشتق فشرده‌شده ارسال نکنید مگر اینکه گیرنده مجاز به دریافت کل محتویات آن باشد. زبان گزارش آن را به‌طور جداگانه انتخاب کنید. تغییر زبان یا هر تنظیم انتخابی نیازمند پیش‌نمایش دیگری پیش از ایجاد است. 1. هدف افشا را وارد کنید و تاریخ‌ها، شناسه فرستنده و معیارهای متن دقیق را انتخاب کنید. 2. انتخاب کنید که آیا هویت‌ها را حفظ کنید، فقط شرکت‌کنندگان فهرست‌شده را نمایش دهید یا همه را مستعار کنید. در حالت مستعارسازی، شناسه/عنوان چت‌ها و شناسه پیام‌ها نیز جایگزین می‌شوند. مستعارنامه‌ها در داخل یک افشا ثابت هستند و بین افشاهای مستقل تهیه شده تغییر می‌کنند. 3. متن پیام را حفظ کنید، آن را به‌طور کامل حذف کنید یا نام‌ها/عبارت‌های واقعی را برای مخفی‌سازی اضافه کنید. در حالت‌های خصوصی، ابزار همچنین نام‌های فرستنده‌ی شناخته‌شده‌ی پنهان، نام‌های کاربری جایگزین، شناسه‌های فرستنده با توکن کامل، نام‌های چت مستقیم، لینک‌ها، آدرس‌های ایمیل و رشته‌های شبیه شماره تلفن را مخفی می‌کند. تطبیق نام شناخته‌شده، تا حد امکان به همت Unicode در تبدیل حروف بزرگ و کوچک عمل می‌کند، از جمله `Straße`/`STRASSE`. عناوین عمومی گروه‌ها/کانال‌ها به طور خودکار از متن پیام حذف نمی‌شوند. اگر محدودیت ماسک‌گذاری هویت‌های شناخته‌شده فراتر رود، خروجی منبع را محدودتر کنید یا متن را حذف کنید؛ این ابزار از پرش بی‌صدا روی نام‌های بعدی خودداری می‌کند. این‌ها قوانین مبتنی بر بهترین تلاش هستند، نه ناشناس‌سازی عمومی. 4. فایل‌ها را حذف کنید مگر اینکه گیرنده به آن‌ها نیاز داشته باشد. نسخه‌های اصلی ضمیمه‌شده پیکسل‌ها، صدا، متن و متادیتای خود را حفظ می‌کنند. آن‌ها توسط ابزار به‌صورت **نه** ناشناس‌سازی می‌شوند. 5. پیش‌نمایش شمارش‌ها، هشدارها و نمونه‌های پیام‌های تبدیل‌شده را مشاهده کنید، سپس صراحتاً ایجاد را تأیید کنید. هر نمونه محدود به ۱۲ پیام و ۲۰۰۰ کاراکتر متن است. این یک نمونه است، نه بررسی کامل نتیجه. تغییر تنظیمات نیاز به پیش‌نمایش دیگری دارد. پیش‌نمایش پس از ۱۵ دقیقه منقضی می‌شود و به آن جلسه مدیر و دقیقاً همان ZIP اصلی محدود است؛ پس از ایجاد قابل استفاده مجدد نیست. پیش‌نمایش جدید، پیش‌نمایش قبلی را برای همان کار و جلسه باطل می‌کند. 6. نتایج کامل را بررسی کنید `index.html` و `messages.jsonl` محلی را قبل از تحویل بررسی کنید. اگر اطلاعات غیرضروری را فاش کرد، یک افشاگری جدید با استثناهای قوی‌تر ایجاد کنید. ZIP امضا شده را در محل ویرایش نکنید. ### پیام‌هایی که با انتخاب حذف شده‌اند **پیش‌نمایش.** افشا وقتی کامل به نظر نمی‌رسد که کامل نباشد. در هر چتی که حداقل یک پیام افشا شده دارد، پیام‌هایی که از انتخاب حذف شده‌اند به صورت نشانگر ظاهر می‌شوند، `[withheld by selection — rule: sender]` (یا `text`, `period`). **پیام‌های خارج‌شده از انتخاب را** انتخاب کنید: یک نشانگر برای هر گروه متوالی از پیام‌های پنهان‌شده (پیش‌فرض) یا یک نشانگر برای هر پیام. نشانگرها فقط شامل قانون و یک شمارش هستند، هرگز متن، فرستنده، تاریخ یا فایل‌ها را در بر نمی‌گیرند. چت‌هایی که هیچ پیامی در آن‌ها فاش نشده است، به طور کامل حذف می‌شوند، بنابراین این بسته وجود آن‌ها را فاش نمی‌کند. پاسخ‌های افشا شده می‌گویند به چه چیزی پاسخ می‌دهند: پیامی که در این نسخه گنجانده شده، پیامی که توسط انتخاب پنهان شده، یا پیامی که در خروجی منبع وجود ندارد (پیش از صدور حذف شده یا هرگز صادر نشده؛ خروجی نمی‌تواند تشخیص دهد کدام یک). پیامی که پنهان شده و یک پاسخ افشا شده به آن پاسخ می‌دهد، همیشه نشانگر مخصوص به خود را دریافت می‌کند، بنابراین پاسخ به سندی اشاره می‌کند که توضیح می‌دهد چرا خالی است. این سه وضعیت با حذف‌ها و فواصل جمع‌آوری که به خروجی منبع تعلق دارند، متفاوت هستند. در `messages.jsonl` (قالب `tgwitness-account-disclosure-v2`) هر پیام دارای `state`: `disclosed`، یا `withheld` با `rules` و `count`. یک پاسخ افشا شده دارای `reply_to` با هدف `id` و `state` (`disclosed`, `withheld`, `not_in_source`). منیفست پیام‌های افشا شده، چت‌ها، رسانه‌ها و `withheld` پیام‌ها. `verify.py` یک نشانگر حاوی محتوا و پاسخی که به رکوردی اشاره می‌کند که در بسته وجود ندارد را رد می‌کند؛ بسته‌های نسخه 1 همانند قبل اعتبارسنجی می‌شوند. قالب فشرده‌شده پروفایل‌های ساختاریافته حساب، مخاطبین، آواتارها، جلسات، استوری‌ها، اشیاء خام تلگرام، سربرگ‌های فوروارد، نقل‌قول‌های پاسخ، کارت‌های تماس و متادیتای موقعیت را حذف می‌کند. این قالب فایل‌های اصلی JSONL، تنظیمات فیلتر خصوصی، کلید نام مستعار و نقشه هویت را شامل نمی‌شود. متن‌های انتخاب‌شده، هویت‌های صراحتاً نگه‌داشته‌شده و فایل‌های گنجانده‌شده همچنان می‌توانند حاوی همان نام‌ها، شناسه‌ها یا عبارات به‌کاررفته در آن فیلترها باشند؛ این موارد نیازمند بررسی جداگانه‌اند. سیاست خصوصی و کلید مستعار در گاوصندوق محلی برای این کار به‌صورت رمزگذاری‌شده نگهداری می‌شوند؛ حذف این کار، سوابق افشای خصوصی مرتبط با آن را پاک می‌کند. سوابق سیاست عمومی به جای مقادیر فیلتر، تعداد فیلترها را ثبت می‌کنند. هدف اعلام‌شده در مانیفست و HTML عمومی است: معیارهای خصوصی صریح و در حالت‌های مستعار، هویت‌های پنهان شناخته‌شده نیز در آنجا ماسک می‌شوند، حتی زمانی که متن پیام حذف شده باشد. هدف را از جزئیات شخصی غیرضروری عاری نگه دارید؛ زمینه شناسایی ناشناخته می‌تواند باقی بماند. بیانیهٔ آن فایل‌های مشتق، سیاست عمومی و هش نسخهٔ اصلی ZIP را پیوند می‌دهد. تأیید می‌تواند یکپارچگی را برقرار کند و در صورتی که منبع به‌صورت محلی ارائه شود، پیوند تطبیقی منبع را نیز برقرار سازد: ``` python -m tgwitness.verify minimized-disclosure.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify minimized-disclosure.zip --fingerprint TRUSTED_SHA256 --evidence account-export.zip ``` ارتباط با منبع به‌طور مستقل اثبات نمی‌کند که تبدیل، هر مورد لازم را انتخاب یا هر جزئیات شناسایی‌کننده را حذف کرده باشد. متن اصلی به‌صورت مدرک ضمیمه نشده است. برای آن قضاوت، بازبینی تازه‌ای لازم است. ## اشتراک‌گذاری و ضبط میزبانی‌شده پیام‌ها و فایل‌های مورد نیاز دریافت‌کننده را انتخاب کنید، نسخهٔ کامل اشتراک‌گذاری را بازبینی کنید و منبع را به‌طور جداگانه نگهداری کنید. هش فایل‌های ZIP ارسال‌شده را ثبت کنید تا دریافت‌کننده بتواند آن نسخهٔ دقیق را شناسایی و تأیید کند. مستعارسازی، شناسه‌های منتخب را جایگزین می‌کند؛ متن و فایل‌های اصلی همچنان بخشی از بازبینی باقی می‌مانند. GitHub Actions از طریق Takeout یا API معمولی، از خروجی‌گیری کل حساب و چت‌های منتخب، و همچنین یک دفتر وقایع یک‌چت پشتیبانی می‌کند. [راهنمای ضبط میزبانی‌شده](https://phishdestroy.github.io/TgWitness/docs/capture/) تأیید تنظیمات و ... را توضیح می‌دهد. 120محدودیت - دقیقه‌ای. برای تأیید یک نسخه اشتراک‌گذاری‌شده مشتق‌شده از ضبط میزبانی‌شده، هش منبع آن را با آرشیو اصلی مطابقت دهید و تأییدیه آن آرشیو را با بررسی‌های مخصوص هر حالت تأیید کنید. [بررسی‌های ویژهٔ حالت](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope). [فرمت مدرک](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) · [گزارش‌های موردی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-reports/) --- # Telegram · فرمت مدرک Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/ محتویات فایل ZIP امضا شده، انواع سوابق، رسیدهای فرایند، پروفایل افراد، نسخه‌های خارج از محل و تأیید آفلاین. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) Translation coverage: this edition includes material from the English original. محتویات فایل ZIP امضا شده، انواع سوابق، رسیدهای فرایند، پروفایل افراد، نسخه‌های خارج از محل و تأیید آفلاین. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![شواهد و تأیید](https://phishdestroy.github.io/TgWitness/assets/chapter-evidence.svg) TgWitness مشاهدات تلگرام قابل مشاهده در حساب کاربری را در یک دفترچه ثبت امضا شده نگهداری می‌کند. دریافت‌کنندگان می‌توانند سوابق ذخیره شده، پیوست‌ها و گزارش‌ها را با یک کلید گردآورنده مورد اعتماد تأیید کنند، سپس دفترچه ثبت را با یک نقطه کنترل که به طور مستقل نگهداری شده است مقایسه نمایند. این صفحه فرمت‌ها، بررسی‌ها و موادی را که باید برای تحویل نگهداری شود، توصیف می‌کند. گیرندگان می‌توانند در ویندوز با **VERIFY.cmd** شروع کنند: این ابزار فایل ZIP اصلی و اثر انگشت کلید به‌دست‌آمده به‌طور مستقل را درخواست می‌کند، نتیجه را با توضیحات نمایش می‌دهد و یک متن پیاده‌سازی تأیید جداگانه را ذخیره می‌کند. برای [راه‌اندازهای تأیید و محیط اجرایی قابل حمل جهت تنظیم و محدودیت‌های اعتماد به آن](https://github.com/phishdestroy/TgWitness/blob/main/docs/VERIFICATION_LAUNCHER.md) مراجعه کنید. **در این صفحه** - [چه چیزی امضا شده است](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#what-is-signed) - [مقایسه خروجی‌های چت](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#comparing-chat-exports) - [واگذاری تحقیق](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#investigation-handoff) - [استخراج بخش تحویل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#handover-extract) - [گزارش‌های قابل‌خواندن](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#readable-reports) - [کانونی‌سازی رویداد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#event-canonicalization) - [سمانتیک بازیگر](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#actor-semantics) - [پوشش: پیوستگی، فواصل و شناسه‌های مشاهده‌نشده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids) - [تهیه‌کننده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#producer) - [پروفایل‌های افراد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#people-profiles) - [شاهد مستقل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#independent-witness) - [فهرست و نقاط کنترل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#manifest-and-checkpoints) - [دامنهٔ اعتبارسنجی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope) - [پیوست‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#attachments) - [دریافت رسیدهای پایدار برای جمع‌آوری و پردازش (0.2)](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#durable-collection-and-process-receipts-02) - [آماده‌سازی RFC 3161 و تأیید پاسخ (0.2)](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02) - [سوابق اختیاری در حالت شواهد: drand و دستگاه‌های تلگرام](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices) ## امضا شده چیست | مطالب | حفاظت | چه مواردی را باید حفظ کرد | | --- | --- | --- | | هر مشاهدهٔ دفترچه، از جمله رویدادهای عملیاتی | زنجیره SHA-256 و امضای Ed25519 برای هر رویداد | امضای اصلی `events.jsonl`، اثر انگشت کلید مورد اعتماد، و یک نقطه کنترل حفظ‌شده | | محتویات فایل ZIP شواهد | `manifest.sig` مانیفست کانونیکال را امضا می‌کند که هش فایل‌های محتوا را فهرست می‌کند | فایل فشردهٔ کامل، شامل مانیفست و امضا | | پیوست‌های نگهداری‌شده | SHA-256 و شمارش بایت در یک رویداد امضا‌شده با `media.saved`؛ هش فایل در مانیفست ZIP امضا‌شده | بایت‌های اصلی درون فایل ZIP تأییدشده | | نقطهٔ کنترل | امضای Ed25519 بر طول دفترچه، هش سر، کلید عمومی و زمان ایجاد | یک نسخهٔ مستقل که پیش از تغییر مورد مناقشه نگهداری شده است | | دریافت رسید | سوابق امضا شده نسخهٔ گردآورنده، هش‌های فایل منبع و تنظیمات اولیه، همچنین در `process.started` گنجانده شده است. | رسید، دفترچه یادداشت مرتبط و شواهد محیطی برای حالت تأیید انتخاب‌شده | | گزارش‌های قابل‌خواندن: `report.html` و اجزای آن، `report.json`، `report.pdf`، `chat.pdf` | یک مهر Ed25519 بر هر فایل بر روی محتوای آن؛ PDF همچنین دارای امضای استاندارد PDF است (رجوع کنید به [گزارش‌های قابل‌خواندن](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#readable-reports)) | فایل دریافت‌شده و اثر انگشت کلید مورد اعتماد؛ زیپی که آن را توصیف می‌کند | | مستقل CSV | امضای رمزنگاری مستقل وجود ندارد؛ هش‌های رویداد به‌تنهایی کافی نیستند | برای بررسی یکپارچگی، از متن دقیق داخل فایل ZIP تأییدشده استفاده کنید. | | اسکرین‌شات‌ها، خروجی‌های چاپی یا PDF تولیدشده توسط مرورگر | امضای TgWitness روی مشتق وجود ندارد | پکیج اصلی تأییدشده را حفظ کنید و نحوهٔ ساخت نسخهٔ مشتق را مستندسازی کنید | جمع‌آورنده پیش از تولید هر فرمت خروجی، امضاهای دفترچه را تأیید می‌کند. گزارش‌های قابل‌خواندن HTML و PDF دارای مهرهای مخصوص به خود هستند؛ CSV مستقل به عنوان بخشی از یک فایل ZIP امضا شده بررسی می‌شود. فایل ZIP را برای حفظ بایت‌های پیوست و منیفست نگه دارید، و یک نقطه کنترل جداگانه برای بررسی دفترچه در مقابل یک مرز قبلی ایجاد کنید. ## مقایسه خروجی‌های چت دو فایل ZIP خروجی چت امضا شده را با اثرانگشت‌های امضاکننده که به‌طور مستقل نگهداری شده‌اند، تأیید و مقایسه کنید: ``` python -m tgwitness.verify first.zip --compare second.zip \ --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256 ``` زمانی که هر دو آرشیو، شناسه پیام و حساب کاربری و چت یکسانی را ثبت می‌کنند، سوابق بر اساس شناسه پیام جفت می‌شوند. **بدون تغییر** به معنای برابری کل رکورد JSON ذخیره شده است: متن کامل، نویسنده، تاریخ‌ها، هدف پاسخ، متادیتای درونی و فیلدهای ناشناخته همگی گنجانده شده‌اند. ترتیب کلیدهای شیء JSON اهمیتی ندارد؛ اما فیلدهای غایب، مقادیر null، انواع مقادیر و ترتیب آرایه‌ها اهمیت دارند. پیش‌نمایش 300 کاراکتری فقط برای نمایش است. ورودی‌های تغییر یافته، فیلد سطح بالایی به نام `changed_fields` را نام‌گذاری می‌کنند، که شامل تغییراتی است که در آن پیش‌نمایش نامرئی هستند. در حین تطبیق، شناسه‌های پیام تکراری به جای اینکه روی یکدیگر بنویسند، رد می‌شوند. یک تفاوت می‌تواند یک نام نمایشی تغییر یافته، تعداد بازدید، حاشیه‌نویسی مجموعه یا سایر متاداده‌های مشاهده باشد. این به خودی خود یک ویرایش تلگرام را تأیید نمی‌کند، مشخص نمی‌کند چه کسی تغییری ایجاد کرده است، یا ثابت نمی‌کند کدام آرشیو متناقض دقیق است. رکوردهای تجزیه‌نشده در مقایسه باقی می‌مانند؛ برابری نمایه‌سازی شده‌ی ذخیره‌شده‌ی آن‌ها به معنای رمزگشایی شدن بار تلگرام آن‌ها نیست. برای هویت‌های حساب/چت متفاوت یا گم‌شده، این ابزار تنها با استفاده از فرستنده، متن کامل، هش فایل، نوع رسانه و تلرانس زمانی پنج ثانیه‌ای، تطابق‌های احتمالی را پیدا می‌کند. این ابزار **تطابق (Matched) را** گزارش می‌کند، نه **بدون تغییر (Unchanged)**. این کاندیداها هویت پیام یا برابری تمام متادیتا را اثبات نمی‌کنند. رکوردهای تجزیه‌نشده همچنان بدون تطابق باقی می‌مانند. تفاوت‌ها در رکوردهای جفت‌شده در خروجی `changed` فهرست می‌شوند، حتی در حالت محتوا؛ این تفاوت‌ها، ویرایش یک پیام واحد را ثابت نمی‌کنند. با استفاده از `--json`، `matched` تعداد جفت‌ها را می‌شمارد و `unchanged` تعداد جفت‌هایی را که رکوردهای کامل ذخیره‌شده‌شان برابر است، می‌شمارد. هیچ‌کدام از این شمارش‌ها، هویت پیام را در حالت محتوا ثابت نمی‌کنند. خروجی‌های موجود `changed_fields` و `unchanged` عددی با نتایج مقایسه قبلی سازگار باقی می‌مانند. فرمت آرشیو و تأیید امضا بدون تغییر باقی می‌مانند. ## واگذاری تحقیقات 1. مرجع پرونده، اپراتور، شناسه عددی حساب تلگرام، منابع انتخاب‌شده، سیاست جمع‌آوری و دوره جمع‌آوری را در یادداشت‌های پرونده خود ثبت کنید. TgWitness مشاهدات را حفظ می‌کند و از یادداشت‌ها و مجموعه‌های مرتبط با منبع در [Case Board](https://phishdestroy.github.io/TgWitness/fa/docs/reference/case-board/) پشتیبانی می‌کند. سوابق انتقال و تحویل را همراه با مدارک پرونده خود نگهداری کنید. تنظیمات جمع‌آوری مورد نظر را با [رویه پذیرش زنده](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md) بررسی کنید. 2. اثر انگشت کلید عمومی فضای کاری را به‌طور مستقل حفظ کنید پیش از آنکه به خروجی‌های آن اتکا کنید. نقاط کنترل امضا شده را در حین جمع‌آوری خارج از جمع‌کننده ذخیره کنید. وقفه‌ها و محدودیت‌های دیده‌شدن حساب را ثبت کنید. 3. یک فایل **ZIP امضا شده** صادر کنید و رسید اجرای امضا شده را نگه دارید. از یک نقطه کنترل در یا قبل از مرز روزنامه‌نگاری صادر شده استفاده کنید. یک نقطه کنترل بعدی می‌تواند به‌درستی یک خروجی قبلی را به‌دلیل کوتاه بودن بیش از حد رد کند. خروجی‌ها شامل کل روزنامه‌نگاری فضای کاری هستند، صرف‌نظر از فیلترهای پنل؛ پیش از اشتراک‌گذاری محتوا، آن را بررسی کنید. 4. از گیرنده بخواهید فایل ZIP را با یک نسخه مورد اعتماد از ابزار تأیید و اثر انگشت/نقطه کنترل ارائه‌شده به‌طور مستقل، اعتبارسنجی کند. از یک نصب مورد اعتماد که محیط پایتون آن فعال است: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --checkpoint retained-checkpoint.json ``` گزارش‌های خروجی موفق `key_pinned: true` و `checkpoint_checked: true` را زمانی که هر دو ورودی ارائه و پذیرفته شوند، صادر می‌کند. نتیجه تأیید را حفظ کنید. ``` For a handover requiring the final exported record to be witnessed, use `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`. This refuses an export with an unwitnessed tail. See the [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary). ``` 1. Record the archive's SHA-256, export boundary, transfer date, sender, and recipient in your custody record. Keep the original package intact and work from copies. Share evidence files rather than the application's private data directory, which also contains account sessions and signing secrets. For transfer, choose a password-protected AES-256 ZIP or the stronger `.tgwpw` container. ZIP uses WinZip's low-cost password derivation; use a long random passphrase. `.tgwpw` uses scrypt and AES-256-GCM and opens with the standalone verifier's `unseal-password` command. The password is not stored and only protects confidentiality; the recipient decrypts the archive and verifies the signed export inside, which is unchanged. 2. اگر لنگراندازی زمانی مستقل مورد نیاز است، [رویه RFC 3161](https://phishdestroy.github.io/TgWitness/fa/docs/reference/timestamp/) را دنبال کنید و درخواست، نقطه کنترل، اطلاعات CA مورد اعتماد و پاسخ مرجع تأییدشده را نگهداری کنید. صرفاً آماده کردن یک درخواست، مهر زمانی را به دست نمی‌دهد. For `.tgwpw`, use an independently obtained verifier and choose a new output file with the original extension: `python verify.py unseal-password export.tgwpw --out evidence.zip`. The command prompts for the password; `--password-stdin` reads one line for automation. It never overwrites an existing file and publishes plaintext only after all records authenticate. Run normal signature verification on the decrypted file afterwards. The container uses scrypt (`N=131072`, `r=8`, `p=1`, 16-byte salt; about 128 MiB RAM) and AES-256-GCM with 1 MiB records and an authenticated final record. An encrypted metadata record stores the inner filename, so downloaded containers can be renamed. تأیید موفقیت‌آمیز، یکپارچگی را نسبت به کلید گردآورنده مورد اعتماد و مرز حفظ‌شده برقرار می‌کند. برای مشاهده فرضیات اعتماد و [نتایج اعتبارسنجی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/) برای بررسی‌های انجام‌شده، به [«دامنه تأیید»](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope) مراجعه کنید. ## استخراج هاند‌اوور یک فایل ZIP امضا شده، کل مجلهٔ فضای کاری را در خود حمل می‌کند. هنگامی که دادگاه، وکیل یا میز رسیدگی به سوءاستفاده تنها به برخی چت‌ها، یک بازه زمانی یا افراد خاصی نیاز دارند، **گزینهٔ «صادرات → تحویل» (Exports → Handover)** یک نسخهٔ فشرده‌شده (`tgwitness-handover-v1`) را مطابق با قوانین افشای انتخاب‌شده آماده می‌کند. اپراتور هدف را اعلام می‌کند و چت‌ها، یک دوره اختیاری (UTC)، افرادی را که استخراج در مورد آن‌هاست، و اینکه با سایر افراد چه اتفاقی می‌افتد (نمایش داده شوند، با نام‌های مستعار P01 جایگزین شوند، P02… یا حذف شوند)، کدام متن‌های پیام باقی می‌مانند، کدام پیوست‌ها و عکس‌های پروفایل گنجانده می‌شوند، و اینکه آیا شماره‌های تلفن و آدرس‌های ایمیل در متن‌ها مخفی (ماسک) شوند. هدف و این قوانین در مانیفست امضا شده و در گزارش وجود دارند؛ مجله، `handover.exported` را با دسترسی‌ای که آن را آماده کرده و SHA-256 فایل را ثبت می‌کند، نه محتویات آن. پایگاه `verify.py` یک استخراج را به دو روش بررسی می‌کند. رکوردی که بدون تغییر نشان داده می‌شود، به طور کامل تأیید می‌شود: محتوای آن با هش، امضای Ed25519 و لینک آن به رکورد قبلی مربوطه تطبیق داده می‌شود. یک رکورد بهینه‌شده، هش و امضای اصلی را حفظ می‌کند، بنابراین امضا همچنان معتبر است، اما فیلدهای پنهان‌شده را نمی‌توان از آن بازحساب کرد؛ رکورد مشخص می‌کند چه چیزی پنهان شده است و گزارش آن را علامت‌گذاری می‌کند. مانیفست، طول ژورنال و سرآیند را با امضای گردآورنده در بالای آن سرآیند مشخص می‌کند، و رکوردهای حذف‌شده را می‌شمارد؛ فایل `coverage.json` چت‌های انتخاب‌شده را توصیف می‌کند. نام‌های داخل نام فایل‌ها شناسایی نمی‌شوند. پیش از اشتراک‌گذاری، فایل‌های نهایی را بازبینی کنید: متن آزاد، نام فایل‌ها و پیوست‌های منتخب همچنان می‌توانند افراد را شناسایی کنند. فایل ZIP امضا شده کامل را نگه دارید: فایل استخراج‌شده یک افشا است، نه جایگزین. ## گزارش‌های قابل‌خواندن شواهد امضا شده، فایل‌های ZIP تحویل و چت، گزارش‌های قابل خواندن HTML و JSON را همراه با PDF در صورت در دسترس بودن فونت‌های مورد نیاز، در زبان گزارش انتخابی، حمل می‌کنند. هر گزارش با کلید Ed25519 فضای کاری مهر و موم شده و می‌توان آن را به صورت جداگانه تأیید کرد: `python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]`. - `report.html` / `chat.html`: بیانیه مهر (`tgwitness-report-seal-v1`) فایل را می‌بندد و SHA-256 هر بایت قبل از آن را امضا می‌کند. ژورنال‌ها و چت‌های طولانی به بخش‌هایی با اندازه قابل پیکربندی تقسیم می‌شوند (تنظیمات گزارش، ۵۰۰ تا ۱۰۰٬۰۰۰ رکورد؛ به‌صورت پیش‌فرض ۵٬۰۰۰): `records/records-0001.html` یا `messages/messages-0001.html`، که هر کدام با شماره، بازه و مجموع خود مهر و موم شده و در منیفست امضا شده به همراه SHA-256 خود فهرست می‌شوند. سلسله‌ای از ضربان‌های قلب جمع‌کننده به صورت یک خط نمایش داده می‌شوند، مگر اینکه در تنظیمات گزارش به صورت جداگانه فهرست شده باشند. - `report.json` (`tgwitness-report-json-v1`، کلیدهای `format`، `report`، `seal`): مهر، SHA-256ِ JSONِ `report` را امضا می‌کند، بنابراین حقایق می‌توانند توسط سیستم‌های موردی و اسکریپت‌ها خوانده شوند و می‌توان از آن‌ها برای انتخابی جهت حفاظت از داده‌ها استفاده کرد، در حالی که فایل امضا شده دست‌نخورده باقی می‌ماند. - `report.pdf` / `chat.pdf`: یک سند رسمی برای چاپ و بایگانی، که دو بار بر روی همان بایت‌ها امضا شده است، کل فایل به جز مقدار امضا (`/ByteRange`). امضای استاندارد PDF (`adbe.pkcs7.detached`، CMS با SHA-256 و ECDSA P-256) از یک سند امضای خود صادر شده استفاده می‌کند گواهی که در گاوصندوق فضای کاری نگهداری می‌شود؛ شماره سریال سوژه آن اثر انگشت کلید Ed25519 است. مهر Ed25519 به عنوان ویژگی بدون امضا CMS در داخل `2.25.240684792623320047764573196045913242332` جابجا می‌شود و SHA-256 را با `"content": "pdf-byte-range"` نام‌گذاری می‌کند، بنابراین کلید Ed25519 ضامن اعتبار گواهی است. یک خواننده PDF نشان می‌دهد که آیا فایل پس از امضا تغییر کرده است یا خیر و تا زمانی که گواهی مورد اعتماد قرار نگیرد، امضاکننده را ناشناس می‌نامد؛ در عوض اثر انگشت Ed25519 را مقایسه کنید. فایل‌های PDF چینی، ژاپنی و کره‌ای به یک فونت روی سرور (یا در `TGWITNESS_FONT_DIR`) نیاز دارند؛ بدون آن، فایل ZIP فقط حاوی گزارش‌های HTML و JSON خواهد بود. در یک کانال یا ابرگروه، Telegram پیام‌های ۱، ۲، ۳ و ... را به ترتیب شماره‌گذاری می‌کند. یک خروجی چت، شماره‌های اول و آخر، تعداد کل پیام‌ها، هر سری از شماره‌های غایب در `message-ids.json` ، مانیفست و هدر `chat.json` را فهرست می‌کند و هر شکاف را در جایی که در متن گفتگو قرار دارد، علامت‌گذاری می‌کند. `verify.py` آنها را از `chat.json` شمارش می‌کند. یک شماره غایب، پیامی است که Telegram بازنگشت (پیش از خروجی‌گیری حذف شده یا برای حساب قابل مشاهده نبوده است)؛ در چت‌های خصوصی و گروه‌های پایه، شماره‌ها در تمام چت‌های یک حساب مشترک هستند و فاصله‌ها شمرده نمی‌شوند. پس از خواندن تاریخچه، خروجی برای هر شماره غایب، مجدداً بر اساس شماره (`channels.getMessages`، تا 10,000 شماره) از تلگرام درخواست می‌کند. نتیجه در `message-ids.json` و گزارش قرار دارد. یک پاسخ خالی ثبت می‌کند که شماره در زمان بررسی مجدد برای این حساب در دسترس نیست؛ این پاسخ علت را مشخص نمی‌کند. پیامی که در زمان بررسی مجدد بازگردانده می‌شود به خروجی اضافه شده و `found_on_recheck` علامت‌گذاری می‌شود. هر گزارش با **آغاز می‌شود. به اختصار**: یک پاراگراف، سپس آنچه که محتوا نشان می‌دهد و آنچه که نشان نمی‌دهد (چه کسی پشت یک حساب کاربری است، کامل بودن تحویل، حذف‌ها پیش از مشاهده، زمان ساعت بدون مهر زمانی). مهر و موم صفحه زمانی به رنگ کهربایی درمی‌آید که مرورگر امضای مهر و موم را بررسی کرده باشد، نه خود صفحه را: مرورگر بایت‌های یک صفحه را به آن اختصاص نمی‌دهد. این رنگ فقط زمانی به سبز تغییر می‌کند که خواننده فایل را در قسمت بررسی در انتهای صفحه قرار دهد و تمام بایت‌ها مطابقت داشته باشند، و تنها در صورتی که صفحه نمایش داده شده همان فایل باشد؛ در غیر این صورت به قرمز تغییر می‌کند. هر گزارش برنامه را دقیقاً نام می‌برد: commit گیت زمانی که گردآورنده از یک checkout اجرا می‌شود یا نصب‌کننده `TGWITNESS_COMMIT` را تنظیم می‌کند، و SHA-256 فایل‌های منبع آن (`source_tree_sha256`، JSON کانونیکال از path → SHA-256 هر `.py`، `.js`، `.css`، `.html` و `.svg` فایل در بسته)، که یک checkout از آن commit آن را بازتولید می‌کند مگر اینکه فایل‌ها تغییر کرده باشند). کلاینت Telegram با نام کتابخانه، لایه API و مرکز داده خود نامگذاری شده است. هنگامی که مشاهده شروع می‌شود و زمانی که خروجی چت آغاز و پایان می‌یابد، گردآورنده زمان را از Telegram می‌پرسد (`updates.getState`، ثانیه‌های کامل) و زمان Telegram منهای ساعت گردآورنده را به همراه عدم قطعیت ناشی از رفت و برگشت ثبت می‌کند؛ گزارش‌ها این اندازه‌گیری‌ها را تحت عنوان «زنجیره امانت» (Chain of custody) نشان می‌دهند. صادرات چت، علاوه بر تاریخ‌های پیام‌ها، زمان خواندن تاریخچه را نیز ثبت می‌کند. ### نمایشگر گزارش آفلاین و راهنمای بایگانی قبل از باز کردن `chat.html` یا `report.html`، فایل ZIP کامل را استخراج کنید. این ویوئر قابلیت جستجو، فیلترها، شرکت‌کنندگان، شاخص‌ها، جزئیات رکورد و گزینش‌های JSON/CSV را بدون نیاز به سرور فراهم می‌کند. فایل‌های `viewer/` و `media/` را در کنار گزارش نگه دارید. گزینش‌ها مشتق هستند: برای مقایسه آنها با آرشیو امضا شده، از `verify.py SELECTION.json --evidence ARCHIVE.zip` استفاده کنید. اعتبارسنج، شناسه گزارش، کلید امضا، مرز بایگانی و هر مورد انتخاب‌شده را بررسی می‌کند؛ موارد ویرایش‌شده، مفقود و تکراری ناموفق هستند. یادداشت‌های انتخاب و زمان ایجاد، متاداده‌های بدون امضا باقی می‌مانند. شکاف‌های شماره‌ی پیام‌ها تنها در جریان چت کامل، بدون فیلتر و صعودی نمایش داده می‌شوند. پنهان کردن یک دسته‌بندی یا عدم بارگذاری یک بلوک داده نباید یک سطر حذف‌شده را به مدرکی برای وجود پیامی که مفقود شده است تبدیل کند. برجسته‌سازی‌های جستجو روی متن ساده قبل از فرارگیری HTML اعمال می‌شوند و نشانه‌گذاری‌های تحت‌اللفظی را حفظ می‌کنند. این مرورگر امضاهای مانیفست، شناسه و کلید گزارش و تمام هش‌های فایل‌های فهرست‌شده را بررسی می‌کند. این ابزار ساختارهای ZIP مبهم یا ناقص، نام‌های تکراری و مسیرهای ناامن را رد می‌کند و فایل‌ها را به حداکثر ۲۵۶ مگابایت (MiB) و مجموع محتوای اعلام‌شده را به ۴ گیگابایت (GiB) محدود می‌نماید. برای آرشیوهای بزرگ‌تر از اعتبارسنج مستقل استفاده کنید. این بررسی مرورگر، بررسی‌های اعتبارسنج را که بر زنجیره‌های دفترچه خاطرات و معنایی داده‌ها انجام می‌دهد، تکمیل می‌کند. `README.txt` شامل یک راهنمای شروع، فهرست فایل‌ها، دستورالعمل‌های تأیید و یادداشت‌های قالب داده به زبان گزارش است و پس از آن یک راهنمای کامل انگلیسی قرار دارد. فایل `SHA256SUMS` شامل فایل‌های فهرست‌شده در خود، به استثنای خودِ آن، `manifest.json` و `manifest.sig` است؛ مانیفست امضا شده همچنین شامل `SHA256SUMS` می‌شود. فایل ZIP اصلی را دست‌نخورده نگه دارید و فایل‌های در حال کار را خارج از پوشه استخراج‌شده ذخیره کنید. گزارش‌های PDF شامل نشانک‌های بخش و شناسایی پرونده/گزارش در صفحات بعدی هستند. ### گفت‌وگو در زمان صدور صادرات یک چت، آنچه را که Telegram در مورد چت هنگام شروع صادرات گفته است، ثبت می‌کند: برچسب‌های خود Telegram (`scam`، `fake`، `restricted` با دلایل آن، `verified`)، نام‌های کاربری، توضیحات، تعداد اعضا و ادمین‌ها، بحث مرتبط، حفاظت از محتوا، اینکه آیا اعضای جدید پیام‌های قبلی را می‌بینند و از کدام پیام به بعد در این حساب تاریخچه قابل مشاهده است (`available_min_id`)، تاریخ پیام ۱ که همان تاریخ ایجاد چت است، و SHA-256 عکس چت (ذخیره شده در `media/`). این اطلاعات جایگاه حساب صادرکننده در چت را ثبت می‌کند: نقش، تاریخ پیوستن، اینکه چه کسی آن را دعوت کرده و برای یک ادمین، حقوق او. در عوض، درخواستی که Telegram رد می‌کند، نام‌گذاری می‌شود. وقتی حساب صادرکننده، ادمین باشد، خروجی، لاگ ادمین چت را (Telegram حدود ۴۸ ساعت نگه می‌دارد) در `admin-log.json` ثبت می‌کند: حذف‌ها و ویرایش‌ها به همراه محتوا و حسابی که اقدام کرده است. این تنها سوابق یک حذف است که نام حذف‌کننده را مشخص می‌کند. ### شاخص‌ها گزارش‌ها فهرست می‌کنند، و آرشیو شامل موارد زیر است که در پیام‌های ضبط‌شده، میز رسیدگی به تخلفات می‌تواند بر اساس آن‌ها اقدام کند: `indicators.csv` ، `indicators.stix.json` (STIX 2.1 ) و `indicators.misp.json` (رویداد MISP ): لینک‌ها و دامنه‌ها (که همچنین پشت متن، در دکمه‌ها و در پیش‌نمایش لینک‌ها پنهان شده‌اند)، آدرس‌های ارز دیجیتال، نام‌های کاربری و لینک‌های دعوت Telegram ، شماره‌های تلفن، آدرس‌های ایمیل و تصاویر ذخیره شده. آدرس‌های بیت‌کوین، لایت‌کوین، دوج‌کوین و ترون فقط زمانی فهرست می‌شوند که چک‌سام base58 آنها معتبر باشد، آدرس‌های سگ‌ویت زمانی که چک‌سام bech32 یا bech32m آنها معتبر باشد و آدرس‌های تون زمانی که CRC آنها معتبر باشد؛ آدرس‌های EVM و سولانا به عنوان بررسی‌نشده علامت‌گذاری می‌شوند. تصاویر دارای هش SHA-256 و هش دیداری (dHash، ۶۴ بیتی) هستند که در کپی‌های فشرده‌سازی یا تغییر اندازه مجدد شده، تقریباً بدون تغییر باقی می‌ماند. گزارش‌ها شاخص‌ها را طوری می‌نویسند که به طور تصادفی باز نشوند (`hxxps[://]example[.]com` )؛ فایل‌ها مقادیر را همان‌طور که بوده‌اند حفظ می‌کنند. هر شاخص به عنوان ناشناخته و نه برای تشخیص خودکار علامت‌گذاری شده است (STIX `indicator_types: unknown` , MISP `to_ids: false` ، توزیع در سازمان خود): قرار گرفتن در لیست به این معناست که پیامی حاوی آن بوده است، نه اینکه مخرب باشد. لینکی که متن آن آدرس متفاوتی را نسبت به آدرسی که با آن باز می‌شود نشان می‌دهد، در گزارش علامت‌گذاری می‌شود. گزارش‌های PDF با اظهاریه‌ای از بازرس برای امضای دستی، یک چک‌لیست برای دفتر اسناد رسمی یا کارشناس دادگاه، و یک کد QR (که در صفحه اول نیز وجود دارد) به پایان می‌رسند که حاوی شناسه گزارش، اثر انگشت کلید و SHA-256 داده‌های معتبر است، به طوری که یک نسخه چاپی به آرشیو مربوطه منتهی می‌شود. ## کانونی‌سازی رویداد ورودی هش دقیقاً شامل این فیلدها است: ``` seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash ``` سریال‌سازی با JSON سازگار با پایتون با UTF-8، کلیدهای شیء مرتب‌شده، بدون فرار ASCII، بدون فاصله‌های خالی بی‌اهمیت و بدون NaN/بی‌نهایت: ``` json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":"), allow_nan=False).encode("utf-8") ``` هَش رویداد از SHA-256 آن بایت‌ها به‌دست می‌آید. امضا، امضای Ed25519 بر روی ۳۲ بایت خام هَش است که سپس به کد base64 تبدیل می‌شود. اولین previous_hash شامل ۶۴ صفر است. اعداد توالی از ۱ شروع شده و به اندازه ۱ افزایش می‌یابند. تمام رویدادها، از جمله رویدادهای عملیاتی، یک زنجیره مشترک دارند. هیچ سرکوب ارسال تکراری وجود ندارد: مشاهدات مکرر رسیدهای متمایزی هستند، نه ادعایی مبنی بر اقدامات متمایز تلگرام. تاریخ‌های خام تلگرام رشته‌های ISO هستند؛ فیلدهای باینری به اشیایی حاوی bytes_base64 تبدیل می‌شوند. متن پیام، انتیت‌ها، توصیف‌کننده‌های رسانه، متادیتای پاسخ، واکنش‌ها و اقدامات سرویس، در صورت ارائه، در متادیتای خام پیام حفظ می‌شوند. observed_at ساعت دیواری UTC گردآورنده است. source_at تاریخ تلگرامی ارائه‌شده در صورت موجود بودن است. اعلان‌های حذف، زمان دقیق حذف را ارائه نمی‌دهند، بنابراین source_at نامشخص باقی می‌ماند. ترتیب دریافت در انتقال لزوماً با ترتیب رویداد منبع مطابقت ندارد. اسنپ‌شات‌های تاریخچه از تاریخ‌های منبع قدیمی‌تر اما زمان‌های مشاهده فعلی استفاده می‌کنند. ## سمانتیک بازیگر actor_id در message.new، فرستنده پیام است. message.edited ویرایشگر مشخصی ندارد؛ payload.sender_id فرستنده پیام مشاهده‌شده را ثبت می‌کند. حذف actor_id همچنان null باقی می‌ماند. پیام‌های سرویس عضویت، فرستنده و نوع اقدام را حفظ می‌کنند، بدون اینکه هر حذف را به یک ترک داوطلبانه تبدیل کنند. به‌روزرسانی‌های خام شرکت‌کننده، actor_id را همان‌طور که ارائه شده حفظ می‌کنند. اسنپ‌شات‌های واکنش، یک عامل تغییر را ابداع نمی‌کنند. اعلان‌های حذف برای چت‌های خصوصی و گروه‌های عادی فقط شامل شناسه پیام‌ها هستند. این چت‌ها یک توالی شناسه یکپارچه در سطح حساب را به اشتراک می‌گذارند، بنابراین یک شناسه، یک پیام واحد از این حساب را شناسایی می‌کند. زمانی که پیامی با آن شناسه قبلاً در این دفترچه ثبت شده باشد، حذف در آن چت به عنوان message.deleted با payload.chat_resolution به عنوان نام متد ثبت می‌شود. شناسه‌هایی که هرگز ذخیره نشده‌اند به صورت deletion.unscoped بدون chat_id نگه داشته می‌شوند؛ هیچ چیز حدس زده نمی‌شود. کانال‌ها و ابرگروه‌ها پیام‌ها را در هر چت شمارش می‌کنند و هرگز به این شکل مطابقت داده نمی‌شوند. هنگامی که پیام حذف‌شده توسط حساب مشاهده‌شده ارسال شده باشد، payload.deleted_message_was_outgoing مقدار true را دارد؛ اما هویت حذفی هنوز مشخص نمی‌شود. یک اطلاعیه بدون دامنه (unscoped notice) ثابت نمی‌کند که پیامی هرگز ذخیره نشده است: ممکن است یک گفتگوی مطابقت‌دار خارج از دامنه مشاهده فعلی باشد، یا یک تطابق منحصربه‌فرد در دسترس نباشد. عدم وجود دوباره بررسی‌شده (Recheck absence) همچنان یک مشاهده جداگانه از اعلان حذف در شمارش‌های گزارش، فیلترها و برچسب‌ها باقی می‌ماند. بازیابی بعدی، وضعیت فقدان فعلی را پاک می‌کند، در حالی که بررسی ناموفق قبلی را در تاریخچه امضا شده حفظ می‌کند؛ هیچ‌یک از این مشاهدات، اعلان حذف را ثابت نمی‌کنند. شناسههای متعدد که از یک اعلان به یک گفتگوی واحد منتهی می‌شوند، صرف‌نظر از تعدادشان، در قالب یک `deletion.batch` گروه‌بندی می‌شوند. این اعلان مشخص نمی‌کند که آیا کل تاریخچه پاک شده است، چه کسی این پاک‌سازی را انجام داده است، یا اینکه آیا این عمل شامل همه شرکت‌کنندگان بوده است یا خیر. پیام‌های ارسالی ذخیره شده این محدودیت‌ها را تغییر نمی‌دهند. ژورنال‌های قدیمی‌تر ممکن است حاوی رویدادهای `history.cleared` باشند که از دسته‌های ده یا چند آی‌دی استنتاج شده‌اند، با متن توضیحی که حذف را به شرکت‌کننده دیگر نسبت می‌دهد. این استنتاج‌ها توسط به‌روزرسانی پشتیبانی نمی‌شوند. آن سوابق امضا شده اصلی را حفظ کنید، اما آن‌ها را به عنوان اعلان‌های حذف گروهی در نظر بگیرید؛ رابط کاربری فعلی به همین ترتیب آن‌ها را برچسب‌گذاری می‌کند. ## پوشش: پیوستگی، فواصل و شناسه‌های نادیده هر فایل ZIP امضا شده حاوی `coverage.json` است، گزارش HTML با همان خلاصه باز می‌شود و `verify.py` آن را از روی `events.jsonl` بازحساب می‌کند به جای اینکه به فایل اعتماد کند: - **به‌طور مداوم از X تا Y مشاهده می‌شود.** یک دوره با `observation.started` آغاز می‌شود و در یک مکث، یک توقف، قطع اتصال تلگرام، خروج، شروع فرآیندی بدون توقف منظم، یا بیش از سه دقیقه بدون هیچ ثبت در حین مشاهده پایان می‌یابد (تپش‌های قلب هر دقیقه ثبت می‌شوند، بنابراین سکوت به معنای توقف فرآیند، یخ‌زدگی یا خواب رفتن کامپیوتر است). هنگامی که فاصله تپش قلب در **بخش پارامترها** تغییر کند، هر تپش آن را ثبت می‌کند و سکوت مجاز به سه بازه تبدیل می‌شود، که هرگز کمتر از سه دقیقه نخواهد بود. - **شکاف‌ها** زمان بین دوره‌ها را همراه با دلیل فهرست می‌کنند. شکافی که در آخرین ثبت هنوز باز است با `not_resumed_by_last_record` علامت‌گذاری می‌شود. - **شناسه پیام‌های مشاهده‌نشده.** برای کانال‌ها و ابرگروه‌ها، که پیام‌ها را به‌ازای هر چت شمارش می‌کنند، شناسه‌هایی که بین موارد مشاهده‌شده مفقود هستند به‌صورت بازه فهرست می‌شوند. آن‌ها به‌عنوان *مشاهده‌نشده* گزارش می‌شوند — حذف‌شده، هرگز تحویل‌داده‌نشده، یا خارج از تاریخچه ذخیره‌شده — هرگز به‌عنوان حذف‌شده. چت‌های خصوصی و گروه‌های عادی از یک توالی در سراسر حساب استفاده می‌کنند، بنابراین فواصل درون یکی از این چت‌ها معنایی ندارند و در آنجا فهرست نمی‌شوند. - اخطاریه‌های شکاف در سطح گفتگو (برای مثال درخواست تلگرام برای بازیابی تفاوت در یک کانال) به‌عنوان یادداشت محسوب می‌شوند؛ آن‌ها پوشش کلی را مختل نمی‌کنند. ### شماره‌های پیام‌های مفقود (`gap_summary`) **پیش‌نمایش.** `coverage.json` → `gap_summary` اعدادی را که تلگرام اختصاص داده و این گردآورنده هرگز ندیده است، اندازه‌گیری می‌کند. تلگرام پیام‌ها را یک‌بار در هر کانال یا ابرگروه، و یک‌بار در هر حساب کاربری در سراسر چت‌های خصوصی، ربات‌ها و گروه‌های عادی شماره‌گذاری می‌کند. عددی بین دو پیام مشاهده‌شده یا مشاهده شده یا مفقود است؛ یک بازه پیوسته، این گزاره مثبت را بیان می‌کند که هر پیام شماره‌گذاری‌شده در آن مشاهده شده است. یک شکاف، نه کنشگری را نام می‌برد و نه دلیلی را. | میدان | معنی | | --- | --- | | `status` | `on`، یا `off` وقتی در **پارامترها → تحلیل شکاف** غیرفعال شود | | `parameters` | پارامترهایی که نتیجه را تولید کرده‌اند، تا بتوان آن را تکرار کرد | | `chats[]` | برای هر کانال یا ابرگروه یک ورودی، که هر کدام به‌طور جداگانه شماره‌گذاری شده‌اند | | `account` | سلسلهٔ سراسری حساب شامل چت‌های خصوصی، ربات‌ها و گروه‌های عادی | | `status` (به ازای هر توالی) | `applicable`، یا `not_applicable` با `reason` | | `observed_from`, `observed_to`, `span` | اولین و آخرین شماره مشاهده‌شده و اندازهٔ بازه | | `observed`, `observed_without_content` | اعداد مشاهده‌شده؛ اعدادی که تنها از طریق سوابق حذف یا بازبینی مجدد شناخته می‌شوند | | `missing`, `density`, `gap_ranges`, `largest_gap` | اعدادی که هرگز مشاهده نشدند، سهم آن‌ها از بازه، تعداد اجراها، طولانی‌ترین اجرا | | `clusters[]` | شکاف‌های فهرست‌شده: `low`, `high`, `missing`، و اعداد مشاهده‌شده مجاور `after` / `before` به همراه زمان‌های مشاهدهٔ آن‌ها | | `service_estimate` | فقط زمانی که فعال باشد: چند شماره مفقود بر اساس سهم مشاهده‌شده‌شان به‌عنوان پیام‌های خدماتی محسوب می‌شوند. هرگز از `missing` | اعتبار از ژورنال استخراج می‌شود، هرگز فرض نمی‌شود: - **کانال‌ها و ابرگروه‌ها** به‌ازای هر چت اندازه‌گیری می‌شوند، همچنین در خروجی چت‌های منتخب. سوابق انتخاب‌شده توسط فرستنده اندازه‌گیری را انجام می‌دهند. `not_applicable`. - **سecuence در سطح کل حساب** فقط از اولین پیام تا آخرین پیامی که در حالی که جمع‌آوری کل حساب فعال بود دریافت شد، اندازه‌گیری می‌شود و چت‌های خصوصی، ربات‌ها، گروه‌های عادی و پیام‌های خود حساب را حفظ می‌کند، بدون اینکه هیچ چتی مستثنی شود (`scope.changed`). اعدادی که توسط `deletion.unscoped` به‌عنوان مشاهده‌شده بدون محتوا شمرده می‌شوند. خروجی‌گیری یا واگذاری چت‌های انتخابی نمی‌تواند آن را اندازه‌گیری کند. اگر جمع‌آوری کل حساب خاموش و سپس روشن شود، یادداشتی می‌گوید که اعدادی که در این فاصله استفاده شده‌اند، به‌صورت شکاف ظاهر می‌شوند. - پیام‌های سرویس، رکوردهای دفترچه یادداشت با شماره‌های اختصاصی خود هستند، بنابراین خودِ شکاف‌هایشان را می‌بندند؛ برآورد اختیاری تنها یک زمینه است. `verify.py` محاسبه مجدد `gap_summary` از `events.jsonl` با پارامترها در ژورنال امضا شده `coverage.json` member (پیش‌فرض برای آرشیوهای قدیمی‌تر) و خط مربوط به کل حساب را در خلاصه پوشش خود چاپ می‌کند. آرشیو `get_capture_status`(MCP و خط فرمان) همان اندازه‌گیری را برای گفتگوهایی که یک دسترسی می‌تواند بخواند بازمی‌گرداند؛ سecuence در سطح کل حساب فقط برای دسترسی‌ای که کل فضای کاری را پوشش می‌دهد. مشاهدات تکراری یک پیام خدماتی فقط یک بار شمرده می‌شوند و تخمین سرویس حساب فقط از اعدادی در محدوده اندازه‌گیری‌شده استفاده می‌کند. یک دامنه اعمال‌شده باید صراحتاً پیام‌های خودِ حساب را قبل از فعال شدن اندازه‌گیری در سطح کل حساب حفظ کند؛ رکوردهای قدیمی‌تر بدون این اطلاعات نمی‌توانند این شرط را برقرار کنند. متوقف کردن مشاهده، محدوده اندازه‌گیری‌شده را گسترش نمی‌دهد و از از سرگیری آن یادداشت می‌شود. پرس‌وجوی آرشیو زنده دارای یک بودجه زمانی است که شامل اسکن پایگاه داده آن نیز می‌شود و یک اندازه‌گیری ناتمام را به‌عنوان جزئی علامت‌گذاری می‌کند. تلگرام [توالی‌های جداگانه شناسه پیام](https://core.telegram.org/api/updates#message-id-sequences) را مستند می‌کند. این اعداد مشاهدات را توصیف می‌کنند؛ آنها عامل حذف را شناسایی نمی‌کنند یا مشخص نمی‌کنند که چرا عددی غایب است. زمانی که Telegram پذیرش حساب را متوقف می‌کند، رکورد `coverage.gap` که نظارت را پایان می‌دهد، حاوی `cause` (`account_banned`، `account_frozen`، `account_deleted`، `session_duplicated`، `session_revoked`، `session_expired`، `session_ended` یا `not_authorized`) و خطای Telegram است؛ `verify.py` علت پایان دوره را نام‌گذاری می‌کند. پوشش، دوره‌های مشاهده ثبت‌شده، وقفه‌ها و نتایج پیام‌ها را ترکیب می‌کند. آن را همراه با چت‌های انتخاب‌شده، دوره و سیاست پیوست ارزیابی کنید؛ عملکرد مداوم به تنهایی تحویل کامل به‌روزرسانی‌های تلگرام را تضمین نمی‌کند. ## تهیه‌کننده مفاد امضاشده ZIPهای شواهد، خروجی‌های چت، دفترچه‌های شاهدی و بیانیه فایل‌های پروفایل افراد حاوی `producer` هستند: نرم‌افزار، نسخه، پروژه (PhishDestroy)، صفحه اصلی و مخزن منبع. گزارش HTML همان خط را نشان می‌دهد، و `verify.py` آن را به عنوان بخشی از آنچه تأیید کرده است، چاپ می‌کند. آرشیوهایی که قبل از وجود این فیلد ایجاد شده‌اند، تأیید می‌کنند که قبلاً بوده و گزارش می‌شود که تولیدکننده‌ای را نام نبرده‌اند. هر رکورد `observation.started` همچنین نام کلاینت Telegram را که مشاهده کرده است، ذکر می‌کند: `api_id` آن (هرگز هش آن)، اینکه آیا این یک جفت عمومی داخلی است یا اپلیکیشن خود اپراتور، توضیحات کلاینت ارسال‌شده در درخواست اتصال Telegram، و نوع مسیر اتصال با حالت IP (بدون آدرس پروکسی یا رمز). گزارش و `custody.json`، هر کلاینت و مسیر متمایز را به همراه زمان ثبت آن‌ها، و زمان‌هایی که هیچ پروکسی فهرست‌شده پاسخ نداد و Telegram آدرس سرور را مشاهده کرد، فهرست می‌کنند. ژورنال‌های ثبت‌شده پیش از این نیز همین را نشان می‌دهند. ## پروفایل‌های افراد یک فایل پروفایل (`tgwitness-dossier-v1`، JSON) به درخواست از روی سوابق موجود در دفترچه خاطرات برای یک چت ساخته می‌شود؛ هیچ چیزی از تلگرام دریافت نمی‌شود و محتوای پروفایل هرگز در دفترچه خاطرات نوشته نمی‌شود (فعال و غیرفعال کردن پروفایل‌ها به عنوان `dossier.changed` ثبت می‌شود). برای هر شخص دارای پیام ذخیره شده، تاریخچه نام و نام کاربری، برچسب‌های تلگرام (ربات، کلاهبرداری، جعلی، پریمیوم، تأیید شده، محدود، حذف شده) همان‌طور که در زمان ذخیره مشاهده شده، پروفایل شناسه عکس‌ها، هش SHA-256 و هش بصری (pHash، سازگار با `imagehash.phash`) آواتار از کش آواتار محلی با آواتارهای مشابه، فعالیت (اولین و آخرین پیام، شمارش‌ها، اشتراک‌گذاری‌های ویرایش‌شده و حذف‌شده، پیام‌ها بر اساس ساعت UTC)، اینکه چه کسی به چه کسی پاسخ می‌دهد، چت‌های دیگر در این گزارش، جایی که آن شخص نوشته و از کیف‌پول‌ها (BTC، EVM، TRON، TON، LTC، DOGE، XMR، SOL؛ آدرس‌های Base58Check اعتبارسنجی شده‌اند) یاد کرده است، شماره‌های تلفن، نام‌های کاربری و لینک‌ها، از جمله لینک‌های پنهان‌شده پشت متن. هر واقعیت فهرست سوابق دفترچه (`seq`) را که از آن آمده است، ذکر می‌کند و `record_hashes` حاوی هش هر رکورد مرجع است. این بیانیه با کلید فضای کاری امضا شده است: ``` python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip ``` امضا را بررسی می‌کند، خودِ خروجی مدرک را (امضا، زنجیره هش و فایل‌ها) اعتبارسنجی می‌کند و اطمینان حاصل می‌کند که هر رکورد ارجاع‌داده‌شده در همان خروجیِ همان فضای کاری بدون تغییر وجود دارد. هش‌های آواتار برچسب «منبع از کش محلی» (نه رکوردهای دفترچه) را دارند. @ها تطبیق الگو هستند — سرنخی برای بررسی، نه حقایق تأییدشده. پروفایل‌ها به صورت جداگانه برای هر چت فعال می‌شوند، می‌توانند به صورت یک فایل فشرده ZIP با رمزگذاری AES-256 صادر شوند و هنگام غیرفعال شدن یا حذف چت از منابع، پاک می‌گردند. ## شاهد مستقل دفترچه یادداشت شاهد (`tgwitness-witness-v1`) و پست‌های کانال آن با خروجی مدرک با `verify.py --witness … --channel …` مطابقت داده می‌شوند؛ به [شاهد مستقل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/) مراجعه کنید. ## منشور و نقاط کنترل فایل manifest.json شامل فرمت، زمان خروجی، کلید عمومی، اثر انگشت، طول دفترچه، هش سر، دامنه، تولیدکننده، محدودیت‌ها و SHA-256 هر عضو محتوای دیگر به جز خود `manifest.json` و `manifest.sig` است. فایل manifest.sig امضای Ed25519 در قالب base64 بر روی JSON کانونیکال manifest است. اعتبارسنج، اعضای غیرمنتظره/غایب، نام‌های تکراری، فایل‌های خراب، توالی/زنجیره شکسته، امضاهای نامعتبر و عدم تطابق با نقطه کنترل ارائه‌شده را رد می‌کند. این هیچ‌گاه مسیرهای آرشیو را استخراج نمی‌کند. اندازه کل اعلام‌شده بدون فشرده‌سازی را به ۴ گیگابایت محدود می‌کند؛ `--max-gib N` آرشیوهای بزرگ‌تری را که با افزایش حد **پارامترها** ساخته شده‌اند، مجاز می‌داند. فرآیند تأیید را از نسخه نصب‌شده TgWitness یا یک نسخه بازبینی‌شده اجرا کنید. نسخه‌ای که در یک آرشیو گنجانده شده است، از استفاده قابل حمل پشتیبانی می‌کند؛ پیش از اجرای آن، این نسخه را با نصب مورد اعتماد خود مطابقت دهید. یک نقطهٔ کنترل بیانیه‌ای را امضا می‌کند که حاوی کلید عمومی، طول دفترچه خاطرات، هَشِ سرآیند و زمان ایجاد است. اعتبارسنج می‌تواند بررسی کند که یک آرشیو بعدی حاوی همان پیش‌وند است. نقطهٔ کنترل را خارج از گردآورنده حفظ کنید، تا اعتبارسنجی بعدی، آرشیو را با یک مرجع که به‌طور جداگانه نگهداری می‌شود، مقایسه کند. ## دامنهٔ اعتبارسنجی فرآیند تأیید، آرشیو و حالت جمع‌آوری به‌کاررفته برای تولید آن را بررسی می‌کند. حالتی را انتخاب کنید که مرز اعتمادش با مورد مطابقت داشته باشد، سپس ورودی‌های تأیید آن را حفظ کنید. | حالت جمع‌آوری | آنچه اعتبارسنج بررسی می‌کند | ورودی‌های اعتبارسنجی و مرز اعتماد | | --- | --- | --- | | فضای کاری محلی | امضاها، زنجیره هش، مانیفست و بایت‌های پیوست | اثر انگشت جمع‌آوری‌کننده به‌طور مستقل نگهداری می‌شود؛ مدیر میزبان کلید امضای محلی را کنترل می‌کند | | محیط کاری محلی با شاهد مستقل | آرشیو بررسی می‌کند و با پیش‌وند ژورنال قبلی که توسط شاهد حفظ شده است، تطابق را بررسی می‌کند | کلید و سوابق شاهد مورد اعتماد را جداگانه نگه دارید؛ نقطهٔ کنترل پیش‌وند مشاهده‌شده را متصل می‌کند | | [GitHub Actions ضبط می‌کند](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) | تأیید گیت‌هاب هش آرشیو، گردش کار تأییدشده و کامیت‌های گردآورنده، راनर میزبانی‌شده، منشأ جلسه/کلید جدید و یکپارچگی داخلی آرشیو | سیاست اعتبارسنج مورد اعتماد، مخزن تماس‌گیرنده و بسته گواهی‌نامه گیت‌هاب؛ مجموعه زیر جریان کاری ثابت‌شده اجرا می‌شود | | [استقرار ابری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/) | چرخهٔ عمر ارائه‌دهنده و سوابق دسترسی، وضعیت فایروال و Cloudflare، به‌علاوهٔ سوابق اجرای امضا‌شدهٔ گردآورنده | پرس‌وجوهای فقط-خوانی به ارائه‌دهنده و Cloudflare؛ در دسترس بودن بررسی‌های فردی به ارائه‌دهنده بستگی دارد | | [ماشین مجازی محرمانه Intel TDX](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) | نقل‌قول امضا و وضعیت پلتفرم، پیوند به بیانیه گردآورنده، ترکیب و اندازه‌گیری‌های سیستم‌عامل | زنجیره اعتماد اینتل و اندازه‌گیری‌های استقرار مورد انتظار؛ نتایج هر بررسی TDX الزامی را حفظ کنید | در اکتساب مهر و موم‌شده، گردآورنده تأییدشده داده‌ها را از طریق یک اتصال تلگرام احرازشده در داخل محیط تأییدشده دریافت می‌کند. گواهی، آرشیو را به آن اجرای خاص پیوند می‌دهد، بنابراین اعتبارسنجی هم اکتساب و هم یکپارچگی فایل در آینده را پوشش می‌دهد. این امر بر کد تأییدشده و زنجیره اعتماد پلتفرم که در بالا فهرست شده است، متکی است. اعتبارسنجی ضبط گیت‌هاب به یک جلسه ایجادشده در داخل اجرای برنامه نیاز دارد و ضبط‌های مبتنی بر جلسات واردشده را رد می‌کند. رسید اجرای برنامه، نسخهٔ گردآورنده، هش‌های فایل و تنظیمات راه‌اندازی را ثبت می‌کند. ریشه‌یابی گیت‌هاب و اندازه‌گیری‌های TDX بررسی‌های محیطی را فراهم می‌کنند؛ [رکورد اعتبارسنجی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/) پیکربندی‌های آزمایش‌شده را شناسایی می‌کند. TgWitness مشاهداتی را که جمع‌آوری می‌کند امضا می‌کند؛ تلگرام و نویسندگان پیام این امضاها را صادر نمی‌کنند. در یک فضای کاری محلی، مطالبی که قبل از اولین نقطه کنترل مستقل ایجاد شده‌اند همچنان به گردآورنده و دارنده کلید آن وابسته هستند. سوابق پوشش، دامنه انتخاب‌شده و نتایج جمع‌آوری را توصیف می‌کنند، در حالی که مهرهای زمانی خارجی تأییدشده، مرز بایگانی یا دفتر کل ثبت‌شده را در زمان تثبیت می‌کنند. ## پیوست‌ها فایل‌ها در پوشه media/ با استفاده از SHA-256 آدرس‌دهی می‌شوند. یک رویداد media.saved یک هش و طول بایت را به یک رویداد پیام خاص پیوند می‌دهد. نام‌های خام فایل‌ها متادیتا هستند و هرگز مسیرهای محلی نیستند. بایت‌های رسانه به‌صورت ناهمزمان دانلود می‌شوند، بنابراین حذف فوری ممکن است از ضبط آن‌ها جلوگیری کند. موارد غیرفعال‌سازی جمع‌آوری، فایل‌های بزرگ/با اندازه نامشخص، خطاهای دانلود و دانلودهای قطع‌شده به‌عنوان نتایج قابل مشاهده هستند. از کار افتادن یک فرآیند می‌تواند فایل‌های ناقص و ارجاع‌نشده‌ای را باقی بگذارد؛ این فایل‌ها در خروجی‌ها گنجانده نمی‌شوند. خروجی‌گیرنده ZIP، رسانه‌های ذخیره‌شده را با نام‌هایشان تطبیق می‌دهد. خروجی‌های JSONL، CSV و HTML امضاهای رویدادها را تأیید می‌کنند اما بایت‌های رسانه را منتقل نمی‌کنند. گزارش‌های مشتق شده صرفاً برای سهولت هستند؛ فایل events.jsonl، نمایش معتبر رویدادها است. خروجی کامل چت، پیوست‌ها را در تنظیمات پیوست فضای کاری، در پوشه media/ ذخیره می‌کند که با نام SHA-256 نام‌گذاری شده‌اند. هر رکورد پیام در chat.json، فایل خود را (`file`، `file_sha256`) یا دلیل عدم وجود آن را (`file_status`)، به همراه آنچه خواننده در اطراف متن دیده است، ثبت می‌کند: لینک‌های پشت متن، منبع فوروارد، دکمه‌های ربات، امضا، بازدیدها و تایمر حذف خودکار. `verify.py` بررسی می‌کند که هر فایل نام‌گذاری‌شده در منیفست امضا‌شده زیر آن هش وجود داشته باشد. ## جمع‌آوری پایدار و رسیدهای فرایند (۰.۲) یک جاب رسانه و رویداد پیام آن در یک تراکنش ثبت می‌شوند. این جاب، توصیف‌کننده اصلی پیام تلگرام (TL) را ذخیره می‌کند؛ مشاهده امضا شده، سیاست‌های SHA-256، حساب کاربری و اندازه آن را پیوند می‌دهد. بازیابی، پیش از دانلود، این پیوند را تأیید می‌کند. این جاب هرگز پیام فعلی را فراخوانی نمی‌کند و بی‌صدا یک پیوست جدیدتر را جایگزین آن می‌کند. جاب‌های متوقف‌شده دوباره امتحان می‌شوند، در حالی که شکست دائمی یک نتیجه صریح باقی می‌ماند. هر فضای کاری (workspace) دارای ژورنال (journal) و هویت امضای (signing identity) خود است. یک رویداد process.started شامل شناسه اجرا (run ID)، ساعت‌های محلی، نسخه‌های وابستگی، هش‌های فایل منبع، حساب/دامنه اولیه (initial account/scope)، و تنظیمات ضبط (capture settings) است. تپش‌های قلب (Heartbeats) شامل شناسه اجرا، زمان مونوتونیک (monotonic time) و وضعیت صف (queue state) هستند. رسید اجرای برنامه را می‌توان به صورت یک بیانیه با امضای جداگانه نیز دانلود کرد. برای تأیید اعتبار محیط اجرا، آن را با تأییدیه گیت‌هاب یا بررسی‌های TDX که در [دامنه تأیید اعتبار](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope) توضیح داده شده است، جفت کنید. نقاط کنترل خودکار به صورت محلی در هنگام راه‌اندازی، هر پنج دقیقه در حین مشاهده (**پارامترها → هر بار نقطه کنترل امضا شده**)، و در هنگام توقف منظم، حفظ می‌شوند. اعتبارسنجی راه‌اندازی و خروجی‌گیری، دفترچه را با آخرین نقطه کنترل محلی نگهداری‌شده مقایسه می‌کنند. این کار می‌تواند بازگشت پایگاه داده را زمانی که نقطه کنترل باقی مانده باشد، تشخیص دهد. نگهداری مستقل، آن مرجع را خارج از فضای کاری در دسترس نگه می‌دارد؛ یک نشان‌گر زمانی خارجی تأییدشده نیز به طور اضافی آن را در زمان ثابت می‌کند. پس از راه‌اندازی مجدد، موقعیت به‌روزرسانی ذخیره‌شده تلگرام از سر گرفته می‌شود (`catch_up_from` در `observation.started`) و به‌روزرسانی‌های از دست رفته درخواست می‌شوند. یک بازبینی دوره‌ای، `message.recovered` را برای پیام‌های از دست رفته و `message.missing_on_recheck` را زمانی که تلگرام دیگر یک پیام ذخیره‌شده را بازنمی‌گرداند، ثبت می‌کند؛ مورد دوم یک اطلاعیه حذف نیست و نه نام حذف‌کننده و نه زمان را مشخص نمی‌کند. ### نسخه‌برداری و بازیابی خارج از محل (S3) نسخهٔ خارج از محل (Exports، به‌صورت پیش‌فرض غیرفعال) بخش‌های مجله، فایل‌های نگهداری‌شده، نقاط کنترل با مهر زمانی و خروجی‌های چت تکمیل‌شده را به ذخیره‌سازی سازگار با S3 بارگذاری می‌کند، رمزگذاری‌شده با نسخهٔ خارج از محل (Exports، به طور پیش‌فرض غیرفعال) بخش‌های دفترچه، فایل‌های نگهداری‌شده، نقاط کنترل را به همراه مهرهای زمانی‌شان و خروجی‌های چت تکمیل‌شده را در یک فضای ذخیره‌سازی سازگار با S3 بارگذاری می‌کند، که پیش از بارگذاری با کلید نگه‌داری‌شده در گاوصندوق فضای کاری با استفاده از رمزگذاری 256-GCM AES رمزگذاری می‌شود؛ نگهداری Object Lock در صورتی اعمال می‌شود که باکت از آن پشتیبانی کند. بدون کلید دانلودشده، این نسخه قابل خواندن نیست. با `python -m tgwitness.replica restore --key-file KEY.json --out DIR` بازیابی و تأیید کنید. بازیابی به یک دایرکتوری معمولی و خالی نیاز دارد. فایل‌های دانلود شده و اشیاء رمزگشایی شده تا زمان تأیید کامل دفترچه یادداشت و هر نقطه کنترل نگهداری‌شده، در حافظه موقت خصوصی باقی می‌مانند. مسیرهای شیء ناامن، بازه‌های بخش ناسازگار و دفترچه‌های یادداشت کوتاه‌تر از یک نقطه کنترل رد می‌شوند؛ اعتبارسنجی ناموفق، هیچ‌یک از فایل‌های بازیابی‌شده را منتشر نمی‌کند. تأییدهای نگهداری، حالت و تاریخ Object Lock بازگشتی را با مهلت ارسال‌شده هنگام بارگذاری (با تلرانس گرد کردن یک ثانیه‌ای) مقایسه می‌کنند. مهلت منقضی‌شده، نامعتبر یا کوتاه‌تر از حد مجاز، تأییدشده محسوب نمی‌شود. وضعیت، شیء نمونه‌برداری‌شده‌ای را گزارش می‌دهد که نگهداری آن برای آن بارگذاری خاص خوانده شده است. نبود یا خرابی رسانه محلی به‌عنوان خطای مرحله گزارش می‌شود و مکان نمای رسانه را قبل از آن نگه می‌دارد، تا فایل در مرحله بعدی دوباره امتحان شود؛ فایل‌ها، نقاط کنترل و خروجی‌های بعد از آن همچنان کپی می‌شوند. عملیات بازیابی، تمام ارجاعات به رسانه‌های نگهداری‌شده را با هش‌های رمزگشایی‌شده و اندازه‌های ثبت‌شده مطابقت می‌دهد. بخش‌های مجله‌ای یکسان و همپوشان از بارگذاری‌های قطع‌شده یکپارچه‌سازی (deduplication) می‌شوند؛ همپوشانی‌های متضاد رد می‌شوند. نقاط کنترل ایجادشده در حین بارگذاری، تا زمانی که سوابق مجله‌ای مربوط به آن‌ها کپی نشده‌اند، به تعویق می‌افتند، بنابراین یک چرخه کامل‌شده، هیچ نقطه‌کنترلی را جلوتر از مجله‌اش منتشر نمی‌کند. ### اسنپ‌شات‌های خروجی استریم صادرات جریانی از یک اسنپ‌شات خواندن پایدار SQLite استفاده می‌کند. ممکن است سر آن هنگام تکمیل دانلود، قدیمی‌تر از ژورنال زندهٔ فعلی باشد. یک نقطه‌کنترل که پس از آن اسنپ‌شات ایجاد می‌شود، می‌تواند به درستی گزارش دهد که آرشیو کوتاه‌تر است؛ آن را با یک نقطه‌کنترل در یا قبل از پیش‌وند صادر شده مقایسه کنید، نه یک نقطه‌کنترل دلخواه بعدی. ## آماده‌سازی RFC 3161 و تأیید پاسخ (۰.۲) حالت مدرک (به طور پیش‌فرض غیرفعال) تنها هش SHA-256 هر نقطه کنترل امضا شده را از طریق مسیر فضای کاری و هرگز از طریق MTProxy، به مراجع RFC 3161 و تقویم‌های OpenTimestamps فهرست‌شده ارسال می‌کند. پاسخ‌ها در `checkpoints/anchors/` نگهداری، صادر و توسط `verify.py` بررسی می‌شوند (`--tsa-ca` امضای TSA را بررسی می‌کند؛ اثبات‌های OpenTimestamps را با `ots upgrade` و `ots verify` تأیید کنید). پنل یک آرشیو درخواست آماده می‌کند که حاوی بایت‌های کانونیکال checkpoint.json، یک اثر انگشت پیام SHA-256 و یک نانس تصادفی در timestamp.tsq، چک‌سام‌ها و دستورالعمل‌ها است. هیچ درخواست شبکه‌ای انجام نمی‌شود. آماده‌سازی یک مهر زمانی معتبر نیست. `python -m tgwitness.anchor verify` دو بار ts را در OpenSSL فراخوانی می‌کند: یک بار برای بررسی بایت‌های نقطه‌کنترل و یک بار دیگر برای بررسی درخواست اصلی. یک فایل CA مورد اعتماد به صراحت مورد نیاز است؛ گواهی‌نامه‌های ضمیمه‌شده به طور خودکار مورد اعتماد قرار نمی‌گیرند. بررسی درخواست در CLI اختیاری است، بنابراین برای بررسی نانسی (nonce) باید --request را نگه دارید و ارائه دهید. نتیجه بیان می‌کند که آیا بررسی شده است یا خیر. امضای نقطه کنترل جمع‌آورنده و دفترچه همچنان باید به طور جداگانه با اثر انگشت جمع‌آورنده مورد اعتماد، تأیید شوند. فرآیند تأیید، امضای پاسخ، بایت‌های نقطه کنترل و در صورت ارائه، درخواست اصلی را تحت اعتماد CA مشخص‌شده بررسی می‌کند. بررسی‌های لغو و اعتبارسنجی بایگانی بلندمدت پس از انقضای گواهی‌نامه، خارج از محدوده اعتبارسنج فعلی است. [رویه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/timestamp/) و [نتایج اعتبارسنجی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/) را مشاهده کنید. ## سوابق اختیاری در حالت شواهد: دستگاه‌های drand و Telegram دو رکورد دیگر می‌توانند روی همان پاس‌های مهر و زمان اجرا شوند. هر دو به‌طور پیش‌فرض غیرفعال هستند و تنها زمانی که حالت شواهد روشن است، فعال می‌شوند: اضافی‌ها → شواهد و پشتیبان‌ها → **شاهدان بیشتر · اختیاری**، یا `"drand": true` و `"devices": true` در `POST /api/evidence`یکی از آن‌ها مانع دیگری یا مهرهای زمانی نمی‌شود؛ پنل آخرین نتیجه هر یک را زیر فرم نشان می‌دهد. **drand** (`beacon.drand` ). هر بار عبور، جدیدترین دور از drand quicknet، یعنی تصادفی‌سازی عمومی League of Entropy (هر دور ۳ ثانیه)، را در مجله ثبت می‌کند: `chain` ، `round` ، `randomness` ، `signature` ، `round_time` و `relay` که پاسخ داده است. یک دور تأییدشده و غیرقابل‌پیش‌بینی، یک مرجع زمانی پایین‌تر برای محتوای پیوندداده‌شده با هش بعدی فراهم می‌کند. یک مهر زمانی تأییدشده در یک نقطه کنترل بعدی، یک مرجع زمانی بالا را فراهم می‌کند. این بررسی‌ها، محتوای پیوندداده‌شده را محدود می‌کنند؛ پوشش جمع‌آوری به طور جداگانه ارزیابی می‌شود. گردآورنده ابتدا از `drand.cloudflare.com` می‌پرسد، سپس از رله‌های Protocol Labs، از طریق مسیر فضای کاری، هر بار یک درخواست. `verify.py` بررسی می‌کند که هر تصادفی بودن، SHA-256 امضای آن است و زمان دور صحیح است، و دورها، طولانی‌ترین بازه بدون یک دور و اینکه ساعت جمع‌آورنده چقدر از drand عقب بوده را گزارش می‌دهد. این امضای BLS را بررسی نمی‌کند. `--check-drand` دورها را با یک رله Cloudflare و یک رله Protocol Labs مقایسه می‌کند، همگی آن‌ها یا یک نمونه تصادفی ۱۰۰ تایی در یک ژورنال طولانی؛ دوری که متفاوت باشد، اعتبارسنجی را رد می‌کند. **دستگاه‌های تلگرام** (`account.devices`). هر بار عبور، جلسات حساب را با `account.getAuthorizations`، فهرستی که تلگرام در تنظیمات → دستگاه‌ها نشان می‌دهد را می‌خواند و ثبت می‌کند: در صورت تغییر از بار قبلی، به‌طور کامل، با `added` و `removed` هش‌های جلسه، در غیر این صورت فقط شمارش و SHA-256 آن. مدل دستگاه، پلتفرم، برنامه و نسخه، زمان ایجاد و آخرین فعالیت، کشور و منطقه حفظ می‌شوند؛ آدرس‌های IP حفظ نمی‌شوند، زیرا خروجی‌های شواهد از کنترل شما خارج می‌شوند. سشن خود گردآورنده همیشه فعال است، بنابراین فقط فعالیت سشن‌های دیگر به عنوان تغییر در نظر گرفته می‌شود. `verify.py` گزارش می‌دهد که لیست هر چند وقت یک‌بار ثبت شده و هر جلسه جدید و خاتمه‌یافته. این لیست فقط زمانی خوانده می‌شود که نظارت در حال اجرا باشد. آنها چه چیزی را نشان نمی‌دهند: drand چیزی بیش از ترتیب سوابق در برابر زمان عمومی را اثبات نمی‌کند، و فهرست دستگاه‌ها بیانیهٔ Telegram است که از طریق گردآورنده صادر شده و مانند هر سابقهٔ دیگری توسط گردآورنده امضا شده است. **لاگ Cloudflare Gateway** (`cloudflare.gateway_dns`). برای سروری که از طریق Cloudflare Gateway ([DNS Gateway](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#cloudflare-as-an-outside-witness)) حل‌نشانی می‌کند، هر بار کپی، آنچه را که Gateway از زمان کپی قبلی ثبت کرده است، کپی می‌کند: یک رکورد برای هر بازه زمانی حداکثر سه ساعته با `from`, `until`، سرور `location_id`، سرور `address` زمانی که یکی تنظیم شده باشد، و `queries` به عنوان `[at, name, type, rcode, decision, colo]`، همچنین زمانی که هیچ‌کدام وجود نداشته است. آن را در زیر **گزارش‌گیر Cloudflare Gateway** تنظیم کنید: حساب کاربری، مکان، آدرس اختیاری و یک توکن فقط-خواندنی (خواندن تحلیل‌های حساب کاربری؛ خواندن PII اعتماد صفر برای حفظ یک آدرس از یک مکان مشترک). این پنل قبل از ذخیره، آنها را با یک درخواست بررسی می‌کند؛ توکن رمزگذاری‌شده باقی می‌ماند و هرگز وارد گزارش‌ها نمی‌شود. `verify.py` فهرست پنجره‌ها، نام‌های بیشترین جستجو و هر زمانی که هیچ کپی‌ای پوشش نمی‌دهد را فهرست می‌کند؛ رکوردی که تعدادش با پرس‌وجوهایش مطابقت ندارد، ناموفق است. پنجره‌ای که در یک ثانیه بیش از یک صفحه از پرس‌وجوها را در خود جای دهد، آن صفحه را نگه می‌دارد و می‌گوید بقیه مفقود است. کپی پاسخ کلودفلر از طریق گردآورنده، که توسط گردآورنده امضا شده است؛ ظرف ۲۴ ساعت هر کسی که توکن فقط-خواندن داشته باشد می‌تواند آن را با کلودفلر مقایسه کند. --- # Telegram · شاهد مستقل Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/ یک ویژنس را با کلید و بات اختصاصی خود اجرا کنید، نقاط کنترل امضا شده را در یک کانال منتشر کنید و خروجی‌ها را با آن مطابقت دهید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) یک ویژنس را با کلید و بات اختصاصی خود اجرا کنید، نقاط کنترل امضا شده را در یک کانال منتشر کنید و خروجی‌ها را با آن مطابقت دهید. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [شواهد و تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) ![شواهد و تأیید](https://phishdestroy.github.io/TgWitness/assets/chapter-evidence.svg) [صادرات و تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) · [اطمینان بالا](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/) · [راهنمای پنل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/#extras) شاهد، نقاط کنترل امضا شده را به طور جداگانه‌ای از گردآورنده نگهداری می‌کند. این ابزار امضای گردآورنده و پیوستگی دفترچه خاطرات را بررسی می‌کند، نتیجه را با کلید خود امضا می‌کند و آن را در یک کانال تلگرام منتشر می‌نماید. آن را روی یک سرور جداگانه با دسترسی فقط-خواندنی به نقطه پایانی شاهدِ گردآورنده اجرا کنید. نمودار جریان · جمع‌آور → شاهد (نقطهٔ کنترل امضا شده: تعداد رکوردها + هش سرآیند); شاهد → دفترچه شواهد، کلید شخصی; شاهد → کانال تلگرام (ارسال امضا شده از طریق ربات اختصاصی خود); فایل فشرده شواهد → verify.py; دفترچه شواهد، کلید شخصی → verify.py; کانال تلگرام → verify.py (صادرات تلگرام دسکتاپ یا صفحهٔ t.me/s) · جمع‌آور · شاهد · دفترچه شواهد، کلید شخصی · کانال تلگرام · فایل فشرده شواهد · verify.py · نقطهٔ کنترل امضا شده: تعداد · رکوردها + هش سرآیند · ارسال امضا شده از طریق ربات · اختصاصی خود · صادرات تلگرام دسکتاپ یا · صفحهٔ t.me/s **نمودار به صورت متن** 1. جمع‌آور → شاهد (نقطهٔ کنترل امضا شده: تعداد رکوردها + هش سرآیند) 2. شاهد → دفترچه شواهد، کلید شخصی 3. شاهد → کانال تلگرام (ارسال امضا شده از طریق ربات اختصاصی خود) 4. فایل فشرده شواهد → verify.py 5. دفترچه شواهد، کلید شخصی → verify.py 6. کانال تلگرام → verify.py (صادرات تلگرام دسکتاپ یا صفحهٔ t.me/s) **در این صفحه** - [آنچه شاهد دریافت می‌کند و آنچه دریافت نمی‌کند](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/#what-the-witness-gets-and-what-it-does-not) - [آنچه بررسی و ثبت می‌کند](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/#what-it-checks-and-records) - [اجرای یک شاهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/#run-a-witness) - [صفحه اثبات عمومی برای چندین فضای کاری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/#public-proof-page-for-several-workspaces) - [تأیید کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/#verify) ## آنچه ویجت دریافت می‌کند و آنچه دریافت نمی‌کند | شاهد دارد | شاهد هرگز نداشته است | | --- | --- | | **توکن شاهد** فقط-خواندنی برای یک فضای کاری | اطلاعات جلسه تلگرام یا اعتبارنامه‌های API گردآورنده | | کلید Ed25519 اختصاصی و دفترچهٔ خود | گنجینهٔ گردآورنده، کلید امضا یا توکن پنل | | توکن ربات تلگرام خود | محتوای پیام: سرآیند شامل تعداد رکوردها و یک هش است | توکن در **«افزونه ← شاهد مستقل**» ایجاد می‌شود، یک‌بار نمایش داده می‌شود و فقط به صورت یک تصویر ( SHA-256) ذخیره می‌گردد. این توکن دقیقاً یک نقطه پایانی (endpoint) را باز می‌کند، `GET /api/witness/head`، که یک نقطه کنترل تازه امضا شده به علاوه شمارشگرهای مجموعه بدون محتوا که امضا شده‌اند و وضعیت عملیاتی را بازمی‌گرداند. این توکن نمی‌تواند پنل را باز کند، محتوای پیام را بخواند یا تنظیمات را تغییر دهد، و توکن پنل در آنجا پذیرفته نمی‌شود. توکن را در همان صفحه لغو کنید. گردآورنده ثبت می‌کند که یک کلید شاهد جدید چه زمانی شروع به بررسی می‌کند (`witness.seen`) و آخرین بررسی را برای هر توکن نشان می‌دهد؛ شاهدی که در عرض ۲.۵ بازه بررسی نکرده باشد، به عنوان «دیر شده» (overdue) علامت‌گذاری می‌شود. شاهدان جدید در هر نظرسنجی یک چالش تصادفی ارسال می‌کنند؛ عبارت ضبط، آن را زیر امضای گردآورنده منعکس می‌کند. شمارنده‌ها به نقطه کنترل دقیق متصل هستند و در پست‌های امضا شده شاهد گنجانده می‌شوند. هدرهای قدیمی همچنان توسط شاهد مستقل پذیرفته می‌شوند. رشد مجله به تنهایی هرگز به عنوان یک پیام جدید شمرده نمی‌شود. ## آنچه بررسی و ثبت می‌کند در هر بازه زمانی (به طور پیش‌فرض ۱۰ دقیقه) شاهد: 1. خودِ سر را بازیابی می‌کند (جمع‌کننده نمی‌تواند آن را جابجا کند یا از آن بگذرد)؛ 2. امضای گردآورنده، کلید ثابت‌شده گردآورنده (`--collector-fingerprint`، یا اولین کلید مشاهده‌شده)، یک شمارش غیرکاهشی و یک سر که در شمارش ثابت‌شده تغییر نکرده است را تأیید می‌کند. اثبات‌های گنجاندن و سازگاری مرکل تأیید می‌کنند که یک دفترچه خاطرات رو به رشد، نقطه کنترل نگهداری‌شده را گسترش می‌دهد. پس از استفاده از اثبات‌های پیوستگی، حذف آن‌ها رد می‌شود؛ 3. یک رکورد امضا شده را به ژورنال خود ضمیمه می‌کند: `witness.anchor` با وضعیت `ok`، `key_changed`، `rollback` (رکوردهای کمتر از قبل)، `fork` (طول یکسان، هدر متفاوت) یا `invalid` (پاسخ در اعتبارسنجی شکست خورد)، یا `witness.no_response` وقتی گردآورنده پاسخ نداد؛ 4. نتیجه را در حالی که شاهد در حال اجرا است و می‌تواند به API ربات دسترسی داشته باشد، امضا شده و همراه با «بدون پاسخ» در کانال ارسال می‌کند. شناسه پست ثبت می‌شود (`witness.posted`)، یک پست ناموفق نیز (`witness.post_failed`). یک پست به این شکل است؛ خط آخر حاوی بیانیهٔ امضا شده است: ``` TgWitness witness #42 · journal head Collector 3fa9c2d1e0b4a7f6: 18234 records Head 9b1f…c07e 2026-10-28T19:40:00.123+00:00 TGW1.eyJhdCI6…. ``` ## اجرای یک شاهد شما به یک ربات تلگرام (با استفاده از @BotFather یکی بسازید)، یک کانال که آن ربات در آن مدیر است، و آدرس کلکسیونر که از طریق شاهد قابل دسترسی باشد — از طریق HTTPS خارج از شبکه خصوصی (به پروفایل HTTPS در [بخش استقرار](https://phishdestroy.github.io/TgWitness/fa/docs/reference/deployment/) مراجعه کنید) نیاز دارید. در پنل، **Extras → Independent witness → Configure را** باز کنید. سه مرحله دسترسی فقط-خواندنی، کانال و فاصله زمانی شما را پوشش می‌دهد، سپس شاهد را راه‌اندازی می‌کند. سیاست انتشار، پروکسی اختیاری HTTP/SOCKS5 و آدرس Bot API سفارشی در زیر **تنظیمات پیشرفته** قرار دارند. فرم دانلود می‌شود `witness.json` با سنجاق کردن کلید جمع‌آوری این فضای کاری. توکن فقط-خوانی تازه‌ساخته را با **«ذخیره فایل دسترسی** به عنوان» دانلود کنید `witness-token.txt`؛ آن را و یک `bot-token.txt`در کنار آن JSON قرار دهید. کالکتور هرگز توکن بات را دریافت نمی‌کند. دانلود، سرویس را راه‌اندازی یا پیامی را منتشر نمی‌کند. هیچ شاهد پروژه میزبان به طور ضمنی ثبت نمی‌شود. ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json python -m tgwitness.witness fingerprint --config witness.json ``` اولین دستور، فایل‌های پیکربندی و مخفی را بدون درخواست‌های شبکه‌ای یا ایجاد کلید بررسی می‌کند. مسیرها در JSON نسبت به آن فایل هستند؛ مسیرهای CLI/محیط نسبت به دایرکتوری کاری هستند. اثر انگشت شاهد را خارج از میزبان آن حفظ کنید. نشانگر آخرین پرس‌وجوی گردآورنده تنها یک درخواست را تأیید می‌کند؛ انتشار توسط Proof گزارش می‌شود یا در دفترچه یادداشت شاهد و کانال بررسی می‌شود. اگر پنل پشت یک تونل SSH قرار دارد، فقط endpoint محدودشده witness را با [این مثال Caddy](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.witness.example) روی یک نام میزبان HTTPS جداگانه در دسترس قرار دهید. فضای کاری پیش‌فرض سپس از `https://witness.example.org` استفاده می‌کند، فضاهای کاری دیگر از `https://witness.example.org/profiles/ID` استفاده می‌کنند. توکن‌ها همچنان لازم هستند؛ پنل و مسیرهای API دیگر آن توسط آن میزبان مجازی فوروارد نمی‌شوند. برای نقاط کنترل منتشرشده به‌طور منظم، `all` را انتخاب کنید. فاصله زمانی پنج دقیقه به معنای حدود ۲۸۸ پست در روز برای هر فضای کاری است. `changes`/`problems` عمداً برخی از بررسی‌ها را منتشر نمی‌کنند. MTProxy برای کلاینت تلگرام گردآورنده است. پینگ HTTP ویटनेس و API بات تلگرام از مسیر مستقیم/HTTP/SOCKS5 خود ([API بات](https://core.telegram.org/bots/api)) استفاده می‌کنند. **در کنار جمع‌آورنده، با Docker** (همان میزبان — فرآیند و کلید مستقل، اما اپراتور یکسان): مقادیر را در `.env` قرار دهید و پروفایل را راه‌اندازی کنید. ``` TGWITNESS_WITNESS_TOKEN=tgww_... TGWITNESS_WITNESS_BOT_TOKEN=123456:ABC... TGWITNESS_WITNESS_CHANNEL=@your_witness_channel # another workspace: TGWITNESS_WITNESS_COLLECTOR=http://tgwitness:8787/profiles/ docker compose --profile witness up -d docker compose logs witness # prints the witness key fingerprint ``` برای استفاده از تصویر منتشرشده از `docker compose --project-directory . -f deploy/compose/compose.image.yaml --profile witness up -d` استفاده کنید. **روی سرور شخص دیگری** (یک شاهد مستقل واقعی): مخزن را آنجا کپی کنید، `TGWITNESS_WITNESS_COLLECTOR=https://your-collector.example.org` به علاوه سه مقدار بالا را در `.env` تنظیم کنید، سپس ``` docker compose --project-directory . -f deploy/compose/compose.witness.yaml up -d ``` یا بدون داکر: ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --bot-token-file bot-token.txt --channel @your_witness_channel ``` ### انتشار به دیسکورد شاهد می‌تواند به جای تلگرام، در یک کانال دیسکورد پست کند. در دیسکورد، **Edit Channel → Integrations → Webhooks را** باز کنید، یک وب‌هوک ایجاد کرده و URL آن را کپی کنید. در پنل، در مرحله ۲، **Discord webhook · your channel** را انتخاب کنید. روی هاست شاهد، URL را با نام `discord-webhook.txt` در کنار `witness.json`؛ این هرگز به جمع‌آوری‌کننده نمی‌رسد. ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --discord-webhook-file discord-webhook.txt ``` یک شاهد یک ناشر دارد: یک کانال تلگرام یا یک وب‌هوک دیسکورد، نه هر دو. پست‌ها حاوی همان بیانیه امضا شده هستند و نمی‌توانند به هیچ‌کس پینگ ارسال کنند. پستی که طولانی‌تر از ۲۰۰۰ کاراکتر دیسکورد باشد، با یک خط کوتاه جایگزین می‌شود که چک کامل به آن پیوست شده است. `witness-check.txt`. هر شناسه پست به صورت ثبت می‌شود. `witness.posted`. `verify.py --channel`فقط خروجی‌های کانال تلگرام را می‌خواند، بنابراین برای دیسکورد دفترچه شاهد را نگه دارید: این دفترچه حاوی تمام چک‌ها است. ### گزینه‌ها | گزینه | محیط | پیش‌فرض | معنی | | --- | --- | --- | --- | | `--interval` | `TGWITNESS_WITNESS_INTERVAL` | 10 | دقایق بین بررسی‌ها، ۱–۱۴۴۰ | | `--timeout` | `_TIMEOUT` | 30 | ثانیه‌ها برای انتظار تا شروع کار جمع‌آورنده و API ربات: ۵۰۰–۶۰۰ | | `--post` | `_POST` | `all` | `all`: هر چک؛ `changes`: یک رئیس جدید یا یک مشکل؛ `problems`: فقط مشکلات و پاسخ‌های گمشده | | `--title` | `_TITLE` | `TgWitness witness` | اولین کلمات هر پست کانال | | `--collector-fingerprint` | `_COLLECTOR_FINGERPRINT` | – | کلید جمع‌آوری را پین کنید به‌جای اعتماد به اولین پاسخ | | `--proxy` | `_PROXY` | مستقیم | `socks5://host:port` یا `http://host:port` | | `--bot-api` | `_BOT_API` | `https://api.telegram.org` | آدرس API ربات، مثلاً یک سرور محلی API ربات | | `--data-dir` | `_DATA` | `witness-data` | کلید شاهد و دفترچه شواهد | | `--config` | `_CONFIG` | – | فایل JSON با هر یک از گزینه‌های بالا | آدرس گردآورنده، توکن‌ها و کانال از `--collector`, `--token` یا `--token-file`, `--bot-token` یا `--bot-token-file`, `--discord-webhook-file` و `--channel`، یا `_COLLECTOR`, `_TOKEN`, `_TOKEN_FILE`, `_BOT_TOKEN`, `_BOT_TOKEN_FILE`, `_DISCORD_WEBHOOK_FILE` و `_CHANNEL`، که اسرار را از فهرست فرآیندها پنهان نگه می‌دارد. یک فایل پیکربندی از نام‌های گزینه‌ها با خط تیره پایین، به‌علاوه `texts`، استفاده می‌کند که کلمات پست‌های کانال را جایگزین می‌کند: ``` {"collector": "https://your-collector.example.org", "token_file": "witness-token.txt", "bot_token_file": "bot-token.txt", "channel": "@your_witness_channel", "interval": 5, "timeout": 30, "post": "changes", "title": "Partner witness", "texts": {"ok": "journal head", "no_response": "no answer from the collector", "records": "records"}} ``` کلیدهای `texts`: `ok`, `key_changed`, `rollback`, `fork`, `invalid`, `no_response`, `collector`, `records`, `head`. خط فرمان بر محیط و محیط بر فایل ارجحیت دارد. گزینه‌های ناشناخته یا کلیدهای متنی به جای نادیده گرفته شدن، با یک پیام شاهد را متوقف می‌کنند. استفاده از کلمات هرگز بر اعتبارسنجی تأثیر نمی‌گذارد: verify.py در پایان هر پست، توکن امضا شده را بررسی می‌کند. با `--post changes` یا `problems`، چک‌هایی که ارسال نشده‌اند همچنان در دفترچه یادداشت شاهد باقی می‌مانند و `verify.py` آنها را به عنوان هرگز ارسال نشده لیست می‌کند؛ رکورد شروع، سیاست را نام‌گذاری می‌کند. هر چک همچنان در دفترچه یادداشت ظاهر می‌شود، بنابراین تعداد کمتر پست‌ها به معنای زمان‌های مستقل تلگرام کمتر است، نه تعداد کمتر چک‌ها. بدون کانال، شاهد همچنان دفترچه یادداشت خود را حفظ می‌کند. اثر انگشت کلید شاهد (`python -m tgwitness.witness fingerprint`) را در جای دیگری نگه دارید. ## صفحه اثبات عمومی برای چندین فضای کاری `python -m tgwitness.proof` تا ۳۲ فضای کاری را همزمان شاهد می‌کند و یک صفحه فقط-خواندنی با آخرین بررسی امضا شده هر یک ارائه می‌دهد. هر فضای کاری کلید شاهد و دفترچه خاطرات (journal) خود را در زیر پوشه داده‌ها و یک کلید گردآورنده (collector) سنجاق‌شده دریافت می‌کند؛ ارسال به یک کانال تلگرام برای هر فضای کاری اختیاری است. از [proof.config.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proof.config.example) شروع کنید: | میدان | معنی | | --- | --- | | `title` | عنوان صفحه، ۱–۱۰۰ کاراکتر | | `data_dir` | کلیدها و دفترچه‌های یادداشت شاهد، نسبت به فایل؛ پیش‌فرض `proof-data` | | `interval`, `timeout` | دقایق بین بررسی‌ها (۱–۱۴۴۰، پیش‌فرض ۵)؛ ثانیه‌های انتظار (۵–۶۰۰، پیش‌فرض ۲۰) | | `workspaces[].id`, `label` | نام مستعار کوتاه با حروف کوچک و نام نمایش داده شده | | `workspaces[].collector` | آدرس کلکسیونر؛ سایر فضاهای کاری با `/profiles/` | | `workspaces[].collector_fingerprint` | الزامی، متفاوت برای هر فضای کاری | | `workspaces[].token_file` | فایل حاوی توکن شاهد فقط-خواندنی آن فضای کاری | | `workspaces[].channel`, `bot_token_file` | اختیاری، به‌صورت مشترک: ارسال هر بررسی به یک کانال | | `workspaces[].proxy`, `bot_api` | مسیر اختیاری و آدرس Bot API | ``` python -m tgwitness.proof --config proof.json --check-config python -m tgwitness.proof --config proof.json --host 127.0.0.1 --port 8790 ``` اولین دستور، فایل و فایل‌های توکن را بدون باز کردن اتصال اعتبارسنجی می‌کند. این صفحه تنها به درخواست‌های GET و HEAD پاسخ می‌دهد: - `/` تمام فضاهای کاری را نشان می‌دهد؛ فضایی که بررسی برای ۲.۵ بازه را انجام نداده باشد، به‌عنوان منقضی علامت‌گذاری می‌شود. - `/api/proof` همانند JSON بازمی‌گردد. - `/api/proof/` جدیدترین بیانیه امضا شده را دانلود می‌کند (`tgwitness-public-proof-v1`): شماره و هش سوابق شاهد، وضعیت، کلید گردآورنده سنجاق‌شده، نقطه کنترل، مجموعه شمارنده‌ها و اینکه آیا ارسال کانال موفقیت‌آمیز بوده است، امضا شده توسط کلید شاهد آن فضای کاری. - `/healthz` وقتی مانیتور یک فضای کاری متوقف می‌شود، کد وضعیت ۵۰۳ را برمی‌گرداند. به صفحه یک نام میزبان (hostname) اختصاصی بدهید، مانند [Caddyfile.proof.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.proof.example). برای تأیید، دفترچه یادداشت (witness journal) یک فضای کاری را با `python -m tgwitness.witness export --data-dir proof-data/ --out witness.zip` و آن را همان‌طور که در زیر توضیح داده شده است، استفاده کنید. ## تأیید از سمت شاهد، ژورنال آن را صادر کنید: ``` python -m tgwitness.witness export --out witness.zip # Docker (add -f deploy/compose/compose.witness.yaml on a witness server): docker compose exec witness python -m tgwitness.witness export --out /witness/witness.zip docker compose cp witness:/witness/witness.zip . ``` سپس، در هر کجا، با فایل ZIP امضا شده توسط گردآورنده و کانال خروجی‌گرفته شده از تلگرام دسکتاپ (*تاریخچه چت را صادر کنید* → JSON مقدار `result.json` را می‌دهد) یا صفحه عمومی آن `https://t.me/s/…` : ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel result.json ``` `verify.py` دفترچه یادداشت شاهد (زنجیره و امضاها) را بررسی می‌کند، و سپس بررسی می‌کند که آیا **هر سر که شاهد دیده بخشی از دفترچه یادداشت صادرشده است** یا **خیر**: رکورد در آن شمارش باید دقیقاً همان هش را داشته باشد. سری که مطابقت نداشته باشد، اعتبارسنجی را رد می‌کند — یعنی دفترچه یادداشت پس از آنکه شاهد آن را دید، تغییر کرده است. همچنین سرهایی را که پس از صدور گزارش مشاهده شده‌اند، ناهنجاری‌هایی را که شاهد ثبت کرده است، پاسخ‌های ناموفق، دوره‌هایی را که نقاط کنترل تطابق‌دارشان در این گزارش موجود است («گواهی‌شده از X تا Y») و فواصل را گزارش می‌کند. نقاط کنترل بعدی آن دوره‌ها را گسترش نمی‌دهند. نتیجه شامل شماره آخرین رکورد تطبیق‌یافته و تعداد رکوردهای انتهایی بدون چک‌پوینت تطبیق‌شده است. تنها پاسخ‌هایی که با کلید خودِ اکسپورت امضا شده‌اند، شمارش می‌شوند: اکسپورتی که با کلیدی امضا شده باشد که شاهد هرگز آن را ندیده است، به عنوان «شاهد نشده» گزارش می‌شود و بدون `--fingerprint` امضاکننده آن پین نمی‌شود. با `--channel`، هر پست امضا شده باید رکورد به رکورد با دفترچه یادداشت شاهد مطابقت داشته باشد: پست‌های تغییر یافته در اعتبارسنجی شکست می‌خورند و پست‌های گمشده فهرست می‌شوند. یک تاریخ در خروجی JSON تلگرام ارائه‌شده، یک متادیتای قابل ویرایش است که خارج از توکن شاهد امضا شده قرار دارد. تطابق توکن، تاریخ انتشار را احراز هویت نمی‌کند؛ نتیجه صراحتاً گزارش می‌دهد که اعتبارسنجی زمان انتشار انجام نشده است. ### نیاز به مرز خروجی گواهی‌شده برای واگذاری که باید شامل یک رکورد نهایی با گواهی شاهد باشد، `--require-witness` را اضافه کنید: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --require-witness ``` این امر مستلزم اثر انگشت شاهدی است که به‌طور مستقل نگهداری شده و یک نقطه کنترل تطابق‌دار در انتهای دقیق این خروجی. یک نقطه کنترل که فقط پیشوند قبلی را پوشش می‌دهد ناکافی است. جمع‌آوری را متوقف کنید، اجازه دهید شاهد وضعیت نهایی را مشاهده کند و قبل از نوشتن‌های بیشتر در ژورنال، خروجی را صادر کنید؛ اگر ژورنال تغییر کرد، یک نقطه کنترل دیگر نگهداری کرده و آن وضعیت را صادر کنید. یک نقطه کنترل بعدی به تنهایی نمی‌تواند هش نهایی یک خروجی کوتاه‌تر را تأیید کند. هنگامی که `--channel` نیز ارائه شود، عدم وجود پست‌های ادعا شده یا یک مجموعه تطابق خالی، این بررسی سخت‌گیرانه را ناموفق می‌کند. بدون این پرچم، بررسی‌های یکپارچگی عادی همچنان رکوردهای بدون شاهد را گزارش می‌کنند بدون اینکه آرشیوی را که در غیر این صورت سالم است، رد کنند. مجله شاهد و کلید پین‌شده آن را جداگانه نگه دارید. بررسی‌های آنلاین، پیوستگی بین نقاط کنترل را تأیید می‌کنند؛ تأیید آفلاین هر نقطه کنترل نگهداری‌شده را با خروجی مقایسه می‌کند. سرهای قدیمی بدون اثبات پیوستگی، مقایسه آفلاین را حفظ کرده و بدون تأیید پیوستگی آنلاین گزارش می‌شوند. گزارش، زمان‌های از کار افتادگی شاهد و انتشارهای ناموفق را بر حسب بازه زمانی فهرست می‌کند. ### مهرهای روزانه و تقویم‌های زمان‌بندی در دسترس نبوده شاهد مرز دفترچه روز UTC قبلی را مهر و موم می‌کند و هش آن مهر و موم امضا شده را به OpenTimestamps ارسال می‌نماید. یک ارسال تقویمی در انتظار مدرک است؛ تنها تعهدات بیت‌کوین که به‌طور مستقل بررسی شده‌اند در اعتبارسنج تأیید می‌شوند. اگر همه تقویم‌ها با شکست مواجه شوند، مهر امضا شده و تلاش ناموفق در مجله باقی می‌مانند. پاس نگهداری ساعتی آن رکورد اصلی را، حتی پس از راه‌اندازی مجدد یا تغییر تاریخ، مجدداً امتحان می‌کند. این پاس حداکثر 32 مهر را اسکن می‌کند، حداکثر دو ارسال از دست رفته را ارسال می‌کند و برای هر پاس حداکثر 60 ثانیه برای تلاش‌های مجدد صرف می‌کند. یک نشانگر پایدار به صورت چرخشی مهرهای قدیمی‌تر را بررسی می‌کند. ارسال‌های نگهداری‌شده از مسیر ارتقاء-اثبات موجود پیروی می‌کنند. یک تلاش مجدد مهر را بازنویسی نمی‌کند، تاریخ اصلی آن را تغییر نمی‌دهد یا ادعا نمی‌کند که تقویم آن را زودتر دریافت کرده است. یک تعهد بیت‌کوین بعدی همچنان یک تأیید خارجی بعدی باقی می‌ماند. اثبات‌های از دست رفته همچنان `none` باقی می‌مانند؛ اثبات‌های در انتظار تا زمانی که اعتبارسنج به طور مستقل آنها را بررسی کند، همچنان `pending` باقی می‌مانند. --- # Telegram · برچسب‌های زمانی Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/timestamp/ تمبرهای زمانی RFC 3161 برای نقاط کنترل امضا شده: چه چیزی به مرجع ارسال می‌شود و چگونه پاسخ تأیید می‌شود. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) تمبرهای زمانی RFC 3161 برای نقاط کنترل امضا شده: چه چیزی به مرجع ارسال می‌شود و چگونه پاسخ تأیید می‌شود. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [شواهد و تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) ![شواهد و تأیید](https://phishdestroy.github.io/TgWitness/assets/chapter-evidence.svg) TgWitness درخواست‌های RFC 3161 را آماده می‌کند و پاسخ‌های مرجع تاریخ‌نگاری (TSA) را تأیید می‌کند. این رویه دستی نه یک مرجع تاریخ‌نگاری را انتخاب می‌کند و نه داده‌ای را ارسال می‌نماید؛ حالت مدرک هر دو را طبق یک برنامه زمان‌بندی‌شده ([قالب مدرک](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02)) انجام می‌دهد. یک درخواست آماده‌شده **هنوز یک مدرک تاریخ‌نگاری نیست**. ## آنچه مدرک را پیوند می‌دهد نمودار جریان · مشاهدات حساب کاربری → زنجیره SHA-256 و امضاهای Ed25519; زنجیره SHA-256 و امضاهای Ed25519 → نقطهٔ کنترل امضا شده; نقطهٔ کنترل امضا شده → هَش دقیق بایت‌به‌بايت و نانس تصادفی; هَش دقیق بایت‌به‌بايت و نانس تصادفی → درخواست RFC 3161; درخواست RFC 3161 → TSA مستقل; TSA مستقل → پاسخ امضا‌شده TSA; نقطهٔ کنترل امضا شده → تأیید داده‌ها، عدد یک‌بار مصرف و اعتماد صریح به CA; پاسخ امضا‌شده TSA → تأیید داده‌ها، عدد یک‌بار مصرف و اعتماد صریح به CA · مشاهدات حساب کاربری · زنجیره SHA-256 وامضاهای Ed25519 · نقطهٔ کنترل امضا شده · هَش دقیق بایت‌به‌بايتو نانس تصادفی · درخواست RFC 3161 · TSA مستقل · پاسخ امضا‌شده TSA · تأیید داده‌ها، عددیک‌بار مصرف و اعتمادصریح به CA **نمودار به صورت متن** 1. مشاهدات حساب کاربری → زنجیره SHA-256 و امضاهای Ed25519 2. زنجیره SHA-256 و امضاهای Ed25519 → نقطهٔ کنترل امضا شده 3. نقطهٔ کنترل امضا شده → هَش دقیق بایت‌به‌بايت و نانس تصادفی 4. هَش دقیق بایت‌به‌بايت و نانس تصادفی → درخواست RFC 3161 5. درخواست RFC 3161 → TSA مستقل 6. TSA مستقل → پاسخ امضا‌شده TSA 7. نقطهٔ کنترل امضا شده → تأیید داده‌ها، عدد یک‌بار مصرف و اعتماد صریح به CA 8. پاسخ امضا‌شده TSA → تأیید داده‌ها، عدد یک‌بار مصرف و اعتماد صریح به CA امضای گردآورنده، سوابق را به کلید خود متصل می‌کند. یک پاسخ معتبر از TSA می‌تواند اثبات کند که یک ایست بازرسی خاص در زمان اعلام‌شده توسط TSA وجود داشته است. سپس ایست بازرسی می‌تواند پیشوند دفترچه را متصل کند. این امر زمان هر اقدام تلگرام یا صحت محتوای ضبط‌شده را اثبات نمی‌کند. ## روند کار 1. اثر انگشت کلید گردآورنده را از طریق یک کانال امن جداگانه حفظ کنید. کلیدی که تنها توسط فایل ZIP بررسی‌شده ارائه می‌شود برای شناسایی گردآورنده کافی نیست. 2. در بخش **«صادرات» → «آماده‌سازی درخواست مهر زمانی**»، فایل ZIP درخواست فضای کاری انتخاب‌شده را دانلود کنید. فایل‌های `checkpoint.json`، `timestamp.tsq`، `SHA256SUMS` و `README.txt` را استخراج کنید. بایت‌های نقطه‌کنترل را تغییر ندهید. 3. یک TSA مناسب برای تحقیق انتخاب کنید. `timestamp.tsq` را با استفاده از روش مستندشده آن ارسال کنید، همراه با `application/timestamp-query` برای یک سرویس HTTP. پاسخ باینری اصلی را به عنوان `timestamp.tsr`، نقطه پایانی، زمان بازیابی و نتیجه درخواست ذخیره کنید. درخواست حاوی هش و نانس است نه پیام‌ها؛ متادیتای شبکه همچنان درخواست را فاش می‌کند. 4. گواهی ریشهٔ مورد اعتماد را به‌طور مستقل از پاسخ به‌دست آور، به‌علاوهٔ هر گواهی واسطه‌ای که لازم است. گواهی‌ای که در پاسخ آمده صرفاً به این دلیل که در آنجا گنجانده شده مورد اعتماد قرار نمی‌گیرد. 5. از یک نصب معتبر TgWitness، اعتبارسنجی کنید: ``` python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem ``` در صورت نیاز `--intermediates tsa-intermediates.pem` یا `--openssl /path/to/openssl` را اضافه کنید. OpenSSL باید از `ts` پشتیبانی کند. در ویندوز، اعتبارسنج همچنین نصب استاندارد Git را جستجو می‌کند. OpenSSL 3.5.9 به صورت محلی با یک CA/TSA مصنوعی آزمایش شد. 1. پس از نقطهٔ کنترل، یک فایل ZIP مجلهٔ امضا شده را صادر کنید تا شامل آن پیش‌وند باشد. با استفاده از اثر انگشت مستقل شناخته‌شده تأیید کنید: ``` python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json ``` 1. حفظ فایل ZIP، نقطهٔ کنترل، درخواست، پاسخ، زنجیرهٔ گواهی، نتایج تأیید و سوابق تحویل خارج از جمع‌آورنده. تکرار تأیید هنگام دریافت. برای آماده‌سازی یک درخواست از یک نقطهٔ کنترل ذخیره شده: ``` python -m tgwitness.anchor prepare checkpoint.json --out timestamp-request.zip ``` فرآیند آماده‌سازی JSON را کانونیکال می‌کند و چک‌پوینت مطابقت‌دار را در آرشیو درج می‌کند. از **بایت‌های چک‌پوینت آن آرشیو** برای تأیید TSA استفاده کنید، حتی اگر فایل ورودی فضای خالی متفاوتی داشته باشد. ## مرزهای اعتبارسنجی | بررسی | رفتار فعلی | | --- | --- | | داده‌ها | SHA-256 بایت‌های دقیق نقطه‌ی کنترل باید با پاسخ مطابقت داشته باشد | | درخواست | با `--request`، پرس‌وجوی اصلی و نانس تأیید می‌شوند | | امضای TSA | OpenSSL امضا و زنجیره را تا CA صریح تأیید می‌کند. | | امضای گردآورنده | به‌طور جداگانه توسط اعتبارسنج مجله با یک کلید ثابت‌شده تأیید می‌شود | | ابطال | بدون بازیابی خودکار OCSP/CRL | | اعتبار بلندمدت | پس از انقضای گواهی، اعتبارسنجی آرشیو انجام نمی‌شود | | ارسال برنامه‌ریزی‌شده | حالت شواهد، به‌طور پیش‌فرض غیرفعال | `--request` از نظر فنی اختیاری است، اما حذف آن مانع از تأیید نانس اصلی می‌شود. برای این رویه کامل، `request_checked` نتیجه باید درست باشد. تأیید اعتبار گواهی‌نامه از قوانین OpenSSL نصب‌شده و زمان تأیید اعتبار پیروی می‌کند. حفظ بلندمدت نیازمند یک سیاست جداگانه برای گواهی‌نامه/مدرک لغو است. یک امضای رمزنگاری معتبر به طور خودکار به معنای یک مهر زمانی معتبر یا تعیین قابلیت پذیرش قانونی نیست. اگر اپراتور قبل از مهرزنی زمانی، مشاهدات را جعل کرده باشد، TSA آن بایت‌ها را ثابت می‌کند؛ اما صحت آن‌ها را اثبات نمی‌کند. ## سپردهٔ سوابق شناسه‌ی پرونده، فرستنده و گیرنده، زمان انتقال به وقت UTC و منبع آن، هدف، نام فایل‌ها/مقادیر SHA-256، اثر انگشت گردآورنده، بازه‌ی توالی، فواصل شناخته‌شده، نسخه‌ی اعتبارسنج و نتیجه‌ی اعتبارسنجی را ثبت کنید. این سوابق را امضا کرده و به صورت مستقل از طریق فرآیند سازمان خود نگهداری کنید. سیستم سوابق امانی چندکاربره در TgWitness پیاده‌سازی نشده است. در طول توسعه با هیچ TSA زنده و مستقلی تماس گرفته نشد. تست‌های محلی یک CA/TSA مصنوعی ایجاد می‌کنند تا سازگاری و رد داده‌های تغییر یافته، نانس یا CA را بررسی کنند. --- # Telegram · ذخیره‌سازی و بازیابی Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/storage/ نسخه‌برداری، انتقال فایل‌های قدیمی‌تر به فضای ابری شما، نسخه‌های کپی‌شده تحت Object Lock و بازیابی روی دستگاه جدید. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) نسخه‌برداری، انتقال فایل‌های قدیمی‌تر به فضای ابری شما، نسخه‌های کپی‌شده تحت Object Lock و بازیابی روی دستگاه جدید. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/deployment/) ![راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/assets/chapter-operate.svg) پنل سه وظیفه را جدا می‌کند: | وظیفه | کارکرد آن | | --- | --- | | یک نسخه پشتیبان تهیه کنید | ژورنال امضا شده، نقاط کنترل، فایل‌های نگهداری‌شده و خروجی‌های صف‌شده را به مقصد S3 پیکربندی‌شده کپی کنید. | | فضای محلی رایگان | پیوست‌های قدیمی‌تر انتخاب‌شده را به S3 یا یک درایو ابری rclone کپی کنید، آن‌ها را به‌طور کامل دوباره بخوانید، بایت‌های رمزگذاری‌شده را تأیید کنید، سپس نسخه محلی تأییدشده را حذف کنید. | | یک نسخهٔ مدرکی را نگه دارید | قفل شیء S3 را پیکربندی کنید و وضعیت نگهداری بازگردانده‌شده را بررسی کنید. سرویس باید حالت و تاریخ درخواستی را تأیید کند. | آزادسازی فضا هرگز دفترچه یادداشت امضا شده را حذف یا بازنویسی نمی‌کند. هر پیوست، شناسه اصلی SHA-256 و یک رسید بازیابی را حفظ می‌کند. فشرده‌سازی اختیاری gzip قبل از رمزگذاری احراز هویت‌شده انجام می‌شود. نام فایل‌های ابری حاوی نام‌های تلگرام، شناسه چت یا نام‌های اصلی پیوست‌ها نیست. یک پیوست می‌تواند تا ۳۲ گیگابایت باشد. پاسخ بارگذاری به تنهایی مجوز حذف یک فایل را نمی‌دهد. TgWitness شیء رمزگذاری‌شده کامل را دانلود کرده و اندازه و SHA-256 آن را تأیید می‌کند، رسید را ذخیره می‌کند، سپس بلافاصله قبل از حذف، بایت‌های محلی را دوباره بررسی می‌کند. یک خطای بارگذاری، بازخوانی متفاوت یا لغو انتقال، فایل محلی را سر جای خود باقی می‌گذارد. اگر یک نسخه پشتیبان مدرک فعال هنوز آن فایل را کپی نکرده باشد، حذف آن نیز منتظر می‌ماند. **در این صفحه** - [وقتی دیسک در حال پر شدن است](https://phishdestroy.github.io/TgWitness/fa/docs/reference/storage/#when-the-disk-is-filling-up) - [اتصال به مقصد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/storage/#connect-a-destination) - [فایل بازیابی را حفظ کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/storage/#keep-the-recovery-file) - [بازیابی پس از از دست دادن نصب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/storage/#recover-after-losing-the-installation) - [ربات اپراتور و اعلان‌های تکمیل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/storage/#operator-bot-and-completion-notices) ## وقتی فضای دیسک رو به اتمام است وقتی فضای آزاد از مقدار **پارامترها ← پیوست‌ها ← فضای آزاد دیسک** کمتر شود (پیش‌فرض 1 GiB)، دریافت پیوست‌ها موقتاً متوقف می‌شود و صف باقی می‌ماند. مشاهدات متنی ادامه دارند. این رفتار مستقل از اعلان‌هاست: خاموش کردن اعلان، فضای ذخیرهٔ دریافت یا حفاظت‌های ذخیره‌سازی را غیرفعال نمی‌کند. برای اقدام زودتر، **اجرای خودکار** را فعال کنید، **حذف فایل محلی برای آزاد کردن فضا** را انتخاب کنید و **انتقال اضافی هنگام کمبود فضای دیسک** را فعال کنید. این قاعدهٔ اختیاری به‌طور پیش‌فرض زیر 5120 MiB فضای آزاد شروع می‌شود و دسته‌دسته ادامه می‌یابد تا 10240 MiB آزاد شود. هر دو آستانه قابل تنظیم‌اند. مقصد، حداقل سن فایل، حد دسته، بررسی با بازخوانی کامل و پیش‌نیازهای پشتیبان‌گیری شواهد همان اجرای دستی‌اند. مقصدی را خودبه‌خود فعال نمی‌کند. بررسی هر 30 ثانیه انجام می‌شود؛ خطا یا نبود پیشرفت، تلاش بعدی را پنج دقیقه عقب می‌اندازد. وضعیت و زمان تلاش مجدد پس از راه‌اندازی دوباره باقی می‌مانند. وقتی قاعده غیرفعال است، اجراهای زمان‌بندی‌شده فاصلهٔ عادی را حفظ می‌کنند. پنل فضای آزاد، ذخیرهٔ بسته‌بندی، آماده‌بودن قاعده و فایل‌های ردشده به علت کمبود فضای موقت را نشان می‌دهد. بسته‌بندی و بازیابی پیش از شروع، حداکثر نیاز به فضای موقت و هنگام نوشتن، فضای موجود را بررسی می‌کنند. ذخیرهٔ تنظیم‌شده برای دریافت استفاده می‌شود، با حداقل 64 MiB برای عملیات ذخیره‌سازی. این بررسی‌ها سهمیهٔ سیستم فایل نیستند؛ فرایند دیگری می‌تواند بین بررسی‌ها فضا مصرف کند. Gzip اشیای راه‌دور را بدون اتلاف داده فشرده می‌کند؛ دفتر ثبت فعال را کوچک نمی‌کند و بایگانی محلی نمی‌سازد. JPEG، ویدیو و ZIP ممکن است بسیار کم کوچک شوند یا کمی بزرگ‌تر شوند. با فعال بودن فشرده‌سازی، بسته‌بندی ممکن است موقتاً حدود دو برابر اندازهٔ پیوست به‌علاوهٔ فضای ذخیره نیاز داشته باشد. آستانهٔ شروع را برای بزرگ‌ترین فایل‌ها به‌اندازهٔ کافی زود تعیین کنید. فایل بیش‌ازحد بزرگ حفظ و گزارش می‌شود؛ فایل‌های کوچک‌تر و نسخه‌های راه‌دورِ ازپیش‌بررسی‌شده همچنان می‌توانند فضا آزاد کنند. با نسخهٔ بررسی‌شده می‌توان فایل محلی را بدون ساخت فایل بسته‌بندی دیگری حذف کرد. بازیابی نیز فضای موقت می‌خواهد و ممکن است تا فراهم‌شدن آن رد شود. اگر فایل مناسبی برای انتقال نباشد یا مقصدی تنظیم نشده باشد، TgWitness نمی‌تواند خودکار فضا آزاد کند. مدیریت ذخیره‌سازی هرگز دفتر ثبت امضاشده را کوتاه یا بازنویسی نمی‌کند. برای مشاهدات متنی جدید همچنان فضا لازم است. ## یک مقصد را متصل کنید در **بخش «افزودنی‌ها» → «فضای ذخیره‌سازی و دیسک» → «مدیریت ذخیره‌سازی**»، وظیفه و مقصد را انتخاب کرده، آن را ذخیره کنید، سپس **«آزمایش بارگذاری و دانلود**» را برگزینید. این آزمایش یک پروب کوچک تصادفی را بارگذاری کرده و آن را دوباره می‌خواند. این کار از محتوای تلگرام استفاده نمی‌کند. برای S3، از endpoint، region و bucket واقعی ارائه‌دهنده استفاده کنید. Wasabi، Backblaze، Cloudflare R2 و سایر خدمات سازگار از همان تنظیمات S3 استفاده می‌کنند. سازگاری API به تنهایی به معنای پشتیبانی از Object Lock نیست. حالت Governance ممکن است به یک مدیر مجاز اجازه دهد تا از نگهداری (retention) عبور کند؛ حالت Compliance محدودیت‌های متفاوتی دارد. قبل از اتکا به نگهداری، وضعیت بازگردانده‌شده Object Lock را بخوانید. برای یک مقصد rclone، یک ریموت با استفاده از تنظیمات ارائه‌دهنده rclone ایجاد کنید و ریموت مذکور را جای‌گذاری کنید `[name]` بخش را در پنل قرار دهید. ابزار کمکی نصب‌شده از MEGA، Google Drive، OneDrive، Dropbox، Box، pCloud و سایر ارائه‌دهندگانی که در انتخابگر نمایش داده شده‌اند، پشتیبانی می‌کند. اعتبارنامه‌ها در گاوصندوق رمزگذاری‌شده این فضای کاری ذخیره می‌شوند. به‌روزرسانی‌های OAuth نیز دوباره در گاوصندوق ذخیره می‌شوند. اعتبارنامه‌ها به رویدادهای گزارش (journal) اضافه نمی‌شوند و در دانلودهای بازیابی گنجانده نمی‌شوند. این ابزار کمکی در داخل فضای کاری نصب می‌شود، با یک نسخه سنجاق‌شده و یک پوشهٔ «SHA-256». این فایل به مسیر (PATH) سیستم اضافه نمی‌شود. فایل‌های پیکربندی و فایل‌های کاری، فایل‌های موقتی در همان فضای کاری هستند. اتصالات از راه دور مبتنی بر فرمان و فایل‌های محلی رد می‌شوند. rclone در حال حاضر برای درخواست‌های خارجی به یک مسیر **«مستقیم» (Direct)** که صراحتاً انتخاب شده باشد نیاز دارد. برای یک مسیر SOCKS5 یا HTTP در فضای کاری، از ذخیره‌سازی بومی S3 استفاده کنید؛ rclone یک مسیر غیرفعال را بی‌صدا دور نمی‌زند. ## فایل بازیابی را نگه دارید گزینه **«ذخیره فایل بازیابی** پس از کپی کردن فایل‌ها» را انتخاب کرده و آن را در مکانی جدا از محل نصب نگهداری کنید. این فایل حاوی کلید رمزگشایی و رسیدهای اشیاء امضا شده است، بنابراین آن را به عنوان پشتیبان کلید خصوصی در نظر بگیرید. پیکربندی راه دور اصلی و اعتبارنامه‌های مقصد را نیز به طور جداگانه نگهداری کنید. فایلی که برای بازیابی قبل از کپی بعدی گرفته می‌شود، حاوی رسید آن فایل بعدی نخواهد بود. اثر انگشت کلید امضا باید از قبل به طور مستقل ثبت شده باشد. امضایی که تنها با کلیدی که در همان فایل ارائه شده بررسی شود، مشخص نمی‌کند که فایل بازیابی متعلق به چه کسی است. برای تعمیر رسیدهای ذخیره‌سازی گم‌شده در یک فضای کاری موجود، **گزینه «بازیابی فایل‌ها» را از یک فایل بازیابی ذخیره‌شده** باز کرده و آن فایل را انتخاب کنید. این پنل امضا را بررسی می‌کند و به کلید امضای همان فضای کاری نیاز دارد. این گزینه از جایگزینی یک کلید ذخیره‌سازی متفاوت خودداری می‌کند. سپس **«بازیابی همه فایل‌ها» را** انتخاب کنید. بازیابی، قانون ذخیره‌سازی خودکار را متوقف می‌کند تا نوبت برنامه‌ریزی‌شده بعدی نتواند فوراً فایل‌های بازیابی‌شده را دوباره حذف کند. پس از اتمام کار با نسخه‌های محلی، قانون را مجدداً فعال کنید. فرآیند بازیابی، متن رمزگذاری‌شده را تأیید می‌کند، رمزگشایی را احراز هویت می‌کند، در صورت لزوم فشرده‌سازی را برعکس می‌کند و متن ساده اصلی را بررسی می‌کند SHA-256 قبل از قرار دادن یک فایل در `media/`یک شیء راه دور خراب هرگز یک فایل محلی را جایگزین نمی‌کند. یک فایل محلی موجود با بایت‌های متفاوت به جای اینکه بازنویسی شود، برای بازبینی نگه داشته می‌شود. ## بازیابی پس از از دست دادن نصب TgWitness را روی دستگاه دیگری نصب کنید. از فایل بازیابی خصوصی، اثر انگشت جداگانه ضبط‌شده و اعتبارنامه‌های مقصد اصلی استفاده کنید: ``` python -m tgwitness.storage recover \ --recovery storage-recovery.json \ --fingerprint TRUSTED_WORKSPACE_SHA256 \ --credentials original-rclone.conf \ --output recovered-attachments ``` برای S3، `--credentials` اشاره به یک فایل JSON خصوصی با `access_key` و `secret_key`؛ فایل بازیابی امضا شده، تنظیمات مقصد را فراهم می‌کند. این فرمان از یک اتصال خارجی مستقیم استفاده می‌کند و زمانی که یک ریموت rclone به آن نیاز دارد، کمک‌یار پین‌شده را دانلود می‌کند. این فرمان وجود یک دایرکتوری خروجی موجود را رد می‌کند. بایت‌های اصلی بازیابی‌شده به `recovered-attachments/media/`، نام‌گذاری شده توسط SHA-256 خود. `recovery-log.jsonl` یک رکورد بدون امضا از عملیات بازیابی است. این فرمان یک ژورنال امضا شده از دست رفته یا کلید امضای آن را بازسازی نمی‌کند. برای این موارد یک نسخه پشتیبان کامل از فضای کاری را نگه دارید. یک فایل بازیابی ذخیره‌سازی، یک نسخه پشتیبان کامل از فضای کاری نیست. ## ربات اپراتور و اعلان‌های تکمیل ربات تلگرام متعلق به اپراتور است. آن را از طریق BotFather ایجاد کنید و توکن، چت مقصد و شناسه کاربران تلگرام مجاز صریح را در پنل تنظیم کنید. هم فرستنده و هم چت باید مطابقت داشته باشند. پیام‌ها و دستورات فوروارد شده از ربات‌های دیگر نادیده گرفته می‌شوند. `/status` و `/stats` در حالت پیش‌فرض فقط وضعیت در دسترس هستند. حالت کنترل اختیاری اضافه می‌کند `/pause`, `/resume` و `/copy`. `/copy` درخواست وظیفه ذخیره‌سازی پیکربندی‌شده را می‌کند؛ این بدان معنا نیست که بارگذاری از راه دور قبلاً به پایان رسیده است. دستورات نمی‌توانند URLها، فایل‌ها یا برنامه‌های شل دلخواه را فراهم کنند. از تنظیمات اعلان جداگانه برای هشدارها و اعلان‌های اتمام کار استفاده کنید. اعلان‌های اتمام کار، یک خروجی‌گیری حساب با فاصله‌ها را از یک خروجی‌گیری کامل متمایز می‌کنند و شمارش‌های تاریخچه و ذخیره‌سازی را نشان می‌دهند. گزیده‌های پیام، مگر اینکه به طور جداگانه در تنظیمات اعلان فعال شده باشند، گنجانده نمی‌شوند. انتخابگر سرویس از کاتالوگ واقعی نصب‌شده Apprise و نه از یک مجموعه ثابت از نمونه‌های ارائه‌دهنده، تولید می‌شود. --- # Telegram · امنیت و مدیریت داده‌ها Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/security/ مدل تهدید، مدل دسترسی، اسرار در حالت استراحت، در معرض دید شبکه، وارد کردن جلسات و نحوه گزارش آسیب‌پذیری. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) مدل تهدید، مدل دسترسی، اسرار در حالت استراحت، در معرض دید شبکه، وارد کردن جلسات و نحوه گزارش آسیب‌پذیری. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/deployment/) ![راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/assets/chapter-operate.svg) این صفحه دسترسی، ذخیره‌سازی و حفاظت شبکه را در یک فضای کاری محلی یا سرور توصیف می‌کند. برای جمع‌آوری در یک GitHub runner یا در یک ماشین مجازی محرمانه Intel TDX، به [حالت‌های تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope) مراجعه کنید که بررسی‌هایی را برای محیط جمع‌آوری اضافه می‌کنند. اتصالات حساب کاربری، اعلان‌ها، زمان‌مهرها، نسخه‌های خارج از محل و شاهدان تنظیمات مسیریابی خاص خود را دارند. | حوزه | به طور خلاصه | | --- | --- | | دسترسی | کلید ادمین به‌علاوه دسترسی محدودشده به حساب‌ها/چت‌ها، هفت مجوز و جلسات قابل‌ابطال؛ به‌صورت پیش‌فرض localhost | | رازهای در آرامش | تنظیمات جلسه، جفت API، کلید امضا و پروکسی با Fernet رمزگذاری می‌شوند. | | پیام‌ها و رسانه‌ها | ذخیره بدون رمزگذاری: از رمزگذاری دیسک و مجوزهای سخت‌گیرانه استفاده کنید | | یکپارچگی | زنجیره هش SHA-256 و امضای Ed25519 بر روی هر رکورد | | مرز اعتماد محلی | مدیر میزبان فضای کاری و کلید امضای آن را کنترل می‌کند؛ نقاط کنترل مستقل مرز دفترچه قبلی را حفظ می‌کنند | برای گزارش‌های آسیب‌پذیری، به [سیاست امنیتی](https://github.com/phishdestroy/TgWitness/blob/main/.github/SECURITY.md) مراجعه کنید. **در این صفحه** - [مدل دسترسی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/security/#access-model) - [محتوای پنل و خروجی‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/security/#panel-content-and-exports) - [اسرار ذخیره‌شده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/security/#secrets-at-rest) - [پروکسی‌ها و مسیرهای شبکه](https://phishdestroy.github.io/TgWitness/fa/docs/reference/security/#proxies-and-network-routes) - [وارد شدن و واردات جلسات](https://phishdestroy.github.io/TgWitness/fa/docs/reference/security/#sign-in-and-session-imports) - [لاگ‌ها و انتقال](https://phishdestroy.github.io/TgWitness/fa/docs/reference/security/#logs-and-transport) - [محدودیت‌های یکپارچگی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/security/#integrity-limits) - [اگر به مشکلی مشکوک هستید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/security/#if-you-suspect-a-problem) ## مدل دسترسی توکن پنل اصلی کنترل کامل را اعطا می‌کند. سایر افراد می‌توانند [دسترسی محدود](https://phishdestroy.github.io/TgWitness/fa/docs/reference/access/) خود را دریافت کنند: فضاهای کاری و چت‌های منتخب، مجوزها، انقضا، محدودیت‌های IP، محدودیت‌های ورود و جلسات قابل لغو. یک دسترسی محدود به چت نمی‌تواند عملیات کل فضا را انجام دهد حتی اگر مجوز آن تیک خورده باشد. محیط‌های کاری یک فرآیند را به اشتراک می‌گذارند و داده‌ها را از مدیر میزبان ایزوله نمی‌کنند. پنل به‌طور پیش‌فرض روی localhost گوش می‌دهد. ورود به سیستم از طریق مرورگر، یک توکن دسترسی را با یک اعتبارنامه جلسه (session credential) مبادله می‌کند؛ مرورگر آن را به‌عنوان یک توکن حمل‌کننده (bearer token) ارسال می‌کند. این توکن در sessionStorage نگهداری می‌شود، نه در یک کوکی احراز هویت. قفل کردن/خروج (Lock/sign-out) جلسه مرورگر را پاک می‌کند. بستن مرورگر یا پایان دادن به یک جلسه، جمع‌آوری داده‌ها را متوقف نمی‌کند. توکن‌های صادر شده و اعتبارنامه‌های جلسه به صورت هش در گاوصندوق رمزگذاری شده نگهداری می‌شوند. ابطال، جلسات مرتبط را پایان می‌دهد؛ تغییرات مجوز بر درخواست‌های بعدی تأثیر می‌گذارد. فایل‌های دانلود شده قابل بازیابی نیستند. مدیر می‌تواند جلسات مرورگر خود را نیز محدود کند، اما اسکریپت‌هایی که مستقیماً از توکن پنل اصلی استفاده می‌کنند، دسترسی کامل خود را حفظ کرده و از آن محدودیت‌های جلسه مرورگر عبور می‌کنند. احراز هویت ناموفق بر اساس آدرس کلاینت محدود شده است. محدودیت‌های IP بر اساس آدرسی اعمال می‌شوند که توسط برنامه دیده می‌شود؛ پیش از اتکا به آن، عملکرد پروکسی معکوس را بررسی کنید. اعتبارنامه‌های Witness همچنان جداگانه و فقط-خواندنی برای نقاط کنترل/وضعیت سلامت باقی می‌مانند. ### دسترسی دمو `/api/demo-access` یک بوت‌استرپ عمدتا غیرمعتبر برای یک دمو مصنوعی، ایزوله و صریحاً راه‌اندازی‌شده است. این قابلیت یک فرآیند جداگانه با چرخه عمر محدود صادر می‌کند، هرگز توکن پنل واقعی یا بازنویسی TGWITNESS_TOKEN را صادر نمی‌کند. صدور و استفاده از آن نیازمند یک همتا و میزبان لوپ‌بک، بدون سربرگ‌های فوروارد شده و بدون درخواست فرا-منشأ (cross-origin) است. فضاهای کاری اضافی یا یک جلسه مجاز، این مسیر را غیرفعال می‌کنند. فضاهای کاری زنده هرگز این قابلیت را صادر نمی‌کنند. این دمو نمی‌تواند حساب‌ها را به هم متصل کند یا تنظیمات جمع‌آوری را تغییر دهد. ## محتوای پنل و خروجی‌ها این پنل از هیچ فونت خارجی، ابزار تحلیل، منابع CDN یا رسانه‌های خارجی جاسازی‌شده استفاده نمی‌کند. متن استخراج‌شده از تلگرام به صورت متن درج می‌شود، نه HTML. فایل‌های پیوست دانلودشده به صورت پیوست‌های باینری ارائه می‌شوند. خروجی‌های JSONL رشته‌های اصلی را حفظ می‌کنند؛ HTML آن‌ها را فرار می‌کند؛ سلول‌های CSV که می‌توانند به فرمول تبدیل شوند، با یک آپاستروف پیش‌وند می‌شوند. خروجی‌ها شامل اسرار احراز هویت و امضا نمی‌شوند، اما عمداً شامل متادیتای منبع جمع‌آوری‌شده، شناسه‌ها و احتمالاً محتوای شخصی یا حساس هستند. هش‌های دسترسی تلگرام و ارجاعات فایل‌ها می‌توانند در متادیتای خام منبع وجود داشته باشند. ## رازهای در آرامش اطلاعات احراز هویت API تلگرام، کلید جلسه و کلید امضا با Fernet رمزگذاری می‌شوند. برای پیام‌ها و رسانه‌های محلی، رمزگذاری توسط دیسک یا حجم میزبان فراهم می‌شود؛ فضای کاری فایل‌های معمولی را ذخیره می‌کند. خروجی‌ها می‌توانند از یک فایل فشرده ZIP با رمزگذاری AES-256 محافظت‌شده با رمز عبور استفاده کنند، و نسخه‌های خارج از محل از AES-256-GCM استفاده می‌کنند. کلید گاوصندوق به‌طور پیش‌فرض روی دایرکتوری داده‌های محافظت‌شده قرار دارد. برای ذخیرهٔ جداگانهٔ آن، از یک فایل کلید اصلی خارجی در زیر استفاده کنید. در یونیکس، فایل‌های کلید خصوصی جدید از حالت 0600 و دایرکتوری‌های دادهٔ جدید از حالت 0700 استفاده می‌کنند؛ در ویندوز، ACL دایرکتوری را برای حساب سرویس و مدیران مجاز تنظیم کنید. مجوزهای موجود دایرکتوری حفظ می‌شوند. ### کلید اصلی خارجی برای یک دایرکتوری داده جدید، TGWITNESS_VAULT_KEY_FILE می‌تواند یک کلید اصلی تصادفی خارجی را فراهم کند. HKDF-SHA256 و یک سالت تصادفی جداگانه، یک کلید فرنِت متفاوت برای هر فضای کاری استخراج می‌کنند. vault.external.json باید برای بازیابی حفظ شود. در صورت عدم وجود یا نادرست بودن کلیدهای اصلی، عملیات با خطا متوقف می‌شود. گاوصندوق‌های محلی موجود به صورت خودکار مهاجرت نمی‌شوند. پنل، حالت ذخیره‌سازی کلید انتخاب‌شده را نمایش می‌دهد. رمزگذاری دیسک، فایل‌های پیام و رسانه محلی را در هر دو حالت محافظت می‌کند؛ برای جزئیات راه‌اندازی به [بخش‌های اتصال و حفاظت از داده‌ها](https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/) مراجعه کنید. ## پروکسی‌ها و مسیرهای شبکه پیکربندی پروکسی در گاوصندوق رمزگذاری می‌شود. گذرواژه‌ها و اسرار MTProxy توسط API بازنمی‌گردند یا در سوابق شواهد نوشته نمی‌شوند. هر فضای کاری مسیر تلگرام و [حالت آی‌پی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/connection/#ip-modes) خود را انتخاب می‌کند. **مخفی کردن آدرس،** پشتیبان‌گیری مستقیم تلگرام را رد می‌کند و برای درخواست‌های HTTP خارجی به یک پروکسی نیاز دارد. حالت پشتیبان‌گیری صریحاً انتخاب‌شده پس از تأخیر، دسترسی مستقیم به تلگرام را مجاز می‌سازد؛ حالت تونل/VPN مسیرهای مستقیم را مجاز می‌کند. انتخاب حالت تونل، VPN را نصب یا تأیید اعتبار نمی‌کند. این تنظیمات، تمام ترافیک دستگاه، مرورگرها، مدیران بسته یا حل DNS میزبان پروکسی محلی را کنترل نمی‌کنند. MTProxy فقط ترافیک تلگرام را منتقل می‌کند. درخواست‌های خارجی می‌توانند از یک پروکسی جداگانه SOCKS5/HTTP، مسیر SOCKS5/HTTP فضای کاری، یا یک مسیر مستقیم مجاز استفاده کنند؛ همچنین می‌توان آن‌ها را غیرفعال کرد. این شاهدی مستقل تنظیمات حمل‌ونقل خود را دارد. احراز هویت معمولی CONNECT در پروتکل‌های SOCKS5/HTTP توسط خود این پروتکل‌ها رمزگذاری نمی‌شود. پشتیبانی از رازهای MTProxy جعلی TLS همچنان فراهم نیست. ## ورود و واردسازی جلسات فایل‌های تبدیل‌شده .tgwitness-session حاوی یک رمز مخفی مجوز متن ساده هستند تا زمانی که در گاوصندوق بارگذاری و ذخیره شوند. CLI آفلاین، اسکیماهای بازبینی‌شده Telethon را می‌پذیرد. پانل واردات علاوه بر این، ورودی‌های Pyrogram SQLite، TData ZIP مدرن تک‌حساب، و JSON مستند را می‌پذیرد. این قابلیت احراز هویت شده، به چهار فایل / ۸ مگابایت محدود است، و بارگذاری‌ها را بدون استخراج آرشیو یا ذخیره فایل‌های اصلی، در حافظه پردازش می‌کند. اطلاعات احراز هویت نرمال‌شده فقط به مرورگر احراز هویت‌شده درخواست‌کننده بازگردانده می‌شوند؛ آنها پس از موفقیت در احراز هویت تلگرام در گاوصندوق رمزگذاری‌شده ذخیره می‌شوند. از فایل‌های اصلی و تبدیل‌شده محافظت کنید و از کپی‌برداری همزمان یک مجوز توسط کلاینت‌ها جلوگیری کنید. پردازش TData، چک‌سام‌های کانتینر، هش‌های رمزگشایی محلی و طول ساختارها را تأیید می‌کند. رمز عبور محلی دسکتاپ ارائه‌شده به‌طور موقت استفاده می‌شود و ذخیره نمی‌گردد. این پارسر محدود تضمین نمی‌کند که هر نسخه دسکتاپ سازگار است. تصاویر QR به‌صورت محلی تولید می‌شوند، توکن‌های ورود تلگرام با اعتبار محدود را در خود دارند و هرگز به سرویس رندرینگ خارجی ارسال نمی‌شوند. قفل کردن، تغییر فضای کاری، ورود جدید و تغییرات مسیر، تلاش‌های QR در حال انتظار را لغو می‌کنند. بارگذاری مجدد/بستن یک تب ممکن است یک تلاش را تا زمان انقضای آن در حالت انتظار باقی بگذارد. ورود موفق از طریق QR همچنان الزام به پیوند حساب را اعمال می‌کند. بدنه‌های معمولی API همچنان به ۱۶ کیلوبایت محدود هستند؛ مسیر وارداتی احراز شده تا ۱۲ مگابایت JSON رمزگذاری شده را می‌پذیرد و محدودیت فایل رمزگشایی شده کوچکتر را به طور جداگانه اعمال می‌کند. کدهای ورود و رمزهای احراز هویت دو مرحله‌ای تلگرام ذخیره نمی‌شوند. وضعیت شماره تلفن/کد-هش در حین تأیید اعتبار در حافظه نگهداری می‌شود. جلسات تلگرام دسترسی به حساب کاربری را فراهم می‌کنند؛ هرگز یک پوشه داده، جلسه، توکن، کلید گاوصندوق یا کلید امضای خصوصی را در گیت‌هاب بارگذاری نکنید. ## لاگ‌ها و انتقال پاسخ اعتبارسنجی پیش‌فرض API جایگزین می‌شود تا مقادیر اعتبارنامه‌ها را بازتاب ندهد. ثبت دسترسی برنامه غیرفعال است. از پیکربندی پروکسی معکوس برای ثبت سربرگ‌های احراز هویت یا بدنه درخواست‌ها خودداری کنید. HTTP توکن‌ها و اطلاعات محرمانه ورود را به صورت متن ساده حمل می‌کند: هرگاه از localhost خارج می‌شوید از HTTPS یا تونل SSH استفاده کنید. ## محدودیت‌های یکپارچگی تأیید صحت محلی، امضاهای سوابق، زنجیره هش، پیوست‌ها و فهرست خروجی را بررسی می‌کند. مدیر، کلید امضای محلی را در اختیار دارد و می‌تواند دفترچه یادداشت امضا شده دیگری ایجاد کند؛ یک نقطه کنترل که به‌طور مستقل نگهداری می‌شود، جایگزینی پیشوندی را که پوشش می‌دهد، تشخیص می‌دهد. اثر انگشت کلید و نقاط کنترل را نزد گیرنده یا یک شاهد مستقل نگه دارید. برای جمع‌آوری مستقل، گزینه ضبط [GitHub Actions](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) یا [استقرار Intel TDX](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx)را انتخاب کنید. اعتبارسنج‌های آنها علاوه بر یکپارچگی آرشیو، منشأ گردش کار یا اندازه‌گیری‌های سخت‌افزاری را بررسی می‌کنند. تمبرهای زمانی اختیاری و نسخه‌های رمزگذاری‌شده خارج از محل، نقاط زمانی و نسخه‌های قابل بازیابی را فراهم می‌کنند؛ [فرمت شواهد](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#verification-scope)، بررسی‌های مربوط به هر حالت را توصیف می‌کند. ## اگر به وجود مشکل مشکوک هستید دایرکتوری داده اصلی را حفظ کرده و برای تحلیل از یک نسخهٔ جداگانه استفاده کنید. نسخهٔ تحت تأثیر، عملیات و مراحل قابل تکرار را از طریق [سیاست امنیتی](https://github.com/phishdestroy/TgWitness/blob/main/.github/SECURITY.md) گزارش کنید و داده‌ها و اعتبارنامه‌های حساب کاربری را خصوصی نگه دارید. --- # معماری Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/architecture/ اجزای جمع‌آورنده، پنل، دفترچه، کارگران و شاهد، و نحوهٔ جابجایی داده‌ها بین آن‌ها. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) اجزای جمع‌آورنده، پنل، دفترچه، کارگران و شاهد، و نحوهٔ جابجایی داده‌ها بین آن‌ها. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![توسعه](https://phishdestroy.github.io/TgWitness/assets/chapter-develop.svg) یک فرآیند پایتون میزبان پنل FastAPI و هر تعداد فضای کاری ایزوله است، که هر کدام دارای یک کلاینت حساب کاربری تل‌هان (Telethon) هستند. SQLite یک دفترچه وقایع امضا شده با قابلیت الحاق تنها و تنظیمات عملیاتی قابل تغییر را در خود جای می‌دهد. یک گاوصندوق رمزگذاری‌شده حاوی اعتبارنامه‌های API، StringSession و کلید امضا است. فرانت‌اند، HTML/CSS/JavaScript بسته‌بندی‌شده و ساده‌ای است: نیازی به ساخت با Node، CDNها یا دانلودهای فرانت‌اند در زمان اجرا نیست. Optional browser and AyuGram recorders run in **separate processes or containers**. The `tgwitness_capture` package owns their event format, keys, artifacts, checkpoint API, independent witness and standalone verifier. It is bundled in the main wheel and can also be installed alone from `addons/capture`, without importing the collector. The main panel's `capture_api.py` and `capture_connections.py` provide administrator-only, workspace-scoped controls under `/api/capture`; connection tokens live in the encrypted vault. No recorder or outbound request starts with the main process. Each explicit command verifies a fresh challenge against the pinned recorder key. Exports are verified before download and keep their original signature; they do not become Telegram message events. Collection sessions and proxy routes stay with each client. See the English [Independent capture guide](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md) for deployment and trust boundaries. | ماژول | مسئولیت | | --- | --- | | collector.py | مجوز، انتخاب دیالوگ، به‌روزرسانی‌ها، اسنپ‌شات‌ها، صف رسانه‌ای، نظارت بر اتصال | | interactions.py / telegram_client.py | اقدامات واضح پنل، رسیدهای امضا‌شده، شناسه‌های درخواست پایدار و سیاست تلاش مجدد فراخوانی/پیوست‌شدن محلی وظیفه | | message_content.py | مقایسهٔ قابل مشاهدهٔ پیام‌ها، بدون در نظر گرفتن متادیتای دسترسی به انتقال | | workers.py | منتظر کارگران فایل خروجی قبل از پاکسازی لغو باشید | | distributed_export.py / distributed_pages.py | وظایف هم‌زمان چت، رزروهای هر حساب، نقاط کنترل امضا شده و پاک‌سازی پس از تأیید بایگانی | | distributed_takeout.py / export_timing.py | جلسات از سرگیری‌پذیر Takeout و زمان‌بندی برای هر شروع یا از سرگیری | | store.py | معاملات WAL، زنجیره رویداد مرتب‌شده، فیلترهای پرس‌وجو، تنظیمات عملیاتی | | fulltext.py | شاخص متن کامل مشتق‌شده (شکل‌های واژگان، BM25)، متصل به سرآیند دفترچهٔ امضا شده؛ هرگز صادر نمی‌شود | | security.py | ایجاد فایل خصوصی، گاوصندوق رمزگذاری‌شده، امضای Ed25519، قفل تک‌فرآیندی | | evidence.py | خروجی کامل دفترچه، مشتقات، نقاط کنترل، تأیید پیوست | | verify.py | راست‌آزماین مستقل و فقط-خواندنی ( stdlib + رمزنگاری): آرشیوها، پوشش، دفترچه‌های شاهدی و پست‌های کانال، فایل‌های پروفایل | | app.py | API احرازشده، چرخهٔ عمر، اعتبارسنجی درخواست، پنل ایستا | | profiles.py | گردآورنده‌های چندحساب، کنترل‌کننده دسترسی مشترک، چرخه عمر به‌ازای هر فضای کاری | | access.py | مجوزهای محدود، بررسی‌های دسترسی، محدودیت‌های IP، محدودیت‌های جلسه و کنسول مدیر | | proxy_catalog.py | اسکرین‌شات‌های فید عمومی، بررسی‌های انتقال، استخر پروکسی مشترک و انتخاب مبتنی بر سلامت | | provenance.py | اندازه‌گیری‌های کد و وابستگی‌های هویت، اجراشده و امضا‌شده | | network.py | مسیرهای تأییدشده برای هر فضای کاری؛ وضعیت و شواهد سانسور شده؛ گزینه‌های انتقال تله‌تون | | sessions.py | تبدیل آفلاین فقط-خواندنی طرح‌های SQLite تله‌تون بررسی‌شده | | import_حساب.py | تشخیص و نرمال‌سازی در حافظه‌ای فایل‌های حساب کاربری و JSON پشتیبانی‌شده | | tdata.py | خوانندهٔ محدود مدرن TData ZIP، اعتبارسنجی چک‌سام/رمزگشایی، بدون استخراج | | doctor.py | بررسی‌های آمادگی محلی بدون جمع‌آوری، ورود یا نصب بسته | | download.py | دانلود خروجی استریمینگ احرازشده با خوانش‌های محدود و بدون بازنویسی | | monitoring.py | سیاست رویداد تأییدشده برای هر فضای کاری و قواعد پیوست‌بندی بر اساس نوع، که توسط پردازشگرها، وضعیت و رسیدهای امضاشده به اشتراک گذاشته می‌شوند | | scope.py | دامنهٔ مشاهده (گفت‌وگوهای انتخابی، پوشهٔ تلگرام، کل حساب)، انواع منابع، استثناها، سطوح بازبینی مجدد | | dossier.py | پروفایل افراد در هر گفتگو بر اساس سوابق ذخیره شده ساخته شده است: حقایق با ارجاع به سوابق، SHA-256/pHash آواتار، استخراج ذکرها | | witness_api.py | توکن‌های شاهد فقط-خواندنی و سرتیتر امضاشدهٔ دفترچهٔ یادداشت که ممکن است دریافت کنند | | witness.py | فرآیند شاهد مستقل: کلید و دفترچه یادداشت اختصاصی، بررسی‌های سرانگشتی، پست‌های امضا‌شده کانال، خروجی‌گیری | | alerts.py | اخطاریه‌های اپرایز و فهرست اعلان‌های پنل | | logging_config.py | ثبت لاگ کنسول و تشخیص وضعیت سرورهای چرخشی برای راه‌اندازی‌های بدون پنجره | | ایستا/ | رابط کاربری واکنش‌گرا، دروازه دسترسی محلی، فیلترها، جزئیات، خروجی‌ها، تنظیم حساب | | demo.py | دفترچهٔ مصنوعی به‌وضوح برچسب‌گذاری‌شده، جدا از مجموعهٔ واقعی | پردازشگرهای مشاهده قبل از اتصال ثبت می‌شوند. جمع‌آوری زنده توسط هویت کلاینت فعال، وضعیت اجرای صریح، منابع فعال یا دامنه مشاهده (حالت‌های پوشه یا کل حساب، چت جدید را در اولین به‌روزرسانی خود به عنوان یک منبع اضافه می‌کنند) و سیاست رویداد کنترل می‌شود. کلاینت‌های رد شده و جایگزین شده نمی‌توانند در به‌روزرسانی‌های زنده مشارکت کنند. واکنش‌های خام و به‌روزرسانی‌های عضویت، محدودیت‌های دید را حفظ می‌کنند. محتوای پیام ورودی و وظیفه رسانه‌ای پایدار آن با هم ثبت می‌شوند. وظایف، توصیه‌گر اصلی TL را حفظ کرده و هش آن را به مشاهده پیام امضا شده پیوند می‌دهند. معنایی‌های فرستنده/ویرایشگر/حذف‌کننده از هم جدا شده‌اند. هر فضای کاری یک حساب کاربری را می‌پذیرد و دارای دایرکتوری و هویت امضای خود است. فضای کاری اصلی برای سازگاری در ریشه باقی می‌ماند؛ فضاهای کاری اضافی در profiles// قرار دارند. یک توکن حامل کل نصب را کنترل می‌کند؛ فضاهای کاری اجزای مجزای مجوزدهی نیستند. قفل‌های فرآیند از دایرکتوری‌ها محافظت می‌کنند؛ قفل‌های پایگاه داده، درج رویدادها را به صورت سریالی انجام می‌دهند. هر افزودنی به طور همزمان در WAL (لاگ پیش‌رونده) SQLite با حالت همگام کامل commit می‌شود. رویدادهای به‌روزرسانی/حذف، ویرایش‌های عادی برنامه را متوقف می‌کنند؛ مدیران فایل‌سیستم در محدوده اعتماد باقی می‌مانند. مجازیت API یک توکن حمل‌کننده است. عملیات ورود به سیستم سریالی و دارای محدودیت زمانی هستند. بارگذاری‌ها در حساب کاربری از یک اختصاصی استفاده می‌کنند 12 محدودیت بدنه‌ی رمزگذاری‌شده MiB و یک 8 محدودیت فایل رمزگشایی‌شده MiB؛ درخواست‌های عادی API حفظ می‌کنند 16 محدودیت KiB. تبدیل در یک نخ کارگر (worker thread) اجرا می‌شود، بارگذاری‌ها را در حافظه نگه می‌دارد و ورودی نرمال‌شده را به مرورگر احراز شده بازمی‌گرداند. ورود با QR دارای یک شناسه موقت برای هر فضای کاری، یک وظیفه منتظر (waiter task) و لغو صریح است. تنها مجوز پذیرفته‌شده به مشتری فعال تبدیل می‌شود. Telegram FloodWait با یک مقدار Retry-After بازگشته می‌شود؛ اعتبارنامه‌ها و پیام‌های خطای خام RPC در خطاهای API فاش نمی‌شوند. خروجی‌های ژورنال خارج از حلقه رویداد غیرهمزمان اجرا می‌شوند و به ازای هر فضای کاری به صورت سریالی انجام می‌گیرند. آن‌ها همزمان با ادامه نوشته‌های WAL، یک نمای خواندنی پایدار را استریم می‌کنند. وظایف دریافت چت می‌توانند به طور همزمان روی حساب‌های مجزا اجرا شوند؛ هر حساب تا زمانی که وظیفه‌اش متوقف نشود، رزرو باقی می‌ماند. یک وظیفه متوقف‌شده یا ناموفق، نقاط کنترل خود را حفظ می‌کند. تأیید موفق بایگانی، پاکسازی فایل‌های کاری آن را مجاز می‌سازد و فقط فایل ZIP، طرح امضا شده و وضعیت را باقی می‌گذارد. گردآورندگان فضای کاری حلقه فرآیند/رویداد را به اشتراک می‌گذارند. اسنپ‌شات‌های تاریخچهٔ جاری و به‌روزرسانی‌های زنده می‌توانند هم‌پوشانی داشته باشند. هر دو مشاهدات جداگانه‌ای هستند که با برچسب منبع مشخص شده‌اند؛ موارد تکراری به‌صورت خودکار حذف نمی‌شوند. هیچ نتیجه‌گیری‌ای از روی شناسه‌های گمشده، متن‌های حذف‌شدهٔ ساختگی، فهرست‌کردن اجباری اعضا یا پیوستن خودکار به گروه‌ها اعمال نمی‌شود. برای توضیحات مربوط به اپراتور، [نحوه کارکرد جمع‌آوری](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/) و [فرمت‌های حساب‌ها و جلسات](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/) را ببینید. پیکربندی شبکه در گاوصندوق رمزگذاری‌شده نگهداری می‌شود. اعمال یک مسیر، کلاینت‌های قدیمی را می‌بندد و ورود ناکامل را لغو می‌کند؛ اتصالات بعدی از آن مسیر استفاده می‌کنند و به هیچ‌گونه بازگشت مستقیم (fallback) دسترسی ندارند. یک نصب جدید کلید خارجی، کلید فرنت (Fernet) هر فضای کاری را با HKDF-SHA256 از یک فایل کلید اصلی و یک شور تصادفی (salt) ذخیره‌شده استخراج می‌کند. این کار، اسرار را به‌طور جداگانه از دایرکتوری داده‌ها محافظت می‌کند، نه از محتوای متن ساده (plaintext) دفترچه یادداشت/رسانه‌ها. ورودی دمو محلی از قابلیت فرآیندی که به‌طور جداگانه تولید شده است استفاده می‌کند، و هرگز از توکن پنل پیکربندی‌شده استفاده نمی‌کند. صدور و پذیرش آن نیازمند حالت دمو صریح، یک ریشه مصنوعی بدون فضای کاری اضافی یا جلسه مجاز، همتا/میزبان لوپ‌بک، بدون سربرگ‌های فوروارد پروکسی، و بدون درخواست مرورگر فرا-منشأ است. APIهای زنده احراز هویت حامل را حفظ می‌کنند و در حالت دمو تغییرات جمع‌آوری را رد می‌کنند. --- # آنچه آزمایش شده است Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/ آزمون زنده تلگرام، بررسی‌های خودکار، بررسی‌های مرورگر و آنچه هنوز تأیید نشده است. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) Translation coverage: this edition includes material from the English original. آزمون زنده تلگرام، بررسی‌های خودکار، بررسی‌های مرورگر و آنچه هنوز تأیید نشده است. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [شواهد و تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) ![شواهد و تأیید](https://phishdestroy.github.io/TgWitness/assets/chapter-evidence.svg) **به‌روزرسانی‌شده در 6 نوامبر 2026.** نتایج به بازنگری، محیط و بار کاری ثبت‌شده برای هر اجرا وابسته هستند. [قابلیت‌های فعلی،](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md) گردش کارهای در دسترس را توصیف می‌کند؛ این صفحه ثبت می‌کند که در واقع چه چیزی بررسی شده است. [نمودارهای عملکرد](https://phishdestroy.github.io/TgWitness/docs/validation/) · [بازبینی انگلیسی امضا شده](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md) · [اندازه‌گیری‌های قابل دانلود](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/MEASUREMENTS.csv) | آخرین شواهد | نتیجه | دامنه | | --- | --- | --- | | بازبینی انتشار · 6 نوامبر | 1,461 تست اصلی گذرانده شده؛ 37 تست پلتفرم رد شده | منبع `92e539af40d8`؛ یافته‌های باز حفظ شدند | | خروجی‌های تازه · 6امبر | 127.713 و 141.781 رکورد در ثانیه، چرخه کامل | دو حساب در هر سرور؛ متن و متادیتا از طریق WARP | | آرشیوهای نگهداری‌شده · 6 نوامبر | 48 بایگانی؛ 3,598,381 رکورد تأیید شده | آرشیوهای موجود با کلیدهای ثابت‌شدهٔ فضای کاری بررسی می‌شوند | | Trusted Live · 5 نوامبر | ثبت‌برداری محافظت‌شده CPU و بررسی‌های WARP | ورود رسمی دسکتاپ و خروجی بومی بدون تغییر باقی می‌مانند | | Phala / Intel TDX · 4 نوامبر | تمام بررسی‌های اعتبارسنجی 16 در اجراهای بعدی با موفقیت پاس شدند | استقرار تاریخی؛ هیچ حساب تلگرامی روی CVM وجود ندارد | **در این صفحه** - [بازبینی انتشار و صادرات تازه · 6 نوامبر 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/#release-audit-and-fresh-exports--6-november-2026) - [Trusted Live CPU Ubuntu و WARP · 5 نوامبر 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/#trusted-live-cpu-ubuntu-and-warp--5-november-2026) - [راه‌اندازی زنده ابر فالا · 4 نوامبر 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/#live-phala-cloud-deployment--4-november-2026) - [فهرست دفترچه سرور زنده · 1 نوامبر 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/#live-server-journal-inventory--1-november-2026) - [بررسی‌های آفلاین و تزریق خطا اخیر · 1 نوامبر 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/#recent-offline-and-fault-injection-checks--1-november-2026) - [آزمایش زنده تلگرام، کل حساب · 29 اکتبر 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/#live-telegram-test-whole-account--29-october-2026) - [صادرات محافظت‌شده با رمز عبور با libarchive باز شده · 29 اکتبر 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/#password-protected-export-opened-with-libarchive--29-october-2026) - [آزمون زنده تلگرام · 27 تا 29 اکتبر 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/#live-telegram-test--27-to-29-october-2026) - [اندازه‌گیری مصنوعی ظرفیت محلی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/#synthetic-local-capacity-measurement) - [جستجوی متن کامل در یک میلیون پیام · 5 نوامبر 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/#full-text-search-on-one-million-messages--5-november-2026) - [صلاحیت باقی‌مانده](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/#remaining-qualification) ## بازبینی انتشار و صادرات تازه · 6 نوامبر 2026 در این حسابرسی از نسخه v0.9.1 در کد منبع استفاده شد `92e539af40d8368d198ff5e040f1d876f2c1310e`، نسخه `92e539af40d8-83e41104669e`. تست‌های دود (smoke checks) بسته‌های نصب‌شده روی سه سرور با موفقیت انجام شد. گزارش امضا شده وضعیت مشاهده‌شده در آن زمان را حفظ می‌کند. [![نرخ‌های اکتساب و صدور کامل برای دو بار کاری جدید](https://phishdestroy.github.io/TgWitness/assets/performance.svg)](https://phishdestroy.github.io/TgWitness/docs/validation/) | بار کاری | ثبت می‌کند | تأمین | چرخهٔ کامل | نرخ چرخه کامل | | --- | --- | --- | --- | --- | | سرور A · دو حساب | 27,030 | 189.043s | 211.647s | 127.713 رکورد در ثانیه | | سرور B · دو حساب | 29,299 | 182.513s | 206.650s | 141.781 رکورد در ثانیه | هر دو خروجی بدون قابلیت از سرگیری شروع شدند، فایل‌های پیوست و آواتارها را شامل نمی‌شدند و با صفر رکورد تکراری یا دوباره استفاده شده به پایان رسیدند. چرخه کامل شامل آماده‌سازی، دریافت، انتخاب، بسته‌بندی و تأیید آرشیو است. سرور A همچنین یک بررسی خواندن چت محافظت‌شده را اجرا کرد. به چهار رویداد FloodWait در A و سه رویداد در B احترام گذاشته شد. این مشاهدات تضمین کلی throughput را اثبات نمی‌کنند. | بررسی | نتیجه | صلاحیت | | --- | --- | --- | | هسته pytest | 1,461 گذرانده شد | پلی‌ور 37 | | مرورگر / تجربه کاربری مرورگر / مدرک / سایت | 102/66/15/9 گذرانده شد | این برنامه‌ها با سایر آزمون‌ها هم‌پوشانی دارند؛ شمارش‌ها جمع‌شدنی نیستند | | افزونهٔ Capture | 124 پاس شد | سه بررسی وب رسمی که توسط sandbox مورد نیاز کرومیم مسدود شده‌اند | | مجوز API | 269 مسیرها؛ 538 درخواست‌های ارسال‌شده | اطلاعات احراز هویت گمشده و دسترسی لغو شده | | آرشیوهای نگهداری‌شده | 48 از 48 تأیید شده | 3,598,381 رکورد؛ کلیدهای فضای کاری سنجاق‌شده | | خوانش‌های زنده ناوگان | 24 از 40 پروفایل موفق شدند | 16 مسیر WARP واجد شرایط نشد؛ آن پروفایل‌ها متصل نبودند | [گزارش امضا شده](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md) تمام یافته‌های باز را ثبت می‌کند، از جمله سه نقص در یک اسنپ‌شات از چت مخفی منتشرنشده که در نسخه اصلی مورد حسابرسی قرار گرفته، وجود ندارد. [صلاحیت تاریخچه عمومی](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-BENCHMARK-2026-11-06.md) قبلی از یک بازنگری و حجم کاری متفاوت استفاده می‌کرد؛ نرخ‌های آن نباید با این مقایسه ترکیب شوند. گزارش اصلی را با استفاده از [کلید و اعتبارسنج پیوندی](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/README.md#verify-the-original-files) تأیید کنید. امضای آن از گزارش اپراتور در برابر دستکاری محافظت می‌کند. این یک تأیید مستقل، اثبات نویسندگی تلگرام یا گواهی GDPR نیست. ## Trusted Live CPU Ubuntu و WARP · 5 نوامبر 2026 اجرای یکپارچه‌سازی نگهداری‌شده از یک مهمان اوبونتو 24.04.5 صرفاً مبتنی بر CPU (4 vCPU، 8 GiB) در زیر QEMU و درون یک میزبان RunPod CPU استفاده کرد. کالکتور از `14e642a5` استفاده کرد؛ اعتبارسنجی از `02072461` استفاده کرد. اصلاحات نهایی در [PR شماره 114](https://github.com/phishdestroy/TgWitness/pull/114) ادغام شدند، به عنوان `755f78f6`، که درخت آن با هِد PR آزمایش‌شده مطابقت داشت. این یک TEE نبود. - یک کانکتور WARP واقعی وضعیت سالمی را گزارش کرد؛ HTTPS واسطه‌شده، فعال‌بودن WARP و Gateway را گزارش داد. سه پروب همان آدرس خروجی را مشاهده کردند، نه تضمین IP ثابت. - قطع اتصال WARP باعث شد درخواست پروکسی‌شده ناموفق شود. HTTPS مستقیم سرویس دروازه رد شد. در فضای نام ضبط‌کننده، IPv4/IPv6 مستقیم، DNS خارجی و حل‌کننده UDP تعبیه‌شده در Docker مسدود شدند. - یک توکن ارائه‌دهنده محدود به خواندن تنها می‌توانست health/connections را بخواند و نمی‌توانست توکن ثبت‌نام کانکتور را بخواند. مشاهدات امضا‌شده ارائه‌دهنده شامل نمونه‌های صریحاً در دسترس نبوده بودند. شاهد روی میزبان اپراتور اجرا شد، بنابراین این نشان‌دهنده ثبت و نگهداری است، نه نگهداری توسط شخص ثالث مستقل. - دسکتاپ رسمی به صفحه خوش‌آمدگویی بدون احراز هویت خود رسید. ورودی صفحه‌کلید محافظت‌شده در حین ضبط رد شد. سه بخش نمایش H.264 رمزگشایی شدند و لایه زمانی آن‌ها بررسی شد. آرشیو پیش‌پرواز ۱۸ رویدادی با کلید ضبط ثابت‌شده تأیید شد و نقطه کنترل را حفظ کرد.264 بخش‌های نمایش رمزگشایی شدند و روکش ساعت آن‌ها بازرسی شد. 18- آرشیو پیش‌پرواز ۱۸ رویدادی در برابر کلید ضبط ثابت‌شده اعتبارسنجی شد و نقطه کنترل حفظ شد. - تست‌های ضبط نهایی 114 مورد را روی CI ویندوز و لینوکس با Chromium/FFmpeg واقعی با موفقیت پشت سر گذاشتند. پنج تست لنگر و بررسی‌های هشدار وابستگی نیز با موفقیت انجام شدند. راه‌اندازی اولیه با 2 vCPU/4 GiB به دلیل بار همزمان ساخت ایمیج (image-build) با خطای زمان‌بندی (timed out) مواجه شد و از طریق گارد متوقف گردید؛ این مورد به عنوان موفقیت محسوب نمی‌شود. ورود دستی به حساب آزمایشی، خروج بومی چت، مقایسه ترکیبی واقعی و خروج از تلگرام از سمت تلگرام همچنان در انتظار انجام هستند. هیچ‌یک از جلسات تل‌تون (Telethon) ارائه‌شده وارد نشدند. پیوست‌ها، OCR خودکار، تأیید محلی drand BLS و گواهی Trusted Live TDX واجد شرایط نبودند. ## راه‌اندازی زنده Phala Cloud · ۴ نوامبر ۲۰۲۶ **نتیجه تاریخی:** پیاده‌سازی‌های بعدی همه را پشت سر گذاشتند 16 بررسی‌های اعتبارسنج، شامل Intel TDX و تونل سریع. شواهد راه‌اندازی مجدد، کشف آدرس امضا شده و زمان‌بندی‌های گزارش به‌طور جداگانه بررسی شدند. هر CVM آزمایشی پس از اجرای خود حذف شد. | راه‌اندازی | مقدار ثبت‌شده | | --- | --- | | ارائه‌دهنده | Phala Cloud · `tdx.small` · US-WEST-1 | | استقرار | `--provider phala --quick-tunnel`؛ فضای کاری در ابتدا خالی | | جمع‌آوری‌کنندهٔ اولیه | `df7d860c` · v0.8.1 | | کلکتیور با تمام اصلاحات | `53a0f7e9` | | مهمان تولید | `dstack-0.5.12`؛ دسترسی SSH غیرفعال است | | خدمات خارجی | ntfy.sh، گیت‌هاب و Intel PCS | | هزینهٔ مشاهده‌شده | هفت CVM، مجموعاً حدود 1.9 سنت آمریکا؛ قیمت‌گذاری آزمایشی تاریخی | ترتیب زیر، خطاهای اولیه، اصلاحات و بررسی‌های تکمیل‌شده را از هم جدا می‌کند. هیچ حساب تلگرامی به این CVMها متصل نبود. **پیاده‌سازی‌ها 1–2 · تفاوت‌های ارائه‌دهنده و بررسی‌های پسرگشتی** The first two deployments found five differences from the simulated Phala Cloud. Private Phala regressions reproduce each difference and fail without its fix: | در Phala Cloud | قبل از رفع مشکل | رفع مشکل | | --- | --- | --- | | `compose_file.name` مورد نیاز است | HTTP 422، هیچ چیزی ایجاد نشد | پیکربندی Docker Compose نام CVM را حمل می‌کند | | مگر اینکه یک مقدار خالی داده شود، Phala اسکریپت پیش از راه‌اندازی خود را به app-compose اندازه‌گیری‌شده اضافه می‌کند (نسخه 0.0.20: ورود به داکر، `docker compose pull`، رمز عبور ریشه، کلیدهای SSH از `user_config`) | `tdx_compose` شکست می‌خورد: کد خارج از پیکربندی منتشرشده Docker Compose | app-compose مقدار `pre_launch_script` را روی `""` تنظیم می‌کند؛ Phala سپس آن را نادیده می‌گیرد | | بدون `image`، Phala، `dstack-dev-0.5.12`، نسخه توسعه را با دسترسی SSH فعال‌شده انتخاب می‌کند. | `server_state` شکست می‌خورد. تنها رکورد گواهی سخت‌افزاری در این تصویر تأیید شد؛ فقط رکورد ارائه‌دهنده و `tdx_os` آن را نشان می‌دهند. | راه‌اندازی، ساخت نسخه تولید (production build) از آخرین نسخه Phala، `dstack-0.5.12` را درخواست می‌کند. | | با غیرفعال بودن دروازه dstack، جزئیات CVM هرگز مقدار `instance_id` را دریافت نمی‌کند. | استقرار ۳۰ دقیقه منتظر می‌ماند و با شکست مواجه می‌شود | شناسه نمونه از وضعیت CVM خوانده می‌شود. | | راه‌اندازی مجدد، توقف و راه‌اندازی، عملیات CVM هستند، نه بازنگری‌های برنامه. | `provider_actions` راه‌اندازی مجددها را فهرست نکرد. | عملیات خواندن نیز در نظر گرفته می‌شوند | **پیاده‌سازی 3 · تأیید، بررسی دسترسی و شواهد راه‌اندازی مجدد** - CVM با `dstack-0.5.12` و دسترسی SSH غیرفعال اجرا شد. کالکتور حدود ۱.۵ دقیقه پس از ایجاد، آدرس امضا شده خود را ارسال کرد. سپس Deploy، `tdx_binding` و `tdx_quote` (Intel TCB UpToDate، رکورد گواهی سخت‌افزار v4، FMSPC `20a06f000000`، در حالت اشکال‌زدایی نیست، قابل مهاجرت نیست، پشتیبانی از داده‌های تأیید رمزنگاری استخراج‌شده از اینتل)، `tdx_compose_hash`، `tdx_compose` (بایت به بایت) و `tdx_identity` (کلیدهای KMS). - پنل در آدرس trycloudflare.com خود، بدون توکن یا با توکن اشتباه، پاسخ ۴۰۱ و با توکن پنل، پاسخ ۲۰۰ داد. - `verify` با `--source` که روی آرشیو گیت‌هابِ کامیت تنظیم شده بود و اثر انگشت به‌صورت جداگانه ارسال شد: سرور، `server_state`، فایروال (بدون گیت‌وی، بدون نقطه پایانی عمومی)، لاگ ارائه‌دهنده، بیانیه، اثر انگشت، هش منبع، بوت و پنج بررسی `tdx_*` با موفقیت انجام شد. Cloudflare و `tdx_os` در دسترس نبودند، بنابراین نتیجه ناقص بود. - دو بار راه‌اندازی مجدد از طریق API فالا: هر بار که CVM با همان کلید گردآورنده، یک آدرس امضا شده جدید و پاسخ ۵۳۰ از آدرس قدیمی، در کمتر از دو دقیقه بازگشت. `verify` بوت جدید و هر دو راه‌اندازی مجدد را به عنوان REVIEW گزارش کرد. با `--evidence`، امضاهای ژورنال و سه راه‌اندازی تأیید شد، که هر کدام دارای رکورد گواهی سخت‌افزاری Intel TDX مخصوص به خود از همان CVM بودند. - `destroy` فقط آن CVM را حذف کرد. سپس فضای کاری خالی شد و آدرس پنل دیگر پاسخی نداد. - بررسی قیمت ویزارد پنل، `tdx.small` را با نرخ ۰.۰۵۸ دلار در ساعت خواند. یک کلید اشتباه، پیام ساده‌ی «کلید API پذیرفته نشد» را دریافت کرد. **اصلاحات پیگیری · کشف آدرس امضا شده و اندازه‌گیری‌های سیستم‌عامل** - Without the address key, `verify` followed the newest well-formed post on the address topic, which is printed in the published compose. One forged post sent it to a host that does not exist, and `statement` failed: a forger could not pass as the collector, but could block third-party verification, for up to 12 hours with a forged future timestamp. The collector now also posts its address signed with its own key, `verify` accepts only such posts when the collector makes them, and posts are ordered by ntfy.sh's receive time. A private cloud-wizard regression replays the forged posts. A CVM runs this only from a commit that contains it, so this run's collector did not sign its address yet and `verify` said so. - `tdx_os` بدون `dstack-mr` که نسخه فعلی آن به جای `measure --json` که در مستندات نام برده شده، از `measure-os` استفاده می‌کند، قادر به اجرا نبود. اکنون اعتبارسنج، MRTD و RTMR0-2 را خود از روی ایمیج منتشر شده و شکل VM، شامل جداول ACPI، محاسبه می‌کند. **راه‌اندازی 4 · تمام 16 بررسی، مهرهای گزارش و تأیید راه‌اندازی مجدد** - Deploy یک‌بار `dstack-0.5.12` منتشرشده را دانلود کرد، آن را با هش تصویر سیستم‌عامل که CVM گزارش کرده بود مطابقت داد، و `tdx_os` تأیید شد: MRTD، RTMR0، RTMR1 و RTMR2 با مقادیر محاسبه‌شده برای QEMU یکسان بودند. 8.2.2، 1 vCPU و 2 GiB. همان محاسبه، مقدار متفاوتی برای RTMR0 را برای ادعای 4 GiB، 2 vCPU، QEMU 9.2.1 یا یک کارت شبکه دوم، نشان داد و برای کرنل، فریمور یا خط فرمان تغییر یافته و برای ایمیج توسعه، ناموفق بود. - `verify` هر ۱۶ بررسی خود را، از جمله کانکتور تونل سریع، با موفقیت پشت سر گذاشت، بنابراین نتیجه PASS بود. این گواهی HTML و PDF را نوشت که با امضاها و مهرهای زمانی، با یک مهر زمانی معتبر eIDAS از واحد زمان‌بندی دولت بلژیک TSU 202301 (وضعیت تأیید شده در لیست مورد اعتماد بلژیک)، یک مهر زمانی FreeTSA و امضای راستی‌آزما، مهر و موم دیجیتال شده بود؛ `check-report` همه آنها و امضای PDF را تأیید کرد. - پس از راه‌اندازی مجدد، `verify --evidence` دو راه‌اندازی را تأیید کرد، هر یک همراه با گواهی سخت‌افزاری تولیدشده درون CVM و هر یک از `dstack-0.5.12` منتشرشده بوت شده بود؛ راه‌اندازی مجدد و بوت جدید تحت بررسی بودند. - `destroy` فضای کاری را خالی رها کرد. **پیاده‌سازی 5 · کشف امضاشده توسط کلکسیونر و رد پست جعلی** مجموعه‌کننده از commit `53a0f7e9` اجرا شد که شامل اصلاحات فوق است. - کلکسیونر آدرس امضا شده با کلید خود را، در کنار پست HMAC اپراتور، منتشر کرد. سپس دو پست جعلی به موضوع اضافه شدند: یکی با HMAC صفر شده و دیگری امضا شده با یک کلید Ed25519 دیگر، که هر دو مدعی زمانی در سال ۲۰۹۶ بودند. `verify` آدرس امضا شده توسط کلید گردآورنده را برداشت و از هر ۱۶ بررسی سربلند بیرون آمد؛ مهر بار دیگر حاوی مهر زمانی معتبر بلژیکی، مهر زمانی FreeTSA و امضای راستی‌آزما بود، و `check-report` آنها را تأیید کرد. - پس از یک راه‌اندازی مجدد، جمع‌آورنده آدرس جدید امضا شده را ارسال کرد: `verify` آن را بلافاصله پیدا کرد، اپراتور **آدرس فعلی را پیدا کرد** ۲۷ ثانیه بعد از ارسال HMAC، و هر دو ارسال‌های جعل شده را نادیده گرفتند. `verify --evidence` دو راه‌اندازی را که از `dstack-0.5.12` بوت شده بودند تأیید کرد. - ابزار استقرار چاپ کرد که فالا از CVM چه مبلغی، شامل هزینه دیسک، دریافت می‌کند: $0.06078 در ساعت. ### جادوگر پنل و دامنهٔ باقی‌مانده ویزارد پنل دو بار روی Phala Cloud اجرا شد، یک بار از طریق API وظیفه آن و یک بار از طریق مرورگر با یک کرومیم واقعی: بررسی قیمت، ایجاد با commit تحت **Advanced**، گذراندن هر شش بررسی احراز هویت، لیست سرور که قیمت صورتحساب شده (۴۴.۳۷ دلار در ماه) را نشان می‌دهد، **Find آدرس فعلی**، دانلود پیکربندی اندازه‌گیری‌شده Docker Compose و حذف آن. مرورگر هیچ خطای صفحه‌ای را مشاهده نکرد. هر بار پس از آن، فضای کاری خالی بود. موارد زیر پوشش داده نشده‌اند: یک دامنه کلودفلر روی فالا، یک حساب تلگرام روی CVM، و ایمیج `dstack-0.6.1`. قیمت ویزارد قبل از ایجاد، فقط قیمت محاسباتی فالا است، زیرا API آن فقط قیمت دیسک را برای یک CVM موجود اعلام می‌کند؛ لیست سرورها قیمت صورتحساب‌شده پس از ایجاد را نشان می‌دهد. تمام قیمت‌های این بخش در تاریخ 4 نوامبر 2026 مشاهده شده‌اند. ## فهرست دفترچه سرور زنده · 1 نوامبر 2026 در حدود ساعت 19:15 به وقت جهانی (UTC)، پرس‌وجوهای `query_only` در SQLite (خواندنی-تنها و متوالی) رویدادها را در ده پایگاه‌داده فضای کاری روی یک سرور در حال اجرا شمارش کردند. جمع‌آوری داده‌ها در حین پرس‌وجوها ادامه داشت، بنابراین این یک نمای کلی اتمی در سراسر فضاهای کاری نیست. | مشاهده‌شده در ده پایگاه‌داده فضای کاری | شمارش | | --- | --- | | فضاهای کاری با حداقل یک رویداد `message.new` | 8 | | سوابق مجله، شامل رویدادهای عملیاتی | 1,610,818 | | رویدادهای `message.new` | 900,232 | | رویدادهای `message.edited` | 80,683 | | رویدادهای `message.deleted` | 400,536 | | رویدادهای `message.recovered` | 53,403 | | رویدادهای `message.snapshot` | 2,183 | | رویدادهای `media.saved` | 50,418 | | رویدادهای `media.failed` | 5,575 | | رویدادهای `coverage.gap` | 11 | | بایت‌های پایگاه داده، به جز فایل‌های WAL و رسانه‌ها | 7,909,003,264 | این‌ها هستند **شمارش رویدادها**، نه پیام‌های منحصربه‌فرد، افراد یا فایل‌های رسانه‌ای. یک پیام یکسان می‌تواند در بیش از یک فضای کاری ظاهر شود، و ویرایش یا حذف می‌تواند یک رویداد مجله (journal event) دیگر ایجاد کند. `media.failed` رویدادهای خرابی تاریخی را می‌شمارد، نه صف رسانه‌ای فعلی را. پرس‌وجوها انجام دادند **نه** امضاها و زنجیره کامل هش تمام 1,610,818 سوابق، اندازه‌گیری تحویل یا پهنای‌باند، یا اثبات اینکه هر رویداد تلگرام ثبت شده است. هیچ‌گونه محتوای پیام، شناسه حساب کاربری یا چت، برچسب‌های فضای کاری، اعتبارنامه‌ها یا فایل‌های خصوصی در اینجا منتشر نمی‌شوند. در این بازبینی، مانیتور عمومی که به طور جداگانه پیکربندی شده بود، سه منبع را پوشش داد: یک پاسخ ضبط OK بود و دو مورد `no_response` گزارش کردند. آن مانیتور خلاصه وضعیت سلامت ده فضای کاری نیست. `no_response` به این معنی است که ناظر نتوانست در آن بررسی پاسخی دریافت کند؛ این امر به معنای از دست رفتن پیام نیست. تست کوچکتر 29 اکتبر در زیر، امضای صریح و تأیید زنجیره هش خود را دارد. ## بررسی‌های آفلاین و تزریق خطا اخیر · 1 نوامبر 2026 این بررسی‌ها از داده‌های فرضی و فایل‌های محلی استفاده می‌کنند؛ آن‌ها شواهد رگرسیون را برای منبع فعلی اضافه می‌کنند، نه برای اندازه‌گیری دیگری از تحویل زنده تلگرام: | بررسی | آنچه اجرا شد | | --- | --- | | Source archive | دو بیلد با بایت‌های منبع یکسان اما زمان‌های فایل تغییر یافته، ZIP و چک‌سام یکسانی تولید کردند. بایت‌های بایگانی دقیق و هش‌های فایل مطابقت داشتند؛ فایل‌های تست خصوصی خارج ماندند. یک خطای نوشتن شبیه‌سازی‌شده، آرشیو و چک‌سام قبلی را دست‌نخورده باقی گذاشت. | | Account export recovery | یک خطای دیسک شبیه‌سازی‌شده روی دومین عضو ZIP هیچ فایل ZIP منتشرشده یا جزئی از آن را باقی نگذاشت. Resume هر رسید امضا شده را از نظر بایت‌ها یکسان حفظ کرد، یک آرشیو قابل تأیید مستقل با استفاده از اثر انگشت امضای مورد انتظار تولید کرد و شکاف پوشش مصنوعی را به‌عنوان یک نتیجه جزئی حفظ نمود. ادعاهای مقیاس‌پذیری در برابر اسکن‌های مکرر وظایف و رسیدها با رشد تاریخچه‌ها محافظت می‌کنند. | | Minimized disclosure privacy | نام‌ها و مستعارهای یونیکد ساختگی، متادیتای درهم‌تنیده، فرستندگان ناشناس و فیلدهای رسانه‌ای در هر سه حالت هویت و با حذف متن بررسی شدند. خطای محدودیت ماسکینگ به‌طور پنهانی سانسور را تضعیف نکرد؛ خروجی امضاشده حساب اصلی بدون تغییر باقی ماند. | | Linux media decoder and OCR | یک [بررسی CI با Docker لینوکس](https://github.com/phishdestroy/TgWitness/actions/runs/41341200341/job/124951395192) در commit `5a9e0814` با موفقیت انجام شد: تولید ورودی‌های Ogg/Opus، MP3، M4A، MP4 با ویدئو، WAV و FLAC؛ کنترل‌های مدت‌زمان جعلی و ارجاع فایل ثانویه؛ و fixtures پارسر تغییر‌یافته 48 (34 رد شد، 14 در محدوده رمزگشایی شد). OCR واقعی Tesseract با بیت‌های اصلی بدون تغییر اجرا شد. دکودر و OCR در کانتینرهای ایزوله شبکه بدون مدل Whisper اجرا شدند. | این بررسی‌ها در [درخواست‌های کش (pull-request)](https://github.com/phishdestroy/TgWitness/blob/main/.github/workflows/pr-check.yml) و گردش کارهای [کامل بررسی (Checks)](https://github.com/phishdestroy/TgWitness/blob/main/.github/workflows/checks.yml) اجرا می‌شوند. آن‌ها این مرزهای شکست را آزمایش می‌کنند، نه هر شکست احتمالی در ذخیره‌سازی یا اینکه آیا یک افشاگری به‌طور خودکار برای انتشار ایمن است یا خیر. بررسی رسانه، دقت تشخیص گفتار یا تحویل تلگرام را اندازه‌گیری نمی‌کند. هر مشتق را پیش از اشتراک‌گذاری بازبینی کنید. ## آزمایش زنده تلگرام، کل حساب · ۲۹ اکتبر ۲۰۲۶ همان حساب کاربری پس از تست زیر همچنان فعال بود. در ۲۹ اکتبر ساعت ۱۲:۱۰ به وقت جهانی، دامنه آن به کل حساب کاربری (کانال‌ها، گروه‌ها، چت‌های خصوصی و ربات‌ها) تغییر یافت؛ پنل درخواست تأیید کرد و دفترچه ثبت‌شده امضا شده آن را ثبت نمود. تا ساعت ۱۷:۵۹ به وقت جهانی، دفترچه حاوی موارد زیر بود: | ثبت‌شده، ۲۷ اکتبر ۲۱:۳۶ تا ۲۹ اکتبر ۱۷:۵۹ به وقت جهانی | شمارش | | --- | --- | | سوابق دفترچه | 9,968 | | پیام‌های جدید | 5,308 | | از آن‌ها پس از تغییر به کل حساب | 3,878 | | حذف‌ها | 784 | | از آن‌ها پس از اینکه TgWitness پیام را ذخیره کرده بود، حذف شدند | 596 | | ویرایش‌ها | 41 | | پیام‌های اضافه شده توسط بازبینی مجدد | 2,273 | | پیام‌هایی که دیگر قابل بازیابی نیستند | 18 | | پیام‌ها با اسنپ‌شات‌های تاریخچه ذخیره می‌شوند | 242 | | پیوست‌های ذخیره‌شده | 247 | | شروع جمع‌آوری | 19 | | Telegram FloodWait مکث می‌کند | 26 | - بررسی **Verify** پنل، امضاها و زنجیره هش تمام ۹٬۹۶۸ رکورد را تأیید کرد. - پیام‌ها از ۲ گروه یا کانال و ۳ چت خصوصی و ربات‌ها ارسال شده‌اند. یک دکمه پیام در **چت‌ها** فشرده شد؛ درخواست و پاسخ تلگرام در دفترچه شواهد ثبت شده است. - چت‌های جدید هنگام اسکن مجدد حساب توسط جمع‌آورنده در هنگام راه‌اندازی مجدد اضافه شدند. ذخیره پیام‌های قبلی چت‌های جدید (`history = 0`) غیرفعال بود، بنابراین در اینجا پوشش داده نشده است. موارد پوشش داده نشده: واکنش‌ها، تغییرات عضویت، پروفایل افراد، ارسال پیام، پیوستن از طریق دعوت‌نامه، پروکسی‌ها، اعلان‌ها، ربات ویitness و چندین حساب به طور همزمان. فایل‌های عمومی فقط حاوی شمارش هستند. ## خروجی محافظت‌شده با رمز عبور با libarchive باز شد · ۲۹ اکتبر ۲۰۲۶ یک آرشیو که با کد رمزگذاری خروجی (WinZip AES-256، فرمت قابل‌خواندن توسط 7-Zip و WinRAR) نوشته شده بود، با Windows `tar` (bsdtar 3.6.2, libarchive) باز شد. با رمز عبور صحیح، فایل استخراج‌شده با SHA-256 اصلی مطابقت داشت؛ رمز عبور اشتباه با پیام «Incorrect passphrase» (عبارت عبور نادرست) رد شد. خود برنامه‌های 7-Zip و WinRAR اجرا نشدند. ## آزمایش زنده تلگرام · ۲۷ تا ۲۹ اکتبر ۲۰۲۶ یک حساب واقعی تلگرام که از طریق استخر جفت API داخلی وارد شده بود، یک ابرگروه را از **۲۷ اکتبر ساعت ۲۱:۳۶ به وقت جهانی تا ۲۹ اکتبر ساعت ۰۵:۱۵ به وقت جهانی** ضبط کرد. گردآورنده در آن دوره ۱۲ بار راه‌اندازی شد. | ثبت‌شده | شمارش | | --- | --- | | سوابق دفترچه، شامل ضربان‌ها و سوابق سرویس | 2,385 | | پیام‌های جدید | 1,291 | | حذف‌ها | 472 | | از آن‌ها پس از آنکه TgWitness متن را ذخیره کرده بود، حذف شدند | 347 | | ویرایش‌ها | 12 | | پیام‌هایی که هنگام توقف از دست رفته‌اند، توسط بازپروژه (recheck) اضافه می‌شوند | 12 | | پیوست‌های ذخیره‌شده | 17 | | پیوست‌ها دانلود نشده‌اند (دانلود غیرفعال است، یا فایلی برای دانلود وجود ندارد) | 14 | | Telegram FloodWait در حین بازبینی مجدد، هر بار به مدت ۳ ثانیه مکث می‌کند | 8 | - امضاها و زنجیره هش تمام ۲٬۳۸۵ رکورد با کلید عمومی دفترچه تأیید می‌شوند. - پس از راه‌اندازی مجدد، جمع‌آورنده از وضعیت به‌روزرسانی ذخیره‌شده (`pts`) از سر گرفته می‌شود و Telethon جبران می‌کند؛ سپس بازبینی دوباره پیام‌های هنوز مفقود را اضافه می‌کند. - در هر FloodWait، گردآورنده به مدت زمان درخواست‌شده صبر کرد و سپس ادامه داد. - حساب همچنان وارد شده باقی ماند و همان جلسه در ۲۹ اکتبر دوباره متصل شد. این تست شامل موارد زیر نمی‌شود: چندین حساب به طور همزمان، نقش‌های مدیر، پروکسی‌ها، قطعی‌های طولانی‌تر از چند ساعت و [رویه کامل پذیرش زنده](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md). فایل‌های عمومی فقط حاوی این شمارش‌ها هستند: هیچ شناسه حساب یا چت، پیام یا اعتبارنامه‌ای. ## اندازه‌گیری مصنوعی ظرفیت محلی Private synthetic capacity run: 10,000 events across 100 chats. | متریک | مشاهده‌شده | | --- | --- | | ورودی | ۱۰٬۰۰۰ رویداد پیام مصنوعی در ۱۰۰ منبع مصنوعی منتخب | | متن پیام | ۴۰۰ کاراکتر؛ بدون رسانه یا شبکه | | ورودی | ۵۳٫۲۷۳ ثانیه؛ ۱۸۷٫۷ رویداد در ثانیه | | تاخیر پردازشگر | p50 4.162 میلی‌ثانیه؛ p95 7.784 میلی‌ثانیه؛ حداکثر 129.118 میلی‌ثانیه | | خروجی زیپ | ۱۹٫۸۶۸ ثانیه با فعال بودن tracemalloc | | نقطه اوج تخصیص‌های خروجی پی‌thon ردیابی‌شده | ۰.۵۱ مگابایت؛ RSS پردازش نمی‌شود | | اندازهٔ فایل زیپ | ۴٬۶۱۰٬۹۶۲ بایت | | تأیید مستقل | تمام ۱۰٬۰۰۰ رویداد تأیید شدند | این ابزار مسیر محلی ضبط/صادرات سریالی را در این میزبان ویندوز اندازه‌گیری می‌کند. این ابزار اندازه‌گیری، تحویل MTProto، حساب‌های همزمان، محدودسازی تلگرام، رسانه‌ها، بار کاری طولانی‌مدت یا تعداد تضمین‌شده‌ای از چت‌های واقعی را انجام نمی‌دهد. این اندازه‌گیری مربوط به قبل از ابزارهای نهایی مهر و موم زمانی آفلاین است، که مسیر پیام اندازه‌گیری‌شده را تغییر نمی‌دهد. ## جستجوی متن کامل در یک میلیون پیام · ۵ نوامبر ۲۰۲۶ دستور: `python tools/bench_fulltext.py --messages 1000000 --work ` A deterministic signed journal of 1,000,000 synthetic messages in 200 chats (Russian word forms, Ukrainian, English, Chinese, Japanese, links and handles) was indexed in 71 seconds; the index took 58 MiB beside a 1.50 GiB journal. Best-match searches took 9 to 190 ms (median), against 2.4 to 3.2 seconds for the previous substring search. Full results, hardware and limits: [Full-text search](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/#benchmark). Private compatibility tests also verify a frozen signed archive made before full-text search with the current verifier, and a current archive with the frozen archive's own `verify.py`. ## صلاحیت‌های باقی‌مانده ژورنال زندهٔ نگهداری‌شده، ثبت واقعی جمع‌آوری، ویرایش‌ها، اعلان‌های حذف، پیوست‌ها، بازبینی‌های مجدد و مدیریت محدودیت نرخ را فراهم می‌کند. این ابزار سوابق جامع تحویل، ماتریس کنترل‌شده دیده‌بانی نقش‌ها، واکنش‌دهندگان، انتظار سیل طولانی‌مدت (FloodWait)، مسدودسازی حساب‌ها و بازیابی پس از وقفه شبکه/فرآیند را ثبت نمی‌کند. صدور توکن QR از تأیید QR موبایلی تکمیل‌شده مستقل است. بررسی‌های Docker/Compose و نصب در CI ثبت می‌شوند؛ استقرار واقعی Phala و تأیید زمان‌بندی خارجی در بالا توضیح داده شده است. این موارد بار بالا و پایدار، یک ماتریس کامل پلتفرم/نقش زنده، بازبینی امنیتی مستقل، اعتبارسنجی بایگانی بلندمدت یا گواهی قانونی را تضمین نمی‌کنند. وضعیت ذخیره شده MTProto و جبران وقفه پیاده‌سازی شده‌اند؛ اما بازپخش زنده اتمیک بدون از دست دادن اطلاعات هنوز پیاده‌سازی نشده است. کامیت‌های جدیدتر، پیام‌ها و کورسورها را به‌صورت اتمیک ارسال می‌کنند و اقدامات اخیر (Recent Actions) موجود را حفظ می‌کنند، اما پوشش ترکیبی آن با صلاحیت زنده متفاوت است. برای مشاهده ماتریس صلاحیت کنترل‌شده، به بخش [پذیرش زنده (live acceptance)](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md) مراجعه کنید. [زیرپوشه حسابرسی عمومی](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/README.md) فقط شامل گزارش امضا شده و اندازه‌گیری‌های تجمیعی است. رسیدهای عملیاتی تفصیلی، داده‌های خام و مطالب حساب کاربری خصوصی باقی می‌مانند. اسکرین‌شات‌های اپلیکیشن در `docs/assets/` از داده‌های نمایشی فرضی استفاده می‌کنند. --- # اعلان عدم سازگاری مجوز و معماری Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/license/ TgWitness تحت مجوز MIT برای همه است و چرا از نظر معماری با گردش کار Taylor Wessing ناسازگار است. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) TgWitness تحت مجوز MIT برای همه است و چرا از نظر معماری با گردش کار Taylor Wessing ناسازگار است. TgWitness تحت [مجوز MIT](https://phishdestroy.github.io/TgWitness/LICENSE) توزیع می‌شود. موضع ما هیچ شرطی به مجوز اضافه نمی‌کند. > یک امضا دروغ را به حقیقت تبدیل نمی‌کند. > > > > TgWitness برای شرکت‌ها، دفاتر حقوقی یا افرادی که معتقدند گذاشتن «دکتر» قبل از نام، هر آنچه را که پس از آن می‌آید، درست می‌کند، مناسب نیست. عناوین، سربرگ‌ها و امضاها بر شواهد ارجحیت ندارند. > > > > اگر گردش کار شما با نتیجه‌ای که موکل برای آن هزینه کرده است شروع می‌شود و نیاز دارید که سوابق به دنبال آن بیاید، در حال جستجوی ابزاری متفاوت هستید. TgWitness برای حفظ سوابق و در دسترس قرار دادن آن برای بررسی وجود دارد. > > > > بگذارید آن «پزشکان» به ترازنامه‌های مشتریان شرکتی خود رسیدگی کنند. یک عنوان، دروغ را درمان نمی‌کند. > > > > ریاضی مذاکره نمی‌کند. [سوابق منبع](https://phishdestroy.io/steam_dossier/taylor_wessing) · [اعلامیه اخلاقی و تداوم تاریخی](https://phishdestroy.github.io/TgWitness/fa/docs/reference/notice/) [مجوز کامل MIT](https://phishdestroy.github.io/TgWitness/LICENSE) · [پروژه](https://github.com/phishdestroy/TgWitness/blob/main/README.md) · [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [ویکی](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Home.md) --- # اعلان عدم سازگاری اپراتور Canonical page: https://phishdestroy.github.io/TgWitness/fa/docs/reference/notice/ اطلاعیه اپراتور ما درباره تیلور وسینگ و رکورد منبع آن. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) اطلاعیه اپراتور ما درباره تیلور وسینگ و رکورد منبع آن. **PhishDestroy · اطلاعیه پروژه TgWitness** [سوابق منبع](https://phishdestroy.io/steam_dossier/taylor_wessing) · [اعلان اصلی](https://phishdestroy.github.io/TgWitness/NOTICE) ## ⚖️ اطلاعیه اخلاقی و تداوم تاریخی ما اخیراً مطلع شده‌ایم که برای برخی از شرکت‌های حقوقی—و به‌ویژه دکتر توبیاس شلینسکی و دکتر پاتریک وینسنت زورهیده—ریاضیات و حقایق عینی بی‌ربط هستند. فروختن عدم انطباق با GDPR به شرکت‌ها به‌عنوان یک سرویس تجاری، در حالی که خودتان در مدیریت داده‌های پایه ناکام هستید، تخصص حقوقی نیست. عمل کردن تحت این توهم که شما خود قانون هستید، یا اینکه امضای یک فرد برجسته بر ادعایی جعلی به طور جادویی دروغ را به حقیقت تبدیل می‌کند، ناتوانی فنی را پنهان نمی‌کند. این ابزار با حوزه‌های قضایی که موارد زیر در آن‌ها حاکم است، سازگار نیست: - شرکت‌سالاری - عدالت خصوصی‌سازی‌شده یا تجاری - پلوکراسی - دزدی‌سالاری و فساد نهادی اشاره‌ای ویژه به دکتر پاتریک زورهیده، دکتر توبیاس شلینسکی، و کسانی که تلاش می‌کنند از «حق فراموش شدن» به عنوان سلاحی برای پنهان کردن شکست‌های پردازش داده‌های خود، پاکسازی سوابق نهادی‌شان و محو کردن سوابق تاریخی استفاده کنند: > تیلور وسینگ (دکتر توماس شلینسکی و دکتر پاتریک وینسنت زورهیده) → وسینگ و برنبرگ-گوسلر → استون‌وال ۱۰۰ برتر → دکتر گراف فون در گولتز دکتر وسینگ و شریک (از سال ۱۹۵۷) → رودایگر گراف فون در گولتس → ماده ۱۷۵ در اصلاحیهٔ ۱۹۳۵ خود برای رعایت دقیق مجوز MIT، ما استفاده از این نرم‌افزار را محدود نمی‌کنیم. با این حال، باید روشن باشد: قراردادهای حقوقی بلندمدت، ارعاب قانونی و درخواست‌های حذف دیجیتال نمی‌توانند تاریخ را تحریف کنند، نسب را بازنویسی نمایند یا حقیقت را پنهان سازند. [مجوز MIT](https://phishdestroy.github.io/TgWitness/LICENSE) · [موضع ما در مورد تیلور وسینگ](https://phishdestroy.github.io/TgWitness/fa/docs/reference/license/) · [مدل مدرک](https://phishdestroy.github.io/TgWitness/fa/docs/reference/how-it-works/) [پروژه](https://github.com/phishdestroy/TgWitness/blob/main/README.md) · [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [ویکی](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Home.md) --- # TgWitness Changelog & Release Notes Canonical page: https://phishdestroy.github.io/TgWitness/docs/reference/changelog/ Read TgWitness changes by version, including unreleased work. Check release notes before assuming a source feature is included in an installed package. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/llms.txt) Translation coverage: this edition includes material from the English original. هر تغییر در هر نسخه، از جمله تغییراتی که هنوز منتشر نشده‌اند. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Documentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Project reference](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Project reference](https://phishdestroy.github.io/TgWitness/assets/chapter-project.svg) **On this page** - [Unreleased](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/#unreleased) - [0.9.1 preview · 5 November 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/#091-preview--5-november-2026) - [0.9.0 preview · 4 November 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/#090-preview--4-november-2026) - [0.8.1 preview · 2 November 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/#081-preview--2-november-2026) - [0.8.0 preview · 2 November 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/#080-preview--2-november-2026) - [0.7.1 preview · 1 November 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/#071-preview--1-november-2026) - [0.7.0 preview · 31 October 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/#070-preview--31-october-2026) - [0.6.1 · 27 October 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/#061--27-october-2026) - [0.6.0 · 27 October 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/#060--27-october-2026) - [0.5.1 · 27 October 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/#051--27-october-2026) - [0.5.0 · 26 October 2026](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/#050--26-october-2026) ## Unreleased - Isolate request-body capacity and token-family lockouts, set Secure download cookies behind trusted HTTPS proxies, limit pending tickets per access, and expose journal write failures. - Add an English Secret Chat demo with fictional requests, replies, attachments and retained deletion notices. Document the separate development implementation and its open defects; the demo does not enable Telegram connections. - Remove the unused one-shot exporter and check recovery against the current exporter. Reject unexpected or repeated message IDs in recheck responses. - Combine concurrent exports with resumable Standard API and Takeout acquisition. Each job retains its own progress, timings and signed checkpoints; accounts remain reserved until that job stops. Include the account controls, batch import and report-verification updates in the same build. - Add offline `VERIFY.cmd` / `VERIFY.sh` launchers, plain-language verification explanations and saved UTF-8 transcripts to signed exports in all 25 panel languages. Build a separate Windows verifier with an embedded runtime and a language menu. Unpinned signers remain unconfirmed; successful integrity verification does not establish admissibility. - Add optional jurisdiction guidance for 25 countries to Report Studio and exported assessments, with separate civil/criminal sources, local-language summaries and next steps derived from the actual package. Guidance remains a research draft, does not raise assurance, and is excluded from reusable layout profiles and inherited sharing-copy settings. - Allow the pinned Russian morphology dictionary resources in Windows portable builds while continuing to reject unrecognized files in dependency data directories. - Keep missing-on-recheck observations separate from deletion notices in HTML, JSON and PDF counts and viewer labels. Do not claim unscoped deletion IDs were never saved when their chat is outside the current observation scope. - Record multiple deleted IDs as a deletion batch without inferring a whole-history clear, the deleting participant, or deletion for everyone. Relabel legacy history-clear events without changing their signed records. - Publish the one-command installer only after application and security checks pass for the exact main commit and the signed package passes Ubuntu local/HTTPS service and Windows PowerShell acceptance. Keep the previous download when checks fail or time out. Add authenticated tests of the actual public installer URLs. - Preserve `previous_hash` in the signed-record preview even when its hexadecimal digits resemble a payment card number. Secret masking still applies to message content; the stored record is unchanged. - Reconstruct compact chat snapshots consistently in MCP, retain unknown fields, and distinguish capped lists from removals. Resume date scans, preserve topic names across history reads, and bound image previews. Apply metric choices to filtered reports and count historical service messages separately. - Plan sealed exports against the remaining session time, offer smaller selections, update progress estimates and reserve time for packaging. - Compare every message field, validate record counts and structure, enforce CLI verification options, and display OpenTimestamps states separately. - Close coverage on worker failure, bind heartbeats to the capture run, and verify TDX signing-key binding and supported component statuses. - Add read-only MCP tools (preview): `get_messages_by_date` (one calendar day in a named time zone, computed server-side), `get_pinned_messages`, `get_chat_stats` with `gap_summary`, `get_topics`, and `get_media`, which returns a verified, downscaled image preview anchored to its SHA-256 and `media.saved` record. Every MCP tool now declares an output schema. New connections include these tools; existing connections keep the tools they were issued with. - Show each account's selected route and checked exit address, group session controls, and retain interface preferences when adding an account. Record connection changes without repeating identical background checks. Validate withheld-marker contents and reply states in minimized exports, including rejection of a missing-source label for an included record. - Update collection-mode instructions and Russian guidance. Allow a bounded publication-settling interval while requiring exact installer bytes. - Mark messages left out of a minimized disclosure (preview): inside each disclosed chat, withheld messages appear as content-free markers naming the selection rule, one per run or one per message, and disclosed replies state whether they answer a disclosed message, a withheld one or one that is not in the source export. The package format becomes `tgwitness-account-disclosure-v2`; `verify.py` rejects markers with content and replies pointing at missing records, and still verifies version 1 packages. - Repeat gap analysis with the settings carried by the signed export, count each service-message number once, and bound account estimates to the measured interval. Require explicit whole-account scope, retain pause/resume boundaries, and interrupt expensive archive scans at their time budget. - Add missing message numbers (preview): `coverage.json`, the HTML and PDF reports, `verify.py` and the archive's `get_capture_status` measure numbers Telegram assigned and this collector never saw, per channel or supergroup and for the account-wide sequence of private chats, bots and ordinary groups during whole-account collection. Each result states whether it applies and why, lists its parameters, and anchors listed gaps to the neighbouring observations. **Parameters → Gap analysis** sets the listed gaps, the account-wide sequence and an optional service-message estimate that is never subtracted. A gap names no actor and no reason. - Record in the signed message when self-destructing media is fetched despite a type or duration rule (`media_capture.rule_override`), with the limits that still applied. - Add chat-state snapshots (preview): while observing, every enabled source is read periodically and saved as a signed `chat.state` record with title, description, counts, pinned messages, administrators with rights, and gifts on channels and profiles, plus the differences from the previous snapshot. Unpinning, rights changes and gift conversions or upgrades without a service message become visible. Parts Telegram refuses are named and carried forward, never reported as removed. **Parameters → Chat state** sets the interval, pause and parts. - Add anomaly indicators to evidence reports (preview) as registered, versioned processors in `tgwitness/metrics/`: first-time posters per day with flagged injection-like days, service messages among message numbers, joins and departures per month, and pins and unpins per month. Reports list every processor that ran with its version and print its method; **Parameters → Report metrics** chooses them. - Keep ranked-search pages within the first 1,000 results regardless of page size, order OCR/transcription results before pagination, and retain exact match positions when Unicode expansions and invisible-character removal cancel each other's length changes. - Keep photo downloads on the still variant named by their metadata and hash manifests, including after file-reference renewal. Reject truncated photo/chat attachments and corrupt reused files instead of counting them as saved. Check recovered multi-account message IDs against missing intervals without expanding large gaps. - Release a session's local connection lock after transport shutdown, including when a disconnected client was already removed from the workspace. Cancelling the waiting operation cannot release the lock early, and closing an older session cannot unlock a different current key. - Apply a chat export's skip/hash-only choice to recovered messages and profile photos, and record that choice in the acquisition metadata. Reject changed messages before fetching attachments in the separate files stage. Count missing message numbers as intervals so sparse histories do not exhaust memory, including during a cancellable full recheck. - Preserve available self-destructing photos, videos and files in the API journal with a dedicated immediate queue, explicit TTL/view-once labels and signed saved/unavailable/not-saved outcomes. Block read receipts in the API client, including batches and wrapped requests. Keep byte limits, disk reserves and Telegram backoff; saved bytes do not establish human viewing. - Preserve image-rendered Unicode emoji in official Web message text, reply previews, reactions and derived page text without changing the client DOM. A live account test exposed the omission; video and saved pages already retained the image. - Improve chat-export Takeout, unreadable-message recovery, shared absent-number rechecks and bounded range retries. Preserve observed deletions in export scope, compare verified archives, and distinguish archive integrity from an independently confirmed signer. - Protect imported sessions from remote logout, close idle connections and prevent simultaneous reuse of a session key. Add explicit session management and masked two-step password entry; cancellation or switching workspaces prevents submission. Read single-account export messages before their separate attachment stage. - Keep source export and AI actions disabled while local source search is pending, empty or has failed; clear stale previews before the next search. Exercise delayed replies explicitly in browser checks. - Use unambiguous synthetic privacy identifiers and report the exact marker/context on handover-test failures, avoiding accidental matches inside report metadata. - Add an in-panel comparison of collection methods and explain account task ownership beside full-history controls. Refresh source-version badges, qualification records and Trusted Live network results; check version labels before publication. - Add [full-text search](https://phishdestroy.github.io/TgWitness/fa/docs/reference/search/) (preview): Russian and Ukrainian word forms, English stems, Chinese and Japanese phrases without spaces, exact phrases, domains in hidden links and buttons, @usernames, wallets and phones, filters for chat, sender, message ID and observation period, ranked with BM25. The index is derived from the signed journal, bound to its latest record hash, never exported, and can be kept on disk, in memory only or turned off. Recognized text is indexed in memory only and labelled as machine recognition. - Ask the archive retrieves the best matches from the full-text index when it is complete, keeps the 24-source limit, and cuts long texts around their match. MCP `search_messages` accepts `ranked=true`. - Add `tgwitness index status|rebuild` with JSON output on stdout and stable exit codes. - Fix ranked search paging: `next_offset` is now returned when more matches exist, through `/api/search`, MCP `search_messages` and Ask the archive's partial marker. Paging stops at the first 1,000 results. - Fix Ask the archive failing on questions longer than 24 words or 200 characters. The full-text query keeps the question's first distinct words; a query the index cannot read falls back to exact-text retrieval. - Centre excerpts on the match in long texts that hide zero-width characters between letters. - Build the website when a language lacks new translations: untranslated blocks stay in English with the page notice and are listed by the build. - Add the [command line](https://phishdestroy.github.io/TgWitness/fa/docs/reference/cli/) (preview): `tgwitness search`, `context`, `messages`, `stats` and `export` with `--json` and stable exit codes, reading a stopped workspace directly or a running panel through a scoped, revocable archive connection. Add `.agents/skills/tgwitness-cli/SKILL.md` for agents. - Add the `get_activity_stats` archive tool, also offered over MCP: messages by UTC hour and weekday, peak days, edit and deletion shares, senders, domains and @handles, with coverage gaps. Computed on request, not stored. - Add the `export_messages` archive tool for the command line: saved observations streamed as JSON Lines in journal order, with full text and a completion record. It is granted only when selected; existing connections keep the tools they were issued with. - Recheck archive access before every streamed record, including completion. Revoked or expired connections end without a completion record; lazy export reads share the archive worker limit and timeout. - `tgwitness index` and the new commands find the data directory of the installation that runs them. ## 0.9.1 preview · 5 November 2026 - Keep message and attachment outcomes visible after single-chat sealed capture, including missing data, failed files and unfinished downloads. Translate final status when changing language after shutdown, and clear connection or export errors once they recover while retaining rejected-action and unconfirmed-revocation warnings. - Update the pinned OAuthLib dependency to 4.0.1 for CVE-2026-49272 and regenerate the runtime, browser and MCP hash locks. - Show in-flight attachment bytes without counting them as preserved evidence, reset progress on retries and clear it on pause. Keep official-client chat controls disabled during QR/2FA login and until a chat is available. Explain that Takeout approval requires another previously signed-in device. Bound CI dependency installation and avoid the stalled Azure package mirror. - Add explicitly selected direct networking for official Web capture through GitHub Actions. Proxy remains the default and never falls back to direct. The panel and signed verification report disclose direct IP exposure, and verification rejects a mismatch between the selected route and the hosted network. - Add an optional official Telegram Web observation mode with passive or sequential paced viewing, a fresh profile, restricted UI actions, login-excluded video and signed rendered observations. A required proxy bridge prevents direct fallback; exit changes stop recording. The GitHub Actions mode uses the approved sealed workflow and recipient encryption. - Bind official recordings to independently saved source/settings, check video segment order and clean endings, record fresh drand rounds and support independent public-relay comparison. Report unfinished procedures, unconfirmed logout and the limits of local or Cloudflare assurance explicitly. See [Official client witness](https://github.com/phishdestroy/TgWitness/blob/main/docs/OFFICIAL-WITNESS.md) for scope and validation. - Add opt-in Trusted Live preview: isolated official Desktop/Web sessions, native JSON preservation, guarded visual recording, per-chat continuity annotations, and verifier-recomputed reports. Supply a Linux network guard with no direct fallback, periodic proxy-routed drand observations, and optional independent read-only Cloudflare samples. Account/WARP/TDX qualification remains pending; see `docs/TRUSTED-LIVE.md`. - Make sealed export modes explicit: Telegram Takeout by default, regular API account export, or a single-chat event journal, with differences and limits shown before collection. Select multiple chats, save agreed settings, verify them with `--expected-selection`, and reject incomplete account exports with `--require-complete`. Correct the outdated one-chat-only hosted documentation. - Preserve signed message pages before requesting files or hashes. Resume from frozen history, retain completed attachments, and finish an interrupted export with explicit gaps when time or disk is limited. - Add Telegram Desktop compatible JSON/HTML views alongside authoritative signed data. GitHub capture supports full-account and selected-chat exports through regular API or Takeout, with chat types, dates and media settings. - Deliver large GitHub archives in encrypted parts with a signed, attested manifest and verified local assembly. Remove the fixed 4 GiB delivery failure without omitting preserved evidence. - Retry transient pinned OCR source downloads without relaxing checksum checks. Retry brief Windows file-sharing failures when saving private state. - Configure account exports before collection: select chats and media types, exclude avatars by default, and choose downloads, Telegram range hashes or metadata only. Keep a shared attachment budget and record incomplete files explicitly. - Show Takeout approval requirements and retry deadlines before collecting; check approval again without replacing the waiting session. Phone, QR and existing-session login retain their own authorization flow. - Save Telegram-provided SHA-256 ranges with file representation and data-center metadata. Compare them against locally supplied files; Telegram identifiers and access hashes are not treated as content hashes. - Collect message history across selected chats before processing attachments when messages-first mode is enabled. Preserve the journal in a compact export when full HTML or attachment packaging exceeds the remaining capacity. - Stream sealed delivery encryption without a second full plaintext archive. Remove interrupted ciphertext, preserve the original evidence for retry, and keep capture deadlines across runner steps with time reserved for delivery. - Require sealed-container validation in the release workflow. Phala deployment status now distinguishes verified, incomplete and review-required attestation instead of inferring trust from the provider name. - Validate every sealed-container build input against its pinned source. Retry transient package downloads up to three times while retaining signature, SHA-256 and exact-package checks before offline installation. - Include the hash-export configuration examples in source archives and preserve the translated documentation and required site assets from the latest main revision. - Keep the current tunnel address when an older signed address post is replayed. Signed posts are ordered by their signed time; unsigned posts use the relay's receive time. - Trust only the Caddy proxy on the private Docker HTTPS network and normalize client addresses for authentication limits. - Keep operator IP addresses out of new signed access events, hide administrative payloads from shared views, and enforce workspace and export ownership boundaries. - Reject duplicate JSON keys, prepended ZIP content and HTML injected into report seals; distinguish pinned witness keys from pinned collector keys. ## 0.9.0 preview · 4 November 2026 - Reserve each account exclusively for monitoring, history or an export. Serialize Telegram RPCs and persist full FloodWait deadlines. - Add durable distributed chat exports with date/language/reply filters, bounded labelled context, signed chunks and explicit pause/resume. See [Distributed chat export](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md). - Keep account reservations until every export worker has stopped, including repeated pause requests and sibling worker failures. History loading in sealed sessions also reserves the account exclusively. - Add participant timelines from saved observations: names, membership, explicit deletion flags and message activity. Profile refreshes are bounded; optional presence recording preserves unavailable or expired status as unknown and does not attribute online activity to a chat. - Save, import and reuse report layout profiles without copying case details or report filters. Profiles are validated and isolated by workspace. - Automatically offload eligible attachments to configured external storage under disk pressure, with reserve-space checks, compression, optional encryption and full readback verification before local eviction. Journals remain local. - Make the recording settings and chat tabs fit narrow screens, including wider system fonts, and fix profile controls and localized labels. - Include reviewed website assets in source archives and verify conditional dependency versions in SBOM inventories. - Phala Cloud deployments work on Phala Cloud itself (first real run, 4 November 2026): the compose carries its name, Phala's own pre-launch script is kept out of the measured app-compose, the production OS image is chosen instead of Phala's development default, the instance ID is read from the CVM state, and restarts from the CVM's operations count in `provider_actions`. Private Phala regressions simulate each of these. - `tdx_os` without outside tools: the verifier downloads the published dstack OS image once, matches it to the hash the CVM reports and computes MRTD and RTMR0-2 itself, the ACPI tables QEMU builds for the VM's shape included. A development image, other firmware, kernel, command line, memory, vCPUs or devices fail. Each journal start is checked the same way. - Attestation certificate for Phala deployments: `verify --report` also writes HTML and a signed PDF, sealed by a qualified eIDAS time stamp from the Belgian government's time-stamping authority, a FreeTSA time stamp and the verifier's own key; `check-report` checks the seal. - Quick tunnel addresses are also posted signed with the collector key, so a verifier is not misled by forged posts on the address topic; on Phala Cloud the tunnel check passes, since its connector runs inside the measured compose. ## 0.8.1 preview · 2 November 2026 - Runtime, sealed and media containers moved to pinned Wolfi/glibc with Python 3.12 and hash-locked system packages (AMD64 + ARM64). Image scans are clean of HIGH/CRITICAL. - Tesseract 5.5.4 built from verified source, English and Russian data pinned. - Release checks now cover real OCR, offline transcription, signed multilingual PDFs and container restrictions. The source archive includes all container build inputs. - **Extras → Independent capture** in the English panel: browser/AyuGram recorders with encrypted tokens, pinned keys, tab selection, start/pause, snapshots, checkpoints and verified ZIP downloads. Everything is off by default. - New optional `tgwitness-capture` package: Chromium PNG/MHTML snapshots, AyuGram SQLite copies, optional silent video, Ed25519 event chains, signed ZIP/HTML reports and a standalone verifier. Each recorder has its own key and storage. - Fixed Phala installs: source bundles were missing the capture package. ## 0.8.0 preview · 2 November 2026 **Reports** - Report studio: eight designs (Classic, Editorial, Briefing, Analytics, Technical, Overview, Reading series, Ledger & margin), live preview, HTML and native signed PDF. Switching designs keeps filters, charts and notes. - Pick report data by chat, author, date and event type and preview it before saving. Edits show before/after, deletions show what was saved earlier. - Reports look like proper dossiers now: cover, key figures, evidence map, numbered findings, timeline. PDFs get an A4 cover with QR, bookmarks and page refs. - Each report explains what its conclusions rest on: export-time checks, observations, missing material, how to check it independently (EN/RU/DE wording). - Send, edit and observed times are shown separately, plus replies, threads and metadata. **Case Board and groups** - Private Case Board: signed bookmarks, exact-version highlights, action slices, collections, threaded comments and statuses. Team notes stay apart from observations; the verifier checks board exports too. Export permission alone doesn't reveal team notes. - Account groups share settings. Members follow the group, an account's own value wins until reset. Changes show which accounts they hit and ask before overwriting. Access can be granted to a whole group. - Group screen at `/groups/`: accounts, problems, shared chats, group export. **Setup and connection** - Six-step first setup and one Settings page with simple/standard/expert levels, in all 25 languages. Each step has its own URL, Back works. - The setup asks whether the account is a separate one; a main account only records chosen chats. After Start it shows that connection, events, sources and files work. - Guided Connection screen: pick accounts, prepare and check a route, then apply. Direct, own proxies, public MTProto pool, WireGuard profiles and portable WARP. - Automatic connection tries public MTProxy, then WARP, then direct (if allowed) and shows a status indicator instead of failing silently. - Video duration limits in file policies. **Panel and safety** - No more one-click accidents: pausing, excluding and removing sources are confirmed, sending from a chat needs "Write as @account" first, route changes while observing offer to pause. - One set of counters everywhere (deleted with text, deleted before saving, missing on recheck). - Account files are inspected before connecting. URL, workspace and account always agree, a mismatch blocks actions. Chats open read-only and mask detected secrets. - Downloads fall back to normal browser downloads, big archives stream through one-time cookies. Prepared exports keep size, SHA-256 and "Download again". - Panel token rotation keeps the new session alive. Temporary network failures offer Retry. - Panel dialogs instead of `window.confirm`, journal paging fixed, lots of small UI fixes. - Public-channel showcase: expiring read-only links with redacted authors and signed snapshots. **Servers and evidence** - Extras → Server 24/7: a Hetzner server from the panel with a quick tunnel or your own domain. `python -m tgwitness.cloud destroy` cleans everything up. - Phala Cloud option: the collector runs in an Intel TDX confidential VM, `verify` checks the attestation up to Intel's root. - Gateway DNS (`--gateway-dns`): the server only resolves through Cloudflare Gateway. - Optional drand rounds and Telegram device lists in evidence mode. - Setup by goal: four questions, suggested settings, credibility and reliability scales. **Other** - Notification service catalog with icons, optional operator control bot, Discord witness posts. - Storage separates backups, verified file offloading and evidence retention. - AI previews show the endpoint and outside route. - Pull requests run both panel suites, including Firefox and WebKit downloads. Release packages wait for dependency, CodeQL and container audits. - Docs: a [panel guide](https://phishdestroy.github.io/TgWitness/fa/docs/reference/panel/) for every screen. ## 0.7.1 preview · 1 November 2026 - **Start here** with two paths: export my account, or follow an investigation. - Account export through Telegram Takeout or the regular API, resumable, with signed progress and coverage records ([account export](https://phishdestroy.github.io/TgWitness/fa/docs/reference/account-export/)). - Separate signed sharing copies with filters, pseudonyms and optional text/file removal. Signatures establish integrity; they do not establish Telegram authorship, completeness or legal admissibility. - Readable offline reports for account exports and sharing copies, printable, with record links and instructions for the recipient. - Clear handoff after download: original vs sharing copy, report preview, instructions to copy. - Rejected Telegram logins are told apart from paused accounts and network errors. **Sign in again** keeps the workspace. - Load the history of enabled sources with pause/resume, plus a signed progress report ([history](https://phishdestroy.github.io/TgWitness/fa/docs/reference/history/)). - Read-only MCP at `/mcp`, local archive search with optional AI, local OCR/transcription, signed webhooks with retries. - GitHub Actions capture preview: one chat on a temporary runner, encrypted result, pinned provenance ([sealed capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md)). - Self-contained signed reports in 25 languages with chain of custody; archives add `custody.json` and `SHA256SUMS`. - Panel rework: workspace URLs, Back/Forward, drafts survive updates, Ctrl/Cmd+S, Sources split into tabs, Parameters search, journal filters and inspector, live updates. - Batch session import, account groups, MTProxy dashboard with ping, countries and own lists. - MTProxy decryption through OpenSSL (it used to eat a whole CPU core). - Stronger masking in sharing copies, bounded media decoding, repeatable source ZIPs. - Notification services refuse redirects. Weekly Dependabot, nightly CodeQL and container scans. - Lots of fixes: stuck chat profiles, quick search, DST in search dates, 502s behind Caddy, GIF/sticker downloads, slow proxy list parsing, duplicate sessions on import. ## 0.7.0 preview · 31 October 2026 - OpenTimestamps proofs are parsed strictly; Bitcoin attestations show as `bitcoin-unverified` until you run `ots verify`. - Verification reports which part of the journal witness checkpoints cover; `--require-witness` demands a pinned witness and matching final record. - Access and permissions guides, updated proxy and IP mode guides. - Panel and docs site in 25 languages. Site publishing fails on missing translations. - Added the [roadmap](https://github.com/phishdestroy/TgWitness/blob/main/docs/ROADMAP.md). ### Initial preview contents · 30 October 2026 - First GitHub release: Windows portable, wheel, source archive. - The setup guide has an "Open to everyone" section: no country or sanctions blocks, and Taylor Wessing as the only incompatibility we name. It is our position, not a licence condition. - The README and Wiki now present the authors' Ethical Notice & Historical Continuity statement, with document references, historical context and an explicit explanation that MIT permission applies to everyone. - The operator notice and the Taylor Wessing page speak in our own voice. - Returned to the MIT License. A tool whose output third parties must be able to check should not stumble over its licence. `LICENSE` is the standard MIT text again, the package declares MIT with the OSI classifier, and the container, portable package, website, Wiki and translated README labels say so. Our statement stays in NOTICE and on the Taylor Wessing page as our position; it adds no licence condition. The presentation artwork reads "open source" again. - Added our Operator Incompatibility NOTICE to README, SECURITY, the documentation, Wiki and website. A single source keeps the complete statement consistent across those pages; source, Python and portable distributions include NOTICE alongside the licence. - High-assurance deployment (`python -m tgwitness.cloud`, [guide](https://phishdestroy.github.io/TgWitness/fa/docs/reference/high-assurance/)) on Hetzner, DigitalOcean, Linode, Vultr or EC2: no SSH key, no inbound ports, panel only through a Cloudflare Tunnel, and a `verify` command for third parties. - Local launchers open the panel in the browser once it's up. - Read-only online demo of the real panel with fictional data. - Wiki with 13 guides, docs website with a reference section, search, diagrams and 13 languages. - **Sign out of Telegram** on the Account page. - About 940 Russian panel strings fixed by hand. - Observation scope: chosen chats, a folder or the whole account, by type. New chats are picked up immediately. - Investigation mode for accounts that join groups and talk to bots. - People profiles (opt-in per chat), independent witness bot, notification excerpts, Parameters page, light/dark theme. - Panel mini-client: send messages, press bot buttons, preview and join invites. - Fixed message loss after a long stop (rechecks used to stop after 1,000 messages). - Many fixes from a full review: attachment byte counts, restore checks, scope edge cases, verify.py witness handling, off-site copy retries. - Pillow 13 (39 advisories against 12.3). ## 0.6.1 · 27 October 2026 - Renamed TgWatch to TgWitness, old archives still verify. - Evidence mode timestamps checkpoints with RFC 3161 and OpenTimestamps. - Password-protected AES-256 ZIP exports. - Notifications through Apprise. - 13 interface languages; README, Quick start and Deployment in 12 languages. - Encrypted off-site copy to S3-compatible storage with Object Lock. - Catch-up after restart and rechecks every 15 minutes. - Built-in pool of public API pairs, no own API ID needed. - New Chats view, Accounts view, multi-account chat export, signed full chat export. - Windows portable package, public website, GitHub Pages workflow. - Better launchers on all platforms, redesigned panel, new logo. ## 0.6.0 · 27 October 2026 - New account form with Phone, QR code, Files and Auth key tabs. - Auth Key + DC ID sign-in, Telethon/Pyrogram sessions, TData ZIPs, StringSession, account JSON. - QR login with 2FA, Desktop local passcodes. - Demo opens on its sample journal; refreshed panel look. ## 0.5.1 · 27 October 2026 - Only the active account client is accepted; rejected logins are disconnected. - Windowless Windows launches with logs in `logs/server.log`. - Case-insensitive Unicode search, full UTC dates on phones. - Linux/macOS launch scripts, Docker helpers, optional HTTPS with Caddy, GHCR images. - Docs on export signatures and investigation handoff. ## 0.5.0 · 26 October 2026 - Per-account monitoring categories, presets and signed policy changes. - Direct local entry to synthetic demos. Older history: [release status](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/RELEASE.md) and [verification](https://phishdestroy.github.io/TgWitness/fa/docs/reference/verification/). --- # یک دفترچه. چهار حالت جمع‌آوری. هشت سطح تأیید. Canonical page: https://phishdestroy.github.io/TgWitness/fa/guides/modes.html دامنه‌های جمع‌آوری، مرزهای رویداد، هشت مکانیزم تأیید و شش سناریوی تحقیقاتی خیالی. [Project context and measured scale](https://phishdestroy.github.io/TgWitness/docs/reference/overview/) [Documentation index](https://phishdestroy.github.io/TgWitness/fa/llms.txt) حالت‌ها، سناریوها و سطوح شواهد TgWitness آنچه حساب متصل مشاهده می‌کند را ثبت می‌کند. شخص ثالث می‌تواند یکپارچگی رکورد را در برابر یک کلید مورد اعتماد مستقل تأیید کند. [مودهای جمع‌آوری](https://phishdestroy.github.io/TgWitness/fa/guides/modes.html#scope)[سناریوها](https://phishdestroy.github.io/TgWitness/fa/guides/modes.html#scenarios)[سطوح شواهد](https://phishdestroy.github.io/TgWitness/fa/guides/modes.html#levels) مروری ۳–۵ دقیقه‌ای · مثال‌های فرضی · پیاده‌سازی فعلی 1. **تلگرام** به‌روزرسانی‌های قابل مشاهده برای حساب 2. **مجموعه‌کننده** سوابق پیوندی، هر یک امضا شده 3. **تأییدکننده** کلید مورد اعتماد + مرز حفظ‌شده `h₁ → h₂ → h₃ · Ed25519`یکپارچگی بررسی می‌شود. منشأ تلگرام و صحت یک پیام دو پرسش جداگانه هستند. ## دامنهٔ مشاهده را انتخاب کنید سه دامنه و یک پیش‌تنظیم تحقیق. استثناها و انواع منابع فعال همچنان اعمال می‌شوند. پیش‌فرض**گفتگوهای انتخاب‌شده** سوابق فقط منابع انتخاب‌شده به‌صورت دستی. چت‌های جدید به‌طور خودکار اضافه نشده است. برای انتخاب کنید مجموعه‌ای شناخته‌شده از کانال‌ها یا گروه‌ها. هیچ ظرفیت چت ثابتی تأیید نشده است. **چه کاری انجام نمی‌دهد** این ابزار چت‌های دیگر را کشف نمی‌کند و تاریخچه قبلی را تکمیل نمی‌کند. پوشه حساب**پوشه تلگرام** سوابق شامل پوشه‌ها و دسته‌بندی‌ها، به علاوه موارد مستثنی و چت‌های بایگانی‌شده در صورت پیکربندی. چت‌های جدید مطابقت چت‌های فعال؛ تغییرات پوشه در عرض یک ساعت. برای انتخاب کنید یک تحلیلگر از قبل یک پوشه پرونده را نگهداری می‌کند. جمع‌آوری را در یک حساب اختصاصی تأیید کنید. **چه کاری انجام نمی‌دهد** این اعمال مربوط به تغییر پوشه نیست muted/read شرایط. دامنه را تأیید کنید**کل حساب** سوابق چت‌های قابل مشاهده برای حساب کاربری، شامل گفتگوهای خصوصی و ربات‌ها، در انواع منتخب. چت‌های جدید هنگام دریافت اولین به‌روزرسانی اضافه می‌شود. برای انتخاب کنید یک حساب مشاهده اختصاصی، شامل حسابی که در یک پرونده مشارکت دارد. **چه کاری انجام نمی‌دهد** به‌طور خودکار به چت‌ها نمی‌پیوندد و دسترسی به منبع را دور نمی‌زند. پیش‌تنظیم کل حساب**حالت تحقیق** سوابق تمام انواع منابع، اقدامات خود، پروفایل‌های منبع و ۲۰۰ پیام قابل مشاهدهٔ اخیر از منابع تازه‌کشف‌شده. چت‌های جدید یک چت یا ربات جدید یک پروفایل و یک نمای کلی از تاریخچه دریافت می‌کند. برای انتخاب کنید از طریق پنل به یک تیم بپیوندید یا با یک ربات تعامل کنید. پیش‌تنظیم را مرور و ذخیره کنید. **چه کاری انجام نمی‌دهد** این کار هر گفتگوی موجود یا کال‌بک‌های فشرده‌شده در کلاینت دیگر را اسنپ‌شات نمی‌کند. این کارت‌ها یک مقایسه محلی هستند، نه کنترل‌های جمع‌آوری زنده. آنها حساب کاربری را تغییر نمی‌دهند. **چه کاری انجام نمی‌دهد** هیچ حالتی چت‌های مخفی را نمی‌خواند، هنگام توقف فرآیند ضبط نمی‌کند، به‌طور خودکار به منابع نمی‌پیوندد یا تاریخچهٔ قبلی را فراتر از مقدار درخواست‌شده بازیابی نمی‌کند. snapshot/export. [جزئیات را بخوانید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/) ## ثبت با GitHub Actions (پیش‌نمایش) ورود جدید به Telegram، یک گفتگو، آرشیو رمزگذاری‌شده و گواهی منشأ GitHub. [باز کردن دستیار ثبت](https://phishdestroy.github.io/TgWitness/fa/docs/capture/) ## آنچه ثبت می‌شود فقط مشاهدات تحویل‌شده یا صراحتاً درخواست‌شده وارد سوابق می‌شوند. انتساب ناشناخته، ناشناخته باقی می‌ماند. ثبت سوئیچ‌ها · تصویر محلیپیام‌های جدیدویرایش‌هاحذف‌هاواکنش‌هاعضویت پنل این سوئیچ‌ها را برای هر فضای کاری اعمال می‌کند. غیرفعال کردن یکی از آن‌ها، سوابق موجود را حفظ می‌کند؛ فعال کردن مجدد آن، رویدادهای از دست رفته را بازسازی نمی‌کند. **ماتریس رویداد: مطالب ذخیره شده و ناشناخته‌های باقی‌مانده** | دسته‌بندی | ذخیره شد | نامشخص باقی می‌ماند | | --- | --- | --- | | پیام | متن، شناسه‌ها، متادیتای فرستنده، زمینه پاسخ و پاکت به‌روزرسانی اصلی. | امضای تلگرام قابل راستی‌آزمایی توسط شخص ثالث وجود ندارد. | | ویرایش | هر نسخهٔ مشاهده‌شده، بدون بازنویسی نسخه‌های قبلی. | ویرایش‌های میانی ممکن است از دست بروند؛ فرستنده لزوماً ویراستار نیست. | | حذف | توجه: متن قبلاً ذخیره شده نیز، در صورت وجود، درج می‌شود. | اطلاعات حذف‌کننده و زمان دقیق اقدام ارائه نمی‌شوند. | | حذف بدون دامنه | اعلان در سطح حساب؛ همتای ناشناس صریح باقی می‌ماند. | هیچ گفتگوی حدس‌زده‌ای در کار نیست. همبستگی در صورت امکان از شناسه‌های دامنه‌حساب کاربری که قبلاً ذخیره شده‌اند استفاده می‌کند. | | واکنش | شمارنده‌های تحویل‌شده و هویت‌های اخیر قابل مشاهده. | هر واکنش‌دهنده‌ای قابل مشاهده نیست؛ برای دریافت فهرست کامل موجود، نیاز به پرس‌وجوهای جداگانه است. | | عضویت | پیام‌های ارائه‌ی خدمات و به‌روزرسانی‌های شرکت‌کنندگان ارسال شد. | نقش و نوع چت دید را محدود می‌کنند؛ سکوت دلالت بر غیبت ندارد. | | پیوست | توصیف‌کننده نسخه اصلی، بایت‌های ذخیره شده، SHA-256 و نتایج تلاش‌ها. | یک فایل ناپدید شده ممکن است در دسترس نباشد؛ نسخه جدیدتر جایگزین آن نمی‌شود. | | برش تاریخچه | پیام‌های در حال حاضر قابل مشاهده، به‌عنوان مشاهدات تاریخچه علامت‌گذاری شده‌اند. | ویرایش‌های قبلی و محتوای ناپدیدشده بازسازی نمی‌شوند. | | مالکیت اقدامات | خروجی messages/edits و صفحه‌کلید پاسخ‌دهی تطبیقی button_press مِتادیتا. | فراخوانی‌های بازگشتی فشرده در کلاینت دیگری قابل مشاهده نیستند. | | دکمه‌های ربات | متد کال‌بک، URL، وب‌اپلیکیشن و متادیتای درخواست همراه با پیام نگهداری می‌شوند. | URLها و phone/location درخواست‌ها متن هستند و به‌طور خودکار باز یا اجرا نمی‌شوند. | ### محدودیت‌های پیش‌فرض پیوست عکس‌ها 20 MiB ویدیو 100 MiB فایل‌ها 50 MiB انیمیشن‌ها 20 MiB یادداشت‌های ویدیویی 50 MiB صدا 20 MiB صوتی 50 MiB استیکرها 5 MiB **چه کاری انجام نمی‌دهد** یک سوئیچ، متادیتای جاسازی‌شده را سانسور نمی‌کند یا سوابق عملیاتی را غیرفعال نمی‌سازد. ضبط، هویت عاملی را که تلگرام ارائه نکرده است، شناسایی نمی‌کند. [جزئیات را بخوانید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/) ## از اختیاراتی که دارید استفاده کنید هر حساب کاربری فضای کاری، دفترچه یادداشت، کلید امضا، مسیر و صف خود را دارد. ### تلفن + کد وارد شوید 2FA زمانی که فعال باشد. ### QR کد اسکن از یک دستگاه مجاز؛ 2FA ممکن است همچنان لازم باشد. ### Telethon .session فایل جلسه حساب کاربری را وارد کنید. ### Pyrogram .session وارد کنید پشتیبانی‌شده Pyrogram فرمت جلسه. ### TData ZIP یک حساب دسکتاپ پشتیبانی‌شده؛ رمز عبور محلی در صورت تنظیم. ### StringSession متن یک الصاق کنید Telethon StringSession. ### .session + .json جلسه و متادیتای همراه تطبیق‌یافته را انتخاب کنید. ### کلید امضا HEX + DC ID مجازات حساب کاربری را همراه با شناسه مرکز داده‌های آن وارد کنید. **API جفت** اختیاری است. بدون آن، API جفت اختیاری است. بدون آن، TgWitness از یک استخر جفت‌های عمومی، از جمله جفت‌های تلگرام دسکتاپ رسمی، استفاده می‌کند. `Direct · SOCKS5 · HTTP CONNECT · MTProxy`MTProxy تجربی است؛ عمومی داخلی MTProxy فهرست‌ها در دسترس هستند. یک مسیر پروکسی ناموفق به اتصال مستقیم بازنمی‌گردد. دو فضای کاری روی یک دستگاه، دو شاهد مستقل نیستند. **چه کاری انجام نمی‌دهد** عملیات وارد کردن (Import) دور زدن تأیید اعتبار تلگرام را انجام نمی‌دهد، 2FA یا فرمت‌های جلسه پشتیبانی‌نشده. حساب‌ها همچنان فرآیند برنامه را به اشتراک می‌گذارند. [فرمت‌های حساب](https://phishdestroy.github.io/TgWitness/fa/docs/reference/accounts/) ## اقدام از پنل ارسال یا پاسخ دهید، یک دکمهٔ بات فعلی را فشار دهید، پیش‌نمایش لینک را ذخیره کنید، سپس صراحتاً به یک چت بپیوندید یا یک بات را با پارامتر شروع آن راه‌اندازی کنید. `interaction.preview``interaction.requested``interaction.result` رسیدهای پیش‌نمایش، درخواست و نتیجه امضا می‌شوند. قبل از فشردن دکمه، سرور پیام را دوباره دریافت می‌کند و صفحه‌کلید تغییر یافته را رد می‌کند. متن و آدرس‌های بازگشتی کال‌بک همچنان به عنوان زمینه ثبت‌شده باقی می‌مانند. **چه کاری انجام نمی‌دهد** بدون برنامه‌های وب، پرداخت‌ها، phone/location اشتراک‌گذاری یا پرس‌وجوهای درون‌خطی. نمایش یک URL به معنای باز کردن آن نیست. [جزئیات را بخوانید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/collection/) ## بازیابی و تداوم شکاف‌ها نشان داده می‌شوند، نه پنهان. ### از موقعیت ذخیره شده از سر بگیرید پس از راه‌اندازی مجدد، تلگرام برای دریافت به‌روزرسانی‌های از دست رفته درخواست می‌شود. نگهداری محدود و تفاوت‌های منقضی می‌توانند شکاف‌هایی ایجاد کنند. ### پیام‌های قابل مشاهده را مجدداً بررسی کنید پیش‌فرض‌ها: منابع اولویت‌دار هر ۱۵ دقیقه، سایر منابع هر ۶ ساعت. نتایج شامل message.recovered و message.missing_on_recheck. ### خواندن coverage.json دوره‌های مشاهده، فواصل زمانی همراه با دلایل و شناسه‌های مشاهده‌نشده، همراه با خروجی امضا شده ارسال می‌شوند. یک رکورد «غیبت در بازبینی مجدد» (missing-on-recheck) یک اطلاعیه حذف نیست. **چه کاری انجام نمی‌دهد** یک اسنپ‌شات تاریخی بعدی یک قطعی را پاک نمی‌کند و هر نسخهٔ ناپدیدشده را بازیابی نمی‌کند. نشانگر ذخیره شده، تأیید بی‌از‌دست‌رفتن پذیرش دفترچه نیست. [جزئیات را بخوانید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) ## هفت سطح. سؤالات متفاوت. هر مکانیزم به یک سؤال محدود پاسخ می‌دهد. سرویس‌های خارجی را به‌طور جداگانه پیکربندی کرده و لنگرهای اعتماد آن‌ها را خارج از گردآورنده حفظ کنید. 1. ### ثبت SHA-256 زنجیره + Ed25519 به ازای هر رویداد؛ اولین previous_hash اولین 64 بیت 0 است. **بررسی‌های شخص ثالث** ترتیب‌بندی و امضاها تحت کلید گردآورنده سنجاق‌شده. **چه کاری انجام نمی‌دهد** این اصالت تلگرام یا کامل بودن آن را اثبات نمی‌کند. **دستور تأیید** ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 ``` 2. ### ظرف manifest.json فهرست هش‌های فایل را فهرست می‌کند؛ manifest.sig آن را امضا می‌کند. media.saved بایت‌های پیوست را به یک رویداد متصل می‌کند. **بررسی‌های شخص ثالث** فایل‌های ارائه‌شده با مانیفست امضا شده و رسیدهای رسانه‌ای مطابقت دارند. **چه کاری انجام نمی‌دهد** آن امضای جداگانه دانلود شده را امضا نمی‌کند CSV, HTML یا اسکرین‌شات امضا نمی‌کند. **دستور تأیید** ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 ``` 3. ### مرز حفظ‌شده نقطهٔ کنترل در هنگام راه‌اندازی، به‌طور پیش‌فرض هر ۵ دقیقه یک‌بار، و توقف منظم. یک نسخه را در جای دیگری نگهداری کنید. **بررسی‌های شخص ثالث** خروجی بعدی با طول و سرِ قبلیِ نگهداری‌شده مطابقت دارد؛ می‌توان بازگشت به عقب را تشخیص داد. **چه کاری انجام نمی‌دهد** این جایگزینی هم دفترچه یادداشت و هم تمام نقاط کنترل نگهداری‌شده را تشخیص نمی‌دهد. **دستور تأیید** ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json ``` 4. ### زمان خارجی حالت شواهد یک نقطه کنترل ارسال می‌کند SHA-256 به RFC 3161 مقامات (FreeTSA, DigiCert) و OpenTimestamps تقویم‌ها. **بررسی‌های شخص ثالث** یک پاسخ تأییدشده TSA تاریخ آن بایت‌ها را مشخص می‌کند؛ یک تأییدشده OpenTimestamps یک اثبات تأییدشده، آن‌ها را به بیت‌کوین لنگر می‌اندازد. **چه کاری انجام نمی‌دهد** یک درخواست آماده یا رسید تقویم در انتظار را به عنوان یک مهر زمانی تأیید شده در نظر نمی‌گیرد. **دستور تأیید** ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca trusted-ca.pem ots upgrade checkpoint.ots ots verify checkpoint.ots ``` 5. ### شاهد مستقل میزبان جداگانه، نقطه پایانی فقط-خواندنی محدوده، چالش تازه، مختص خود key/journal و TGW1 پست‌های کانال. **بررسی‌های شخص ثالث** سرهای قبلاً پذیرفته‌شده؛ وضعیت‌ها خوب، key_changed، بازگشت به عقب، شاخه‌زنی، نامعتبر و no_response. **چه کاری انجام نمی‌دهد** این کار دو فضای کاری روی یک میزبان گردآورنده را به شاهدان مستقل تبدیل نمی‌کند. **دستور تأیید** ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel result.json ``` 6. ### نسخهٔ تکراری خارج از محل S3نسخهٔ سازگار که با AES-256-GCM; Object Lock زمانی که باکت از آن پشتیبانی می‌کند. **بررسی‌های شخص ثالث** Restore فایل‌ها را تنها پس از موفقیت در تأیید دفترچه یادداشت، نقطهٔ کنترل و رسانه‌های نگهداری‌شده منتشر می‌کند. **چه کاری انجام نمی‌دهد** آن بدون کلید صادرشده بازیابی نمی‌شود و بدون بررسی پاسخ ذخیره‌سازی، فرض نمی‌کند که نگهداری شده باشد. **دستور تأیید** ``` python -m tgwitness.replica restore --key-file KEY.json --out EMPTY_DIR ``` 7. ### منشأ را اجرا کنید رسید اجرای امضا شده: هش‌های منبع، نسخه‌های وابستگی و زمینهٔ فرآیند. خوداظهاری. **بررسی‌های شخص ثالث** آنچه گردآورنده امضا درباره اجرای خود گزارش داد. **چه کاری انجام نمی‌دهد** این گواهی فرآیند مستقل را ارائه نمی‌دهد و مخدوش‌شدن را پیش از ثبت‌دادن رد نمی‌کند. **دستور تأیید** ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 ``` ### آنچه هیچ سطحی اثبات نمی‌کند تحویل هر به‌روزرسانی تلگرام؛ صحت متن؛ اینکه شناسه فرستنده یک شخص واقعی را شناسایی می‌کند؛ عدم وجود خدشه‌داری جمع‌آوری‌کننده پیش از ثبت؛ قابلیت پذیرش در دادگاه. [شاهد مستقل](https://phishdestroy.github.io/TgWitness/fa/docs/reference/witness/) محلی SHA-256 آزمایشی ### سعی کنید رکورد ۲ را تغییر دهید رکورد بعدی لینک ذخیره شده قبلی را حفظ می‌کند. تغییر متن، هش محاسبه‌شده رکورد ۲ را تغییر می‌دهد. متن سند ۲ ثبت ۱`h1`با ۶۴ صفر شروع می‌شود ثبت ۲`h2`شامل موارد ذخیره شده h1 ثبت ۳`h3`شامل موارد ذخیره شده h2 مثال ایستا: h2 پوشش «دیدار در ساعت ۱۱:۰۰» را در بر می‌گیرد. تغییر آن متن، را تغییر می‌دهد h2؛ رکورد ۳ همچنان به ذخیره شده ارجاع می‌دهد h2. **هش‌های کامل را بررسی کنید** هَش رکورد ۲ ذخیره شده `SHA-256(e₂)` هاش مجدد رکورد ۲ `SHA-256(e₂)` این نمونه هش‌ها را محاسبه می‌کند، نه امضاها را. اعتبارسنج واقعی هر امضا و لینک را با کلید مورد اعتماد بررسی می‌کند. [جزئیات را بخوانید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/how-it-works/) ## از میان شواهد مسیری را برگزینید موارد فرضی. جمع‌آوری را پیش از رویداد مربوطه آغاز کنید؛ مرزها و فواصل را در کنار محتوا حفظ کنید. ### یک کانال جزئیات پرداخت را تغییر می‌دهد حالت → رویدادها گفتگوهای انتخاب‌شده ← پیام‌ها، ویرایش‌ها، حذف‌ها. خروجی نسخه‌ها و پیوست‌های مشاهده‌شده بر اساس هش. تأیید امضا شده ZIP + نقطهٔ کنترل حفظ‌شده + پاسخ TSA تأییدشده. **چه کاری انجام نمی‌دهد** آن چیزی را که هرگز ثبت نشده است، بازیابی نمی‌کند. ### پیام‌ها پس از یک رویداد ناپدید می‌شوند حالت → رویدادها پوشه یا کل حساب کاربری → تمام دسته‌بندی‌های رویداد. خروجی نسخه‌های اصلی ذخیره‌شده، اعلان‌های حذف و پوشش با فواصل. تأیید امضا شده ZIP + دفترچه یادداشت شاهدی مستقل. **چه کاری انجام نمی‌دهد** این، حذف‌کننده را از اطلاعیه‌ای که هیچ عاملی را مشخص نمی‌کند، شناسایی نمی‌کند. ### یک ربات فروشگاه را بررسی کنید حالت → رویدادها پیش‌تنظیم بررسی → دکمه‌ها، پیش‌نمایش لینک‌ها و شروع صریح ربات. خروجی رسیدهای تعامل امضا شده، کال‌بک‌های بازگشتی و پروفایل‌های ذخیره شده. تأیید امضا شده ZIP؛ هر پرونده را در برابر ... تأیید کنید ZIP. **چه کاری انجام نمی‌دهد** این کار یک اپلیکیشن وب بات را باز نمی‌کند، پرداختی انجام نمی‌دهد یا کال‌بک‌های کلاینت دیگر را ثبت نمی‌کند. ### یک شرکت‌کننده در چت‌ها نام‌های خود را تغییر می‌دهد حالت → رویدادها هر دامنه → مشاهده‌شده sender/profile مِتادیتا. خروجی تاریخچه نام/نام کاربری بر اساس شناسه عددی، لینک‌های «همچنین در» و سرنخ‌های استخراج‌شده. تأیید دُسیه JSON مطابقت داده شده با امضا ZIP. **چه کاری انجام نمی‌دهد** این کار یک کیف‌پول، رشته مشابه شماره تلفن یا نام کاربری را به هویت اثبات‌شده تبدیل نمی‌کند. ### مشاهده طولانی‌مدت با یک نسخهٔ خارج از محل حالت → رویدادها هر دامنه → حالت مدرک و یک S3 یک نسخهٔ مشابه با پشتیبانی‌شده Object Lock. خروجی نسخه رمزگذاری‌شده، نقاط کنترل نگهداری‌شده و پاسخ‌های مهر زمانی. تأیید با کلید صادرشده بازیابی کنید، سپس بدون سرور اصلی اعتبارسنجی کنید. **چه کاری انجام نمی‌دهد** این جایگزین یک شاهد مستقل یا یک کلید رمزگشایی نگهداری‌شده به‌طور جداگانه نمی‌شود. [جزئیات را بخوانید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/) ## یک بسته قابل بررسی تحویل دهید نسخهٔ اصلی امضا شده، اثر انگشت کلید نگهداری‌شده به‌طور مستقل، نقطهٔ کنترل مربوطه و نتیجهٔ تأیید را ارائه دهید. - امضا شده ZIP - JSONL - CSV - HTML - نقطهٔ کنترل - اجرای رسید - خروجی چت: chat.json / chat.html - دایرهٔ موضوع JSON - حفاظت‌شده با رمز عبور AES-256 ZIP - خروجی‌های جداگانه برای چندین حساب - CLI پخش: ۵ GiB محدودیت پیش‌فرض ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json ``` تأییدکننده را از یک نسخهٔ مورد اعتماد دریافت کنید، نه از آرشیوی که در حال بررسی است. **چه کاری انجام نمی‌دهد** مستقل CSV و HTML کانون‌های امضا‌شده نیستند. یک رمز عبور محرمانگی انتقال را محافظت می‌کند، نه اصالت را. چندین خروجی، دفترهای حساب را ادغام نمی‌کنند. [جزئیات را بخوانید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) ## مقایسهٔ محصول تحویل‌شده اشیاء پایه بدون امضا، مهر زمانی یا سیستم‌های شاهد افزوده. اسکریپت‌ها و لاگ‌گیرها بسته به پیاده‌سازی متفاوت هستند؛ «جزئی» به معنای محدود به مواد ضبط‌شده یا قابل مشاهده است. | رویکرد | ویرایش‌ها / حذف‌ها | امضا را ثبت کنید | زمان خارجی | شاهد مستقل | پوشش / شکاف‌ها | تأیید بدون نویسنده | | --- | --- | --- | --- | --- | --- | --- | | خروجی تلگرام دسکتاپ | جزئی | خیر | خیر | خیر | خیر | خیر | | Telethon اسکریپت اسنپ‌شات | جزئی | خیر | خیر | خیر | خیر | خیر | | ثبت‌کنندهٔ حذف: گزارش متنی | جزئی | خیر | خیر | خیر | خیر | خیر | | اسکرین‌شات / ضبط وب | جزئی | خیر | خیر | خیر | خیر | خیر | | TgWitness با افزونه‌های پیکربندی‌شده | جزئی | بله | بله | بله | جزئی | بله | **چه کاری انجام نمی‌دهد** این جدول هر اسکریپت یا محصول لاگ‌گیری را ارزیابی نمی‌کند. بررسی‌های اختیاری زمان و شاهد به خدمات و لنگرهای اعتماد خاص خود نیاز دارند؛ هیچ‌یک حقیقت منبع را اثبات نمی‌کنند. شناسه‌های کد و پروتکل را دقیقاً حفظ کنید. [جزئیات را بخوانید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/) ## محدودیت‌ها را همراه با شواهد حفظ کنید تأیید اعتبار زمانی مفید است که دامنه‌اش صریح باقی بماند. - چت‌های مخفی در دسترس نیستند. - هیچ چیزی در حالی که فرآیند متوقف است ثبت نمی‌شود؛ بازیابی محدود است. - یک رکورد تأییدشده، اثباتی بر صحت محتوای آن نیست. - اپراتوری که کلید را در اختیار دارد می‌تواند هر محتوایی را امضا کند. شاهدان مستقل و زمان‌مهرها، جایگزینی‌های بعدی را محدود می‌کنند، نه ضبط اولیه نادرست. - از یک حساب اختصاصی استفاده کنید، نه حساب اصلی خود. - تلگرام می‌تواند حساب‌ها را به دلیل حجم درخواست محدود کند. **چه کاری انجام نمی‌دهد** هیچ حالت یا سطح شواهدی، قابلیت پذیرش قانونی، تحویل کامل تلگرام یا هویت دنیای واقعی را اثبات نمی‌کند. [راهنمای راه‌اندازی](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=fa)[حساب اختصاصی](https://phishdestroy.github.io/TgWitness/fa/docs/dedicated-account/)[EVIDENCE.md](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/)[INVESTIGATION.md](https://phishdestroy.github.io/TgWitness/fa/docs/reference/investigation/)