بخشی از این صفحه هنوز به زبان انگلیسی است: متن اصلی انگلیسی پس از ترجمه تغییر کرده است.
منبع / راهاندازی
Telegram · راهاندازی سریع
هر روش نصب و راهاندازی TgWitness: بسته ویندوز، پایتون، داکر و دمو مصنوعی، همراه با بررسیهای اولیه.
انگلیسی · روسی · اوکراینی · اسپانیایی · پرتغالی (برزیل) · ترکی · عربی · فارسی · اردو · هندی · بهاسا اندونزی · تایلندی · فونت سادهشدهٔ چینی
TgWitness یک برنامه مستقل برای مشاهده گروهها و کانالهای تلگرامی است که حسابهای کاربری شما به آنها دسترسی دارند. این برنامه به صورت محلی و با دایرکتوری داده اختصاصی خود اجرا میشود.
اولین بازدید؟ قبل از اتصال یک حساب کاربری، دمو را بررسی کنید. یک راهنما برای پروکسیها، شاهدان، خروجیها یا راهاندازی سرور انتخاب کنید. GitHub Actions ضبط (پیشنمایش) یک اجرا را در شاخه 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 و ویندوز، پنل محلی در مرورگر شما باز میشود. در بخش اتصال تلگرام در زیر ادامه دهید. نصب، تأیید و بهروزرسانی شامل گزینههای دسترسی به سرور، بررسی اسکریپت قبل از اجرا، بهروزرسانیها و حذف است.
سایر روشها#
انتشارها در گیتهاب، سورس و داکر جایگزینهای نصبکننده هستند. دانلودهای قابل حمل پس از انتشار یک نسخه ساخت (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 فعلی را دانلود و استخراج کنید یا مخزن را کلون کنید:
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 خودکار، راهاندازی مجدد، تصاویر منتشرشده، بهروزرسانیها و پشتیبانگیریها است.
رابط کاربری را کاوش کنید#
- دستور TgWitness-Demo.cmd
را
در بستهٔ قابل حمل، scripts\Demo.cmd
را در یک پوشهٔ منبع ویندوز، یا
sh start.sh --demoرا در لینوکس/macOS اجرا کنید. اجرای سورس ابتدا.venvرا ایجاد کرده و وابستگیها را نصب میکند. - http://127.0.0.1:8787 را باز کنید.
- دموی محلی بهطور خودکار دفترچه نمونه را باز میکند. برای دسترسی مستقیم محلی نیازی به کپی توکن نیست.
پیامهای دمو خیالی هستند. حالت دمو نمیتواند به یک حساب واقعی تلگرام متصل شود.
اتصال تلگرام#
[!هشدار] از حسابهای اختصاصی استفاده کنید. تلگرام میتواند حسابها را به دلیل حجم درخواستهایی که بیش از حد میداند، صرفنظر از کلاینت، محدود یا برای همیشه مسدود کند. حسابهایی را که برای مشاهده آماده شدهاند به جای حسابهای شخصی یا باارزش به آن متصل کنید و یک شناسه/هش API روی یک حساب اختصاصی ایجاد کنید.
- اگر دموی بومی در حال اجرا باشد، آن را متوقف کرده و Start.cmd یا
sh start.shرا اجرا کنید. در غیر این صورت، نصب زندهٔ بالا را همچنان در حال اجرا نگه دارید. - برای ورود از توکن پنل استفاده کنید. یک فضای کاری جدید باز میشود، ابتدا آن را راهاندازی کنید. فقط دانلود، دنبال کردن چتها یا شواهد برای یک پرونده را انتخاب کنید.
- بررسی اتصال را مرور کنید. در صورت نیاز، پروکسی خود را پیکربندی کنید؛ تنظیمات اتصال پس از راهاندازی در دسترس باقی میمانند.
- در Connect Telegram، یک شماره تلفن، یک کد QR، فایلهای حساب (TData،
.session، StringSession، فایل JSON حساب) یا یک کلید مجوز کامل. در صورت درخواست، تأیید تلگرام، کد و رمز عبور دو مرحلهای را تکمیل کنید. - حساب نمایشدادهشده را بررسی کنید، چتها را انتخاب کرده و تنظیمات خود را مرور کنید. از صفحه نهایی، پایان را انتخاب کنید. برای فقط دانلود، شروع صادرات یک صادرات یکباره را آغاز میکند و صادراتها را برای نمایش پیشرفت آن باز میکند؛ این کار مشاهده مداوم را فعال نمیکند.
پس از راهاندازی، گزینهی Chats → Choose چتهای انتخابشده را تغییر میدهد. Settings کنترلهای مربوط به جمعآوری و فایلها را در اختیار دارد؛ More tools → Sources فهرست منابع را در سطح استاندارد یا حرفهای به تفصیل ارائه میدهد. راهنمای پنل، شش بخش اصلی و کنترلهای متناسب با هر بخش را توصیف میکند.
ID API + هش اختیاری است: فضای کاری از جفت ذخیره شده یا وارد شده خود، یا یک جفت فعال از مجموعه داخلی استفاده میکند. برای استفاده از برنامه خود، یکی را جایگذاری کنید
API ID:API Hash یک جفت را در بخش شناسه API قرار دهید. برای کلید احراز هویت، تمام 512 کاراکتر هگزادسیمال را الصاق کرده و شناسه DC ارائهشده را انتخاب کنید. شناسه کاربر اختیاری است و در صورت وارد کردن، بررسی میشود.
اطلاعات اعتبارنامه API، برنامه شما را شناسایی میکنند؛ آنها به خودی خود، حساب کاربری را مجاز نمیسازند. گروههای خصوصی به نام کاربری عمومی نیازی ندارند، اما حساب کاربری شما باید دسترسی داشته باشد.
For existing accounts, see accounts and session formats: 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 همراه بر اساس نام پایهٔ فایل جفت میشوند؛ هر حساب واردشده فضای کاری مخصوص به خود را دریافت میکند. بخش وارد کردن دستهای و گروههای حساب را ببینید.
برای افزودن حساب کاربری دیگر، علامت + را در کنار انتخابگر حساب کاربری فشار دهید یا از مسیر حسابها → افزودن حساب کاربری استفاده کنید. فضاهای کاری دارای جلسات، ژورنالها، کلیدها، منابع و صفهای جداگانهای هستند. تغییر نماها باعث میشود سایر گردآورندهها همچنان در حال اجرا باقی بمانند. یک حساب تلگرام نمیتواند در این نصب به دو فضای کاری اختصاص داده شود. تعداد ثابتی از فضاهای کاری وجود ندارد؛ آنها یک فرآیند را به اشتراک میگذارند، بنابراین ظرفیت به ماشین بستگی دارد.
توکن پنل زنده از دسترسی به مجوزهای تلگرام و مطالب ذخیرهشده شما محافظت میکند؛ این توکن از اعتبارنامههای 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 مراجعه کنید.
- تأیید دفترچه: بررسی امضاهای رویداد و پیوندهای زنجیره. خروجی 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 مراجعه کنید.
توقف مشاهده جمعآوری را متوقف میکند. قفل کردن فقط دسترسی از طریق مرورگر را میبندد. با بستن زبانه، فرایند جمعآوری همچنان اجرا میشود. متوقف کردن فرایند، جمعآوری را قطع میکند؛ ثبت تاریخچه نمیتواند تمام ویرایشها یا حذفهای ازدسترفته را بازسازی کند. برای سیاستهای رویدادها، صفهای پیوست، جداسازی حسابها و رفتار هنگام راهاندازی مجدد، نحوهٔ کار جمعآوری را ببینید.
جلسات و اسرار رمزگذاری میشوند. محتوای پیام، رسانهها و خروجیها به یک دیسک یا حجم رمزگذاریشده نیاز دارند. امضاهای دفترچه خاطرات را با یک کلید مورد اعتماد تأیید کنید و نقاط کنترل را بهطور جداگانه نگهداری کنید. سوابق ضبط، رسیدهای زمانی خارجی و گواهیهای محیطی را برای حالت جمعآوری انتخابشده بازبینی کنید.
برای پشتیبانگیری/بازیابی فایل OPERATIONS.md، برای میزبانی فایل DEPLOYMENT.md و برای نمونههای سرویس به deploy/ مراجعه کنید. پنل نصبشده همچنین شامل یک راهنمای راهاندازی آفلاین در آدرس /guide.html است.
تأیید واقعی و محدودیتهای باقیمانده در فایلهای VERIFICATION.md و READINESS.md ثبت شدهاند.