# Telegram · Ish jarayonlari va operatsiyalar

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

Panelning kundalik ishlashi: rejimlar, monitoring kategoriyalari, parametrlar, bildirishnomalar, eksportlar, zaxira nusxasi va sig'im.

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

Panelning kundalik ishlashi: rejimlar, monitoring kategoriyalari, parametrlar, bildirishnomalar, eksportlar, zaxira nusxasi va sig'im.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Hujjatlash](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Joylashtirish va tiklash](https://phishdestroy.io/tgwitness/uz/docs/reference/deployment/)

![Joylashtirish va tiklash](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

Birinchi ulanishingiz uchun [akkauntlar va sessiya formatlaridan](https://phishdestroy.io/tgwitness/uz/docs/reference/accounts/) foydalaning. Saqlangan versiyalar, voqea siyosatlari va bo'shliqlar haqida tushuntirish uchun [yig'ish qanday ishlashini](https://phishdestroy.io/tgwitness/uz/docs/reference/collection/) ko'ring. Ushbu qo'llanma kundalik ish faoliyati va tiklashni qamrab oladi.

Boshqariladigan o'rnatish quyidagilarni o'z ichiga oladi: **START-HERE.html** va **START-HERE.txt** uning ishga tushiruvchi dasturi yonida, o'rnatish yo'liga moslashtirilgan omborcha havolasi va buyruqlar bilan. `tgwitness guide --print`ni SSH orqali ishga tushiring yoki `tgwitness paths`ni haqiqiy ma'lumotlar katalogini aniqlash uchun ishlating. Asosiy systemd o'rnatishi maxfiy holatni `/var/lib/tgwitness-…` ostida saqlaydi; `/opt/tgwitness` esa dasturni o'z ichiga oladi.

Boshqariladigan vaqtinchalik Cloudflare tunneli uchun `tgwitness tunnel off` jamoat kirishini yopadi, mahalliy panel va to'plam esa ishlashda davom etadi. `tgwitness tunnel on` uni yoqadi; `tgwitness tunnel restart` yangi tunnel ulanishini yaratadi. Uning joriy manzilini ko'rish uchun `tgwitness open` dan foydalaning. Aniq o'chirish sozlamasi xizmatni qayta ishga tushirgandan keyin ham saqlanib qoladi. `tgwitness stop` panel va to'plamni to'xtatadi.

**Ushbu sahifada**

- [Operator ish jarayoni](https://phishdestroy.io/tgwitness/uz/docs/reference/operations/#operator-workflow)
- [Asosiy kalitni ulashmasdan ishni ulashing](https://phishdestroy.io/tgwitness/uz/docs/reference/operations/#share-work-without-sharing-the-main-key)
- [Ijro vaqti rejimlari](https://phishdestroy.io/tgwitness/uz/docs/reference/operations/#runtime-modes)
- [Monitoring toifalari](https://phishdestroy.io/tgwitness/uz/docs/reference/operations/#monitoring-categories)
- [Bildirishnomalar](https://phishdestroy.io/tgwitness/uz/docs/reference/operations/#notifications)
- [Panel tartibi](https://phishdestroy.io/tgwitness/uz/docs/reference/operations/#panel-layout)
- [Joylashtirish muhitlari](https://phishdestroy.io/tgwitness/uz/docs/reference/operations/#deployment-environments)
- [Boshlang'ich tekshiruvlar va eksportlar](https://phishdestroy.io/tgwitness/uz/docs/reference/operations/#startup-checks-and-exports)
- [Zaxira nusxasini olish, tiklash va uzilishlar](https://phishdestroy.io/tgwitness/uz/docs/reference/operations/#backup-restore-and-interruptions)
- [Sig'im va saqlash muddati](https://phishdestroy.io/tgwitness/uz/docs/reference/operations/#capacity-and-retention)

## Operator ish jarayoni

Oqim sxemasi · Saqlash va kalitni himoya qilishni tanlang → O'z tokeni bilan panelni oching; O'z tokeni bilan panelni oching → Ish maydonini tanlang; Ish maydonini tanlang → To'g'ridan-to'g'ri yoki proxy yo'nalishini sozlang; To'g'ridan-to'g'ri yoki proxy yo'nalishini sozlang → Telefon raqamini kiriting yoki fayllarni / QRni tanlang; Telefon raqamini kiriting yoki fayllarni / QRni tanlang → Hisob identifikatsiyasini tekshiring va kirish mumkin bo'lgan guruhlarni tanlang; Hisob identifikatsiyasini tekshiring va kirish mumkin bo'lgan guruhlarni tanlang → Voqea va ilovalar siyosatini saqlang, so'ng kuzatuvni boshlang; Voqea va ilovalar siyosatini saqlang, so'ng kuzatuvni boshlang → Xatolar, kirish, navbatlar va diskni monitoring qiling; Xatolar, kirish, navbatlar va diskni monitoring qiling → Mustaqil tekshiruv nuqtalarini saqlab qolish; Mustaqil tekshiruv nuqtalarini saqlab qolish → Materialni eksport qiling va tekshiring · Saqlash va kalitnihimoya qilishnitanlang · O'z tokeni bilanpanelni oching · Ish maydonini tanlang · To'g'ridan-to'g'riyoki proxyyo'nalishini sozlang · Telefon raqaminikiriting yokifayllarni / QRnitanlang · Hisobidentifikatsiyasinitekshiring va kirishmumkin bo'lganguruhlarni tanlang · Voqea va ilovalarsiyosatini saqlang,so'ng kuzatuvniboshlang · Xatolar, kirish,navbatlar va disknimonitoring qiling · Mustaqil tekshiruvnuqtalarini saqlabqolish · Materialni eksportqiling va tekshiring

**Diagramma matn sifatida**

1. Saqlash va kalitni himoya qilishni tanlang → O'z tokeni bilan panelni oching
2. O'z tokeni bilan panelni oching → Ish maydonini tanlang
3. Ish maydonini tanlang → To'g'ridan-to'g'ri yoki proxy yo'nalishini sozlang
4. To'g'ridan-to'g'ri yoki proxy yo'nalishini sozlang → Telefon raqamini kiriting yoki fayllarni / QRni tanlang
5. Telefon raqamini kiriting yoki fayllarni / QRni tanlang → Hisob identifikatsiyasini tekshiring va kirish mumkin bo'lgan guruhlarni tanlang
6. Hisob identifikatsiyasini tekshiring va kirish mumkin bo'lgan guruhlarni tanlang → Voqea va ilovalar siyosatini saqlang, so'ng kuzatuvni boshlang
7. Voqea va ilovalar siyosatini saqlang, so'ng kuzatuvni boshlang → Xatolar, kirish, navbatlar va diskni monitoring qiling
8. Xatolar, kirish, navbatlar va diskni monitoring qiling → Mustaqil tekshiruv nuqtalarini saqlab qolish
9. Mustaqil tekshiruv nuqtalarini saqlab qolish → Materialni eksport qiling va tekshiring

Avtorizatsiya, transport ulanishi, guruhga kirish va yetkazib berish to'liqligi turli xususiyatlardir. Yashil ulanish holati barcha voqealar qayd etilganini anglatmaydi.

## Asosiy kalitni ulashmasdan ishni ulashing

**Qo'shimcha vositalarni oching → Ko'rib chiquvchi yoki tahlilchiga o'z tokenini berish uchun kirish huquqini** tanlang. Ular ochishi mumkin bo'lgan hisoblar va suhbatlarni tanlang, so'ng ko'rish, eksport qilish yoki operativ harakatlarga ruxsat bering. Yig'ishni boshlaydigan/to'xtatadigan operatorga butun ish maydoni bo'yicha kirish huquqi kerak; ko'rib chiquvchi esa bitta suhbat bilan cheklanishi mumkin. Sessiya cheklovlari, amal qilish muddati va IP-qoidalar Telegram hisobini avtorizatsiya qilishdan alohida. [Kirish huquqlari va ruxsatnomalarni](https://phishdestroy.io/tgwitness/uz/docs/reference/access/) ko'ring.

**Open sessions** ulanishni yakunlash yoki uning barcha sessiyalariga kirishni bekor qilish uchun ishlatiladi. Administrator konsoli ish maydonlari bo'ylab joriy jarayon faoliyatini birlashtiradi. Sessiyani yopish ma'lumotlarni yig'ishni davom ettiradi.

## Ijro rejimlari

| Rejim | Harakat | Xulq-atvor |
| --- | --- | --- |
| Demo | scripts\Demo.cmd yoki `--demo` | Sintetik ma'lumot; haqiqiy akkauntlar o'rtasidagi bog'lanishlar o'chirib qo'yilgan |
| Kuzatuv | Kuzatuvni boshlang | Tanlangan manbalar uchun yetkazilgan yangilanishlarni qayd eting |
| Tarixning tezkor ko'rinishi | Suhbatlar → Suhbat harakatlari → Tarixni yuklash | Joriy 500 tagacha xabar; barcha avvalgi o'zgarishlarni qayta tiklash yo'q |
| Tanaffus | Kuzatuvni to'xtatish | To'plashni to'xtating, ma'lumotlar va navbatdagi ishlarni saqlab qolgan holda |
| Ko'rib chiqish/topshirish | Eksportlar | ZIP, JSONL/CSV/HTML, tekshiruv nuqtasi, jarayon kvitasi va vaqt tamg'asi so'rovi |
| Bir nechta hisoblar | Ish maydonchalari yoki yuqoridagi **+** tugmasi | Bir jarayonda istalgan sonli alohida ish maydonchalari |

Mahalliy demo kirish qo'lda token kiritmasdan avtomatik ochiladi. U izolyatsiyalangan sintetik demo uchun to'g'ridan-to'g'ri loopback-kirishga haqiqiy bo'lgan, jarayon umrboqiyligi imkoniyatidan foydalanadi; asosiy panel tokeni oshkor etilmaydi. Haqiqiy ish maydonchalari va masofaviy yoki proksi orqali demo kirish token autentifikatsiyasini saqlab qoladi. Demo kirish Telegramga ruxsat bermaydi.

## Monitoring toifalari

![Har bir hisob uchun monitoring sozlamalari sun'iy manba ma'lumotlari bilan](https://phishdestroy.io/tgwitness/assets/sources.png?v=761b8bfa296c)

**Qo'shimcha vositalar → Manbalar → Yozib olish → Qaysi o'zgarishlarni saqlashni tanlash** bo'limida yangi xabarlar, tahrirlar, o'chirish bildirishnomalari, reaktsiya yangilanishlari va a'zolik voqealarini alohida tanlang. Standart sozlama barcha toifalarni saqlaydi. **Xabarlar, tahrirlar va o'chirishlar** asl kontekstni saqlaydi, ammo alohida reaktsiya/a'zo yangilanishlarini o'chirib qo'yadi. **Barcha ko'rinadigan faoliyat** beshala elementni tiklaydi. Oldindan belgilangan sozlamalar shaklni o'zgartiradi; qo'llash uchun **Yozib olish sozlamalarini saqlash tugmasini** bosing.

Saqlangan siyosat shu ish maydonidagi barcha tanlangan manbalarga tatbiq etiladi. Boshqa ish maydonchalari o'z sozlamalarini saqlab qoladi. Har bir haqiqiy o'zgarish imzolangan oldingi/keyingi qiymatlarni qayd etadi; joriy siyosat jarayon kvitansiyalari va kuzatuv boshlanishi yozuvlariga ham kiritilgan. Toifani o'chirish oldingi kuzatuvlarni o'chirib tashlamaydi. Uni qayta yoqish o'tkazib yuborilgan o'zgarishlarni qaytarib bermaydi. Ushbu versiyada guruh bo'yicha kategoriyani ustuvor qilish imkoniyati mavjud emas.

Avvalgi kontent muhim bo'lganda yangi xabarlarni yoqib qo'ying: o'chirish bildirishnomasi hech qachon qayd etilmagan matnni qaytarib berolmaydi. Operatsion/qamrov yozuvlari va boshqa guruh xizmat voqealari har doim saqlanadi. Aniq tarix snopshotlari jonli-kategoriya tanlovidan alohida bo'lib, xizmat xabarlari ham bo'lishi mumkin. Ushbu kalitlar aks holda qayd etilgan Telegram ob'ektiga kiritilgan reaktsiya/a'zo metama'lumotlarini o'chirib tashlamaydi.

Tarix snappoti to'xtatilganda ilovalarni navbatga qo'yishi mumkin. Ularni qayta ishlash uchun kuzatuvni boshlang. Navbatga qo'yilgan bo'lish yuklab olingan degani emas. Mavjud bo'lmagan asl fayl yangi tahrirlangan versiya bilan almashtirilmaydi; natijalar alohida qayd etiladi.

**Lock** brauzerga kirishni va maxfiy maydonlarni tozalaydi, lekin yig'ishni ishga tushgan holda qoldiradi. Vozkechishni yopish ham jarayonni ishga tushgan holda qoldiradi. Python jarayonini yoki xizmatini to'xtatish brauzer holatidan qat'i nazar yig'ishni to'xtatadi.

Qo'shimcha ish maydoni, jurnalini va Case Board eslatmalarini qamrab olgan imzolangan ZIP yoki ASiC-E konteyneri to'liq yuklab olingach, o'chirib tashlanishi mumkin. Arxivni tayyorlash yetarli emas: sozlash voqealaridan tashqaridagi yozuv yoki yuklab olingandan keyin qo'shilgan eslatma **O'chirish** funksiyasini mavjud bo'lmaydi.

Panel faylni o'zi qabul qilganda, eksportni faqat har bir baytni olgach hisoblaydi va keyin hajmini`POST /api/exports/{id}/received` ga yuboradi; to'xtab qolgan yuklab olish hisobga olinmaydi. Brauzer saqlash tanlovchisi (Fayl tizimiga kirish) bilan panel fayl yozilib, yopilgach buni xabar qiladi. Ushbu funksiya bo'lmasa, panel qabul qilingan faylni brauzerning yuklamalar ro'yxatiga uzatadi va brauzer uni saqlagan yoki saqlamaganini (masalan, saqlash oynasi bekor qilinganda) aniqlay olmaydi; bunday holda panel yuklash boshlanganini bildiradi, fayl saqlanganini emas. Brauzer mustaqil ravishda yuklab oladigan fayl (panelning brauzer buferidan kattaroq eksport) va boshqa HTTP-klient tomonidan amalga oshirilgan yuklab olish, server butun javobni yuborganida hisobga olinadi. Operatsion tizim va teskari proxy bir necha megabayt javobni buferga saqlaydi, shuning uchun server bu yuklab olishlarda oxirga yaqin joyda uzilishni ko'ra olmaydi. Panel fayl saqlanganini aytmagan bo'lsa, o'chirishdan oldin yuklab olingan faylni tekshiring. Guruh eksporti tayyorlangach darhol yuklab olinsa, hisoblarga hisoblanadi; **tayyorlangan eksportlar** bo'limidan qayta yuklab olish esa hisobga olinmaydi.

Before deleting, the panel shows the format, size, preparation time and SHA-256 of the last downloaded signed archive and asks to confirm that this archive is saved outside the workspace. The server refuses `DELETE /api/profiles/{id}` without `kept_copy` set to that SHA-256 (or to `confirmed` for an archive downloaded before the fingerprint was recorded).

Qo'shimcha ish maydonini o'chirish uning yig'uvchisini to'xtatadi va mahalliy ma'lumotlarini o'chirib tashlaydi. Agar qulflangan fayl yoki fayl tizimi xatosi o'chirishni to'xtatsa, panel xatolikni bildiradi va ish maydonini mavjud emas (`DeletionPending`) deb ko'rsatadi. Uning fayllarini ushlab turgan dasturlarni yoping va **O'chirishni** qayta sinab ko'ring. TgWitness-ni qayta ishga tushirish ushbu ish maydonini to'xtatilgan holda qoldiradi va uning qisman o'chirilgan jurnali yoki kalitlarini qayta yaratmaydi. Muvaffaqiyatli o'chirish faqat katalog o'chirib tashlangandan keyin qayd etiladi; alohida eksport qilingan yoki zaxiralangan nusxalar o'z saqlash siyosatiga bo'ysunadi.

## Bildirishnomalar

**Sozlamalar → Bildirishnomalar va tashqi nusxa → Bildirishnoma manzillari**, yoki **Qo'shimcha vositalar → Qo'shimchalar → Bildirishnomalar → Sozlash**. TgWitness Matrix, Telegram, Discord, Slack, ntfy, elektron pochta va boshqa qo'llab-quvvatlanadigan xizmatlarga ogohlantirishlar yuborish uchun Apprise-dan foydalanadi. Bir ish maydoniga bir nechta manzilni qo'shishingiz mumkin.

1. Har bir satrga bitta Apprise manzil URL-ni kiriting. Xizmatingiz uchun [xizmat katalogi va URL formatlaridan](https://appriseit.com/services/) foydalaning.
2. **Xabar yuborishni** yoqing, so'ng muammo bildirishnomalarini, kuzatilayotgan suhbatlardagi o'zgarishlarni va kunlik xulosani tanlang. Xulosa soati server vaqtiga asoslanadi.
3. Agar o'chirib tashlangan va tahrirlangan xabarlardan saqlangan matnni bildirishnomalarda ko'rsatishni istasangiz, **"Qisqa parchalarni kiritish"**ni yoqing.
4. **Bildirishnomalarni saqlash tugmasini** bosing, so'ngra yetkazilishini tekshirish uchun **test yuboring**.

O'zingizning qabul qiluvchingiz uchun Apprise'ning [JSON webhook'idan](https://appriseit.com/services/json/) foydalaning. Masalan, `jsons://notify.example.org/tgwitness` JSON'ni HTTPS orqali shu manzilga yuboradi. Bu badiiy misol; uni o'zingizning manzilingiz bilan almashtiring.

Manzillar va sozlamalar tanlangan ish maydoniga tegishli. Ogohlantirishlar uning kuzatilayotgan manbalarini, jumladan yangi qo'shilgan suhbatlarni ham qamrab oladi. Yuqori panelidagi qo'ng'iroq ham so'nggi muammolar va suhbat o'zgarishlarini ro'yxatlaydi.

Demo rejimida bildirishnoma boshqaruvlari ko'rinadi, ammo yuborish funksiyasi o'chirilgan. Haqiqiy ish muhitida yetkazib berishni sozlang. Bildirishnomalar o'sha ish muhitining Direct, SOCKS5 yoki HTTP yo'nalishidan foydalanadi; MTProxy ularni yetkazib bera olmaydi. SMTP kabi HTTP bo'lmagan manzillar to'g'ridan-to'g'ri yo'nalishni talab qiladi.

## Panel tartibi

![Sun'iy ma'lumotlardan foydalangan holda ulanish ish maydoni](https://phishdestroy.io/tgwitness/assets/connection.png?v=c8781089fe29)

**Jurnal** kuzatuvlar, qidiruv va filtrlarni ko'rsatadi. Tahrir ushlangan versiyalarni ochadi; o'chirish mavjud bo'lsa, oldingi kontentni ochadi. Noma'lum atribut aniq ko'rsatiladi. Hisoblar **Umumiy ko'rinish** bo'limida mavjud; olish tafsilotlari mahalliy qo'llanmada qoladi.

Tahrirlangan xabarning versiyalarini **Matndagi o‘zgarishlar** yoki **Yonma-yon** yordamida solishtirish uchun uni oching; **Xom ma’lumotlar** saqlangan maydonlarni ko‘rsatadi. Yashirin havolalar va bot tugmalaridagi o‘zgarishlar alohida ko‘rinadi. Saqlangan rasm, audio yoki videolarni ko‘zdan kechirish uchun biriktirma ko‘rinishini oching; yuklab olish tugmasi saqlangan asl nusxadan foydalanish imkonini beradi.

**Live** yozuvlar kelib tushishi bilan jurnal va chatlarni yangilab boradi. Ko‘rib chiqish vaqtida uni pauza qiling yoki tayyor bo‘lganingizda yangi hodisalar tugmasidan foydalaning; ma’lumotlarni yig‘ish davom etaveradi. **Ctrl/Cmd+K** panel amallarini topadi va jurnal bo‘ylab qidiradi.

**Qo'shimcha vositalar → Manbalar** kuzatuv doirasini (tanlangan suhbatlar, Telegram papkasi yoki butun akun), har qanday turdagi mavjud suhbatlarni, ustuvor yulduzchali tanlangan manbalarni, ilova va qayta tekshirish sozlamalari hamda tarix snopshotlarini o'z ichiga oladi. Xususiy manbalar dialog/ID orqali tanlanadi va ommaviy havola yo'q. Kirish holati eng so'nggi tekshiruvni tasvirlaydi, doimiy ruxsatnomalarni emas.

Manbalarni filtrlang, ularning katakchalarini belgilang, so‘ngra ularni birgalikda yoqing, pauza qiling yoki ustuvor sifatida belgilang. Mavjud chatlar ro‘yxatida **Tanlanganlarni qo‘shish** sizning tanlovingizdan foydalanadi; **Barcha mos natijalarni qo‘shish** esa joriy qidiruv va tur filtridan foydalanadi.

**Suhbatlar →** Saqlangan xabarlari bo'lgan barcha **odamlarni** ro'yxatlaydi; suhbat uchun odam profillari yoqilganda, ustiga bosish shu shaxsning profilini jurnal yozuvlari havolalari bilan ochadi.

**Qo'shimcha vositalar → Qo'shimchalar → Mustaqil guvoh** o'qish uchun mo'ljallangan guvoh tokenlarini yaratadi, har bir guvoh oxirgi marta qachon tekshirilganini ko'rsatadi va ularni ([mustaqil guvohni](https://phishdestroy.io/tgwitness/uz/docs/reference/witness/)) ishga tushirish uchun buyruqlar va parametrlarni beradi.

**Qo'shimcha vositalar → Parametrlar** ish maydonining boshqa sahifada ko'rsatilmagan barcha chegaralari va tezligini o'z ichiga oladi: qancha dialog o'qilgani, suhbatlar ro'yxati qanchalik tez-tez qayta o'qilishi, yurak urishi va tekshiruv nuqtasi oraliklari, ishga tushirish buferi, qayta tekshirishlar so'rovlarini qanday tarqatishi (birinchi kechikish, suhbatlar per o'tish, suhbatlar orasidagi tanaffuslar, tiklangan va qayta so'ralgan xabarlar), disk rezervi, yuklab olishlarning vaqt chegaralari va qayta urinishlari, odamlar profillari nimani qidiradi (shu jumladan sizning o'zingizning odatiy ifodalaringiz), bildirishnomalarning hajmi va sur'ati, snapshot, ZIP va brauzerdan yuklab olish limitlari, va Telegram klientining vaqt chegaralari va qayta urinishlari. Har bir maydon o'z diapazonini va standart qiymatini ko'rsatadi; o'zgartirilgan maydonlar belgilangan va ularni bittadan yoki barchasini birga tiklash mumkin. Har bir o'zgartirish oldingi va keyingi qiymatlari bilan `parameters.changed` sifatida qayd etiladi, va kuzatuv boshlanishi yozuvlari amalda bo'lgan qiymatlarni belgilaydi. Qiymatlar keyingi marta qo'llanilgandan boshlab kuchga kiradi; klientning vaqt chegaralari va qayta urinishlari esa keyingi ulanishdan boshlab. Qayta tekshirish oralig'lari, ilova turlari va o'lchamlari, dalillar va tashqi nusxa olish oralig'lari o'z sahifalarida qoladi va ular o'z diapazonidagi istalgan qiymatni, faqat oldindan belgilanganlarni emas, qabul qiladi.

Yuqori panelidagi qo'ng'iroq kuzatilgan suhbatlardagi so'nggi muammolar va o'zgarishlarni ko'rsatadi; o'qilmagan xabarlar o'qilgan deb belgilanmaguncha hisoblanadi. O'zgarishlar har bir suhbat va soat bo'yicha guruhlanadi ("12 tasi o'chirilgan, 1 tasi tahrirlangan, 0 tasi topilmagan"), va tizimdan chiqish yoki disk to'la kabi muammolar, suhbatlar qanchalik band bo'lmasin, ro'yxatda qoladi.

**Qo'shimcha vositalar → Hisob** telefon raqami maydonidan boshlanadi. **Davom ettirish** to'g'ridan-to'g'ri kod kiritishga olib boradi, API ma'lumotlarini faqat yetishmayotganda so'raydi. QR va fayl importi — muqobil yorliqlar. Saqlangan API ma'lumotlari faqat o'z ish maydoni doirasida qayta ishlatiladi. Kirish ekrani yon panel, statistika yoki sozlash paragraflariga ega emas. **Sozlamalar** ikonkasi API, proksi, saqlash va qo'shimcha hisob boshqaruvlarini ochadi. Yangi ish maydoni [birinchi sozlamalarni](https://phishdestroy.io/tgwitness/uz/docs/reference/settings/) ochadi; tizimga kirgandan so'ng, saqlangan manbalar va yozuvlarga ega ish maydoni **Suhbatlar bo'limini** ochadi. Yo'nalishni o'zgartirish kuzatuvni to'xtatishni talab qiladi va yakunlanmagan tizimga kirishni bekor qiladi. Mavjud jurnalni boshqa Telegram hisobiga jimjit bog'lash mumkin emas.

**Eksport** jurnal yaxlitligini tekshiradi va ko'chma fayllarni hosil qiladi. Uning ish maydoni identifikatori yuklab olish CLI ga uzatilishi mumkin. Har bir eksport to'liq jurnal prefiksini belgilaydi; keyingi voqealar keyingi eksportga kiradi. Qidiruv filtrlari paket doirasini o'zgartirmaydi. Imzolash va qamrov bo'yicha batafsil ma'lumot **Tekshirish va dalillar** bo'limida keltirilgan.

Panel Collector **holati** bo'limida yuklanish holatini, navbatga qo'yilgan/muvaffaqiyatsiz bo'lgan media fayllarni, eng qadimgi kutayotgan media faylni, bo'sh disk joyini, so'rov to'xtatishlarini va tasdiqlanmagan kirish huquqiga ega manbalarni ko'rsatadi. Ushbu ma'lumotlar dastlab siqilgan va Hisob sahifasida yashirilgan. Sozlash kartasi keyingi bosqichni ko'rsatadi: hisobni ulash, manbalarni tanlash yoki kuzatuvni boshlash. Hisoblar ro'yxati yuklanish vaqtidagi snapshot; tanlangan ish maydoni muntazam ravishda yangilanadi. Bu ko'p jarayonli SLA monitori emas.

Interfeys manba kontenti uchun mahalliy resurslar va matnli ko'rsatishdan foydalanadi. Chromium'dagi ish stoli va tor maketlar sinovdan o'tkazilgan.

## Joylashtirish muhitlari

| Muhit | O'rnatish | Verifikatsiya holati |
| --- | --- | --- |
| Windows shaxsiy kompyuter/server | Python 3.11+, scripts\Setup.cmd/Start.cmd, shaxsiy ma'lumotlar katalogi | Windows/Python 3.12 da mahalliy tekshirildi |
| Linux server/VPS | Python virtual muhiti, maxsus xizmat foydalanuvchisi, HTTPS/SSH | Kod, CI va systemd misoli keltirilgan; ushbu hostda ijro etilmagan |
| macOS | Python virtual muhit (venv), old plandagi jarayon yoki foydalanuvchi agenti | launchd misoli keltirilgan; alohida o'rnatishni tekshirish zarur |
| Docker/Compose | Doimiy hajm, bitta ishchi | Ta'rif va CI ish vaqti tekshiruvi taqdim etilgan; Docker mahalliyda mavjud emas |
| Telefon brauzeri | Ishlayotgan serverdagi himoyalangan paneldan ulaning | Toraytirilgan Chromium maketi sinovdan o'tkazildi; to'plovchi iOS/Androidda ishlamaydi |

Ko'chma bo'lish – majburiy bulut xizmati yoki frontend qurilmasini talab qilmaslikni anglatadi. Har bir maqsad hanuz mos Python/kripto bog'liqliklarga, mahalliy disk va tarmoqqa kirish huquqiga ega bo'lishi kerak. Qarang: [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/uz/docs/reference/deployment/) va [xizmat shablonlari](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md).

Ish maydonchalari CPU, xotira va voqealar tsiklini baham ko'radi. Jarayonlarni izolyatsiya qilish uchun alohida instantsiyalar, portlar, ma'lumotlar kataloglari va hisob ma'lumotlari ruxsatnomalaridan foydalaning. Alohida instantsiyalar bo'yicha yagona boshqaruv paneli mavjud emas. Bir nechta ishchi dasturini bitta ma'lumotlar bazasiga yo'naltirmang.

## Yozuvlarni tekshirish va eksport qilish

Tayyor muhitni ishga tushirishdan oldin `python start.py --check` buyrug'ini ijro eting. Mashina o'qiy oladigan tekshiruvlar uchun `--json` ni qo'shing yoki mo'ljallangan `--data-dir`, `--host` va `--port` parametrlarini o'tkazing. Ushbu buyruq Telegramga kirish yoki jurnal yaratishni talab qilmay, oldindan zarur shartlarni tekshiradi. Jurnalni tekshirish ilova ishga tushirilganda amalga oshiriladi va yozib olishga tayyorlik panelda ko'rsatiladi. Band port oddiygina mavjud instantsiya bo'lishi mumkin.

File System Access API-ni qo'llab-quvvatlaydigan brauzerlar eksportlarni yozib bo'ladigan oqim orqali saqlaydi. Boshqa brauzerlar esa buferga ko'pi bilan 128 MiB ma'lumotni joylaydi. Katta hajmdagi eksportlar yoki fayl oqimini qo'llab-quvvatlamaydigan brauzerlar uchun streaming CLI-dan foydalaning:

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

Bolalik ish maydoni uchun Exports bo'limidan `--profile ID` ni qo'shing. Masofaviy kirish uchun `--url https://server` ni ishlating. Oddiy HTTP faqat loopback manzillari uchun qabul qilinadi. Token fayldan o'qilib, sarlavhada yuboriladi, chop etilmaydi yoki URLga kiritilmaydi. Yo'naltirishlar rad etiladi. Mavjud manzillar ustiga yozilmaydi. Muvaffaqiyatsiz transferlar o'zlarining vaqtinchalik qism faylini o'chirib tashlaydi. Xabar qilingan SHA-256 transfer tekshiruv yig'indisi hisoblanadi; imzolangan ZIP-ni alohida ishonchli barmoq izi/nazorat nuqtasi yordamida tekshiring.

## Zaxira, tiklash va uzilishlar

1. Kuzatuvni to'xtating va jarayonni toza to'xtating.
2. Butun ma'lumotlar katalogini nusxalash: ma'lumotlar bazalari, mavjud bo'lsa WAL/SHM, media, `credentials.enc`, `signing.enc`, `network.enc`, xazina kalitlari/metamalg'olari, token, nazorat nuqtalari va har bir `profiles/` katalogi.
3. Tashqi kalit rejimida bosh kalitni alohida saqlang va har bir `vault.external.json`ni saqlab qo'ying. Yangi kalit yaratish eski sirlarni tiklashga imkon bermaydi.
4. Maqsad to'xtatilgan paytda tiklang; asl kalitni sozlang, kirishni cheklang va davom ettirishdan oldin yaxlitlikni tekshiring.
5. To'xtash vaqtini va tasdiqlash natijalarini qayd eting. To'xtash vaqti qayd etilgan bo'shliq bo'lib qoladi; tarix snappoti undan keyingi holatni qo'shadi.

Evidence ZIPs exclude sessions/private keys and are not full service backups. `tgwitness backup FOLDER` makes the same copy while the panel keeps running and leaves out the search index, which rebuilds itself; see [Updates and backups](https://phishdestroy.io/tgwitness/uz/docs/reference/deployment/#updates-and-backups). Four things are protected differently:

| Nima | Himoya |
| --- | --- |
| Parolsiz (defolt) fayllarni eksport qiling | Imzolangan, shuning uchun o'zgartirishlar aniqlanadi; eksportni shifrlash uchun parol o'rnating |
| Parol bilan fayllarni eksport qiling | Agar parol o'rnatilsa, tayyor eksport o'zgarmas holda 7-Zip va WinRAR ochadigan WinZip AES-256 ZIP arxiviga joylanadi; parol saqlanmaydi ([dalillar bilan ishlash](https://phishdestroy.io/tgwitness/uz/docs/reference/evidence/)) |
| Jurnal ma'lumotlar bazasi va diskka saqlangan ilovalar | Shifrlangan disk yoki hajm va papka ruxsatlari |
| Telegram sessiyalari va imzolash kalitlari | Ma'lumotlar katalogida shifrlangan (`credentials.enc`, `signing.enc`, `network.enc`) |

To'liq xizmat zaxira nusxasi — bu yuqorida tasvirlangan to'xtatilgan ma'lumotlar katalogi bo'lib, eksport emas. Har ikkala holat uchun himoyalangan saqlash joyidan va aniq o'tkazish mexanizmidan foydalaning. Vaqtinchalik server eksportlari har bir ish maydonining `temporary-exports/` katalogida saqlanadi; yakunlangan javoblar tozalanadi, va uzilgan eksport fayllari keyingi ishga tushirishda, o'sha ish maydoni instantsiya qulfi ushlab turilgan paytda o'chiriladi.

Ulanish tiklanganidan keyin, yig'uvchi saqlangan yangilanish pozitsiyasidan o'tkazib yuborilgan yangilanishlarni so'raydi. Doimiy media ishlar va Telegram yangilanish pozitsiyasi qayta ishga tushirishdan keyin ham saqlanadi; [dalillar formatiga](https://phishdestroy.io/tgwitness/uz/docs/reference/evidence/#durable-collection-and-process-receipts-02) qarang.

## Quvvat va saqlash muddati

Standart cheklovlar, barchasi **Qo'shimcha vositalar → Parametrlar** bo'limida o'zgartirilishi mumkin: birinchi 1,000 ta dialog oynasi, har bir snapshot bo'yicha 500 ta xabar, siqilmagan imzolangan ZIP kontenti uchun 4 GiB (katta arxivlar uchun `verify.py --max-gib N` zarur) va brauzer uchun 128 MiB zaxira hajmi. Ilovalar **Qo'shimcha vositalar → Manbalar → Yozib olish → Ilovalar** bo'limida turiga qarab 1–2,000 MiB joy egallaydi. Yuklab olish CLI bo'yicha standart o'tkaziladigan hajm 5 GiB. Mavjud disk hajmi pastroq limit bo'lishi mumkin. Jurnal, media, WAL, vaqtinchalik eksportlar va zaxira nusxalar uchun joy ajrating. Eksportlar Compose'ning 512 MiB `/tmp` katalogi o'rniga ma'lumotlar hajmini ishlatadi.

Faqat guruhlarni sanash o'rniga sekuntiga sodir bo'ladigan voqealar soni, navbatning yoshi, media baytlari va disk kechikishini o'lchash. Jonli yetkazib berish ishlayotgan yig'uvchida o'lchanadi. Avtomatik saqlash muddati tugagach o'chirish mavjud emas. Jurnal oxirini olib tashlash uning saqlangan tekshiruv nuqtalari bilan bog'liqligini bekor qiladi.

Ustuvor qayta tekshiruvlar allaqachon mavjud: yulduzcha qo'yilgan manbalar sukut bo'yicha har 15 daqiqada, qolganlari har 6 soatda qayta tekshiriladi (qarang: [qayta tekshiruv darajalari](https://phishdestroy.io/tgwitness/uz/docs/reference/collection/#recheck-tiers)). Parol bilan himoyalangan eksportlar yuqorida tasvirlanganidek ishlaydi. Cheklangan kirish [kirish va ruxsatlar](https://phishdestroy.io/tgwitness/uz/docs/reference/access/) bo'limida hujjatlashtirilgan. Qarang: [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md), [LIVE_ACCEPTANCE.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md) va [VERIFICATION.md](https://phishdestroy.io/tgwitness/uz/docs/reference/verification/).
