# Telegram · Joriy etish

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

TgWitness-ni Windows, Linux, macOS yoki Docker-da xizmat sifatida, HTTPS orqali, zaxira nusxalari va yangilanishlari bilan ishga tushiring.

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

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

TgWitness-ni Windows, Linux, macOS yoki Docker-da xizmat sifatida, HTTPS orqali, zaxira nusxalari va yangilanishlari bilan ishga tushiring.

[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/assets/chapter-operate.svg?v=7039a376d47f)

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

## O'rnatishni tanlang

Portativ paket uchun GitHub Releases'dan `TgWitness-<version>-windows-amd64-portable.zip`-ni chiqarib oling. Boshqa usullar uchun manba ZIP-faylni yuklab olib oching yoki omborni klonlang, so'ng loyiha katalogidan quyidagi buyruqni ijro eting:

| O'rnatish | Boshlash | Orqa fonda ishlaydimi? |
| --- | --- | --- |
| Windows uchun portativ paket | `TgWitness.cmd` | Yo'q; oynani ochiq holda saqlang. |
| Windows uchun mahalliy | `Start.cmd` | Yo'q; fon rejimida ishlatish uchun ixtiyoriy logon vazifasidan foydalaning. |
| Linux/macOS uchun mahalliy | `sh start.sh` | Yo'q; fon rejimida ishlatish uchun systemd/launchd dan foydalaning. |
| Har qanday qo'llab-quvvatlanadigan mezbon kompyuterda Docker | `docker compose up -d --build --wait` | Ha, Docker daemon ishlayotgan paytda. |
| Windows uchun Docker yordamchisi | `scripts\Docker.cmd` | Ha; yordamchi veb-server sog'lig'ini kutadi. |
| Linux/macOS uchun Docker yordamchisi | `sh scripts/docker-start.sh` | Ha; yordamchi veb-server sog'lig'ini kutadi. |

Uchinchi tomon tekshira oladigan bulutli server uchun — provayder API orqali yaratilgan, SSHsiz, faqat Cloudflare Tunnel orqali erishiladigan — [yuqori ishonchlilikka ega joylashtirishni](https://phishdestroy.io/tgwitness/uz/docs/reference/high-assurance/) ko'ring.

Native startup maxfiy `.venv`ni yaratadi va bog'langan bog'liqliklarni o'rnatadi. Docker ularni host Pythonni talab qilmay, image ichida quradi. Birinchi marta o'rnatish uchun Internetga ulanish zarur. Python 3.11+ topilmasa, `Start.cmd` hozirgi Windows foydalanuvchisi uchun Python 3.12 ni o'rnatishdan oldin so'raydi (winget orqali, aks holda Python Software Foundation imzosi tekshirilgach python.org installyeridan); u hech qachon administrator huquqlarini so'ramaydi. Docker va OS xizmatlari oldindan talab qilinadi.

Mahalliy va ko'chma o'rnatishlar papkalarida `data/live` dan foydalanadi. Docker `tgwitness-data` nomli hajmni `/data` da ishlatadi. To'liq ma'lumotlar katalogini ataylab ko'chirib o'tmaguningizcha, ular alohida o'rnatishlar hisoblanadi. Yangi Docker konteyneri mahalliy hisoblarni avtomatik ravishda aniqlaydi deb kutmang.

## O'rnatish talablari

Mahalliy o'rnatish uchun Python 3.11 yoki undan keyingi versiya, `venv` va `ensurepip`, birinchi bog'liqlikni o'rnatish uchun Internetga ulanish hamda `.venv` uchun yozish huquqiga ega loyiha papkasi kerak. Ilovaga kiritilgan panel uchun Node.js yoki frontend qurilmasi talab qilinmaydi. Launcher-ni odatdagi operatsion tizim akkauntingizdan ishga tushiring; TgWitness uchun administrator/root huquqlari zarur emas.

- **Windows:** `Start.cmd` avval `py -3`, keyin `python`, so'ngra foydalanuvchi uchun belgilangan va Program Files o'rnatish papkalarini tekshiradi va 3.11-versiya yoki undan keyingi versiyani talab qiladi. Agar hech biri ishlamasa, u yuqorida tasvirlangan avtomatik foydalanuvchi o'rnatilishini taklif etadi. `py -3 start.py` ham ishlaydi. Portativ paketga umuman Python kerak emas.
- **Linux:** `start.sh` `python3.13`, `python3.12`, `python3.11`, `python3` va `python` ni sinab ko'radi va mos keladigan dastur topilmaganda apt, dnf, pacman, zypper, apk yoki Homebrew uchun o'rnatish buyrug'ini chiqaradi. Debian/Ubuntu tizimlarida tanlangan interpretatorga mos `python3-venv` paketini o'rnatish talab qilinishi mumkin. Tarqatishning eski asosiy Python'i Python 3.11+ bilan almashtirilishi yoki to'ldirilishi kerak.
- **macOS:** joriy Python 3.11+ tarqatmasini o'rnating; operatsion tizim taqdim etgan interpretator talabga javob beradi deb hisoblamang. Loyiha katalogidan `python3 start.py`-dan foydalaning.
- **Docker:** Docker Engine/Desktop-ni Compose v2.20 yoki undan yangiroq versiyasi bilan ishlating. Docker Desktop Windowsda Linux konteynerlaridan foydalanishi kerak. Konteyner o'zining Python bog'liqliklarini o'rnatadi; hostda alohida Python o'rnatilishiga ehtiyoj yo'q.

## Mahalliy kompyuter

Windowsda `Start.cmd`, Linux/macOSda esa `sh start.sh` dan foydalaning. `scripts\Setup.cmd` yoki `sh start.sh --setup-only` muhitni tayyorlaydi. Launcher birinchi marta ishlatilganda zarur kutubxonalarni o'rnatadi; keyingi ishga tushirishlarda muhit qayta ishlatiladi. Sozlash va Telegram xabarlarini yig'ish uchun internetga ulanish talab etiladi, ammo mavjud yozuvlarni ko'rib chiqish va eksport yaratish oflayn rejimda amalga oshiriladi.

`python start.py --check`-ni sozlamalardan so'ng ishga tushiring, kollektorni ishga tushirmay turib mahalliy bog'liqliklarni, Ed25519, saqlash joyini, kalit konfiguratsiyasini va tinglash manzilini tekshirish uchun. Tuzilgan chiqish uchun `--json` dan foydalaning. Mo'ljallangan `--data-dir`, `--host` va `--port` ni uzating. Tekshiruv paketlarni o'rnatmaydi, jurnal yaratmaydi yoki Telegramga ulanmaydi; bu yaxlitlik yoki qamrov kvalifikatsiyasi emas. Startup alohida mavjud jurnallarni tekshiradi. `python start.py --help` ham o'rnatishni oldini oladi.

start.py-dan foydalangandan so'ng, Windowsda `.venv\Scripts\python.exe`, Linux/macOSda esa `.venv/bin/python` yordamchi buyruqlarini ishga tushiring yoki avval shu muhitni yoqing. Quyidagi `python -m ...` misollari muhit faol deb hisoblaydi.

```
python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787
```

Atrof-muhit o'zgaruvchilari: TGWITNESS_DATA, TGWITNESS_HOST, TGWITNESS_PORT, TGWITNESS_TOKEN. TGWITNESS_VAULT_KEY_FILE yangi o'rnatish uchun tashqi kalit rejimini tanlaydi; Qo'shimcha ma'lumot: [Tashqi bosh kalit](https://phishdestroy.io/tgwitness/uz/docs/reference/security/#external-master-key). TGWITNESS_TOKEN, agar ko'rsatilsa, kamida 24 belgidan iborat bo'lishi kerak; kriptografik jihatdan tasodifiy qiymatdan foydalaning. U bo'lmasa, ilova panel-token.txt faylida 256 bitli tasodifiy token yaratadi. Atrof-muhit ustunligi ushbu faylni qayta yozmaydi. Kirish ma'lumotlarini aylantirish uchun qayta ishga tushiring.

Aynan bitta jarayon ma'lumotlar katalogiga egalik qilishi mumkin. Platformalararo operatsion tizim fayl qulfi tasodifiy bir vaqtda yozuv qilishni oldini oladi. Bitta Uvicorn ishchisini ishlating. Panel istalgan sonli ish maydonlarini boshqarishi mumkin, qo'shimcha ish maydoni kataloglari profiles/<id>/ ostida joylashadi. Alohida xizmat instantsiyalari uchun alohida kataloglar va portlardan foydalaning. SQLite WAL fayllari tarmoq fayl tizimida emas, balki mahalliy doimiy saqlash joyida bo'lishi kerak. Bir xajmni nusxa ko'chirishlar (replika) o'rtasida ulashingiz mumkin emas.

## Windows uchun portativ paket

Har bir GitHub Release `TgWitness-<version>-windows-amd64-portable.zip` va uning `.sha256` versiyalarini o'z ichiga oladi. U python.org saytidan olingan rasmiy embeddable Python 3.12 ijro muhitini (checksum `tools/build_portable.py` da qayd etilgan), TgWitness va uning qayd etilgan bog'liqliklarini, shuningdek uchta ishga tushiruvchini o'z ichiga oladi:

| Hujjat | Maqsad |
| --- | --- |
| `TgWitness.cmd` | Panelni ishga tushiring; qo'shimcha parametrlar uzatiladi, masalan`TgWitness.cmd --port 8790` |
| `TgWitness-Demo.cmd` | `data\demo`da sintetik demo-ni ishga tushiring |
| `TgWitness-Check.cmd` | Boshlashni boshlamadan tayyorgarlik tekshiruvini ishga tushiring |

Mahkam biriktirilgan rus morfologiyasi lug'ati va PDF rang profillari oflayn foydalanish uchun to'plamga kiritilgan. Qadoqlash faqat ularning `data` bog'liqlik papkalaridagi ma'lum fayl yo'llariga ruxsat beradi; kutilmagan fayllar kompilyatsiyani muvaffaqiyatsiz yakunlaydi.

Butun arxivni yozish mumkin bo'lgan papkaga, masalan `Documents\TgWitness` ga chiqarib oling; uni ZIP ichida yoki Program Files katalogidan ishga tushirmang. Ijro vaqti alohida modul yo'lidan foydalanadi, shuning uchun boshqa Python o'rnatmalari va `PYTHONPATH` unga ta'sir qilmaydi. Ma'lumotlar paketning `data` papkasida saqlanadi. Yangilash uchun TgWitness-ni to'xtating, yangi versiyani yangi papkaga chiqarib oling va `data` papkasini nusxalab o'tkazing.

Uni 64-bit Windowsda Python 3.12 bilan o'zingiz quring:

```
python tools/build_portable.py
```

## Kontener

```
docker compose up -d --build --wait
```

Bu /data uchun nomlangan doimiy hajm yaratadi. Veb-port 127.0.0.1:8787 manziliga bog'lanadi. Jarayon UID 10001 sifatida, imtiyozlari cheklangan, faqat o'qish uchun mo'ljallangan root fayl tizimi va yozish mumkin bo'lgan /data hamda /tmp bilan ishlaydi. `--wait` qaytishdan oldin veb-serverning holatini tekshiradi; Telegram avtorizatsiyasi va yetkazib berish paneldagi oynada paydo bo'ladi. Taqdim etilgan yordamchilar kompilyatsiyadan so'ng 180 soniyalik tayyorlik timeout'idan foydalanadi. Dastlabki bog'liqliklarni yuklab olish bundan ham ko'proq vaqt olishi mumkin.

Ikkala asosiy Compose fayllari ham `tgwitness` loyiha nomidan foydalanadi, shuning uchun yangi chiqarilishni boshqa katalogga chiqarish yangi ma'lumot hajmini jimjit tanlamaydi. Ushbu loyiha uchun faqat bitta joylashtirishni faol saqlang. Mustaqil o'rnatishlar uchun noyob `docker compose -p NAME ...` va boshqa host portidan foydalaning hamda yangilanishlarda ikkalasini ham saqlang. Boshqa loyiha nomidan foydalangan eski joylashtirish uchun uning asl nomini `-p` bilan ishlatishni davom ettiring; `docker compose ls` mavjud loyihalarni ro'yxatlaydi.

`deploy/env.example` ni `.env` ga nusxa ko'chiring va `TGWITNESS_PORT` ni boshqa loopback portidan foydalanish uchun o'zgartiring. Masalan, `TGWITNESS_PORT=8788` panelni `http://127.0.0.1:8788` da ochadi; konteyner esa hanuz 8787 portda tinglaydi. `.env` Git tomonidan e'tiborsiz qoldirilgan.

Boshlang'ich tokenni oling:

```
docker compose exec tgwitness cat /data/panel-token.txt
```

Foydali buyruqlar:

```
docker compose ps
docker compose logs --tail 100 -f
docker compose stop
docker compose up -d --wait
```

`restart: unless-stopped` qulash yoki Docker daemon qayta ishga tushgach kollektorni qayta ishga tushiradi. Linux serverida, odatda `sudo systemctl enable --now docker` bo'lgan distribyutivingizning xizmat menejeri orqali tizim yuklanganda Docker ni yoqishni yoqish. Windows/macOS da Docker Desktop ning tizimga kirishda avtomatik ishga tushirish sozlamasini yoqish. Kompyuterdan chiqish, uxlatish yoki to'xtatilgan Docker daemon yig'ishni to'xtatishi mumkin. Aniq to'xtatilgan konteyner uni qayta ishga tushirmaguningizcha to'xtagan holda qoladi.

Misol konfiguratsiyasida /tmp hajmi 512 MiB bilan cheklangan. Eksport qurilishi uning o'rniga har bir ish maydonining doimiy /data yo'lida joylashgan `temporary-exports/`-dan foydalanadi. Simultane eksportlar, jurnal/WAL o'sishi, media va zaxira nusxalar uchun o'sha joyda bo'sh joy ajrating. Ishga tushiruvchi deploy/constraints.txt faylidan foydalanib, kerakli ijro muhitiga bog'liqlik versiyalarini mahkamlaydi. Docker va yuqori ishonchlilikka ega serverlar pip --require-hashes bilan deploy/requirements.lock va deploy/build.lock-dan o'rnatiladi: har bir paket fayli commitda qayd etilgan SHA-256 bilan mos kelishi kerak, shuning uchun PyPI yoki uning oynasida almashtirilgan fayl o'rnatilmaydi. Faqat manba kodi bilan tarqatiladigan paketlar (jieba, pyaes) launcher, Windows portable builder va Dockerfile tomonidan deploy/build.lock faylida belgilangan setuptools yordamida (`--no-build-isolation`) kompilyatsiya qilinadi, shuning uchun pip alohida, belgilanmagan kompilyatsiya muhitini aniqlamaydi. Python asosiy image va operatsion tizim paketlari mustaqil chiqarilish malakasini talab qiladi.

Jurnal va kalitlarni yo'q qilmoqchi bo'lmasangiz, docker compose down -v ni ishlatmang. Kontener sog'ligi hisobotlari Telegram xabarlarini muvaffaqiyatli qabul qilishni emas, veb-server mavjudligini ko'rsatadi. Panelning yig'uvchisining holatini, yurak urishini, xatolarini va qamrov voqealarini tekshiring.

### Mustaqil guvoh profili

Ixtiyoriy `witness` xizmati [mustaqil guvoh](https://phishdestroy.io/tgwitness/uz/docs/reference/witness/)ni o'z konteynerida, o'z kaliti va jurnali bilan `witness-data` hajmida ishga tushiradi va kollektor uchun faqat o'qish huquqiga ega guvoh tokenini taqdim etadi. Tokenni panelda **More tools → Extras → Independent witness** bo'limida yarating, uni bot tokeni va kanali bilan `.env` ga qo'shing, so'ng profilni ishga tushiring:

```
docker compose --profile witness up -d          # deploy/compose/compose.image.yaml: same flag
docker compose logs witness                     # witness key fingerprint
```

Xizmat Compose tarmog'idagi `http://tgwitness:8787` manzildagi yig'uvchiga ulanadi (`TGWITNESS_WITNESS_COLLECTOR` ustun keladi, masalan, boshqa ish maydoni uchun `/profiles/<workspace ID>` ). Alohida serverda, boshqa birov tomonidan boshqariladigan guvoh uchun `deploy/compose/compose.witness.yaml` manzilini ishlating va `TGWITNESS_WITNESS_COLLECTOR` ni yig'uvchining HTTPS manziliga o'rnating; o'sha faylda faqat guvoh bo'ladi.

## Nashr qilingan rasmni o'rnating

`deploy/env.example` nusxasini `.env` ga nusxalang. `TGWITNESS_IMAGE` ni e'lon qilingan versiyaga, **kichik harfli** ombor yo'lidan foydalangan holda o'rnating, masalan:

```
TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3
TGWITNESS_PORT=8787
```

`compose.yaml` o'rniga, ushbu faylni mustaqil ravishda ishga tushiring:

```
docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait
docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt
```

Hostda manba kodini kompilyatsiya qilish, Python yoki kompilyator o'rnatilishi shart emas. Reliz jarayoni Linux AMD64 va ARM64 konteynerlarini, jumladan Docker Desktop'ning Linux virtual mashinasi (VM)ni qo'llab-quvvatlaydi. Jarayon tavsifidan versiya tegini yoki `ghcr.io/owner/repository@sha256:...` ni ishlating. `latest` tegini ko'chirish yoki ilovani nazoratsiz yangilash sozlanmagan. Image va manba variantlari loyiha nomlari mos kelganda bir xil ma'lumot hajmini ishlatadi.

## Serverda avtomatik HTTPS

Docker bilan ishlaydigan server, nazorat qiladigan domeningiz va doimiy mahalliy saqlash joyidan foydalaning. Domenda A/AAAA yozuvlarini serverga yo'naltiring; IPv6 unga yetib kelganda AAAA yozuvini nashr eting. Kiruvchi TCP 80 va 443 portlarini hamda sertifikat chiqarish uchun chiquvchi DNS/HTTPS trafigini ruxsat eting. Boshqa xizmatlar ushbu portlarni allaqachon egallab olmagan bo'lishi kerak.

`deploy/env.example` ni `.env` ga nusxa ko'chiring va sxema yoki yo'l ko'rsatmasdan host nomini belgilang:

```
TGWITNESS_DOMAIN=watch.your-domain.org
```

HTTPS ustki qatlami bilan manba kompilyatsiyasini ishga tushiring:

```
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt
```

```
docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait
```

E'lon qilingan rasm uchun o'rniga birinchi fayl sifatida `deploy/compose/compose.image.yaml` ni ishlating. Keyingi holat, loglar, yangilash va to'xtatish buyruqlari uchun ikkala `-f` argumentini saqlang.

Caddy sertifikatni oladi va yangilaydi, HTTP-ni HTTPS-ga yo'naltiradi va so'rovlarni xususiy Compose tarmog'idagi yig'uvchiga uzatadi. Sertifikat holatiga o'zining doimiy hajmi biriktirilgan. Yig'uvchining to'g'ridan-to'g'ri host porti faqat loopback uchun mo'ljallangan bo'lib qoladi. Taqdim etilgan Caddy konfiguratsiyasi kirish jurnalini yuritishni yoqmaydi.

`https://watch.your-domain.org` manzilini oching va panel tokenini kiriting. Tayyorgarlikni tuzish konteynerlarni qamrab oladi; sertifikat berish va tashqi erishuv DNS hamda firewallga bog'liq. Agar HTTPS tayyor bo'lmasa, DNS, firewall qoidalarini va:

```
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy
```

Taqdim etilgan Caddy tasviri uning `2-alpine` tegiga ega. Pulling o'sha tasvirni yangilaydi; agar sizga infratuzilma versiyalarini barqaror saqlash kerak bo'lsa, joylashtirishingizda sinovdan o'tgan digestni pin qiling.

## Yangilanishlar va zaxira nusxalari

Yangilanishlar davomida Compose loyiha nomini va ma'lumot hajmini saqlab qolish. Avvalo, to'plovchini to'xtating va to'liq zaxira nusxasini yarating. Standart manbaga asoslangan joylashtirish uchun:

```
docker compose stop
docker compose cp tgwitness:/data ../tgwitness-backup-before-update
```

Har safar ombor tashqarisida yangi zaxira manzilini ishlating va uni hisobga kirish materiali sifatida himoya qiling. Misol yo'li ko'rsatmali; shaxsiy zaxira joyingizdan foydalaning. Yashirin fayllar, barcha ish maydonchalari, kalitlar, jurnal va media hamda butun papkani nusxalang. Agar sozlangan bo'lsa, tashqi omborning bosh kalitini alohida zaxiralang. Dalil ZIP fayli tiklanadigan ilova zaxira nusxasi emas. HTTPS uchun, agar uning sertifikat/hisob holatini saqlash zarur bo'lsa, Caddy hajmlari ham saqlansin.

Manbaani ishga tushirish uchun yangi reliz fayllarini oling va quyidagi buyruqni ijro eting:

```
docker compose up -d --build --wait
```

Image deploy uchun `TGWITNESS_IMAGE` ni xohlagan versiyaga o'zgartiring, so'ngra quyidagi buyruqni ishga tushiring:

```
docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait
```

Oldingi stop/copy buyruqlari uchun ham o'rnatishingizning Compose fayllaridan foydalaning. `.env`, maxsus konfiguratsiya va loyiha nomini o'zgarmas qoldiring. `down` nomlangan hajmlarni saqlaydi; **`down -v` ularni o'chiradi**. `.venv` ni operatsion tizimlar yoki Python versiyalari o'rtasida nusxalamaslikka harakat qiling. Mahalliy yangilanishlar uchun TgWitness ni to'xtating, uning to'liq ma'lumotlar katalogining zaxira nusxasini oling, manba fayllarini almashtiring va ishga tushirishdan oldin `python start.py --setup-only` ni ishga tushiring.

Yangilanishdan so'ng boshqaruv paneli kirishini, hisob identifikatorini, kuzatuv holatini va qamrovni tekshiring. Qayta ishga tushgandan so'ng TgWitness saqlangan Telegram yangilanish pozitsiyasini tiklaydi va yangilanish jarayonida o'tkazib yuborilgan yangilanishlarni so'raydi. Agar kelajakdagi versiya saqlash formatlarini o'zgartirsa, rollback uchun oldingi yangilanishdan oldingi zaxira nusxasi kerak bo'lishi mumkin.

## Masofaviy server

Xizmatni loopback manziliga bog'lab qo'ying va SSH tunneli ishlating yoki HTTPSni teskari proxyda yakunlang. Asosiy Compose fayli faqat mahalliy; ixtiyoriy `deploy/compose/compose.https.yaml` ustki qatlami sozlangan domen uchun Caddy'ni ta'minlaydi. URL manzillari va proxy jurnallarida bearer tokenini ko'rsatmang. Revers-proxy so'rov hajmi va ulanish tezligini cheklashi kerak. Oddiy HTTP-ni Internetga ochiq qoldirmang.

[deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) katalogida systemd, Windows logon vazifasi, macOS foydalanuvchi agenti va Caddy uchun misollar keltirilgan. Ularni o'rnatishdan oldin yo'llarini ko'rib chiqing va moslashtiring. Ular shablonlar bo'lib taqdim etilgan, mahalliy ijro etiladigan platforma kvalifikatsiyalari emas. Oddiy ishga tushiruvchi orqali hech qanday fon xizmati yoki vazifa ro'yxatga olinmaydi.

Windowsda oynasiz `pythonw.exe` ishga tushirilganda, diagnostika ma'lumotlari `logs/server.log` ning ma'lumotlar katalogida (har bir fayl uchun 5 MiB, ikkita aylantirilgan zaxira nusxa) saqlanadi. Konsolda ishga tushirishlar konsol yozuvlarini saqlab qoladi. HTTP kirish yozuvlari ikkala rejimda ham o'chirilgan. Loglarni ma'lumotlar katalogi bilan himoya qiling va ulashishdan oldin tekshirib chiqing.

## Qayta boshlash va bo'shliqlar

So'nggi so'ralgan kuzatuv holati saqlanadi. Agar kuzatuv faol bo'lsa, dastur ishga tushirilganda ulang'ichni qayta ulashga va tanlangan manbalarni tiklashga harakat qiladi. Qo'lda pauza qilish bu niyatni bekor qiladi. Muvaffaqiyatsiz qayta ishga tushirish qayd etilib, panelda ko'rsatiladi.

TgWitness akkaunt va har bir kanal uchun Telegram yangilanish pozitsiyasini (pts, qts, seq va date) ish maydoni seyfida saqlaydi va keyingi ishga tushirishda uni tiklaydi. Keyin klient jarayon to'xtatilgan paytda qoldirilgan yangilanishlarni so'raydi va muntazam qayta tekshirish qoldirilgan xabarlarni tiklaydi hamda Telegram endi qaytarmaydigan saqlangan xabarlarni yozib oladi. Dialog oynalari ishga tushirilganda qayta yuklanadi. Har bir ishga tushirishda avvalgi jurnal sarlavhasi, oflayn chegarasi va qayta tiklangan yangilanish pozitsiyasi qayd etiladi. Monitor har 10 soniyada ulanishni tekshiradi va har daqiqada bir marta heartbeat (**jonlilik belgisi) qo'shadi (Qo'shimcha vositalar → Parametrlar → Jonlilikni har qayd etish**). Ulanish uzilishlari va jim davrlar sababi bilan qamrov bo'shliqlari sifatida qayd etiladi. Tarix snopshotlari jonli yozuvlar yonida alohida joriy-tarix kuzatuvlari sifatida saqlanadi.

Media navbati har bir ish maydonining SQLite ma'lumotlar bazasida saqlanadi. Xabar va uning vazifasi atomik tarzda yakunlanadi. To'xtab qolgan vazifalar ish boshlanganda qayta urinish uchun tiklanadi. Har bir yuklab olishga 120 soniya asosiy kutish vaqti, shuningdek, uning hajmi uchun 256 KiB/s tezlikda hisoblanadigan vaqt va Har bir ilova turi uchun 1–2,000 MiB chegarasi mavjud; timeout, tezlik va qayta urinishlar **Sozlamalar → Qo'shimcha vositalar** bo'limida joylashgan. Yig'uvchi hajmi noma'lum bo'lgan fayllarni o'tkazib yuboradi. To'xtatish navbatdagi ishlarni saqlab qoladi. Qayta urinish dastlabki kuzatilgan fayl ko'rsatkichini ishlatadi, keyinchalik tahrirlangan xabarning eng so'nggi versiyasini emas. Vaqtinchalik xatoliklar cheklangan qayta urinishlarga ega; media FloodWait to'xtab turishlari qayta ishga tushirishdan keyin ham saqlanadi. Media tiklash Telegram yangilanishini tiklashdan alohida va yo'qolgan fayllarni qayta yaratmaydi.

## Zaxira, tiklash va sig'im

`tgwitness backup FOLDER` ma'lumotlar katalogini paneldagi ish to'xtamayotgan paytda nusxalaydi: avvalo tekshiruv nuqtalarini, keyin onlayn zaxira API orqali SQLite fayllarini, so'ngra kalitlar, media va profillarni nusxalaydi, shuning uchun nusxalangan tekshiruv nuqtasi nusxalangan jurnalga qaraganda yangiroq bo'lmaydi. `backup-manifest.json` har bir faylning SHA-256 ko'rsatkichini va jurnal boshlarini ro'yxatlaydi. Qayta tiklash uchun TgWitness-ni to'xtating va butun ma'lumotlar katalogini shu papka bilan almashtiring. Keyingi ishga tushirish jurnalning eski nusxadan tiklanganini qayd etadi. Ushbu yozuv jurnalni ma'lumotlar katalogidan tashqaridagi `TGWITNESS_STATE_DIR` papkasida saqlangan bosh bilan solishtiradi: `tgwitness-state` hajmida Compose, systemd birliklarida `/var/lib/tgwitness-state` va foydalanuvchining mahalliy holat papkasini boshqa hollarda. Yozish mumkin bo'lgan holat papkasi bo'lmasa, tiklash aniqlanmaydi va logda bu haqida bir marta xabar beriladi.

Buyruq bo'lmasa, **butun ma'lumotlar katalog**ini, jumladan vault.key, signing.enc, credentials.enc, SQLite ma'lumotlar bazasi/WAL fayllari, media, token, tekshiruv nuqtalari va barcha profil/kichik kataloglarni nusxalashdan oldin jarayonni to'xtating. Maqsadli xizmat to'xtatilgan paytda to'liq nusxani tiklang. Yo'qolgan vault kalitlari yoki signing-key nomuvofiqligi tizimni ishga tushirishni muvaffaqiyatsiz yakunlaydi; majburiy kirish uchun kalitlarni qayta yaratmang.

Maxfiy zaxira nusxalarini shifrlangan va kirish nazoratli holda saqlang. Dalil ZIP-fayllari ko'chma: ular ilova zaxira nusxalari yoki Telegram sessiyasi zaxira nusxalari emas, balki artefaktlarni ko'rib chiqish uchun mo'ljallangan. Avtomatik saqlash yoki o'chirish mavjud emas. Barcha xabarlar, xom metadata, media, vaqtinchalik eksportlar va zaxira nusxalari uchun disk maydonini rejalashtiring.

Butun jurnalni yuklash o'rniga boshlang'ich tekshiruv va eksport oqim yozuvlari. Eksport o'qish snapshotini mahkamlaydi, shu vaqtda yangi WAL yozuvlari davom etishi mumkin; uzoq davom etadigan eksportlar WAL sahifalarini saqlab qolishi mumkin, shuning uchun disk sig'imi hali ham muhim. ZIP-lar siqilmagan holda 4 GiB bilan cheklangan, bu mustaqil verifikatorning standart qiymatiga mos keladi; **Qo'shimcha vositalar → Parametrlar → Eng katta imzolangan ZIP** limitni oshiradi va bunday arxivlar `verify.py --max-gib N` yordamida tekshiriladi. Boshqa formatlarda voqealar soni bo'yicha cheklov yo'q. Qo'llab-quvvatlanadigan brauzerlar javob bo'laklarini foydalanuvchi tanlagan faylga oqimlaydi. Boshqa brauzerlar esa maksimal 128 MiB buferlaydi va katta o'lchamdagi uzatmalarni autentifikatsiyalangan CLI ga yo'naltiradi:

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

Boshqa ish maydoni uchun **Exports → Workspace ID** bo'limidan `--profile ID`, masofaviy server uchun `--format zip|jsonl|csv|html` va `--url https://your-server` yoki 5 GiB uzatish limitini o'zgartirish uchun `--max-mib` ni ishlating. Oddiy HTTP faqat loopback uchun ruxsat etiladi. Tokenlar sarlavhalarda uzatiladi, yo'naltirishlar rad etiladi, mavjud fayllar ustidan yozib tashlanmaydi va to'liq bo'lmagan yuklamalar yakuniy fayllar sifatida e'lon qilinmaydi. Agar TGWITNESS_TOKEN hosil qilingan tokenni bekor qilsa, alohida himoyalangan va o'sha faol qiymatni o'z ichiga olgan fayldan foydalaning: panel-token.txt ustun qo'yish orqali yozib tashlanmaydi. Buyruqning SHA-256 qiymati faqat uzatish tekshiruv yig'indisi hisoblanadi; imzolangan ZIP faylni mustaqil ravishda tekshiring.

Panel navbatga qo'yilgan/muvaffaqiyatsiz bo'lgan media, eng qadimgi kutayotgan media, bo'sh disk, Telegram so'rovlari to'xtatib turilgan vaqtlar hamda kirish tasdiqlanmagan manbalarni ko'rsatadi. Ushbu diagnostika vositalari to'liq oxirigacha yetkazib berish monitoringi emas. Ish maydonchalari jarayonni baham ko'radi; shovqinli hisob boshqalarga ham ta'sir qilishi mumkin. Alohida ishchi jarayonlar, saqlash muddati/aylantirish, barqaror yangilanishlarni tiklash va to'liq joriy etishni tasdiqlash saqlanib qoladi. Panelga cheklangan kirish huquqi [kirish va ruxsatnomalar](https://phishdestroy.io/tgwitness/uz/docs/reference/access/) hujjatlarida qayd etilgan; mustaqil tekshiruv nuqtalari [guvoh](https://phishdestroy.io/tgwitness/uz/docs/reference/witness/)qo'llanmasida ko'rib chiqilgan.

Batafsil protseduralar: [ulanish/xavfsizlik](https://phishdestroy.io/tgwitness/uz/docs/reference/connection/) va [ishlash rejimlari](https://phishdestroy.io/tgwitness/uz/docs/reference/operations/).
