# Telegram · روندها و عملیات‌ها

Canonical page: https://phishdestroy.io/tgwitness/fa/docs/reference/operations/

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

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

[Documentation index](https://phishdestroy.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.io/tgwitness/fa/docs/reference/deployment/)

![راه‌اندازی و بازیابی](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

برای اولین اتصال، از [حساب‌ها و قالب‌های جلسه](https://phishdestroy.io/tgwitness/fa/docs/reference/accounts/) استفاده کنید. برای توضیح نسخه‌های ذخیره شده، سیاست‌های رویداد و فواصل، به بخش [نحوه کارکرد جمع‌آوری](https://phishdestroy.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.io/tgwitness/fa/docs/reference/operations/#operator-workflow)
- [کار را بدون اشتراک‌گذاری کلید اصلی به اشتراک بگذارید](https://phishdestroy.io/tgwitness/fa/docs/reference/operations/#share-work-without-sharing-the-main-key)
- [حالت‌های زمان اجرا](https://phishdestroy.io/tgwitness/fa/docs/reference/operations/#runtime-modes)
- [دسته‌بندی‌های نظارت](https://phishdestroy.io/tgwitness/fa/docs/reference/operations/#monitoring-categories)
- [اخطاریه‌ها](https://phishdestroy.io/tgwitness/fa/docs/reference/operations/#notifications)
- [چیدمان پنل](https://phishdestroy.io/tgwitness/fa/docs/reference/operations/#panel-layout)
- [محیط‌های استقرار](https://phishdestroy.io/tgwitness/fa/docs/reference/operations/#deployment-environments)
- [بررسی‌ها و خروجی‌های راه‌اندازی](https://phishdestroy.io/tgwitness/fa/docs/reference/operations/#startup-checks-and-exports)
- [نسخه‌برداری، بازیابی و وقفه‌ها](https://phishdestroy.io/tgwitness/fa/docs/reference/operations/#backup-restore-and-interruptions)
- [ظرفیت و نگهداری](https://phishdestroy.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.io/tgwitness/fa/docs/reference/access/) مراجعه کنید.

برای قطع یک اتصال یا لغو دسترسی، از **Open sessions** برای پایان دادن به تمام جلسات آن استفاده کنید. کنسول مدیر، فعالیت‌های فرآیند جاری را در سراسر فضاهای کاری ترکیب می‌کند. بستن جلسه، روند جمع‌آوری را متوقف نمی‌کند.

## حالت‌های اجرا

| حالت | اقدام | رفتار |
| --- | --- | --- |
| دمو | scripts\Demo.cmd یا `--demo` | داده‌های ساختگی؛ ارتباطات حساب‌های واقعی غیرفعال شده |
| مشاهده | شروع مشاهده | ثبت به‌روزرسانی‌های ارائه‌شده برای منابع منتخب |
| لحظه‌نگاری تاریخچه | چت‌ها → اقدامات چت → بارگذاری تاریخچه | حداکثر ۵۰۰ پیام فعلی؛ بدون بازسازی تمام تغییرات گذشته |
| وقفه | مراقبه را متوقف کنید | متوقف کردن جمع‌آوری در حالی که داده‌ها و کارهای صف‌شده حفظ می‌شوند |
| بازبینی/واگذاری | صادرات | ZIP، JSONL/CSV/HTML، نقطهٔ کنترل، رسید فرایند و درخواست مهر زمانی |
| حساب‌های متعدد | فضاهای کاری یا دکمهٔ بالای **+** | هر تعداد فضای کاری مجزا در یک فرایند |

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

## دسته‌بندی‌های نظارت

![تنظیمات نظارت بر هر حساب با داده‌های منبع مصنوعی](https://phishdestroy.io/tgwitness/assets/sources.png?v=761b8bfa296c)

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

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

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

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

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

یک فضای کاری اضافی زمانی قابل حذف است که یک کانتینر ZIP یا ASiC-E امضا شده که شامل ژورنال و یادداشت‌های تخته مورد (Case Board) آن است، به طور کامل دانلود شود. آماده کردن آرشیو کافی نیست: یک رکورد خارج از رویدادهای راه‌اندازی یا یادداشتی که پس از دانلود اضافه شده باشد، **گزینه حذف را** غیرفعال نگه می‌دارد.

وقتی پنل خود فایل را دریافت می‌کند، خروجی را تنها پس از دریافت هر بایت، شمارش می‌کند و سپس اندازه آن را به متد `POST /api/exports/{id}/received` گزارش می‌دهد؛ دانلودی که قطع شود، شمرده نمی‌شود. با استفاده از انتخابگر ذخیره مرورگر (دسترسی به سیستم فایل)، پنل پس از نوشتن و بستن فایل، آن را گزارش می‌دهد. بدون آن، پنل فایل دریافت‌شده را به دانلودهای مرورگر می‌سپارد و نمی‌تواند تشخیص دهد که آیا مرورگر آن را نگه داشته است یا خیر، برای مثال زمانی که دیالوگ ذخیره آن لغو شود؛ در این صورت پنل می‌گوید که دانلود شروع شده است، نه اینکه فایل ذخیره شده است. فایلی که مرورگر به تنهایی دانلود می‌کند (یک خروجی بزرگتر از بافر مرورگر پنل) و دانلود توسط یک کلاینت HTTP دیگر، زمانی شمارش می‌شوند که سرور کل پاسخ را ارسال کرده باشد. سیستم‌عامل و یک پروکسی معکوس چندین مگابایت از یک پاسخ را در بافر خود نگه می‌دارند، بنابراین برای این دانلودها، سرور نمی‌تواند وقفه نزدیک به پایان را ببیند. مگر اینکه پنل اعلام کرده باشد که فایل ذخیره شده است، قبل از حذف کردن فایل دانلود شده را بررسی کنید. خروجی‌گیری گروهی برای حساب‌های آن، زمانی که درست پس از آماده‌سازی دانلود شود، شمارش می‌شود؛ دانلود مجدد آن از **بخش خروجی‌گیری‌های آماده (Prepared exports)** شمارش نمی‌شود.

پیش از حذف، پنل فرمت، اندازه، زمان آماده‌سازی و SHA-256 آخرین آرشیو امضا شده دانلود شده را نمایش می‌دهد و درخواست می‌کند که تأیید شود این آرشیو در خارج از فضای کاری ذخیره شده است. سرور درخواست `DELETE /api/profiles/{id}` را بدون اینکه `kept_copy` برای آن SHA-256 تنظیم شده باشد (یا برای آرشیوی که قبل از ثبت اثر انگشت دانلود شده، `confirmed`) رد می‌کند.

حذف یک فضای کاری اضافی، گردآورنده آن را متوقف کرده و داده‌های محلی آن را حذف می‌کند. اگر یک خطای فایل قفل شده یا سیستم فایل، فرآیند حذف را قطع کند، پنل این خطا را گزارش داده و فضای کاری را همچنان به عنوان «در دسترس نیست» (`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.io/tgwitness/assets/connection.png?v=c8781089fe29)

**ژورنال** مشاهدات، جستجو و فیلترها را نشان می‌دهد. ویرایش، نسخه‌های ضبط‌شده را باز می‌کند؛ حذف، در صورت موجود بودن، محتوای قبلی را باز می‌کند. انتساب ناشناخته صراحتاً مشخص باقی می‌ماند. شمارش‌ها در **بخش «نمای کلی»** موجود هستند؛ جزئیات به‌دست‌آوردن در راهنمای محلی باقی می‌ماند.

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

وضعیت **Live** با رسیدن رکوردها، گزارش وقایع و گفتگوها را به‌روزرسانی می‌کند. هنگام بررسی آن را متوقف کنید، یا زمانی که آماده بودید از دکمهٔ رویدادهای جدید استفاده کنید؛ گردآوری داده‌ها همچنان ادامه می‌یابد. میانبر **Ctrl/Cmd+K** اقدامات پنل را پیدا کرده و در گزارش وقایع جستجو می‌کند.

**ابزارهای بیشتر ← منابع** حاوی دامنه مشاهده (چت‌های انتخاب‌شده، یک پوشه تلگرام یا کل حساب)، چت‌های قابل دسترسی از هر نوع، منابع منتخب با ستاره اولویت، تنظیمات پیوست و بازبینی و اسنپ‌شات‌های تاریخچه است. منابع خصوصی با دیالوگ/ID و بدون لینک عمومی انتخاب می‌شوند. وضعیت دسترسی، جدیدترین بررسی را توصیف می‌کند، نه مجوزهای دائمی را.

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

**چت‌ها → افراد،** همه کسانی را که پیام‌های ذخیره‌شده دارند فهرست می‌کند؛ با فعال بودن پروفایل افراد برای چت، یک کلیک پروفایل آن شخص را با لینک‌هایی به سوابق دفترچه یادداشت باز می‌کند.

**ابزارهای بیشتر → موارد اضافی → شاهد مستقل** توکن‌های شاهد فقط-خواندنی ایجاد می‌کند، نشان می‌دهد که هر شاهد آخرین بار چه زمانی بررسی کرده است و دستورات و گزینه‌های لازم برای اجرای یک ([شاهد مستقل](https://phishdestroy.io/tgwitness/fa/docs/reference/witness/)) را ارائه می‌دهد.

**ابزارهای بیشتر ← پارامترها** هر محدودیت و سرعت فضای کاری را که در صفحه دیگری نیست در خود نگه می‌دارد: چند دیالوگ خوانده شده، لیست چت‌ها هر چند وقت یک‌بار دوباره خوانده می‌شود، فواصل ضربان قلب و نقطه‌کنترل، بافر راه‌اندازی، نحوه پخش درخواست‌های بازبینی مجدد (تاخیر اول، چت‌ها در هر pass, pause between chats, messages recovered and re-requested), disk reserve, timeouts and retries of downloads, what people profiles look for (including your own regular expressions), size and pace of notifications, snapshot, ZIP and browser-download limits, and Telegram client timeouts and retries. هر فیلد محدوده و مقدار پیش‌فرض خود را نشان می‌دهد؛ فیلدهای تغییر یافته علامت‌گذاری شده و می‌توان آن‌ها را یکی یکی یا همه را با هم بازگرداند. هر تغییر به صورت `parameters.changed` به همراه مقادیر قبل و بعد از آن ثبت می‌شود و سوابق شروع مشاهده، مقادیر اعمال‌شده را نام می‌برند. مقادیر از اولین استفاده بعدی خود اعمال می‌شوند؛ تایم‌اوت‌ها و تلاش‌های مجدد کلاینت از اتصال بعدی. فواصل بازبینی مجدد، انواع و اندازه‌های پیوست، شواهد و فواصل کپی خارج از سایت در صفحات مخصوص به خود باقی می‌مانند و می‌توانند هر مقداری از بازه خود را بپذیرند، نه فقط مقادیر از پیش تعیین‌شده.

زنگوله در نوار بالا، مشکلات و تغییرات اخیر در چت‌های مشاهده‌شده را فهرست می‌کند؛ پیام‌های نخوانده تا زمانی که به‌عنوان خوانده‌شده علامت‌گذاری نشوند، شمارش می‌شوند. تغییرات بر اساس هر چت و ساعت گروه‌بندی می‌شوند («۱۲ پیام حذف‌شده، ۱ پیام ویرایش‌شده، ۰ پیام یافت‌نشده») و مشکلاتی مانند خروج از سیستم یا پر شدن دیسک، صرف‌نظر از میزان شلوغی چت‌ها، در لیست باقی می‌مانند.

**ابزارهای بیشتر → حساب کاربری** از فیلد شماره تلفن شروع می‌شود. **ادامه** مستقیماً به ورود کد منتهی می‌شود و فقط در صورت عدم وجود، برای اعتبارنامه‌های API درخواست می‌کند. QR و وارد کردن فایل، برگه‌های جایگزین هستند. اعتبارنامه‌های API ذخیره شده فقط در فضای کاری خود قابل استفاده مجدد هستند. صفحه ورود فاقد نوار کناری، آمار یا بخش‌های تنظیمات است. آیکون **تنظیمات** ، کنترل‌های API، پروکسی، ذخیره‌سازی و حساب‌های اضافی را باز می‌کند. یک فضای کاری جدید، [تنظیمات اولیه را](https://phishdestroy.io/tgwitness/fa/docs/reference/settings/) باز می‌کند؛ پس از ورود، یک فضای کاری با منابع و سوابق ذخیره شده، **بخش چت‌ها را** باز می‌کند. تغییر مسیر نیازمند توقف مشاهده است و ورود ناکامل را لغو می‌کند. یک ژورنال موجود را نمی‌توان بی‌صدا به حساب تلگرام دیگری متصل کرد.

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

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

رابط کاربری از منابع محلی و نمایش متنی برای محتوای منبع استفاده می‌کند. چیدمان‌های دسکتاپ و باریک در Chromium آزموده شده‌اند.

## محیط‌های استقرار

| محیط | نصب | وضعیت تأیید |
| --- | --- | --- |
| رایانهٔ رومیزی/سرور ویندوز | پایتون ۳.۱۱+، scripts\Setup.cmd/Start.cmd، دایرکتوری داده‌های خصوصی | محلی بررسی‌شده روی ویندوز/پایتون ۳.۱۲ |
| سرور لینوکس/VPS | محیط مجازی پایتون (venv)، کاربر سرویس اختصاصی، HTTPS/SSH | نمونهٔ کد، CI و systemd ارائه شده؛ روی این میزبان اجرا نشده است |
| macOS | محیط مجازی پایتون (venv)، فرآیند پیش‌زمینه یا عامل کاربر | نمونه‌ای از launchd ارائه شده؛ نیاز به بررسی نصب جداگانه دارد |
| داکر/کامپوز | حجم پایدار، یک کارگر | تعریف و بررسی زمان اجرای CI ارائه شده؛ Docker به‌صورت محلی در دسترس نیست |
| مرورگر تلفن | اتصال به پنل محافظت‌شده روی یک سرور در حال اجرا | قالب باریک کرومیم آزمایش شده؛ جمع‌آورنده روی iOS/Android اجرا نمی‌شود |

قابلیت حمل به این معنی است که هیچ سرویس ابری اجباری یا ساخت فرانت‌اند لازم نیست. هر هدف همچنان به وابستگی‌های سازگار پایتون/رمزنگاری، دسترسی به درایو محلی و شبکه نیاز دارد. به [DEPLOYMENT.md](https://phishdestroy.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 ZIPs exclude sessions/private keys and are not full service backups. `tgwitness backup FOLDER` makes the same copy while the panel keeps running and leaves out the search index, which rebuilds itself; see [Updates and backups](https://phishdestroy.io/tgwitness/fa/docs/reference/deployment/#updates-and-backups). Four things are protected differently:

| چه | حفاظت |
| --- | --- |
| فایل‌های خروجی بدون رمز عبور (پیش‌فرض) | امضا شده است، بنابراین تغییرات قابل تشخیص هستند؛ برای رمزگذاری خروجی، یک گذرواژه تعیین کنید |
| فایل‌های خروجی با رمز عبور | اگر رمز عبور تعیین کنید، خروجی نهایی بدون تغییر در یک فایل ZIP با رمزگذاری AES-256 WinZip ذخیره می‌شود که توسط 7-Zip و WinRAR باز می‌شود؛ رمز عبور ذخیره نمی‌شود ([مدیریت شواهد](https://phishdestroy.io/tgwitness/fa/docs/reference/evidence/)) |
| پایگاه دادهٔ ژورنال و پیوست‌های ذخیره‌شده روی دیسک | دیسک یا حجم رمزگذاری‌شده و مجوزهای پوشه |
| جلسات تلگرام و کلیدهای امضا | رمزگذاری‌شده در دایرکتوری داده‌ها (`credentials.enc`، `signing.enc`، `network.enc`) |

یک پشتیبان‌گیری کامل سرویس، همان دایرکتوری داده‌های متوقف‌شده‌ای است که در بالا توضیح داده شد، نه یک خروجی (export). برای هر دو از ذخیره‌سازی محافظت‌شده و یک مکانیزم انتقال سنجیده استفاده کنید. خروجی‌های موقت سرور در `temporary-exports/` هر فضای کاری قرار دارند؛ پاسخ‌های تکمیل‌شده پاک می‌شوند و فایل‌های خروجی قطع‌شده هنگام راه‌اندازی بعدی، در حالی که قفل نمونه آن فضای کاری فعال است، حذف می‌گردند.

پس از یک رویداد بازیابی اتصال، گردآورنده به‌روزرسانی‌های از دست رفته را از موقعیت به‌روزرسانی ذخیره شده درخواست می‌کند. کارهای رسانه‌ای پایدار و موقعیت به‌روزرسانی تلگرام در برابر راه‌اندازی مجدد دوام می‌آورند؛ به [فرمت شواهد](https://phishdestroy.io/tgwitness/fa/docs/reference/evidence/#durable-collection-and-process-receipts-02) مراجعه کنید.

## ظرفیت و نگهداری

محدودیت‌های پیش‌فرض، همگی قابل تغییر در بخش**ابزارهای بیشتر → پارامترها**: اولین 1,000 دیالوگ، 500 پیام در هر اسنپ‌شات، 4 گیگابایت محتوای فشرده‌شده با ZIP بدون رمزگذاری (آرشیوهای بزرگ‌تر به `verify.py --max-gib N` نیاز دارند) و یک پشتیبان مرورگر به حجم 128 مگابایت. پیوست‌ها در بخش **ابزارهای بیشتر → منابع → ضبط → پیوست‌ها،** به ازای هر نوع، 1 تا 2,000 مگابایت فضا اشغال می‌کنند. CLI دانلود به طور پیش‌فرض 5 گیگابایت انتقال را تنظیم می‌کند. فضای در دسترس دیسک می‌تواند یک محدودیت پایین‌تر باشد. فضای لازم را برای ژورنال‌ها، رسانه‌ها، WAL، خروجی‌های موقت و پشتیبان‌ها رزرو کنید. خروجی‌ها به جای فضای 512 مگابایتی `/tmp` که توسط Compose فراهم می‌شود، از حجم داده استفاده می‌کنند.

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

بازبینی‌های اولویت‌دار از قبل وجود دارند: منابع ستاره‌دار به‌طور پیش‌فرض هر 15 دقیقه و بقیه هر 6 ساعت بازبینی می‌شوند (ببینید [سطوح بازبینی](https://phishdestroy.io/tgwitness/fa/docs/reference/collection/#recheck-tiers)). خروجی‌های محافظت‌شده با گذرواژه همان‌طور که در بالا آمده کار می‌کنند. دسترسی محدود در [دسترسی و مجوزها](https://phishdestroy.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.io/tgwitness/fa/docs/reference/verification/).
