Manba / Sozlash
Telegram · Joriy etish
TgWitness-ni Windows, Linux, macOS yoki Docker-da xizmat sifatida, HTTPS orqali, zaxira nusxalari va yangilanishlari bilan ishga tushiring.
Inglizcha · Rus tili · Ukrain tili · Ispancha · Portugalscha (Braziliya) · Turkcha · Arab tili · Farsi · O'rdu · hindicha · Indoneziya tili · Vyetnam tili · Xoʻllashma xitoycha
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 ko'ring.
Native startup maxfiy .venvni 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.cmdavvalpy -3, keyinpython, 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.pyham ishlaydi. Portativ paketga umuman Python kerak emas. - Linux:
start.shpython3.13,python3.12,python3.11,python3vapythonni 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 mospython3-venvpaketini 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. 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, masalanTgWitness.cmd --port 8790 |
TgWitness-Demo.cmd |
data\demoda 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 guvohni 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/ 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 katalogini, 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 hujjatlarida qayd etilgan; mustaqil tekshiruv nuqtalari guvoh qo'llanmasida ko'rib chiqilgan.
Batafsil protseduralar: ulanish/xavfsizlik va ishlash rejimlari.