Instalacja, weryfikacja i aktualizacja

TgWitness / Dokumentacja · Pierwsze kroki

Projekt · Szybki start · Wdrożenie

Na tej stronie

• Instalacja za pomocą jednego polecenia
• Gdzie wszystko działa
• Ustawienia wyszukiwania pełnotekstowego
• Dostęp z wiersza poleceń
• Zweryfikuj przed uruchomieniem
• Aktualizacja istniejącej instalacji
• Codzienne polecenia w systemie Ubuntu
• Usuń TgWitness

Zainstaluj za pomocą jednego polecenia#

Instalator z przewodnikiem zawiera prywatne środowisko uruchomieniowe języka Python. Użyj tego samego adresu do przyszłych instalacji: każda publikacja aktualizuje instalator, skróty, podpisy oraz informacje o kompilacji łącznie.

Linux / macOS (Bash):

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

Na serwerze z systemem Ubuntu uruchom program jako root, aby zainstalować usługę działającą w tle. Na komputerze stacjonarnym uruchom program jako zwykły użytkownik.

Windows (PowerShell lub wiersz poleceń):

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

W systemie Windows nie jest wymagany administrator. Proces potomny PowerShell pozostawia terminal otwarty z wynikiem. Python i zależności pozostają w instalacji.

W systemie Ubuntu wybierz opcję „Ten komputer”, „Tymczasowy link HTTPS” lub „Własna domena”. Instalator wyświetli adres panelu oraz klucz dostępu. Aby uzyskać tymczasowy link, otwórz ten adres HTTPS w przeglądarce i wprowadź klucz. W przypadku dostępu lokalnego na serwerze zdalnym użyj przekierowania SSH z komputera (ssh -L 8787:127.0.0.1:8787 user@server) i otwórz http://127.0.0.1:8787. W systemach macOS i Windows lokalny panel otwiera się w przeglądarce; należy pozostawić terminal uruchomiony.

Zaloguj się do Telegrama w panelu i wybierz, co chcesz gromadzić. Sama instalacja nie uruchamia gromadzenia danych z Telegrama.

Gdzie wszystko działa#

get.destroy.tools jest to Cloudflare Worker obsługujący statyczne pliki do pobrania. Nie zawiera panelu TgWitness, sesji Telegramu ani bazy danych dowodów dotyczących użytkowników. Nie jest przekierowywany na serwer VPS projektu. Aplikacja działa na komputerze, na którym uruchamiasz polecenie.

Ustaw TGWITNESS_INSTALL_DIR , aby wybrać inny folder. Zainstalowane wersje i dane są przechowywane oddzielnie. Instalator nie przesyła Twoich kont, wiadomości ani kluczy na stronę pobierania. Wybranie tunelu Cloudflare powoduje, że ruch panelu jest kierowany przez Cloudflare; użycie własnej domeny powoduje przekierowanie na Twój własny serwer.

With TGWITNESS_TRUSTED_PROXIES, the panel accepts a single X-Forwarded-Proto: https from a trusted proxy to set Secure download cookies.

Każda instalacja zawiera pliki START-HERE.html i START-HERE.txt z lokalnymi ścieżkami, poleceniami i linkami do repozytorium. Uruchom tgwitness guide , aby otworzyć przewodnik. W systemie Windows użyj & "$env:LOCALAPPDATA\TgWitness\bin\tgwitness.cmd" guide w PowerShellu.

Ustawienia wyszukiwania pełnotekstowego#

Wyszukiwanie pełnotekstowe (wersja podglądowa) nie wymaga konfiguracji. Jego indeks jest tworzony w tle po aktualizacji.

Wybór administratora w sekcji Dziennik → Filtry → Indeks wyszukiwania zastępuje zmienną dla danego obszaru roboczego. Polecenia wyszukują katalog danych instalacji, w której są uruchamiane; w pozostałych przypadkach należy dodać --data-dir ścieżkę z tgwitness paths. Aby uzyskać pełny słownik języka ukraińskiego (dane na licencji GPL-3.0), zainstaluj pymorphy3-dicts-uk w środowisku Python tej instalacji.

Dostęp z wiersza poleceń#

Wiersz poleceń (wersja podglądowa) odczytuje archiwum w poszukiwaniu skryptów i agentów.

Sprawdź przed uruchomieniem#

Jednowierszowe polecenie polega na protokole HTTPS w przypadku skryptu początkowego. Skrypt ten sprawdza element SHA-256 oraz podpis RSA projektu w aplikacji i ograniczeniach przed instalacją. Można również najpierw pobrać i zweryfikować skrypt początkowy.

Publiczny klucz wydania to release-signing.pub. Jego SHA-256 to:

039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d

Zachowaj ten odcisk palca z wersji repozytorium, której ufasz. Suma kontrolna z tego samego serwera pobierania wykrywa niezgodność; niezależnie zaufany klucz publiczny służy do uwierzytelniania podpisu wydania.

Użyj nowego, pustego katalogu na poniższe pliki do weryfikacji.

Linux / macOS — uruchom w nowym, pustym katalogu pobierania (wymagane są curl i OpenSSL):

curl -fSLO https://get.destroy.tools/install.sh &&
curl -fSLO https://get.destroy.tools/install.sh.sig &&
curl -fSLO https://get.destroy.tools/release-signing.pub &&
test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \
  '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' &&
openssl dgst -sha256 -verify release-signing.pub -signature install.sh.sig install.sh &&
bash install.sh

Łańcuch && łańcuch zatrzymuje się przed wykonaniem, jeśli pobieranie, sprawdzanie odcisku klucza lub podpisu zakończy się niepowodzeniem. Jeśli między pobraniem skryptu a jego podpisaniem nastąpiła publikacja, należy pobrać oba elementy ponownie. Stare instalatory zachowują swoje niezmienne adresy URL pakietów.

Windows — przed uruchomieniem sprawdź element SHA-256:

Invoke-WebRequest https://get.destroy.tools/install.ps1 -OutFile install.ps1 -UseBasicParsing
Get-FileHash .\install.ps1 -Algorithm SHA256
Invoke-RestMethod https://get.destroy.tools/SHA256SUMS.txt

Porównaj skrót z install.ps1 wierszem. Aby przeprowadzić niezależną weryfikację podpisu, użyj OpenSSL (na przykład z poziomu Git Bash) i tego samego odcisku klucza publicznego, co powyżej:

curl -fSLO https://get.destroy.tools/install.ps1 &&
curl -fSLO https://get.destroy.tools/install.ps1.sig &&
curl -fSLO https://get.destroy.tools/release-signing.pub &&
test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \
  '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' &&
openssl dgst -sha256 -verify release-signing.pub -signature install.ps1.sig install.ps1 &&
powershell.exe -NoProfile -ExecutionPolicy Bypass -File install.ps1

Sam system Windows weryfikuje podpisy pakietów za pomocą .NET i nie wymaga OpenSSL. Są to oddzielne podpisy RSA-3072 / SHA-256, a nie Authenticode. Manifest zawiera wersję oprogramowania, dokładny commit w Git, niezmienny identyfikator wydania oraz SHA-256 każdego artefaktu. Strona zawiera linki do odpowiednich źródeł. Manifest i lista sum kontrolnych również posiadają oddzielne podpisy (manifest.json.sig oraz SHA256SUMS.txt.sig).

Aktualizacja istniejącej instalacji#

Nowa publikacja aktualizuje stronę pobierania; zainstalowane programy aktualizują się po ponownym uruchomieniu instalatora. Nie ma funkcji automatycznej aktualizacji ani automatycznego restartu uruchomionej kolekcji. Obecny kanał instalatora to wersja zapoznawcza; opiera się on na opublikowanych, sprawdzonych kompilacjach z main, których commit może być nowszy niż ostatnia numerowana wersja na GitHubie. Wersja strony pochodzi z pyproject.toml; jej commit i identyfikator kompilacji pozwalają rozróżnić aktualizacje w ramach tej samej wersji podglądowej.

Publikacja następuje automatycznie po tym, jak dany commit przejdzie kontrolę aplikacji i bezpieczeństwa, a podpisany pakiet przejdzie testy instalacji w usługach Ubuntu oraz w środowisku Windows PowerShell. Podczas trwania kontroli lub w przypadku ich niepowodzenia te same polecenia kontynuują instalację poprzedniej, sprawdzonej kompilacji. Manifest kompilacji wskazuje, który commit jest aktualnie dostępny; sam numer wersji może pozostać niezmieniony między aktualizacjami wersji zapoznawczych.

Należy użyć tego samego folderu instalacyjnego i tego samego użytkownika systemu operacyjnego, co poprzednio. Należy wykonać kopię zapasową całego katalogu danych przy wyłączonej funkcji gromadzenia danych; tgwitness paths który go identyfikuje. Podpisany eksport nie stanowi pełnej kopii zapasowej instalacji.

Instalacja w katalogu głównym systemu Ubuntu pod adresem /opt/tgwitness:

curl -fsSL https://get.destroy.tools/install.sh | TGWITNESS_INSTALL_DIR=/opt/tgwitness bash -s -- --no-start

Po pomyślnej instalacji:

/opt/tgwitness/bin/tgwitness restart
/opt/tgwitness/bin/tgwitness status
/opt/tgwitness/bin/tgwitness open

W przypadku instalacji przez użytkownika systemu Linux/macOS należy użyć oryginalnej TGWITNESS_INSTALL_DIR lub ustawienia domyślne i ponownie uruchom pierwsze polecenie instalacyjne. Przed aktualizacją zamknij panel działający w tle, a po jej zakończeniu uruchom go ponownie. W przypadku skonfigurowanej usługi w systemie Linux uruchom polecenie tgwitness restart polecenie.

Windows: zamknij uruchomiony panel, ponownie uruchom polecenie instalacyjne dla systemu Windows, a następnie otwórz bin\tgwitness.cmd w tej samej instalacji. Instalator zachowuje dane, sesje, ustawienia dostępu i klucze podpisujące. Przełącza program uruchamiający dopiero po pozytywnym przejściu testów przez nowe środowisko; nieudana instalacja pozostawia poprzedni program uruchamiający na swoim miejscu. Zachowaj kopię zapasową sprzed aktualizacji na wypadek zmian formatu przechowywania danych.

Codzienne polecenia w systemie Ubuntu#

Zobacz sekcję „Dostęp” , aby zapoznać się z tokenami współpracowników, sesjami i ograniczeniami adresów IP, a także sekcję „Publikowanie instalatora”, aby poznać proces wydawania wersji z GitHub do Cloudflare.

Usuń TgWitness#

Nie ma programu do odinstalowania: wystarczy zatrzymać panel i usunąć jego foldery. Usunięcie folderu danych powoduje nieodwracalne zniszczenie dzienników, kluczy podpisujących, sesji Telegrama oraz zapisanych plików. Zanim to zrobisz:

1. Wyeksportuj to, czego potrzebujesz (Eksportuj → Pobierz podpisany plik ZIP) i przechowuj odcisk palca klucza podpisu oraz punkty kontrolne poza tym komputerem. Aby zachować sam obszar roboczy, skopiuj cały folder danych po zatrzymaniu gromadzenia danych.
2. Usuń serwery utworzone w sekcji „Dodatki” → „Serwer 24/7” z listy „Twoje serwery” lub za pomocą python -m tgwitness.cloud destroy; dostawca nalicza opłaty za te serwery do momentu ich usunięcia.
3. Sesję każdego konta w Telegramie należy zakończyć w sekcji Ustawienia → Urządzenia. Usunięcie plików nie powoduje wylogowania sesji po stronie Telegrama.

Instalacja w katalogu głównym systemu Ubuntu. Zwróć uwagę na folder danych, zatrzymaj usługę, a następnie usuń usługę, foldery i skrót:

/opt/tgwitness/bin/tgwitness paths
/opt/tgwitness/bin/tgwitness stop
systemctl list-unit-files 'tgwitness-*'
systemctl disable tgwitness-<ID>
rm /etc/systemd/system/tgwitness-<ID>.service
systemctl daemon-reload
rm -rf /opt/tgwitness /var/lib/tgwitness-<ID> /usr/local/bin/tgwitness

Instalacja dla użytkowników systemu Linux lub macOS. Zamknij panel. Skonfigurowana usługa użytkownika w systemie Linux zostaje zatrzymana za pomocą systemctl --user disable --now tgwitness-<ID>; jego jednostka znajduje się w ~/.config/systemd/user/. Następnie usuń plik ~/.local/share/tgwitness (lub swoją TGWITNESS_INSTALL_DIR) oraz ~/.local/bin/tgwitness skrót.

Windows. Zamknij panel i usuń %LOCALAPPDATA%\TgWitness (lub swój TGWITNESS_INSTALL_DIR). Instalator nie dodaje żadnej usługi, zaplanowanego zadania ani skrótu.