# Telegram · Tez boshlash

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

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

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/uz/llms.txt)

Translation coverage: this edition includes material from the English original.

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

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Hujjatlash](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![Boshlash](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2)

**Inglizcha** · [Rus tili](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/QUICKSTART.md) · [Ukrain tili](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/QUICKSTART.md) · [Ispancha](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/QUICKSTART.md) · [Portugalscha (Braziliya)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/QUICKSTART.md) · [Turkcha](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/QUICKSTART.md) · [Arab tili](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/QUICKSTART.md) · [Farsi](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/QUICKSTART.md) · [O'rdu](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/QUICKSTART.md) · [hindicha](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/QUICKSTART.md) · [Indoneziya tili](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/QUICKSTART.md) · [Vyetnam tili](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/QUICKSTART.md) · [Xoʻllashma xitoycha](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/QUICKSTART.md)

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](https://phishdestroy.io/tgwitness/uz/docs/reference/quickstart/#explore-the-interface). Proxylar, guvohlar, eksport yoki serverni sozlash bo'yicha [qo'llanma tanlang](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md). [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) (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](https://phishdestroy.io/tgwitness/uz/docs/reference/installation/) 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.zip`ni 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](https://github.com/phishdestroy/TgWitness/archive/refs/heads/main.zip) 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](https://phishdestroy.io/tgwitness/uz/docs/reference/deployment/) 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](https://phishdestroy.io/tgwitness/uz/docs/reference/settings/) 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](https://phishdestroy.io/tgwitness/uz/docs/reference/panel/) 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](https://phishdestroy.io/tgwitness/uz/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.

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](https://phishdestroy.io/tgwitness/uz/docs/reference/accounts/#bulk-import-and-account-groups) bo‘limiga qarang.

Yana bir akkaunt qo'shish uchun akkaunt tanlovchisining yonidagi **+ belg**isini 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](https://phishdestroy.io/tgwitness/uz/docs/reference/timestamp/) 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](https://phishdestroy.io/tgwitness/uz/docs/reference/connection/) 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](https://phishdestroy.io/tgwitness/uz/docs/reference/collection/) 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](https://phishdestroy.io/tgwitness/uz/docs/reference/operations/), hosting uchun [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/uz/docs/reference/deployment/) hamda xizmat misollari uchun [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) fayllarini o'qing. O'rnatilgan panelda shuningdek `/guide.html` manzilida oflayn sozlash bo'yicha qo'llanma mavjud.

Haqiqiy tasdiqlash va qolgan cheklovlar [VERIFICATION.md](https://phishdestroy.io/tgwitness/uz/docs/reference/verification/) hamda [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md) fayllarida qayd etilgan.
