# Telegram · اتصال، پروکسی‌ها و حفاظت از داده‌ها

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

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

[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.

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

[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)

این سند توصیف می‌کند TgWitness 0.9.3 رفتار و محدودیت‌های آن. احراز هویت، دسترسی به منبع، اتصال شبکه و کامل بودن ضبط، حالات جداگانه‌ای هستند. برای مراحل ورود، فرمت‌های فایل و حساب‌های متعدد، با فرمت‌های حساب و جلسه شروع کنید. برای سیاست‌های رویداد و رفتار راه‌اندازی مجدد، ببینید که چگونه جمع‌آوری کار می‌کند. [حساب‌ها و قالب‌های جلسه](https://phishdestroy.io/tgwitness/fa/docs/reference/accounts/). برای سیاست‌های رویداد و رفتار راه‌اندازی مجدد، ببینید [نحوه کارکرد جمع‌آوری](https://phishdestroy.io/tgwitness/fa/docs/reference/collection/).

## راه‌اندازی اتصال هدایت‌شده

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

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

فرآیند اعمال (Apply) تا ۹۰ ثانیه، نتیجه موفقیت‌آمیز پیش‌پرواز (preflight) را در صورتی که مسیر، حالت و سیاست آن بدون تغییر باقی بماند، مجدداً استفاده می‌کند. یک تونل مدیریت‌شده باید همچنان فرآیند در حال اجرای یکسانی داشته باشد. نتایج قدیمی‌تر، فرآیندهای تونل تغییر یافته و مسیرهای خودکار استخر MTProxy مجدداً بررسی می‌شوند. رکورد درخواست امضا شده، زمان بررسی اصلی را حفظ کرده و بازاستفاده و سن آن را ثبت می‌کند. هر فرآیند پیش‌پرواز، کلاینت موقت و بدون احراز هویت خود را می‌بندد؛ و گردآورنده (collector) با استفاده از جلسه مجاز خود متصل می‌شود.

| مسیر | TgWitness چه چیزی را مدیریت می‌کند |
| --- | --- |
| مستقیم | اتصالات از میزبان؛ VPN میزبان خارجی شناسایی یا اعمال نمی‌شود. |
| وی‌پی‌ان | یک پروفایل کامل تونل WireGuard برای هر حساب کاربری، که توسط یک فرآیند محلی کاربرانpace SOCKS5 اجرا می‌شود. هیچ رابط میزبان یا درایوری نصب نشده است. |
| پروکسی من | SOCKS5، HTTP CONNECT یا اعتبارنامه‌های MTProxy. یک URL می‌تواند فیلدهای SOCKS5/HTTP را پر کند. انتخاب چندین حساب این پروکسی واردشده را به اشتراک می‌گذارد. |
| MTProto عمومی | استخر موجود مسیرهای Telegram را اختصاص می‌دهد. درخواست‌های خارجی تا زمانی که یک پروکسی مناسب جداگانه در تنظیمات پیشرفته پیکربندی نشود، غیرفعال هستند. |
| WARP | یک تونل محلی جداگانه برای هر حساب انتخاب‌شده، با ثبت‌نام WARP و پروفایل WireGuard نگهداری‌شده در گاوصندوق آن حساب. |

بررسی مسیر فعلی از یک اتصال ترنسپورت تلگرام جدید و بدون احراز هویت استفاده می‌کند، نه جلسه حساب کاربری. این اتصال، یک ارتباط ترنسپورت را از طریق مسیر به مرکز داده حساب کاربری باز می‌کند و یک دور رفت و برگشت MTProto بدون احراز هویت انجام می‌دهد (`req_pq_multi`)؛ هیچ کلید احراز هویتی ایجاد نمی‌کند و از هیچ حسابی استفاده نمی‌کند. تأخیر گزارش‌شده، زمان اتصال به علاوه زمان رفت و برگشت است و بررسی، هر دو بخش را به‌طور جداگانه ثبت می‌کند. برای مسیرهای دارای قابلیت HTTP، همچنین درخواست می‌کند ردیابی HTTPS کلودفلر از طریق آن مسیر را درخواست می‌کند و IP خروجی گزارش‌شده، کشور، وضعیت WARP و زمان بررسی آن را نمایش می‌دهد. آماده‌سازی WARP مگر اینکه ردیابی، فعال بودن WARP را گزارش دهد، ناموفق است. این بررسی‌های پیش از پرواز، اتصال مسیر و خروج مشاهده‌شده را گزارش می‌دهند. سوابق ضبط‌شده را از طریق نتایج به‌دست‌آوردن و تأیید آرشیو مرور کنید. تنها یک فرآیند محلی در حال اجرا به معنای یک بررسی خروج موفق نیست.

پنل میانگین متحرک پنج چک آخر را نگه می‌دارد. یک مسیر است **آهسته** وقتی میانگین از ۵ ثانیه تجاوز کند یا سه بررسی متوالی از آن فراتر روند، و **در دسترس نیست** پس از دو چک برگشتی پیاپی؛ `network.slow_route` و `network.route_recovered` تغییرات را ثبت کنید. برای یک مسیر WARP کند، **ری‌رول وارپ** تونل حساب کاربری را با سایر نقاط پایانی Cloudflare WARP مجدداً راه‌اندازی می‌کند، سریع‌ترین را ثبت و نگهداری می‌کند `network.warp_rerolled` با زمان‌های قبل و بعد؛ **هویت جدید WARP** یک دستگاه 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` | جلسه کاربری تولید بسته شد | وارد کردن مستقیم اسکیماها از پنل ۲/۳ |
| تلگرام دسکتاپ TData ZIP | یک حساب مدرن؛ رمز عبور محلی در صورت محافظت‌شده | تبدیل در حافظه همراه با بررسی‌های چک‌سام و رمزگشایی |
| JSON حساب | میدان‌های پشتیبانی‌شدهٔ API/جلسه/کلید | فقط متادیتا برای پر کردن اعتبارنامه‌های API کافی است؛ ورود با جلسه/کلید یا تلفن/QR همچنان لازم است |
| ورود با QR | تأیید از یک اپلیکیشن تلگرام مجاز | تولید QR محلی، انقضا/تکرار تلاش، احراز هویت دو مرحله‌ای اختیاری |
| TDLib / Pyrogram StringSession | فرمت‌های دیگر مخصوص کتابخانه | پشتیبانی‌نشده |
| توکن بات | یک ربات با مدل دسترسی/به‌روزرسانی اختصاصی خود | توسط این گردآورنده استفاده نشده است |

تلگرام ارسال کد را انتخاب می‌کند، از جمله اینکه آیا پیامک ارسال شود یا خیر. یک هش API نمی‌تواند یک جلسه لغو شده را ترمیم کند یا رمز عبور 2FA فراموش شده را جایگزین نماید. TgWitness کدهای ورود یا رمز عبور 2FA تلگرام را روی دیسک ذخیره نمی‌کند. 2رمز عبور ۲FA. TgWitness حفظ نمی‌کند کدهای ورود یا تلگرام 2رمز عبور ۲FA را روی دیسک ذخیره نمی‌کند.

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

## وارد کردن فایل جلسه تله‌تون

Telethon SQLite, Pyrogram SQLite, and Telegram Desktop TData use different formats. The panel detects and converts the supported structures; renaming a file is not conversion. Select one session and its companion JSON under **Files**, press **Check files**, then **Connect account**. Up to four matching files and 8 MiB total are accepted. See [format limits](https://phishdestroy.io/tgwitness/fa/docs/reference/accounts/) for TData/JSON details. There is no passcode recovery. Phone/2FA or QR login creates a separate authorization.

مسیر خط فرمان اختیاری مخصوص تله‌تون همچنان در دسترس است:

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 خودکار · لیست‌های عمومی** با **پنهان کردن آدرس**» تنظیم می‌شوند. فضاهای کاری موجود که صراحتاً از مستقیم استفاده می‌کردند، حالت اجازهٔ آن را حفظ می‌کنند.

فایل‌ها از طریق اتصالات جداگانه‌ای از اتصالی که پیام‌ها را می‌خواند، خوانده می‌شوند، همان‌طور که اپلیکیشن‌های رسمی انجام می‌دهند. در مرکز دادهٔ خود حساب، کلید مجوز حساب را با یک جلسهٔ جدید MTProto مجدداً استفاده می‌کنند؛ برای مرکز دادهٔ دیگر یک کلید ایجاد و در حالی که حساب متصل است مجاز می‌شود و تنها در حافظه نگهداری می‌شود. هر اتصال فایل از همان مسیر حساب استفاده می‌کند. تعداد آن‌ها در هر مرکز داده توسط **پارامترها → عملکرد → اتصالات فایل به ازای هر مرکز داده تلگرام**; ۰ فایل‌ها را تنها از طریق اتصال اصلی حساب می‌خواند. حداکثر پنج اتصال تلگرام به طور همزمان در سراسر تمام حساب‌های یک نصب برقرار می‌شوند.

## مُدهای 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)، [Therealwh/MTPproxyLIST،](https://github.com/Therealwh/MTPproxyLIST) [KhodeJav/telegram-proxy-collector](https://github.com/KhodeJav/telegram-proxy-collector) و [tgmtproxy/telegram-mtproto-proxy-list](https://github.com/tgmtproxy/telegram-mtproto-proxy-list). اسنپ‌شات ضمیمه‌شده حاوی اطلاعات انتهای نقطه (endpoint facts)، انتساب منبع و تاریخ‌های دانلود است. فهرست‌ها ورودی‌ها هستند؛ بررسی‌های اتصال زیر تعیین می‌کنند که از کدام پروکسی‌ها استفاده می‌شود.

**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.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 محافظت می‌شوند؛ چت‌های مخفی سرتاسری (End-to-end) یک نوع چت جداگانه هستند که توسط [ماژول چت مخفی](https://phishdestroy.io/tgwitness/fa/docs/reference/secret-chats/) ضبط می‌شوند.

## رمزنگاری و امضاها

| لایه | پیاده‌سازی شد | مسئولیت اپراتور |
| --- | --- | --- |
| ترافیک تلگرام | تله‌تون MTProto | اعتماد پلتفرم، مسیر و در دسترس بودن |
| پنل وب | توکن حامل، لوپ‌بک پیش‌فرض، محدودیت‌های درخواست | تونل HTTPS یا SSH برای دسترسی از راه دور |
| رازها | فرنت برای اعتبارنامه‌های API، اعتبارنامه‌های جلسه، اعتبارنامه‌های پروکسی و کلید خصوصی امضا | از کلید رمزگشایی و میزبان در حال اجرا محافظت کنید |
| کلید گاوصندوق | کلید محلی، یا کلید اصلی خارجی برای نصب جدید | جداسازی ذخیره‌سازی محافظت‌شده و پشتیبان‌گیری کلید |
| پیام‌ها و پیوست‌ها | ذخیره‌سازی متن سادهٔ برنامه | دیسک/حجم رمزگذاری‌شده |
| ZIP/JSONL/CSV/HTML | بررسی‌های یکپارچگی، عدم رمزنگاری محتوا | حفاظت از نسخه‌های صادرشده و انتقال‌ها |
| منشأ و زمان | دفترچه ثبت امضا شده، رسید فرایند، ابزارهای RFC 3161 | کلید مورد اعتماد، نقاط بازرسی مستقل/TSA و رویهٔ نگهداری |

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

BitLocker، LUKS، FileVault یا یک حجم رمزگذاری‌شده مدیریت‌شده می‌توانند از ذخیره‌سازی تحت مدل‌های تهدید مربوطه محافظت کنند. یک مدیر یک ماشین در حال اجرا که قفل نشده است، همچنان می‌تواند داده‌ها را بخواند. در برنامه‌ریزی ذخیره‌سازی، SQLite WAL/SHM، رسانه‌ها، خروجی‌های موقت، اسواپ، پشتیبان‌ها و دانلودهای مرورگر را نیز در نظر بگیرید. یک حجم داکر صرفاً به این دلیل که یک حجم است، رمزگذاری نمی‌شود.

## کلید اصلی خارجی

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

```
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` یا جایگزینی یک کلید اصلی می‌تواند دسترسی به جلسات/کلیدهای امضا را از بین ببرد. پشتیبان‌های رمزگذاری‌شده و کلیدها را جداگانه نگه دارید و بازسازی را در یک محیط ایزوله آزمایش کنید.
