# Telegram · راه‌اندازی سریع

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

هر روش نصب و راه‌اندازی TgWitness: بسته ویندوز، پایتون، داکر و دمو مصنوعی، همراه با بررسی‌های اولیه.

[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: بسته ویندوز، پایتون، داکر و دمو مصنوعی، همراه با بررسی‌های اولیه.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [مستندسازی](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![شروع کار](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2)

**انگلیسی** · [روسی](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.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) (پیش‌نمایش) یک اجرا را در شاخه GitHub خود به جای نصب محلی انجام می‌دهد.

## نصب و راه‌اندازی

نصب‌کنندهٔ راهنمایی‌شده شامل پایتون خود است و پیش از نصب، هش‌های بسته و امضاهای نسخه را بررسی می‌کند. اجرای مجدد آن، نصب موجود را به‌روزرسانی می‌کند.

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

```
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"
```

در سرور اوبونتو، برای نصب یک سرویس پس‌زمینه به عنوان root اجرا کنید؛ در دسکتاپ، به عنوان کاربر عادی خود اجرا کنید. در اوبونتو، نصاب آدرس پنل و کلید دسترسی را چاپ می‌کند؛ در macOS و ویندوز، پنل محلی در مرورگر شما باز می‌شود. در بخش **اتصال تلگرام** در زیر ادامه دهید. [نصب، تأیید و به‌روزرسانی](https://phishdestroy.io/tgwitness/fa/docs/reference/installation/) شامل گزینه‌های دسترسی به سرور، بررسی اسکریپت قبل از اجرا، به‌روزرسانی‌ها و حذف است.

### سایر روش‌ها

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

| میزبان | هیچ چیزی نصب نشده است | منبع: پایتون ۳.۱۱+ | داکر: انجین/دسکتاپ با Compose 2.20+ |
| --- | --- | --- | --- |
| ویندوز | `TgWitness-<version>-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.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 روی یک حساب اختصاصی ایجاد کنید.

1. اگر دموی بومی در حال اجرا باشد، آن را متوقف کرده و **Start.cmd** یا `sh start.sh` را اجرا کنید. در غیر این صورت، نصب زندهٔ بالا را همچنان در حال اجرا نگه دارید.
2. برای ورود از توکن پنل استفاده کنید. یک فضای کاری جدید باز می‌شود، [ابتدا آن را راه‌اندازی کنید](https://phishdestroy.io/tgwitness/fa/docs/reference/settings/). **فقط دانلود**، **دنبال کردن چت‌ها** یا **شواهد برای یک پرونده** را انتخاب کنید.
3. بررسی اتصال را مرور کنید. در صورت نیاز، پروکسی خود را پیکربندی کنید؛ تنظیمات اتصال پس از راه‌اندازی در دسترس باقی می‌مانند.
4. در **Connect Telegram**، یک شماره تلفن، یک کد QR، فایل‌های حساب (TData، `.session`، StringSession، فایل JSON حساب) یا یک کلید مجوز کامل. در صورت درخواست، تأیید تلگرام، کد و رمز عبور دو مرحله‌ای را تکمیل کنید.
5. حساب نمایش‌داده‌شده را بررسی کنید، چت‌ها را انتخاب کرده و تنظیمات خود را مرور کنید. از صفحه نهایی، پایان را انتخاب کنید. برای **فقط دانلود**، **شروع صادرات** یک صادرات یک‌باره را آغاز می‌کند و صادرات‌ها را برای نمایش پیشرفت آن باز می‌کند؛ این کار مشاهده مداوم را فعال نمی‌کند.

پس از راه‌اندازی، **گزینه‌ی Chats → Choose** چت‌های انتخاب‌شده را تغییر می‌دهد. **Settings** کنترل‌های مربوط به جمع‌آوری و فایل‌ها را در اختیار دارد؛ **More tools → Sources** فهرست منابع را در سطح استاندارد یا حرفه‌ای به تفصیل ارائه می‌دهد. [راهنمای پنل](https://phishdestroy.io/tgwitness/fa/docs/reference/panel/)، شش بخش اصلی و کنترل‌های متناسب با هر بخش را توصیف می‌کند.

**ID API + هش** اختیاری است: فضای کاری از جفت ذخیره شده یا وارد شده خود، یا یک جفت فعال از مجموعه داخلی استفاده می‌کند. برای استفاده از برنامه خود، یکی را جای‌گذاری کنید `API ID:API Hash` یک جفت را در بخش شناسه API قرار دهید. برای **کلید احراز هویت**، تمام 512 کاراکتر هگزادسیمال را الصاق کرده و شناسه DC ارائه‌شده را انتخاب کنید. شناسه کاربر اختیاری است و در صورت وارد کردن، بررسی می‌شود.

اطلاعات اعتبارنامه API، برنامه شما را شناسایی می‌کنند؛ آن‌ها به خودی خود، حساب کاربری را مجاز نمی‌سازند. گروه‌های خصوصی به نام کاربری عمومی نیازی ندارند، اما حساب کاربری شما باید دسترسی داشته باشد.

For existing accounts, see [accounts and session formats](https://phishdestroy.io/tgwitness/fa/docs/reference/accounts/): the panel accepts Telethon StringSession, Telethon/Pyrogram SQLite, single-account TData ZIP, and supported account JSON. Select a session and its companion JSON together, press **Check files**, then **Connect account**. QR login is also available with the same optional API settings. TDLib, bot sessions and CSV/JSON account inventories are unsupported.

برای چندین حساب، از **حساب‌ها → وارد کردن حساب‌ها** استفاده کنید و فایل‌های نشست پشتیبانی‌شدهٔ آن‌ها را انتخاب نمایید. فایل‌های JSON همراه بر اساس نام پایهٔ فایل جفت می‌شوند؛ هر حساب واردشده فضای کاری مخصوص به خود را دریافت می‌کند. بخش [وارد کردن دسته‌ای و گروه‌های حساب](https://phishdestroy.io/tgwitness/fa/docs/reference/accounts/#bulk-import-and-account-groups) را ببینید.

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

توکن پنل زنده از دسترسی به مجوزهای تلگرام و مطالب ذخیره‌شده شما محافظت می‌کند؛ این توکن از اعتبارنامه‌های API تلگرام جداست. تنها یک دمو محلی که صراحتاً راه‌اندازی شده و مستقیماً به آن دسترسی پیدا شده باشد، ورود خودکار خواهد داشت. یک دمو از راه دور/پروکسی همچنان از `data/demo/panel-token.txt` استفاده می‌کند.

## بازبینی و صدور

- **مجله:** جستجو و فیلتر کردن مشاهدات بر اساس منبع و نوع رویداد.
- یک رویداد را انتخاب کنید تا رکورد اصلی، انتساب و نسخه‌های ذخیره‌شده آن را بررسی کنید.
- جزئیات ویرایش محتوای موجود قبل و بعد را نشان می‌دهند. جزئیات حذف، در صورت وجود، آخرین محتوای ضبط‌شده را نشان می‌دهند؛ عامل ناشناس همچنان ناشناس باقی می‌ماند.
- **خروجی‌ها:** ZIP امضا‌شده، JSONL، CSV و HTML آفلاین.
- **خروجی کامل چت** (**Chats → Export chat**، یا **Exports → Capture or export one chat**): دانلود کل تاریخچه قابل مشاهده یک چت به عنوان یک بسته امضا شده با فایل `chat.json` (به سبک خروجی تلگرام) و یک فایل قابل خواندن `chat.html`. چت‌های خصوصی زمانی کار می‌کنند که حساب کاربری عضو باشد. این یک نسخه لحظه‌ای فعلی است، نه بازسازی پیام‌های حذف شده یا ویرایش شده قبلی. یک کپی را با دستور `python verify.py chat-export.zip --fingerprint TRUSTED_SHA256` تأیید کنید.
- **ذخیره نقطه کنترل:** مرز دفترچهٔ امضا شده را خارج از جمع‌کننده نگه دارید.
- **دانلود رسید اجرای امضا شده:** حفظ سوابق برنامه/نسخهٔ گردآورنده.
- **درخواست مهر زمانی را آماده کنید:** یک درخواست آفلاین برای یک مرجع مهر زمانی آماده کنید؛ برای دریافت و تأیید پاسخ، به [فایل TIMESTAMP.md](https://phishdestroy.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` را اضافه کنید. محدودیت پیش‌فرض انتقال 5 گیگابایت است؛ `--max-mib` آن را تغییر می‌دهد. محتوای ZIP امضا شده به طور پیش‌فرض دارای محدودیت تأیید جداگانه 4 گیگابایت بدون فشرده‌سازی است (**گزینه More tools → Parameters** این مقدار را افزایش می‌دهد؛ چنین آرشیوهایی را با دستور `verify.py --max-gib N` تأیید کنید). آرشیو را با استفاده از یک نسخه معتبر از ابزار تأییدگر، یک اثر انگشت کلید که به طور مستقل نگهداری شده و برای حداقل مدرک، گواهی ریشه مرجع تاریخ‌نگاری (timestamp authority) تأیید کنید (`--tsa-ca`).

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

```
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 استفاده کنند، مگر اینکه آن محیط از قبل فعال باشد.

## جلسات، حفاظت و عملکرد

یک فایل `.session` بسته و سازگار با Telethon SQLite را می‌توان به صورت محلی با دستور `python -m tgwitness.sessions account.session --out account.tgwitness-session` تبدیل کرد، سپس در بخش**ابزارهای بیشتر → حساب → فایل‌ها** بارگذاری نمود. وارد کردن مستقیم فایل و ورود با QR نیز در دسترس است. برای مشاهده فرمت‌های ورود، SOCKS5، HTTP CONNECT، MTProxy و کلیدهای اصلی خارجی به [CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/fa/docs/reference/connection/) مراجعه کنید.

**توقف مشاهده** جمع‌آوری را متوقف می‌کند. **قفل کردن** فقط دسترسی از طریق مرورگر را می‌بندد. با بستن زبانه، فرایند جمع‌آوری همچنان اجرا می‌شود. متوقف کردن فرایند، جمع‌آوری را قطع می‌کند؛ ثبت تاریخچه نمی‌تواند تمام ویرایش‌ها یا حذف‌های ازدست‌رفته را بازسازی کند. برای سیاست‌های رویدادها، صف‌های پیوست، جداسازی حساب‌ها و رفتار هنگام راه‌اندازی مجدد، [نحوهٔ کار جمع‌آوری](https://phishdestroy.io/tgwitness/fa/docs/reference/collection/) را ببینید.

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

برای پشتیبان‌گیری/بازیابی [فایل OPERATIONS.md](https://phishdestroy.io/tgwitness/fa/docs/reference/operations/)، برای میزبانی [فایل DEPLOYMENT.md](https://phishdestroy.io/tgwitness/fa/docs/reference/deployment/) و برای نمونه‌های سرویس به [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) مراجعه کنید. پنل نصب‌شده همچنین شامل یک راهنمای راه‌اندازی آفلاین در آدرس `/guide.html` است.

تأیید واقعی و محدودیت‌های باقی‌مانده در [فایل‌های VERIFICATION.md](https://phishdestroy.io/tgwitness/fa/docs/reference/verification/) و [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md) ثبت شده‌اند.
