TgWitness / Dokumentatsiya

Nima sinovdan o'tkazilgan →

Ushbu sahifaning ba'zi qismlari hanuz ingliz tilida: inglizcha asl matn tarjima qilinganidan keyin o'zgartirilgan.

Manba / Sozlash

Telegram · Tez boshlash

TgWitness-ni o'rnatish va ishga tushirishning barcha usullari: Windows paketi, Python, Docker va sintetik demo, dastlabki tekshiruvlar bilan.

TgWitness / Hujjatlash

Boshlash

Inglizcha · Rus tili · Ukrain tili · Ispancha · Portugalscha (Braziliya) · Turkcha · Arab tili · Farsi · O'rdu · hindicha · Indoneziya tili · Vyetnam tili · Xoʻllashma xitoycha

TgWitness – bu mustaqil dastur bo'lib, u sizning hisoblaringiz kira oladigan Telegram guruhlari va kanallarini kuzatadi. U mahalliy tarzda, o'z ma'lumotlar katalogi bilan ishlaydi.

Birinchi marta tashrif buylyapsizmi? Hisobni ulashdan oldin demo bilan tanishing. Proxylar, guvohlar, eksport yoki serverni sozlash bo'yicha qo'llanma tanlang. GitHub Actions capture (preview) mahalliy o'rnatish o'rniga o'zingizning GitHub forkingizda ishga tushirishni amalga oshiradi.

O'rnatish va ishga tushirish#

Qadam-ba-qadam o'rnatiladigan o'rnatuvchi o'zining Python va checks paketlarining hashlarini va chiqarish imzolarini o'rnatishdan oldin tekshiradi. Uni qayta ishga tushirish mavjud o'rnatmani yangilaydi.

Linux / macOS:

curl -fsSL https://get.destroy.tools/install.sh | bash

Windows (PowerShell yoki Command Prompt):

powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"

Ubuntu serverida fon xizmatini o'rnatish uchun root sifatida ishga tushiring; ish stolidagi kompyuteringizda esa oddiy foydalanuvchi sifatida ishga tushiring. Ubuntu'da o'rnatuvchi panel manzili va kirish kalitini chiqaradi; macOS va Windows'da esa mahalliy panel brauzeringizda ochiladi. Telegram'ga ulanish bo'limida davom eting. O'rnatish, tekshirish va yangilash bo'limida serverga ulanish variantlari, skriptni ishga tushirishdan oldin tekshirish, yangilanishlar va o'chirish masalalari ko'rib chiqiladi.

Boshqa usullar#

GitHub relizlari, manba kodi va Docker o'rnatgichga muqobil hisoblanadi. Portativ yuklab olishlar reliz-build nashr etilgach mavjud bo'ladi:

Mehmondo'st Hech narsa o'rnatilmagan Manba: Python 3.11+ Docker: Engine/Desktop, Compose 2.20+ bilan
Windows TgWitness-<version>-windows-amd64-portable.zipni GitHub Releases'dan yuklab oling, TgWitness.cmd ustiga ikki marta bosing Start.cmd ustiga ikki marta bosing scripts\Docker.cmd ustiga ikki marta bosing
Linux / macOS — sh start.sh sh scripts/docker-start.sh

Manba kodidan foydalanish usullari uchun joriy main tarmog‘ini yuklab oling va arxivdan chiqaring yoki repozitoriyni klonlang:

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

Agar mos Python topilmasa, Start.cmd Windows foydalanuvchingiz uchun Python 3.12 ni o‘rnatishni taklif qiladi (winget yoki imzolangan python.org o‘rnatuvchisi orqali). Agar Python mavjud bo‘lmasa, start.sh Linux distributivingiz yoki macOS uchun aniq o‘rnatish buyrug‘ini chiqaradi. Manbadan birinchi marta ishga tushirilganda .venv yaratiladi va bog‘liqliklar avtomatik ravishda o‘rnatiladi.

Docker ilovani kompilyatsiya qilib, uni fon rejimida ishga tushiradi; host Python keraksiz. scripts\Docker.cmd va scripts/docker-start.sh konteyner sog'lom holatda bo'lganda panel manzili va tokenni chop etadi. Har bir qo'llab-quvvatlanadigan hostdagi ekvivalent Docker buyruqlari quyidagilardan iborat:

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

http://127.0.0.1:8787 saytini oching. Docker yordamchisi yoki ikkinchi Docker buyrug'i tomonidan chop etilgan tokenni ishlating yoki portativ yoki manba o'rnatilmasida data/live/panel-token.txt faylini o'qing. Qolgan qismni quyidagi "Telegramga ulanish" bo'limida davom ettiring. Native va Docker o'rnatmalari alohida saqlashdan foydalanadi; Docker-ni ishga tushirish mavjud native jurnalni import qilmaydi.

Server uchun joylashtirish avtomatik HTTPS, qayta ishga tushirish, e'lon qilingan tasvirlar, yangilanishlar va zaxira nusxalarini o'z ichiga oladi.

Interfeysni o'rganing#

  1. Portativ paketdagi TgWitness-Demo.cmd , Windows manba papkasidagi scripts\Demo.cmd yoki Linux/macOS'da sh start.sh --demo ni ishga tushiring. Manba kodni ishga tushirish avvalo .venv ni yaratadi va zarur kutubxonalarni o'rnatadi.
  2. http://127.0.0.1:8787 saytini oching.
  3. Mahalliy demo namunaviy jurnalni avtomatik ochadi. To'g'ridan-to'g'ri mahalliy kirish uchun token nusxasini ko'chirish shart emas.

Demo xabarlari badiiydir. Demo rejimi haqiqiy Telegram hisobiga ulanmaydi.

Telegramga ulanish#

[!OGOHLANTIRISH] Maxsus hisobvaraqlardan foydalaning. Telegram so'rov hajmlari ortiqcha deb hisoblagan holatlarda, mijoz qaysi bo'lishidan qat'i nazar, hisobvaraqlarni cheklashi yoki doimiy taqiqlashi mumkin. Shaxsiy yoki qimmatbaho hisobvaraqlar o'rniga kuzatuv uchun tayyorlangan hisobvaraqlarni ulang va maxsus hisobvaraqda API ID / hash yarating.

  1. Agar mahalliy demo ishlamoqda bo'lsa, uni to'xtating va Start.cmd yoki sh start.sh faylini ishga tushiring. Aks holda, yuqorida jonli o'rnatishni ishga tushirgan holda qoldiring.
  2. Paneldagi token yordamida tizimga kiring. Yangi ish maydoni ochiladi va birinchi sozlamalar namoyish etiladi. 'Faqat yuklab olish', 'Suhbatlarni kuzatish' yoki 'Dalillar'ni tanlang.
  3. Ulanishni tekshirishni ko'rib chiqing. Agar kerak bo'lsa, o'zingizning proksingizni sozlang; ulanish sozlamalari sozlashdan keyin ham mavjud bo'ladi.
  4. Connect Telegramda telefon raqamini, QR kodni, hisob fayllarini (TData, .session, StringSession, hisob JSON) yoki to'liq avtorizatsiya kalitini tanlang. So'ralganda Telegram tasdig'i, kod va ikki bosqichli parolni kiriting.
  5. Ko'rsatilgan hisobni tekshiring, suhbatlarni tanlang va sozlamalaringizni ko'rib chiqing. Yakuniy ekrandan tugating. Faqat yuklab olish uchun Exportni boshlash bir martalik eksportni ishga tushiradi va uning holatini ko'rsatish uchun Eksportlarni ochadi; bu uzluksiz kuzatuvni yoqmaydi.

Sozlamalarni o'rnatgandan so'ng, Söhbatlar → O'zgarishlarni tanlash tanlangan söhbatlarni o'zgartiradi. Sozlamalar to'plash va fayllarni boshqaradi; Qo'shimcha vositalar → Manbalar Standard yoki Expert darajasida batafsil manba ro'yxatini taqdim etadi. Panel qo'llanmasi oltita asosiy bo'lim va ularning kontekstual boshqaruv elementlarini tasvirlaydi.

API ID + Hash ixtiyoriy: ish maydoni saqlangan yoki import qilingan juftlikni, yoki o'rnatilgan havzodan ishlash juftligini ishlatadi. O'zingizning ilovangizdan foydalanish uchun API ID:API Hash juftligini API ID ga joylashtiring. Auth kaliti uchun barcha 512 geksadesimal xarakterlarni joylashtiring va taqdim etilgan DC ID ni tanlang. Foydalanuvchi ID ixtiyoriy bo'lib, kiritilganda tekshiriladi.

API ma'lumotlari sizning ilovangizni aniqlaydi; ular o'zlari hech qanday hisobni ruxsat etmaydi. Xususiy guruhlarga ommaviy foydalanuvchi nomi kerak emas, lekin sizning hisobingizda kirish huquqi bo'lishi kerak.

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.

Bir nechta hisob uchun Hisoblar → Hisoblarni import qilish bo‘limidan foydalaning va ularning qo‘llab-quvvatlanadigan sessiya fayllarini tanlang. Qo‘shimcha JSON fayllar asosiy nom bo‘yicha juftlanadi; har bir import qilingan hisob o‘z ishchi maydoniga ega bo‘ladi. Ommaviy import va hisob guruhlari bo‘limiga qarang.

Yana bir akkaunt qo'shish uchun akkaunt tanlovchisining yonidagi + belgisini bosing yoki Akkauntlar → Akkaunt qo'shish bo'limidan foydalaning. Ish maydonlarida alohida sessiyalar, jurnallar, kalitlar, manbalar va navbatlar mavjud. Ko'rinishlarni almashtirish boshqa yig'uvchilarni ishga tushirib turadi. Ushbu o'rnatishda bir xil Telegram akkaunti ikki ish maydoniga tayinlanishi mumkin emas. Ish maydonlarining doimiy soni yo'q; ular bitta jarayonni baham ko'radi, shuning uchun sig'im mashinaga bog'liq.

Jonli panel tokeni Telegram ruxsatnomalaringiz va saqlangan materiallarga kirishni himoya qiladi; u Telegram API ma'lumotlaridan alohida. Faqat aniq boshlangan va to'g'ridan-to'g'ri ulanilgan mahalliy demo avtomatik kirish huquqiga ega. Masofaviy/proxy orqali ulanadigan demo hanuzgacha data/demo/panel-token.txt ni ishlatadi.

Ko'rib chiqish va eksport qilish#

  • Jurnal: kuzatuvlarni manba va hodisa turiga ko'ra qidirish va filtrlash.
  • Voqeani tanlang va uning asl yozuvini, atributsiyasini hamda saqlangan versiyalarini ko'rib chiqing.
  • Tahrirlash tafsilotlari mavjud bo'lgan oldingi/keyingi kontentni ko'rsatadi. O'chirish tafsilotlari mavjud bo'lsa, oxirgi qayd etilgan kontentni ko'rsatadi; noma'lum aktor noma'lum bo'lib qoladi.
  • Eksportlar: imzolangan ZIP, JSONL, CSV va oflayn HTML.
  • To'liq suhbat eksporti (Suhbatlar → Suhbatni eksport qilish, yoki Eksportlar → Bir suhbatni olish yoki eksport qilish): bitta suhbatning butun ko'rinadigan tarixini imzolangan paket sifatida chat.json (Telegram-eksport uslubida) va o'qiladigan chat.html bilan yuklab oling. Xususiy suhbatlar hisob qaydnomasi a'zo bo'lganda ishlaydi. Bu hozirgi snapshot bo'lib, o'chirilgan yoki ilgari tahrirlangan xabarlarning qayta tiklangan nusxasi emas. Nusxani python verify.py chat-export.zip --fingerprint TRUSTED_SHA256 bilan tekshiring.
  • Save checkpoint: imzolangan jurnal chegarasini to'plovchidan tashqarida saqlang.
  • Imzolangan ishga tushirish kvitansiyasini yuklab oling: to'plovchining dastur/versiya yozuvini saqlang.
  • Vaqt tamg'asi so'rovini tayyorlang: vaqt tamg'asi vakolat organi uchun oflayn so'rov tayyorlang; Javobni olish va tekshirish uchun TIMESTAMP.md hujjatiga amal qiling.
  • Jurnalni tekshirish: voqea imzolarini va zanjir bog'lanmalarini tekshirish. ZIP eksporti media fayllarni ham tekshiradi.

Qo'llab-quvvatlanadigan brauzerlar katta eksportlarni to'g'ridan-to'g'ri tanlangan faylga saqlaydi. Boshqa brauzerlar eng ko'pi bilan 128 MiB buferlaydi. Server ishlayotgan paytda, oqimli CLI butun javobni buferlamasdan kattaroq yuklab olishlarni qo'llab-quvvatlaydi:

python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip

Boshqa ish maydoni uchun Eksportlar → Ish maydoni ID bo'limidan --profile ID ni qo'shing. Masofaviy server uchun --url https://your-server ni qo'shing. Standart uzatish limiti 5 GiB; --max-mib uni o'zgartiradi. Imzolangan ZIP kontentida standart bo'yicha alohida 4 GiB siqilmagan tekshirish limiti mavjud (Qo'shimcha vositalar → Parametrlar uni oshiradi; bunday arxivlarni verify.py --max-gib N yordamida tekshiring). Arxivni ishonchli verifikator nusxasi, mustaqil saqlangan kalit barmog'i va dalil uchun minimal talab sifatida vaqt shtampi organining ildiz sertifikati (--tsa-ca) yordamida tekshiring.

O'rnatishni tekshiring#

python start.py --setup-only
python start.py --check
python start.py --check --json

--check mahalliy bog'liqliklarni, imzolashni qo'llab-quvvatlashni, saqlash joyini, kalit sozlamalarini va tinglash manzilini tekshiradi. U hech narsa o'rnatmaydi va Telegramga ulanmaydi. Band port boshqa bir nusxa ishlamoqda degani bo'lishi mumkin. Boshqa --port dan foydalaning yoki avval uni to'xtating.

Ishga tushiruvchi dastur .venv ga o'rnatiladi. Yordamchi python -m tgwitness... buyruqlari Windowsda .venv\Scripts\python.exe, Linux/macOSda esa .venv/bin/python ni ishlatishi kerak, agar bu muhit allaqachon faollashtirilmagan bo'lsa.

Sessiyalar, himoya va ishlash#

Yopiq, izchil Telethon SQLite .session faylini mahalliy ravishda python -m tgwitness.sessions account.session --out account.tgwitness-session buyrug'i bilan o'zgartirish, so'ngra More tools → Account → Files bo'limiga yuklash mumkin. To'g'ridan-to'g'ri fayl importi va QR kod orqali kirish ham mavjud. Kirish formatlari, SOCKS5, HTTP CONNECT, MTProxy va tashqi bosh kalitlar bo'yicha CONNECTION-SECURITY.md hujjatiga qarang.

To'xtatish kuzatuvni to'xtatadi. Quqitish faqat brauzer orqali kirishni yopadi. Vozkani yopish yig'ish jarayonini ishga tushgan holda qoldiradi. Jarayonni to'xtatish yig'ishni uzib qo'yadi; tarixning snapshoti barcha o'tkazib yuborilgan tahrirlar yoki o'chirishlarni qayta tiklay olmaydi. Voqea siyosatlari, ilova navbatlari, hisobni izolyatsiya qilish va qayta ishga tushirish xatti-harakatlari bo'yicha yig'ish qanday ishlashini ko'ring.

Sessiyalar va sirlar shifrlanadi. Xabar mazmuni, media va eksportlar shifrlangan disk yoki hajmni talab qiladi. Jurnal imzo(lari)ni ishonchli kalitga qarshi tekshiring va tekshiruv nuqtalarini alohida saqlang. Tanlangan yig'ish rejimi uchun yozib olish yozuvlari, tashqi vaqt kvitansiyalari va muhit tasdiqnomalarini ko'rib chiqing.

Zaxira nusxa olish va tiklash uchun OPERATIONS.md, hosting uchun DEPLOYMENT.md hamda xizmat misollari uchun deploy/ fayllarini o'qing. O'rnatilgan panelda shuningdek /guide.html manzilida oflayn sozlash bo'yicha qo'llanma mavjud.

Haqiqiy tasdiqlash va qolgan cheklovlar VERIFICATION.md hamda READINESS.md fayllarida qayd etilgan.