Niektóre fragmenty tej strony są nadal w języku angielskim: angielski tekst źródłowy uległ zmianie po przetłumaczeniu.
Odniesienie / Zbieraj
Telegram · Procesy i operacje
Codzienne działanie panelu: tryby pracy, kategorie monitorowania, parametry, powiadomienia, eksport danych, tworzenie kopii zapasowych oraz pojemność.
TgWitness / Dokumentacja · Wdrażanie i przywracanie
W przypadku pierwszego połączenia proszę skorzystać z kont i formatów sesji. Wyjaśnienie dotyczące zapisanych wersji, zasad dotyczących zdarzeń oraz luk można znaleźć w sekcji „Jak działa gromadzenie danych”. Niniejszy przewodnik obejmuje codzienne działanie oraz odzyskiwanie danych.
Zainstalowana wersja zawiera pliki , START-HERE.html, oraz START-HERE.txt i obok
programu uruchamiającego, wraz z linkiem do repozytorium i poleceniami dostosowanymi do ścieżki instalacji.
Uruchom plik tgwitness guide --print przez SSH lub tgwitness paths, aby zlokalizować
rzeczywisty katalog danych. Instalacja z uprawnieniami roota w systemd przechowuje stan prywatny w pliku
/var/lib/tgwitness-…; plik /opt/tgwitness zawiera sam program.
W przypadku zarządzanego tymczasowego tunelu Cloudflare, tgwitness tunnel off blokuje publiczny
dostęp, podczas gdy lokalny panel i zbieranie danych nadal działają. tgwitness tunnel on
włączają go; tgwitness tunnel restart tworzy nowe połączenie tunelowe. Użyj
tgwitness open, aby sprawdzić jego aktualny adres. Wyraźne wyłączenie pozostaje aktywne
po ponownym uruchomieniu usługi. tgwitness stop zatrzymuje zarówno panel, jak i zbieranie danych.
Na tej stronie
- Przebieg pracy operatora
- Udostępnianie wyników pracy bez udostępniania klucza głównego
- Tryby działania
- Kategorie monitorowania
- Powiadomienia
- Układ panelu
- Środowiska wdrożeniowe
- Kontrole podczas uruchamiania i eksporty
- Tworzenie kopii zapasowych, przywracanie i przerwy
- Pojemność i okres przechowywania
Przebieg pracy operatora#
Schemat w formie tekstowej
- Wybierz opcję przechowywania danych i zabezpieczenia klucza → Proszę otworzyć panel za pomocą tokenu
- Proszę otworzyć panel za pomocą tokenu → Proszę wybrać obszar roboczy
- Proszę wybrać obszar roboczy → Konfiguracja połączenia bezpośredniego lub przez serwer proxy
- Konfiguracja połączenia bezpośredniego lub przez serwer proxy → Wprowadź numer telefonu lub wybierz pliki / kod QR
- Wprowadź numer telefonu lub wybierz pliki / kod QR → Proszę sprawdzić tożsamość konta i wybrać grupy, do których ma Pan/Pani dostęp
- Proszę sprawdzić tożsamość konta i wybrać grupy, do których ma Pan/Pani dostęp → Zapisz zasady dotyczące zdarzeń i załączników, a następnie rozpocznij monitorowanie
- Zapisz zasady dotyczące zdarzeń i załączników, a następnie rozpocznij monitorowanie → Monitorowanie błędów, dostępu, kolejek i dysku
- Monitorowanie błędów, dostępu, kolejek i dysku → Zachowanie niezależnych punktów kontrolnych
- Zachowanie niezależnych punktów kontrolnych → Eksportowanie i weryfikacja materiałów
Uprawnienia, łączność sieciowa, dostęp do grupy oraz kompletność dostarczenia to odrębne właściwości. Zielony status połączenia nie oznacza, że wszystkie zdarzenia zostały zarejestrowane.
Udostępnianie wyników pracy bez ujawniania klucza głównego#
Otwórz Więcej narzędzi → Dostęp, aby przyznać recenzentowi lub analitykowi własny token. Wybierz konta i czaty, które mogą otwierać, a następnie zezwól na przeglądanie, eksport lub działania operacyjne. Operator, który uruchamia/zatrzymuje gromadzenie danych, potrzebuje dostępu do całego obszaru roboczego; recenzent może mieć dostęp ograniczony do jednego czatu. Limity sesji, wygaśnięcie i reguły dotyczące adresów IP są niezależne od autoryzacji konta Telegram. Zobacz dostęp i uprawnienia.
Proszę skorzystać z opcji „Otwarte sesje”, aby zakończyć połączenie, lub cofnąć dostęp, co spowoduje zakończenie wszystkich sesji. Konsola administratora łączy informacje o bieżącej aktywności procesów we wszystkich obszarach roboczych. Zamknięcie sesji nie powoduje zatrzymania gromadzenia danych.
Tryby działania#
| Tryb | Działanie | Zachowanie |
|---|---|---|
| Wersja demonstracyjna | scripts\Demo.cmd lub --demo |
Dane syntetyczne; połączenia z prawdziwymi kontami wyłączone |
| Uwaga | Rozpocznij obserwację | Rejestruj dostarczone aktualizacje dla wybranych źródeł |
| Migawka historyczna | Czat → Działania na czacie → Załaduj historię | Do 500 aktualnych wiadomości; brak odtwarzania wszystkich przeszłych zmian |
| Pauza | Wstrzymanie obserwacji | Zatrzymanie gromadzenia danych przy jednoczesnym zachowaniu danych i zadań oczekujących w kolejce |
| Przegląd/przekazanie | Eksport | Pliki ZIP, JSONL/CSV/HTML, punkty kontrolne, potwierdzenia przetworzenia oraz żądania dotyczące znaczników czasu |
| Wiele kont | Obszary robocze lub górny przycisk „+” | Dowolna liczba oddzielnych obszarów roboczych w ramach jednego procesu |
Dostęp do lokalnej wersji demonstracyjnej otwiera się automatycznie bez konieczności ręcznego wprowadzania tokenu. Wykorzystuje on uprawnienie ograniczone do czasu trwania procesu, ważne wyłącznie w przypadku bezpośredniego dostępu typu loopback do izolowanej syntetycznej wersji demonstracyjnej; token panelu głównego nie jest ujawniany. Prawdziwe środowiska robocze oraz zdalny lub pośredni dostęp do wersji demonstracyjnej wymagają uwierzytelnienia za pomocą tokenu. Dostęp do wersji demonstracyjnej nie zapewnia uprawnień w aplikacji Telegram.
Kategorie monitorowania#

W sekcji Więcej narzędzi → Źródła → Rejestrowanie → Wybierz zmiany do zachowania wybierz osobno nowe wiadomości, edycje, powiadomienia o usunięciu, aktualizacje reakcji i zdarzenia członkostwa. Ustawienie domyślne zachowuje wszystkie kategorie. Opcja Wiadomości, edycje i usunięcia zachowuje oryginalny kontekst, wyłączając jednocześnie osobne aktualizacje reakcji i członkostwa. Opcja Wszystkie widoczne działania przywraca wszystkie pięć kategorii. Ustawienia wstępne zmieniają formę; naciśnij Zapisz ustawienia rejestrowania, aby zastosować zmiany.
Zapisana polityka ma zastosowanie do wszystkich wybranych źródeł w danym obszarze roboczym. Pozostałe obszary robocze zachowują własne ustawienia. Każda faktyczna zmiana jest rejestrowana wraz z podpisanymi wartościami „przed” i „po” ; aktualna polityka jest również uwzględniana w potwierdzeniach procesów oraz rekordach rozpoczęcia obserwacji. Wyłączenie kategorii nie powoduje usunięcia wcześniejszych obserwacji. Ponowne włączenie nie pozwala na odzyskanie pominiętych zmian. W tej wersji nie ma możliwości nadpisania kategorii na poziomie poszczególnych grup.
Należy pozostawić włączoną opcję rejestrowania nowych wiadomości, gdy istotna jest wcześniejsza treść: powiadomienie o usunięciu nie pozwala na odzyskanie tekstu, który nigdy nie został zarejestrowany. Zapisy operacyjne/dotyczące zasięgu oraz inne zdarzenia związane z obsługą grup są zawsze zachowywane. Wyraźne migawki historii są oddzielone od wyboru kategorii na żywo i mogą zawierać komunikaty serwisowe. Te opcje nie ukrywają metadanych dotyczących reakcji/członków osadzonych w obiekcie Telegramu, który został w inny sposób zarejestrowany.
W przypadku wstrzymania działania funkcji „migawka historii” załączniki mogą zostać umieszczone w kolejce. Należy rozpocząć obserwację, aby je przetworzyć. Umieszczenie w kolejce nie oznacza pobrania. Niedostępny plik oryginalny nie jest zastępowany nowszą, edytowaną wersją; wyniki są rejestrowane oddzielnie.
Funkcja „Lock” kasuje dostęp przeglądarki oraz pola tajne, ale pozostawia proces gromadzenia danych uruchomiony. Zamknięcie karty również nie powoduje zatrzymania procesu. Zatrzymanie procesu lub usługi w języku Python powoduje zatrzymanie gromadzenia danych niezależnie od stanu przeglądarki.
Dodatkową przestrzeń roboczą można usunąć dopiero po pełnym pobraniu podpisanego kontenera ZIP lub ASiC-E, obejmującego jej dziennik oraz notatki z tablicy sprawy. Samo przygotowanie archiwum nie wystarczy: zapis poza zdarzeniami konfiguracyjnymi lub notatka dodana po pobraniu sprawiają, że opcja Usuń pozostaje niedostępna.
Gdy panel odbiera sam plik, zalicza eksport dopiero po otrzymaniu każdego
bajtu, a następnie zgłasza rozmiar do POST /api/exports/{id}/received; przerwane pobieranie
nie jest uwzględniane. W przypadku selektora zapisywania w przeglądarce (dostęp do systemu plików) panel zgłasza to po
zapisaniu i zamknięciu pliku. W przypadku braku takiego okna panel przekazuje odebrany plik do sekcji
pobierania przeglądarki i nie jest w stanie stwierdzić, czy przeglądarka go zachowała, na przykład gdy okno dialogowe zapisywania zostało
anulowane; panel zgłasza wówczas, że pobieranie się rozpoczęło, a nie że plik został zapisany. Plik
pobierany samodzielnie przez przeglądarkę (eksport większy niż bufor przeglądarki panelu) oraz
pobieranie przez innego klienta HTTP są liczone dopiero po wysłaniu przez serwer całej odpowiedzi.
System operacyjny i odwrotny serwer proxy buforują kilka megabajtów odpowiedzi, więc w przypadku tych
pobrań serwer nie jest w stanie wykryć przerwy pod koniec procesu. O ile panel nie poinformował, że plik został zapisany,
przed usunięciem należy sprawdzić pobrany plik. Eksport grupowy jest zaliczany na poczet kont, gdy zostanie
pobrano bezpośrednio po przygotowaniu; ponowne pobranie go z sekcji Przygotowane eksporty nie jest uwzględniane.
Przed usunięciem panel wyświetla format, rozmiar, czas przygotowania oraz wartość SHA-256 ostatnio pobranego
podpisanego archiwum i prosi o potwierdzenie, że archiwum to jest zapisane poza obszarem roboczym. Serwer odrzuca polecenie `
DELETE /api/profiles/{id}`, jeśli parametr `kept_copy` nie jest ustawiony na ten identyfikator SHA-256 (lub na wartość `confirmed` w przypadku archiwum
pobranego przed zarejestrowaniem odcisku).
Usunięcie dodatkowego obszaru roboczego zatrzymuje działanie jego modułu zbierającego dane i usuwa dane lokalne. Jeśli
zablokowany plik lub błąd systemu plików przerwie proces usuwania, panel zgłasza niepowodzenie i
utrzymuje obszar roboczy na liście jako niedostępny (DeletionPending). Proszę zamknąć programy korzystające z jego
plików i ponowić próbę usunięcia. Ponowne uruchomienie TgWitness pozostawia ten obszar roboczy w stanie zatrzymanym i
nie odtwarza częściowo usuniętego dziennika ani kluczy. Pomyślne usunięcie zostaje zarejestrowane
dopiero po usunięciu katalogu; oddzielnie wyeksportowane lub zarchiwizowane kopie pozostają
podlegające własnym zasadom przechowywania danych.
Powiadomienia#
Otwórz Ustawienia → Powiadomienia i kopia poza serwisem → Miejsca docelowe powiadomień lub Więcej narzędzi → Dodatki → Powiadomienia → Konfiguruj. TgWitness wykorzystuje Apprise do wysyłania alertów do Matrix, Telegram, Discord, Slack, ntfy, poczty e-mail i innych obsługiwanych usług. Do jednego obszaru roboczego można dodać kilka miejsc docelowych.
- W każdym wierszu proszę podać jeden adres docelowy Apprise. Proszę skorzystać z katalogu usług i formatów adresów URL odpowiednich dla Państwa usługi.
- Proszę włączyć opcję „Wysyłaj powiadomienia”, a następnie wybrać alerty o problemach, zmiany w obserwowanych czatach oraz codzienne podsumowanie. Godzina podsumowania jest podawana według czasu serwera.
- Proszę włączyć opcję „Dołącz krótkie fragmenty”, jeśli chcą Państwo, aby w powiadomieniach pojawiał się zapisany tekst z usuniętych i edytowanych wiadomości.
- Proszę kliknąć „Zapisz powiadomienia”, a następnie „Wyślij test”, aby sprawdzić, czy wiadomość została dostarczona.
Aby skonfigurować własny odbiornik, proszę skorzystać z webhooka JSON firmy Apprise.
Na przykład jsons://notify.example.org/tgwitness wysyła dane JSON przez protokół HTTPS do tego
punktu końcowego. Jest to przykład fikcyjny; proszę zastąpić go własnym adresem docelowym.
Miejsca docelowe i ustawienia należą do wybranego obszaru roboczego. Powiadomienia o zmianach obejmują obserwowane źródła, w tym nowo dodane czaty. Dzwonek na górnym pasku wyświetla również ostatnie problemy i zmiany w czatach.
W wersji demonstracyjnej elementy sterujące powiadomieniami są widoczne, ale wysyłanie jest wyłączone. Skonfiguruj dostarczanie w rzeczywistym środowisku roboczym. Powiadomienia wykorzystują trasę Direct, SOCKS5 lub HTTP tego środowiska roboczego; MTProxy nie może ich przesyłać. Miejsca docelowe inne niż HTTP, takie jak SMTP, wymagają trasy bezpośredniej.
Układ panelu#

Dziennik zawiera obserwacje, funkcje wyszukiwania i filtry. Edycja powoduje wyświetlenie zarejestrowanych wersji; usunięcie powoduje wyświetlenie poprzedniej treści, o ile jest ona dostępna. Nieznane źródła są wyraźnie zaznaczone. Liczby są dostępne w sekcji „Przegląd”; szczegóły dotyczące pozyskiwania danych znajdują się w lokalnym przewodniku.
Otwórz edytowaną wiadomość, aby porównać jej wersje w widoku Zmiany w tekście lub Obok siebie; widok Dane surowe pokazuje zapisane pola. Zmiany w ukrytych linkach i przyciskach botów są wyświetlane osobno. Otwórz podgląd załącznika, aby sprawdzić zapisane obrazy, pliki audio lub wideo; przycisk pobierania zapewnia stały dostęp do zachowanego oryginału.
Tryb Live aktualizuje dziennik i czaty w miarę napływania rekordów. Wstrzymaj go podczas przeglądania lub użyj przycisku nowych zdarzeń, gdy będziesz gotowy; gromadzenie danych działa nadal w tle. Skrót Ctrl/Cmd+K wyszukuje akcje panelu i przeszukuje dziennik.
Więcej narzędzi → Sekcja Źródła zawiera zakres obserwacji (wybrane czaty, folder w Telegramie lub całe konto), dostępne czaty każdego typu, wybrane źródła oznaczone gwiazdkami priorytetowymi, ustawienia załączników i ponownej weryfikacji oraz migawki historii. Źródła prywatne wybiera się na podstawie okna dialogowego/identyfikatora bez publicznego linku. Status dostępu opisuje ostatnią weryfikację, a nie stałe uprawnienia.
Filtruj źródła, zaznacz ich pola wyboru, a następnie wspólnie je włącz, wstrzymaj lub oznacz jako priorytetowe. Na liście dostępnych czatów opcja Dodaj wybrane wykorzystuje bieżące zaznaczenie, natomiast Dodaj wszystkie wyniki korzysta z aktualnego wyszukiwania i filtra typu.
W sekcji „Czat” → „Osoby” wyświetlana jest lista wszystkich osób, których wiadomości zostały zapisane; jeśli w danym czacie włączono wyświetlanie profili użytkowników, kliknięcie otwiera profil danej osoby wraz z linkami do wpisów w dzienniku.
Więcej narzędzi → Dodatki → Niezależny świadek tworzy tokeny świadka tylko do odczytu, pokazuje, kiedy każdy świadek ostatnio przeprowadził kontrolę oraz udostępnia polecenia i opcje potrzebne do uruchomienia jednego z nich (niezależnego świadka).
Więcej narzędzi → Sekcja Parametry zawiera wszystkie limity i tempo działania obszaru roboczego, które nie znajdują się na innej stronie:
liczbę odczytanych okien dialogowych, częstotliwość ponownego odczytu listy czatów, interwały sygnałów kontrolnych i punktów kontrolnych
, bufor startowy, sposób rozkładania żądań podczas ponownych sprawdzeń (pierwsze opóźnienie, liczba czatów na
przejścia, przerwa między czatami, odzyskane i ponownie żądane wiadomości), rezerwa dyskowa, limity czasu i
ponowne próby pobierania, kryteria wyszukiwania profili użytkowników (w tym własne wyrażenia regularne),
rozmiar i częstotliwość powiadomień, limity migawek, plików ZIP i pobierania w przeglądarce oraz limity czasu i
ponowne próby klienta Telegram. Każde pole pokazuje swój zakres i wartość domyślną; zmienione pola są
oznaczone i można je przywrócić pojedynczo lub wszystkie naraz. Każda zmiana jest rejestrowana jako
parameters.changed wraz z wartościami przed i po zmianie, a zapisy rozpoczęcia obserwacji podają
aktualnie obowiązujące wartości. Wartości obowiązują od następnego użycia; limity czasu i ponowne próby klienta – od
następnego połączenia. Odstępy między ponownymi sprawdzaniami, typy i rozmiary załączników, dowody oraz odstępy między tworzeniem kopii poza serwisem
pozostają na osobnych stronach i mogą przyjmować dowolną wartość z danego zakresu, a nie tylko wartości domyślne.
Dzwonek na górnym pasku wyświetla listę najnowszych problemów i zmian w obserwowanych czatach; wiadomości nieprzeczytane są zliczane do momentu oznaczenia ich jako przeczytane. Zmiany są pogrupowane według czatów i godzin („12 usuniętych, 1 edytowana, 0 nieznalezionych”), a problemy, takie jak wylogowanie lub zapełnienie dysku, pozostają na liście niezależnie od tego, jak intensywna jest aktywność na czatach.
Więcej narzędzi → Rejestracja konta rozpoczyna się od pola numeru telefonu. Kontynuacja prowadzi bezpośrednio do wprowadzania kodu, a o dane uwierzytelniające API pyta się tylko wtedy, gdy ich brakuje. Kod QR i import plików to alternatywne zakładki. Zapisane dane uwierzytelniające API są ponownie wykorzystywane wyłącznie w ramach własnego obszaru roboczego. Ekran wprowadzania danych nie zawiera paska bocznego, statystyk ani sekcji konfiguracyjnych. Ikona „Ustawienia ” otwiera opcje kontroli API, proxy, pamięci masowej oraz dodatkowych kont. Nowy obszar roboczy otwiera ekran pierwszej konfiguracji ; po zalogowaniu obszar roboczy z zapisanymi źródłami i zapisami otwiera sekcję „Czat ”. Zmiana ścieżki wymaga wstrzymania obserwacji i anuluje niedokończone logowanie. Istniejącego dziennika nie można w sposób automatyczny przypisać do innego konta Telegram.
Eksport sprawdza integralność dziennika i generuje pliki przenośne. Identyfikator obszaru roboczego można przekazać do interfejsu CLI pobierania. Każdy eksport przypisuje pełny prefiks dziennika; późniejsze zdarzenia trafiają do kolejnego eksportu. Filtry wyszukiwania nie zmieniają zakresu pakietu. Szczegółowe informacje dotyczące podpisywania i zakresu znajdują się w sekcji Weryfikacja i dowody.
Panel w sekcji „Stan kolektora” przedstawia stan kolektora, pliki multimedialne w kolejce lub z niepowodzeniem, najstarsze pliki multimedialne oczekujące, wolne miejsce na dysku, wstrzymania żądań oraz źródła, do których dostęp nie został potwierdzony w sekcji „Stan kolektora”. Szczegóły te są początkowo zwinięte i ukryte w sekcji „Konto”. Karta konfiguracji przedstawia kolejny krok: podłączenie konta, wybór źródeł lub rozpoczęcie monitorowania. Lista kont stanowi migawkę z momentu ładowania; wybrany obszar roboczy jest okresowo odświeżany. Nie jest to wieloprocesowy monitor SLA.
Interfejs korzysta z lokalnych zasobów i renderowania tekstu dla treści źródłowych. Przetestowano układy desktopowe i wąskie w Chromium.
Środowiska wdrożeniowe#
| Środowisko | Instalacja | Status weryfikacji |
|---|---|---|
| Komputery PC z systemem Windows / serwery | Python 3.11+, skrypty w katalogu Setup.cmd/Start.cmd, prywatny katalog danych | Sprawdzono lokalnie w systemie Windows z wykorzystaniem języka Python 3.12 |
| Serwer Linux/VPS | Środowisko venv w języku Python, dedykowany serwer, protokoły HTTPS/SSH | Podano przykładowy kod, CI oraz systemd; nie są one uruchamiane na tym serwerze |
| macOS | Środowisko venv w języku Python, proces działający w tle lub agent użytkownika | Podano przykładowy plik launchd; konieczna jest oddzielna weryfikacja instalacji |
| Docker/Compose | Stała wydajność, jeden pracownik | Zawiera definicję oraz funkcję sprawdzania środowiska uruchomieniowego CI; Docker niedostępny lokalnie |
| Przeglądarka w telefonie | Proszę połączyć się z chronionym panelem na uruchomionym serwerze | Przetestowano wąski układ oparty na silniku Chromium; narzędzie do gromadzenia danych nie działa na systemach iOS ani Android |
Przenośność oznacza brak konieczności korzystania z usługi w chmurze ani tworzenia interfejsu użytkownika. Każdy komputer docelowy nadal wymaga kompatybilnych zależności języka Python i bibliotek kryptograficznych, a także dostępu do dysku lokalnego i sieci. Proszę zapoznać się z plikiem DEPLOYMENT.md oraz szablonami usług.
Środowiska robocze współdzielą procesor, pamięć oraz pętlę zdarzeń. W celu izolacji procesów należy stosować odrębne instancje, porty, katalogi danych oraz uprawnienia do kont. Nie istnieje ujednolicony panel obejmujący oddzielne instancje. Nigdy nie należy kierować kilku procesów roboczych do jednej bazy danych.
Sprawdzanie i eksportowanie danych#
Przed uruchomieniem przygotowanego środowiska należy wykonać polecenie python start.py --check. Należy dodać opcję --json
w celu przeprowadzenia kontroli w formacie nadającym się do odczytu maszynowego lub podać zamierzone wartości parametrów --data-dir, --host oraz --port.
Polecenie sprawdza warunki wstępne bez logowania się do Telegrama ani tworzenia dziennika.
Weryfikacja dziennika odbywa się podczas uruchamiania aplikacji, a gotowość do przechwytywania jest wyświetlana
w panelu. Zajęty port może po prostu oznaczać istniejącą instancję.
Przeglądarki obsługujące interfejs API dostępu do systemu plików zapisują eksportowane dane za pośrednictwem strumienia z prawem zapisu. Inne przeglądarki buforują maksymalnie 128 MiB. W przypadku większych eksportów lub przeglądarek nieobsługujących strumieniowania plików należy skorzystać z interfejsu CLI do strumieniowania:
python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip
Proszę dodać --profile ID
z sekcji „Exports” dla podprzestrzeni roboczej. W celu uzyskania zdalnego dostępu należy użyć --url https://server
. Zwykły protokół HTTP jest akceptowany wyłącznie w przypadku adresów docelowych typu loopback. Token
jest odczytywany z pliku i wysyłany w nagłówku; nie jest wyświetlany ani umieszczany w adresie URL. Przekierowania są
odrzucane. Istniejące adresy docelowe nie są nadpisywane. W przypadku nieudanych transferów usuwany jest
tymczasowy plik częściowy. Zgłoszony kod SHA-256 stanowi sumę kontrolną transferu; prosimy o oddzielną weryfikację podpisanego
pliku ZIP za pomocą zaufanego odcisku palca/punktu kontrolnego.
Tworzenie kopii zapasowych, przywracanie danych i przerwy w działaniu#
- Wstrzymaj obserwację i zakończ proces w sposób uporządkowany.
- Skopiuj cały katalog danych: bazy danych, pliki WAL/SHM (jeśli występują), pliki multimedialne,
credentials.enc,signing.enc,network.enc, klucze sejfu/metadane, token, punkty kontrolne oraz każdy katalogprofiles/. - W trybie klucza zewnętrznego należy oddzielnie przechowywać klucz główny oraz zachować każdy klucz
vault.external.json. Wygenerowanie nowego klucza nie pozwala na odzyskanie starych tajnych danych. - Proszę przywrócić dane, gdy miejsce docelowe jest zatrzymane; skonfigurować oryginalny klucz, ograniczyć dostęp oraz zweryfikować integralność przed wznowieniem.
- Należy rejestrować przestoje i wyniki weryfikacji. Przestój pozostaje zarejestrowaną luką; migawka historii dodaje stan następujący po nim.
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.
Four things are protected differently:
| Co | Ochrona |
|---|---|
| Eksportowanie plików bez hasła (ustawienie domyślne) | Podpisany, więc zmiany są wykrywalne; ustaw hasło, aby zaszyfrować eksport |
| Eksport plików z hasłem | W przypadku ustawienia hasła gotowy plik eksportu zostanie zapisany bez zmian w formacie ZIP z szyfrowaniem AES-256 za pomocą programu WinZip, który można otworzyć za pomocą programów 7-Zip i WinRAR; hasło nie jest zapisywane (zgodnie z zasadami postępowania z materiałami dowodowymi) |
| Baza danych dziennika oraz załączniki zapisane na dysku | Zaszyfrowany dysk lub wolumin i uprawnienia folderu |
| Sesje w Telegramie i klucze podpisujące | Zaszyfrowane w katalogu danych (credentials.enc, signing.enc, network.enc) |
Pełna kopia zapasowa to opisany powyżej katalog danych zatrzymanych, a nie eksport.
W obu przypadkach należy stosować zabezpieczoną pamięć masową oraz przemyślany mechanizm transferu. Tymczasowe eksporty serwerowe są przechowywane w katalogu
temporary-exports/ każdego obszaru roboczego; zakończone odpowiedzi są usuwane, a pliki przerwanych eksportów
są usuwane przy następnym uruchomieniu, podczas gdy instancja tego obszaru roboczego pozostaje zablokowana.
Po zdarzeniu przywrócenia połączenia kolektor żąda brakujących aktualizacji od zapisanej pozycji aktualizacji. Trwałe zadania multimedialne oraz pozycja aktualizacji Telegramu pozostają zachowane po ponownym uruchomieniu; zobacz format dowodów.
Pojemność i okres przechowywania#
Domyślne limity, które można zmienić w sekcji Więcej narzędzi → Parametry: pierwsze 1,000 okien dialogowych, 500 komunikatów
na migawkę, 4 GiB nieskompresowanej, podpisanej zawartości ZIP (większe archiwa wymagają
verify.py --max-gib N) oraz 128 MiB rezerwy dla przeglądarki. Załączniki zajmują 1–2,000 MiB na
typ w sekcji Więcej narzędzi → Źródła → Rejestracja → Załączniki. Domyślna wartość CLI pobierania to 5 GiB przesłanych danych. Dostępna przestrzeń dyskowa może stanowić
dolną granicę. Zarezerwuj miejsce na dzienniki, multimedia, WAL, tymczasowe eksporty i kopie zapasowe.
Eksporty wykorzystują wolumin danych zamiast katalogu 512 MiB /tmp w Compose.
Należy mierzyć liczbę zdarzeń na sekundę, wiek kolejki, liczbę bajtów multimediów oraz opóźnienie dysku, zamiast liczyć wyłącznie grupy. Dostarczanie na żywo jest mierzone na działającym kolektorze. Nie ma automatycznego usuwania danych po upływie okresu przechowywania. Usunięcie końca dziennika unieważnia jego powiązanie z zachowanymi punktami kontrolnymi.
Priorytetowe ponowne sprawdzenia już istnieją: źródła oznaczone gwiazdką są domyślnie sprawdzane ponownie co 15 minut, pozostałe co 6 godzin (zob. poziomy ponownego sprawdzania). Eksporty chronione hasłem działają zgodnie z opisem powyżej. Ograniczony dostęp opisano w dokumencie dostęp i uprawnienia. Zob. READINESS.md, LIVE_ACCEPTANCE.md i VERIFICATION.md.