# پیام‌ها تغییر می‌کنند. آنچه دیدید را حفظ کنید.

Canonical page: https://phishdestroy.github.io/TgWitness/fa/

[متن‌باز / v0.7.0](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/)

پیام‌های تلگرام را ضبط کنید، تغییرات آن‌ها را حفظ کنید و یک رکورد امضا شده صادر کنید.

[دموی](https://phishdestroy.github.io/TgWitness/demo/?lang=fa)[راهنمای راه‌اندازی](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=fa)

دمو از داده‌های فرضی استفاده می‌کند. نیازی به ورود به تلگرام نیست.

 [ثبت با GitHub Actions (پیش‌نمایش)](https://phishdestroy.github.io/TgWitness/fa/docs/capture/) [نسخهٔ پشتیبان خارج از محل S3: راه‌اندازی و بازیابی](https://phishdestroy.github.io/TgWitness/fa/#s3)

پیامی در گذر زمان#0042

نورث‌استار · پژوهشمنبع/پیام خیالی ۴۲

1. **پیام مشاهده‌شده**09:41:02

   خلاصه گزارش از 14:00 آغاز می‌شود.
2. **ویرایش حفظ‌شده**09:43:18

   خلاصه گزارش از 15:00 آغاز می‌شود.

   نسخه قبلی حفظ شد
3. **اطلاعیه حذف**10:06:45

   محتوای ضبط‌شده در مجله شما باقی می‌ماند.

سه مشاهده. یک تاریخچه. مثال

پیام ناپدید می‌شود. تاریخچه ضبط‌شده باقی می‌ماند.

## هر تغییر ثبت‌شده. دقیقاً همان‌جایی که به آن نیاز دارید.

رابط کاربری را با داده‌های نمایشی فرضی مرور کنید.

TgWitness / گفتگوهای ذخیره شدهفضای کاری مشاهده شما

![گفت‌وگوهای ذخیره شده تلگرام در تم تاریک، همراه با ویرایش‌ها و پیام‌های حذف‌شده که در زمینهٔ خود حفظ شده‌اند](https://phishdestroy.github.io/TgWitness/assets/chats-dark.png)

۰۱ / گفتگوهای ذخیره شده  نمای آشنای گفتگو، با ثبت ویرایش‌ها و اعلان‌های حذف در کنار پیام‌ها.

TgWitness / ژورنالفضای کاری محلی

![روزنامه‌ای شامل پیام‌های مشاهده‌شده، ویرایش‌ها، اعلان‌های حذف و رویدادهای پوشش](https://phishdestroy.github.io/TgWitness/assets/workspace.png)

۰۲ / ژورنال: یک خط زمانی قابل جستجو از آنچه حساب کاربری شما مشاهده کرده است، شامل وقفه‌ها.

TgWitness / تاریخچه ویرایشفضای کاری محلی

![پنجره جزئیات مقایسه نسخه‌های قبلی ضبط‌شده و ویرایش‌شده یک پیام](https://phishdestroy.github.io/TgWitness/assets/detail.png)

۰۳ / تاریخچه ویرایش: مقایسه نسخه‌های ضبط‌شده بدون بازنویسی مشاهدات قبلی.

TgWitness / خروجی‌های امضا‌شدهفضای کاری محلی

![صادرات فضای کاری شامل فایل ZIP امضا‌شده، JSONL، CSV و گزارش آفلاین HTML](https://phishdestroy.github.io/TgWitness/assets/exports.png)

۰۴ / خروجی‌های امضا‌شده: دفترچه را همراه خود ببرید، همراه با یک فهرست مشخصات و یک راستی‌آزمای مستقل.

۰۱ / ضبط

### شما دامنه را انتخاب می‌کنید.

گفتگوهای انتخاب‌شده، یک پوشه تلگرام یا کل حساب. یک فضای کاری جداگانه برای هر حساب.

[مقایسهٔ حالت‌های جمع‌آوری](https://phishdestroy.github.io/TgWitness/fa/guides/modes.html#scope)

۰۲ / حفظ

### تغییرات به داستان می‌افزایند.

نسخه‌های ضبط‌شده، اعلان‌های حذف و فواصل مشاهده در مجله باقی می‌مانند.

[ماتریس رویداد را ببینید](https://phishdestroy.github.io/TgWitness/fa/guides/modes.html#events)

۰۳ / تحویل

### سندی که همراه سفر می‌کند.

فایل ZIP امضا شده، فایل‌های محفوظ و یک گزارش آفلاین. محافظت با رمز عبور اختیاری.

[صادرات و تأیید](https://phishdestroy.github.io/TgWitness/fa/docs/exports/)

## یک بایت را تغییر دهید. زنجیره به شما اطلاع می‌دهد.

هر رویداد به هش قبلی لینک می‌شود و دارای امضای Ed25519 است.

![رویدادهای ضبط‌شده به هش‌های قبلی لینک می‌شوند، امضا دارند و در یک خروجی قابل راستی‌آزمایی منتقل می‌شوند.](https://phishdestroy.github.io/TgWitness/assets/evidence-chain-animated.svg)

![تغییر یک رکورد ضبط‌شده، هش آن را تغییر می‌دهد و اعتبارسنجی رکورد مرتبط را مختل می‌کند.](https://phishdestroy.github.io/TgWitness/assets/evidence-tamper-animated.svg)

![یک نقطهٔ کنترل جداگانه که به‌طور مستقل نگهداری می‌شود، به دریافت‌کننده امکان می‌دهد تا دفترچهٔ صادرشده را با مشاهده‌ای قبلی مقایسه کند.](https://phishdestroy.github.io/TgWitness/assets/evidence-checkpoint-animated.svg)

ببینید هر مکانیزم تأیید چه چیزی را برقرار می‌کند و محدودیت‌های آن در کجا قرار دارد.

[کشف هشت سطح مدرک](https://phishdestroy.github.io/TgWitness/fa/guides/modes.html#levels)

## آماده برای بازبینی توسط شخص دیگر.

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

[مدل مدرک را بخوانید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/)

tgwitness-evidence.zipبستهٔ امضا‌شده

- 01

  مشاهدات اصلیسوابق JSONL + جدول CSV
- 02

  زمینه قابل‌فهمگزارش HTML آفلاین + رسانه‌های نگهداری‌شده
- 03

  تأیید مستقلمنشور امضا شده + اعتبارسنج مستقل

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

## نسخه‌های S3. بررسی‌های خارجی.

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

به‌طور پیش‌فرض غیرفعال

### همه چیز را به یک فضای ذخیره‌سازی سازگار با S3 کپی کنید

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

**تنظیمات ذخیره‌سازی و بازیابی**

رمزگذاری سمت کلاینت

`AES-256-GCM` اشیاء را روی این دستگاه رمزگذاری می‌کند. ارائه‌دهنده اشیاء رمزگذاری‌شده را دریافت می‌کند.

نسخه‌های زمان‌بندی‌شده یا دستی

هم‌اکنون کپی کنید، یا یک بازه زمانی از ۱ تا ۱٬۴۴۰ دقیقه را انتخاب کنید. پیشرفت را در پنل بررسی کنید.

قفل اشیاء

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

بازیابی تأییدشده

کلید رمزگذاری را دانلود کرده و به‌طور جداگانه نگهداری کنید. آن را روی دستگاه دیگری بازیابی کنید؛ فایل‌ها تنها پس از تأیید منتشر می‌شوند.

![پنل کامل کپی خارج از محل: کنترل‌های نقطه پایانی، منطقه، باکت، کلیدهای دسترسی، زمان‌بندی، قفل شیء و کلید بازیابی](https://phishdestroy.github.io/TgWitness/assets/off-site-copy.png)

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

مجله و رسانه‌ها`AES-256-GCM`ذخیره‌سازی سازگار با S3

[پیکربندی S3 و بازیابی یک نسخه](https://phishdestroy.github.io/TgWitness/fa/docs/exports/#s3)[جزئیات تأیید را در بخوانید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/evidence/#off-site-copy-and-restore-s3)

**چه کاری انجام نمی‌دهد** این ابزار بدون کلید رمزگشایی صادرشده بازیابی نمی‌کند و جایگزین شاهدی مستقل نمی‌شود.

### اخطاریه‌ها · اپرایز

هشدارهای مشکل، تغییرات چت و خلاصه‌های روزانه از طریق Apprise: پیام‌رسان‌ها، ایمیل یا وب‌هوک JSON خود.

این کار را **انجام نمی‌دهد.** متن پیام را ارسال نمی‌کند مگر اینکه شما گزیده‌ها را فعال کنید.

 [مقاصد اعلان را پیکربندی کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/operations/#notifications)

### برچسب‌های زمانی خارجی

هش‌های نقطه‌کنترل زمانی را با RFC 3161 و OpenTimestamps ثبت کنید.

**چه کاری انجام نمی‌دهد** این ابزار رسید تقویمی در انتظار را به‌عنوان مهر زمانی تأییدشده بیت‌کوین در نظر نمی‌گیرد.

 [مدارک مهر زمانی را بررسی کنید](https://phishdestroy.github.io/TgWitness/fa/docs/reference/timestamp/)

### شاهد مستقل

یک میزبان جداگانه مشاهدات امضا شده را نگهداری می‌کند و می‌تواند منتشر کند `TGW1` نقاط کنترل را ذخیره می‌کند.

**چه کاری انجام نمی‌دهد** این کار دو فضای کاری روی یک میزبان جمع‌آوری را به شاهدان مستقل تبدیل نمی‌کند.

 [شاهد را راه‌اندازی کنید](https://phishdestroy.github.io/TgWitness/fa/docs/witness/)

### بازیابی و شکاف‌های قابل مشاهده

پس از راه‌اندازی مجدد از سر بگیرید. بازبینی مجدد و `coverage.json` نمایش پیام‌های بازیابی‌شده و فواصل زمانی.

**چه کاری انجام نمی‌دهد** این ابزار هر ویرایش از دست رفته یا پیام ناپدیدشده را بازسازی نمی‌کند.

 [پیوستگی و فواصل را بررسی کنید](https://phishdestroy.github.io/TgWitness/fa/guides/modes.html#continuity)

## اولین فضای کاری شما از اینجا آغاز می‌شود.

ابتدا دمو را بررسی کنید. وقتی آماده بودید، یک حساب اختصاصی را متصل کنید. ویندوز، لینوکس، مک‌اواس یا داکر.

[راهنمای راه‌اندازی را بخوانید](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=fa)

**یک جلسه واردشده، یک کلاینت در حال اجرا.**

یک کلید واردشده TData/session را همزمان در تلگرام دسکتاپ و TgWitness اجرا نکنید. تلگرام می‌تواند مجوز مشترک (AUTH_KEY_DUPLICATED) را باطل کند. برای استفاده موازی، یک ورود جداگانه به TgWitness از طریق تلفن یا QR ایجاد کنید.

[هشدار وارد کردن جلسه را بخوانید](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=fa#session-warning)

**قبل از اتصال نگاهی بیندازید.**

فضای کاری فرضی را بدون حساب تلگرام امتحان کنید.

[راه‌اندازی دمو آنلاین →](https://phishdestroy.github.io/TgWitness/demo/?lang=fa)

ویندوز `scripts\Demo.cmd`لینوکس / مک‌اواس `sh start.sh --demo`

**دستورالعمل‌های نصب محلی**

مرحلهٔ ۰۱

### منبع را دریافت کنید.

[فایل ZIP منبع را دانلود](https://github.com/phishdestroy/TgWitness/archive/refs/heads/main.zip) و از حالت فشرده خارج کنید، یا مخزن را کلون کنید:

```
git clone https://github.com/phishdestroy/TgWitness.git
cd TgWitness
```

راه‌انداز منبع به پایتون ۳.۱۱ یا بالاتر نیاز دارد. راه‌انداز ویندوز در صورت عدم وجود پایتون، امکان نصب را فراهم می‌کند.

[مرور نسخه‌های منتشرشده](https://github.com/phishdestroy/TgWitness/releases)

پایتون روی ویندوز ندارید؟ [بستهٔ قابل حمل را دانلود کنید](https://github.com/phishdestroy/TgWitness/releases/download/v0.7.0/TgWitness-0.7.0-windows-amd64-portable.zip)، آن را استخراج کرده و روی `TgWitness.cmd` دوبار کلیک کنید.

مرحلهٔ ۰۲

### انتخاب کنید چگونه اجرا شود.

روی `Start.cmd` دوبار کلیک کنید، یا در PowerShell اجرا کنید:

```
.\Start.cmd
```

فقط در حال کاوش هستید؟ برای یک دمو جداگانه روی `scripts\Demo.cmd` دوبار کلیک کنید. نیازی به ورود به تلگرام نیست.

با پایتون ۳.۱۱+ و `venv` در دسترس:

```
sh start.sh
```

برای باز کردن مجلهٔ فرضی، دستور `sh start.sh --demo` را اجرا کنید.

با اجرای Docker و نصب Compose 2.20+:

```
docker compose up -d --build --wait
docker compose exec tgwitness cat /data/panel-token.txt
```

دستور دوم توکن پنل خصوصی شما را نمایش می‌دهد. آن را روی دستگاه خود نگه دارید.

پس از راه‌اندازی، [127.0.0.1:8787](http://127.0.0.1:8787) را باز کنید.

برای نصب از سورس، توکن در `data/live/panel-token.txt` قرار دارد. ورود به تلگرام می‌تواند از تنظیمات API داخلی استفاده کند یا از جفت توکن خودتان از [my.telegram.org](https://my.telegram.org). [راهنمای کامل راه‌اندازی ↗](https://phishdestroy.github.io/TgWitness/fa/docs/reference/quickstart/)

**TgWitness 0.7.0** [آخرین تغییرات →](https://phishdestroy.github.io/TgWitness/fa/docs/reference/changelog/) · [ویژگی‌ها و محدودیت‌های شناخته‌شده →](https://phishdestroy.github.io/TgWitness/fa/docs/reference/features/)

## دستورالعمل‌های واضح. یک گام بعدی مفید.

[راهنماها را کاوش کنید ↗](https://phishdestroy.github.io/TgWitness/fa/docs/)

[### مودها، سناریوها و سطوح شواهد چهار حالت جمع‌آوری. هشت سطح تأیید. گردش کار مناسب پرونده‌ی خود را بیابید.](https://phishdestroy.github.io/TgWitness/fa/guides/modes.html)

[01 ### اتصال یک حساب واردات از طریق تلفن، QR و جلسات پشتیبانی‌شده.](https://phishdestroy.github.io/TgWitness/fa/docs/accounts/)[02 ### یک پروکسی انتخاب کنید فهرست‌های عمومی MTProxy یا مسیر اختصاصی شما.](https://phishdestroy.github.io/TgWitness/fa/docs/proxies/)[03 ### راه‌اندازی یک بات شاهد نقاط کنترل امضا شده در کانال تلگرام شما.](https://phishdestroy.github.io/TgWitness/fa/docs/witness/)[04 ### صادرات و تأیید تاریخچه ضبط‌شده را به اشتراک بگذارید و یکپارچگی آن را بررسی کنید.](https://phishdestroy.github.io/TgWitness/fa/docs/exports/)

## روی آرشیو کار کنید.

بارگذاری تاریخچه، بازبینی منابع هوش مصنوعی، اتصال یک کلاینت MCP، شناسایی رسانه‌های ذخیره‌شده و ارسال وب‌هوک‌های امضا‌شده.

از منبع فعلی در دسترس است. نسخهٔ پیش‌نمایش قابل‌حمل‌ونقل ۰.۷.۰ پیش از این ابزارها منتشر شده است.

[جریان کاری را بررسی کنید](https://phishdestroy.github.io/TgWitness/fa/docs/archive/)

## قبل از شروع.

**آیا این صفحه به تلگرام متصل است؟**

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

**آیا می‌تواند پیام‌هایی را که قبل از ضبط حذف شده‌اند بازیابی کند؟**

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

**آیا کل دفترچهٔ یادداشت من رمزگذاری شده است؟**

اطلاعات حساب کاربری و اسرار امضایی در گاوصندوق رمزگذاری‌شده نگهداری می‌شوند. پیام‌ها و پیوست‌های محلی نیازمند یک دیسک یا حجم رمزگذاری‌شده هستند. خروجی‌ها به‌صورت اختیاری می‌توانند از فایل ZIP AES-256 محافظت‌شده با رمز عبور استفاده کنند.

**آیا این با تلگرام مرتبط است؟**

خیر. TgWitness یک پروژه مستقل است که از Telethon استفاده می‌کند و تحت مجوز MIT توزیع شده است. شما حساب‌های خود را با استفاده از تنظیمات داخلی API یا جفت API خود مجاز می‌کنید.

PROJECT NOTICE / LICENCE

## Operator incompatibility.

**Taylor Wessing PartG mbB — German core, Hamburg office.**

Our statement as the authors of TgWitness. It adds no condition to the MIT License. Read the complete notice and its source record.

[Read the complete notice](https://phishdestroy.github.io/TgWitness/docs/reference/notice/) [Original text](https://phishdestroy.github.io/TgWitness/NOTICE)

## ابتدا کاوش کنید. پس از آمادگی، راه‌اندازی کنید.

[دموی](https://phishdestroy.github.io/TgWitness/demo/?lang=fa)[راهنمای راه‌اندازی](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=fa)