# TgWitness: Telegram Export, OSINT & Verification

Canonical page: https://phishdestroy.io/tgwitness/docs/reference/overview/

Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads with their methods and revisions.

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

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

Zainstaluj za pomocą jednego polecenia lub uruchom na GitHub Actions. Zapoznaj się z opcjami badania, opublikowaną skalą oraz tym, co weryfikuje archiwum.

TgWitness to oparty na otwartym oprogramowaniu eksportator danych z Telegrama oraz środowisko do prowadzenia dochodzeń. Zainstaluj go jednym poleceniem, połącz konto, wybierz czaty i wyeksportuj podpisane archiwum. Obsługuje również tymczasowe gromadzenie danych w GitHub Actions oraz kontynuowanie dochodzeń dzięki zapisanym zmianom, obserwacjom usunięć, wyszukiwaniu i raportom.

## Zacznij od zadania, które masz

| Twoje zadanie | Najkrótsza ścieżka | Co otrzymasz |
| --- | --- | --- |
| Zapisz rozmowę lub konto | Zainstaluj, połącz konto, wybierz zakres eksportu | Podpisane archiwum zawierające wybraną historię, wyniki zebranych danych oraz materiały weryfikacyjne |
| Zbierz dane w tymczasowym środowisku uruchomieniowym | Należy skorzystać z funkcji przechwytywania w GitHub Actions, autoryzować nową sesję i wybrać zakres | Zaszyfrowane archiwum z historią przepływu pracy w serwisie GitHub |
| Śledź zmiany w czasie | Utrzymaj działanie funkcji obserwacji dla wybranych czatów | Zapisane wersje, powiadomienia o usunięciu, załączniki i zarejestrowany zakres |
| Zbadaj i podziel się wynikami | Przeszukaj archiwum, skorzystaj z tablicy przypadków i skonfiguruj raport lub kopię do udostępnienia | Wyniki powiązane ze źródłami oraz weryfikowalne przekazanie dostosowane do odbiorcy |

### Instalacja za pomocą jednego polecenia

Instalator zawiera język Python oraz zależności. Pobranie kodu źródłowego, Docker, dostawca AI oraz niezależny świadek są opcjonalnymi elementami, a nie warunkiem wstępnym instalacji.

Linux / macOS:

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

System Windows, w PowerShell lub w wierszu poleceń:

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

Otwórz panel, połącz swoje konto Telegram i wybierz zakres gromadzenia danych. Instalacja sama w sobie nie uruchamia gromadzenia danych. [instrukcja instalacji](https://phishdestroy.io/tgwitness/pl/docs/reference/installation/) wyjaśnia kwestie związane z dostępem lokalnym, serwerami, aktualizacjami oraz sprawdzaniem pobranej kompilacji.

Aby uruchomić tymczasowy program, postępuj zgodnie z instrukcją [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). Ten przepływ pracy wymaga utworzenia forka na GitHubie, autoryzacji oraz hasła do archiwum. Strona capture wyjaśnia te kroki oraz czas trwania sesji przed uruchomieniem. Pobierz i zachowaj powstałe archiwum wraz z materiałami weryfikacyjnymi.

## Dodatkowe ustawienia, jeśli zadanie tego wymaga

Eksport pojedynczego czatu wymaga konta i wybranego zakresu. Ciągła obserwacja, wiele kont, serwery proxy, zasady dotyczące załączników, projekt raportów, dostęp recenzentów, zewnętrzne znaczniki czasu oraz przechowywanie poza serwisem służą różnym wymaganiom związanym z dochodzeniami i przekazywaniem danych. Należy skonfigurować te funkcje, gdy są one istotne.

Zakres, uprawnienia i zminimalizowane kopie udostępniane pomagają operatorom w wyborze tego, co należy gromadzić i ujawniać. Wytyczne dotyczące jurysdykcji oraz ustawienia raportów rejestrują wybraną procedurę i etapy przygotowawcze. Zobacz [eksport konta](https://phishdestroy.io/tgwitness/pl/docs/reference/account-export/), [dostęp](https://phishdestroy.io/tgwitness/pl/docs/reference/access/) oraz [konfigurację raportów](https://phishdestroy.io/tgwitness/pl/docs/reference/case-reports/).

Aplikacja działa na wybranym komputerze lub serwerze. Podstawowe gromadzenie danych nie wymaga procesora graficznego (GPU) ani modelu języka wielkiego (LLM). Opcjonalne funkcje OCR, transkrypcji i analizy AI mają swoje własne wymagania dotyczące zasobów. Należy dobrać rozmiar wdrożenia pod kątem częstotliwości wiadomości, załączników, przechowywanej historii oraz liczby kont działających jednocześnie.

## Zachowaj ten zapis, niezależnie od tego, komu pomoże

Celem jest zachowanie zaobserwowanych materiałów, kontekstu i zmian, niezależnie od tego, czyje stanowisko potwierdzają. Dowody mogą podważać własną relację kolektora dotyczącą wydarzeń. Należy zapewnić identyfikowalność obserwacji źródłowych, brakujących danych oraz wniosków analitycznych, aby inna osoba mogła ocenić ten sam materiał.

Logika działania jest następująca: obserwacja widoczna na koncie → podpisany dziennik → eksport → weryfikacja przez odbiorcę. Zapisane zmiany tworzą nowe wersje. Usunięte obserwacje zachowują wcześniej zarejestrowaną treść. Zapisy dotyczące zasięgu ujawniają znane przerwy w działaniu. Raporty i analizy AI odwołują się do zapisanych źródeł; interpretacja nie staje się obserwacją źródłową tylko dlatego, że pojawia się w podpisanym raporcie.

| Kontrola weryfikacyjna | Co może ustalić odbiorca |
| --- | --- |
| Suma kontrolna pliku, podpisy i łańcuch dzienników | Dostarczone rekordy i pliki są zgodne z oczekiwanym kluczem i granicami dziennika |
| Oddzielnie zachowany punkt kontrolny lub świadek | Archiwum jest zgodne z wcześniej zachowanym stanem dziennika |
| Zweryfikowany zewnętrzny znacznik czasu | Wspomniane bajty istniały w momencie oznaczenia czasowego zgodnie z podanymi założeniami dotyczącymi zaufania. |
| Poświadczenie przechwytywania z serwisu GitHub | Archiwum jest zgodne z zatwierdzonym przebiegiem pracy, wersją kolektora oraz zarejestrowanym skrótem. |
| Poświadczenie Intel TDX | Cytat, stan platformy, oczekiwane pomiary systemu operacyjnego/aplikacji, aktualność oraz tożsamość kolektora przechodzą skonfigurowane kontrole |

W przypadku poświadczonego pozyskiwania uwierzytelnione połączenie z Telegramem zatwierdzonego kolektora oraz jego dane wyjściowe są powiązane ze sprawdzonym środowiskiem wykonania. Archiwum zachowuje przechwyconą treść i kontekst; raporty i analizy odwołują się do tych zapisów. Należy stosować kroki weryfikacji specyficzne dla danego trybu oraz zaufane dane wejściowe zawarte w [przewodniku zaufania](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) i [formacie dowodów](https://phishdestroy.io/tgwitness/pl/docs/reference/evidence/).

## Opublikowana skala i zmierzona wydajność

Poniższe wyniki opisują różne obciążenia i daty. Liczby nie są wymienne: zdarzenie w dzienniku niekoniecznie odpowiada pojedynczej wiadomości w Telegramie.

| Data | Zakres prac | Opublikowany wynik | Co zostało zmierzone |
| --- | --- | --- | --- |
| 1 listopada 2026 r. | Działający serwer, dziesięć baz danych obszarów roboczych | 1,610,818: zapisy dziennika; 900,232: zdarzenia związane z nowymi wiadomościami, 80,683: zdarzenia związane z edycją oraz 400,536: zdarzenia związane z usunięciem | Wykaz przechowywanych dzienników dostępny wyłącznie do odczytu |
| 5 listopada 2026 r. | Wyszukiwanie wśród 1,000,000 syntetycznych wiadomości w czatach 200 | Indeks utworzony w 71 sekund; mediana czasu wyszukiwania na zapytanie wynosi 9–190 ms | Test porównawczy wyszukiwania lokalnego |
| 6 listopada 2026 r. | Dwa najnowsze eksporty danych z serwisu Telegram | Komunikaty 27,030 i 29,299; 56,329 w obu przebiegach | Dwa konta na jedno uruchomienie przez WARP, tekst i metadane, bez pobierania załączników |
| 6 listopada 2026 r. | Te same dwa eksporty, w tym przygotowanie i pakowanie | 127.713 i 141.781 wiadomości na sekundę | Zmierzone wskaźniki pełnego eksportu; oba archiwa zweryfikowano przy użyciu przypiętych kluczy |

[Zapis weryfikacyjny](https://phishdestroy.io/tgwitness/pl/docs/reference/verification/) zawiera spis serwerów, bieżące kontrole zbioru danych oraz pomiary wyszukiwania. [Wyniki eksportu](https://phishdestroy.io/tgwitness/docs/validation/) obejmują dwa rzeczywiste przebiegi, sprzęt, czasy trwania, skróty archiwów oraz podpisane pliki pomiarowe, z których każdy zawiera zarejestrowaną wersję i warunki.

[Kwalifikacja historii publicznej](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-BENCHMARK-2026-11-06.md) rejestruje również **48 zweryfikowanych archiwów zawierających 3,598,381 rekordów** z listy 50 źródeł wejściowych i 40 obszarów roboczych kont. Źródło A, obejmujące osiem kont, pozyskało **768,007 rekordów historii w ciągu 1,117.082 sekund**, łącznie z czasami oczekiwania: **687.512 rekordów na sekundę**, przy wyłączonym pobieraniu załączników. Cała próba, łącznie z walidacją, trwała 1,574.920 sekund. Pomiary te opisują to obciążenie, obok powyższych przykładów mniejszych eksportów świeżych danych.

### Historia testów i czas trwania

Narzędzie TgWitness było rozwijane i testowane przez około sześć miesięcy. Najpierw powstały moduł zbierający dane, podpisany dziennik oraz moduł weryfikujący; panel internetowy i moduły rozszerzające zostały zbudowane na ich podstawie w późniejszym terminie. Niniejsze repozytorium zostało utworzone 29 października 2026 r. w celu publikacji i opiera się na istniejącym kodzie, dlatego jego wiek nie odpowiada wiekowi projektu ([historii rozwoju](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#development-history)). Łączne obciążenie testowe wynosi około 100 milionów, wliczając wcześniejsze przebiegi, awarie, poprawki oraz powtarzane walidacje. Wybrane przebiegi, z których każdy posiada własną wersję, metodę i wynik, zostały udokumentowane w [opatrzonych datą publicznych pomiarach](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#dates-of-the-published-measurements).

## Dokładne odczytanie statusu dostępności

Oceń każdy przepływ pracy pod kątem jego implementacji, opublikowanej kompilacji i zarejestrowanych testów. Kod źródłowy jest obecnie oznaczony jako preview. Ta etykieta wydania współistnieje z działającą kolekcją, eksportami, niezależną weryfikacją i opublikowanymi pomiarami skali. Funkcja w wersji podglądowej i zweryfikowany przepływ pracy mogą występować w tej samej aplikacji; opisz konkretną funkcję i dowody leżące u podstaw oceny.

Należy łącznie uwzględniać [aktualne możliwości](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md), [funkcje i ograniczenia](https://phishdestroy.io/tgwitness/pl/docs/reference/features/), [weryfikację](https://phishdestroy.io/tgwitness/pl/docs/reference/verification/) oraz [dziennik zmian](https://phishdestroy.io/tgwitness/pl/docs/reference/changelog/). Podając wynik, należy odnotować testowaną wersję. Migawka pomiarowa z 6 listopada zawiera również testy, które zakończyły się niepowodzeniem lub zostały pominięte; nie są to wyniki pozytywne.

## Czytelne zarówno dla ludzi, jak i dla narzędzi AI

Witryna zawiera zwięzłą wersję `llms.txt`, kompletny podręcznik w języku angielskim w wersjach `llms-full.txt` i `llms-full.md` oraz wersje stron w formacie Markdown. Są to formaty dokumentacji, a nie wymagania dotyczące sztucznej inteligencji niezbędne do uruchomienia TgWitness.

Opcjonalny dostęp z wiersza poleceń [MCP](https://phishdestroy.io/tgwitness/pl/docs/reference/mcp/) i  umożliwia autoryzowanym narzędziom odczyt wybranych zapisanych rekordów. Treść wiadomości pozostaje niezaufanym dane wejściowe. Podsumowania powinny podawać źródła, odróżniać fakty obserwacyjne od wniosków oraz uwzględniać niepewność. Wyszukiwanie pełnotekstowe, OCR i wyniki generowane przez sztuczną inteligencję nie zmieniają oryginalnych, podpisanych obserwacji.
