TgWitness / Dokumentation

Was wurde getestet? →

Referenz / Einrichtung

Telegram · Schnellstart

Alle Möglichkeiten zur Installation und zum Start von TgWitness: Windows-Paket, Python, Docker und die synthetische Demo mit ersten Überprüfungen.

TgWitness / Dokumentation

Erste Schritte

Englisch · Russisch · Ukrainisch · Español · Português (Brasil) · Türkçe · العربية · Farsi · Urdu · Hindi · Bahasa Indonesia · Tiếng Việt · Vereinfachtes Chinesisch

TgWitness ist eine eigenständige Anwendung zur Überwachung von Telegram-Gruppen und -Kanälen, auf die Ihre Konten Zugriff haben. Sie läuft lokal mit einem eigenen Datenverzeichnis.

Zum ersten Mal hier? Sehen Sie sich die Demo an, bevor Sie ein Konto verbinden. Wählen Sie eine Anleitung für Proxys, Zeugen, Exporte oder die Serverkonfiguration. GitHub Actions Capture (Vorschau) führt eine Erfassung in Ihrem eigenen GitHub-Fork statt in einer lokalen Installation durch.

Installieren und starten#

Das geführte Installationsprogramm enthält eine eigene Python-Umgebung und überprüft vor der Installation die Paket-Hashes und Release-Signaturen. Durch erneutes Ausführen wird eine bestehende Installation aktualisiert.

Linux / macOS:

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

Windows (PowerShell oder Eingabeaufforderung):

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

Führen Sie das Programm auf einem Ubuntu-Server als Root aus, um einen Hintergrunddienst zu installieren; auf einem Desktop-Computer führen Sie es als Ihr normaler Benutzer aus. Unter Ubuntu gibt der Installer die Panel-Adresse und den Zugangsschlüssel aus; unter macOS und Windows öffnet sich das lokale Panel in Ihrem Browser. Fahren Sie unten unter Telegram verbinden fort. Installieren, überprüfen und aktualisieren behandelt die Optionen für den Serverzugriff, die Überprüfung des Skripts vor der Ausführung sowie Aktualisierungen und die Deinstallation.

Andere Methoden#

GitHub-Releases, der Quellcode und Docker sind Alternativen zum Installationsprogramm. Portierbare Downloads stehen nach Veröffentlichung eines Release-Builds zur Verfügung:

Host Keine Installation erforderlich Aus der Quelle: Python 3.11+ Docker: Engine/Desktop mit Compose 2.20+
Windows TgWitness-<version>-windows-amd64-portable.zip aus den GitHub-Veröffentlichungen extrahieren, auf TgWitness.cmd doppelklicken Doppelklicken Sie auf „Start.cmd“ Doppelklicken Sie auf „scripts\Docker.cmd“
Linux / macOS — sh start.sh sh scripts/docker-start.sh

Für die Quellcode-Methoden laden Sie den aktuellen main-Branch herunter und entpacken Sie ihn oder klonen Sie das Repository:

git clone https://github.com/phishdestroy/TgWitness.git
cd TgWitness

Start.cmd bietet an, Python 3.12 für Ihren Windows-Benutzer zu installieren, falls kein passendes Python gefunden wird (über winget oder das signierte Installationsprogramm von python.org). start.sh gibt den genauen Installationsbefehl für Ihre Linux-Distribution oder macOS aus, falls Python fehlt. Beim ersten Start aus dem Quellcode wird .venv erstellt und die Abhängigkeiten werden automatisch installiert.

Docker erstellt die Anwendung und startet sie im Hintergrund; ein Python-Host ist nicht erforderlich. „scripts\Docker.cmd“ und „scripts/docker-start.sh“ geben die Panel-Adresse und das Token aus, wenn der Container ordnungsgemäß läuft. Die entsprechenden Docker-Befehle auf jedem unterstützten Host lauten:

docker compose up -d --build --wait
docker compose exec tgwitness cat /data/panel-token.txt

Öffnen Sie http://127.0.0.1:8787. Verwenden Sie das vom Docker-Helper ausgegebene Token oder den zweiten Docker-Befehl, oder lesen Sie die Datei „data/live/panel-token.txt“ für eine portable oder Quellcode-Installation. Fahren Sie unten unter „Telegram verbinden“ fort. Native und Docker-Installationen verwenden getrennte Speicher; beim Starten von Docker wird ein bereits vorhandenes natives Protokoll nicht importiert.

Bei einem Server umfasst die Bereitstellung automatisches HTTPS, Neustart, veröffentlichte Bilder, Updates und Backups.

Entdecken Sie die Benutzeroberfläche#

  1. Führen Sie „TgWitness-Demo.cmd“ im portablen Paket, „scripts\Demo.cmd“ in einem Windows-Quellordner oder „sh start.sh --demo “ unter Linux/macOS aus. Beim Start aus dem Quellordner wird zunächst „.venv “ erstellt und die Abhängigkeiten werden installiert.
  2. Open-http://127.0.0.1:8787.
  3. Die lokale Demo öffnet das Beispielprotokoll automatisch. Für den direkten lokalen Zugriff ist keine Token-Kopie erforderlich.

Die Beispielnachrichten sind fiktiv. Im Demomodus kann keine Verbindung zu einem echten Telegram-Konto hergestellt werden.

Telegram verbinden#

[!WARNUNG] Verwenden Sie dedizierte Konten. Telegram kann Konten aufgrund von Anfragevolumina, die es als übermäßig erachtet, einschränken oder dauerhaft sperren, unabhängig vom Client. Verbinden Sie Konten, die für die Beobachtung vorgesehen sind, anstatt persönliche oder wertvolle Konten, und erstellen Sie eine API-ID/einen Hash auf einem dedizierten Konto.

  1. Falls die native Demo ausgeführt wird, beenden Sie diese und führen Sie „Start.cmd“ oder „sh start.sh“ aus. Andernfalls lassen Sie die oben gestartete Live-Installation weiterlaufen.
  2. Verwenden Sie das Panel-Token, um sich anzumelden. Bei der ersten Einrichtung öffnet sich ein neuer Arbeitsbereich. Wählen Sie Nur herunterladen, Chats verfolgen oder Beweismaterial für einen Fall.
  3. Überprüfen Sie die Verbindungsprüfung. Konfigurieren Sie bei Bedarf Ihren eigenen Proxy; die Verbindungseinstellungen bleiben nach der Einrichtung verfügbar.
  4. Wählen Sie bei „Connect Telegram“ eine Telefonnummer, einen QR-Code, Kontodateien (TData, .session, StringSession, Konto-JSON) oder einen vollständigen Autorisierungsschlüssel aus. Geben Sie bei Aufforderung die Telegram-Bestätigung, den Code und das Passwort für die zweistufige Authentifizierung ein.
  5. Überprüfen Sie das angezeigte Konto, wählen Sie die Chats aus und überprüfen Sie Ihre Einstellungen. Beenden Sie den Vorgang auf dem letzten Bildschirm. Bei Nur herunterladen startet Export starten einen einmaligen Export und öffnet Exporte, um den Fortschritt anzuzeigen; eine fortlaufende Beobachtung wird dadurch nicht aktiviert.

Nach der Einrichtung ändert Chats → Auswählen die ausgewählten Chats. Unter Einstellungen werden die Erfassung und Dateien gesteuert; Weitere Tools → Quellen bietet die detaillierte Quellenliste auf Standard- oder Expertenebene. Die Bedienungsanleitung beschreibt die sechs Hauptabschnitte und ihre kontextbezogenen Steuerelemente.

API-ID + Hash sind optional: Der Arbeitsbereich verwendet sein gespeichertes oder importiertes Paar oder ein funktionierendes Paar aus dem integrierten Pool. Um Ihre eigene App zu verwenden, fügen Sie ein API ID:API Hash-Paar in das Feld API-ID ein. Fügen Sie für den Auth-Schlüssel alle 512 hexadezimalen Zeichen ein und wählen Sie die bereitgestellte DC-ID aus. Die Benutzer-ID ist optional und wird bei Eingabe überprüft.

API-Zugangsdaten identifizieren Ihre Anwendung; sie autorisieren kein Konto an sich. Private Gruppen benötigen keinen öffentlichen Benutzernamen, aber Ihr Konto muss über Zugriffsrechte verfügen.

Für bestehende Konten siehe Konten und Sitzungsformate: Das Bedienfeld akzeptiert Telethon StringSession, Telethon/Pyrogram SQLite, TData ZIP für Einzelkonten sowie unterstützte Konto-JSON-Dateien. Wählen Sie eine Sitzung und die dazugehörige JSON-Datei gemeinsam aus, klicken Sie auf Dateien prüfen und anschließend auf Konto verbinden. Die QR-Anmeldung ist ebenfalls mit denselben optionalen API-Einstellungen verfügbar. TDLib, Bot-Sitzungen und CSV-/JSON- Kontobestände werden nicht unterstützt.

Verwenden Sie für mehrere Konten Konten → Konten importieren und wählen Sie deren unterstützte Sitzungsdateien aus. Zugehörige JSON-Dateien werden anhand des Basisnamens zugeordnet; jedes importierte Konto erhält seinen eigenen Arbeitsbereich. Siehe Massenimport und Kontogruppen.

Um ein weiteres Konto hinzuzufügen, klicken Sie auf das + neben der Kontoauswahl oder verwenden Sie Konten → Konto hinzufügen. Arbeitsbereiche verfügen über separate Sitzungen, Journale, Schlüssel, Quellen und Warteschlangen. Beim Wechseln der Ansicht laufen andere Collector-Instanzen weiter. Dasselbe Telegram-Konto kann in dieser Installation nicht zwei Arbeitsbereichen zugewiesen werden. Es gibt keine festgelegte Anzahl von Arbeitsbereichen; sie teilen sich einen Prozess, sodass die Kapazität von der Rechenleistung des Computers abhängt.

Das Live-Panel-Token schützt den Zugriff auf Ihre Telegram-Berechtigungen und gespeicherte Daten; es ist unabhängig von den Anmeldedaten für die Telegram-API. Nur eine explizit gestartete, direkt aufgerufene lokale Demo erhält automatisch einen Eintrag. Eine Remote- oder Proxy-Demo verwendet weiterhin „ data/demo/panel-token.txt“.

Überprüfen und exportieren#

  • Protokoll: Beobachtungen nach Quelle und Ereignistyp suchen und filtern.
  • Wählen Sie ein Ereignis aus, um dessen Originaldatensatz, Zuordnung und gespeicherte Versionen einzusehen.
  • Die Bearbeitungsdetails zeigen den verfügbaren Inhalt vor und nach der Bearbeitung an. Die Löschdetails zeigen den zuletzt erfassten Inhalt, sofern vorhanden; ein unbekannter Akteur bleibt unbekannt.
  • Exportformate: signierte ZIP-, JSONL- und CSV-Dateien sowie Offline-HTML.
  • Vollständiger Chat-Export (Chats → Chat exportieren oder Exporte → Einen Chat erfassen oder exportieren): Laden Sie den gesamten sichtbaren Verlauf eines Chats als signiertes Bundle mit chat.json (im Telegram-Export-Stil) und einer lesbaren chat.html-Datei herunter. Private Chats funktionieren, wenn das Konto Mitglied ist. Es handelt sich um eine aktuelle Momentaufnahme, nicht um eine Rekonstruktion gelöschter oder zuvor bearbeiteter Nachrichten. Überprüfen Sie eine Kopie mit python verify.py chat-export.zip --fingerprint TRUSTED_SHA256.
  • Checkpoint beachten: Die Grenze des signierten Protokolls muss außerhalb des Collectors liegen.
  • Signierten Ausführungsbeleg herunterladen: Bewahren Sie die Programm- und Versionsdaten des Erfassungsprogramms auf.
  • Zeitstempelanfrage vorbereiten: Bereiten Sie eine Offline-Anfrage an einen Zeitstempeldienst vor; befolgen Sie die Anweisungen in der Datei „TIMESTAMP.md“, um eine Antwort zu erhalten und zu überprüfen.
  • Protokoll überprüfen: Überprüfen Sie Ereignissignaturen und Kettenverknüpfungen. Beim ZIP-Export werden auch Medieninhalte überprüft.

Unterstützte Browser speichern umfangreiche Exporte direkt in einer Datei Ihrer Wahl. Andere Browser puffern maximal 128 MiB. Solange der Server läuft, unterstützt die Streaming-CLI größere Downloads, ohne die gesamte Antwort zwischenspeichern zu müssen:

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

Für einen weiteren Arbeitsbereich fügen Sie --profile ID über Exports → Workspace ID hinzu. Für einen Remote-Server fügen Sie --url https://your-server hinzu. Das Standard-Übertragungslimit beträgt 5 GiB; --max-mib ändert es. Signierte ZIP-Inhalte haben standardmäßig ein separates Verifizierungslimit von 4 GiB im unkomprimierten Zustand (über Weitere Tools → Parameter lässt sich dieses erhöhen; verifizieren Sie solche Archive mit verify.py --max-gib N). Verifizieren Sie das Archiv mithilfe einer vertrauenswürdigen Kopie des Verifizierers, eines unabhängig aufbewahrten Schlüssel-Fingerabdrucks und – als Mindestanforderung für die Nachweisfähigkeit – des Stammzertifikats des Zeitstempeldienstes (--tsa-ca).

Installationsanleitung#

python start.py --setup-only
python start.py --check
python start.py --check --json

--check überprüft lokale Abhängigkeiten, die Signaturunterstützung, den Speicher, die Schlüsselkonfiguration und die Abhöradresse. Es wird nichts installiert und keine Verbindung zu Telegram hergestellt. Ein belegter Port kann darauf hindeuten, dass eine andere Instanz läuft. Verwenden Sie ein anderes --port oder beenden Sie diese zunächst.

Der Launcher wird in „.venv“ installiert. Zusatzbefehle für „python -m tgwitness...“ müssen unter Windows „.venv\Scripts\python.exe“ oder unter Linux/macOS „.venv/bin/python“ verwenden, es sei denn, diese Umgebung ist bereits aktiviert.

Sitzungen, Schutz und Betrieb#

Eine geschlossene, konsistente Telethon-SQLite-Datei .session kann lokal mit python -m tgwitness.sessions account.session --out account.tgwitness-session konvertiert und anschließend unter Weitere Tools → Konto → Dateien geladen werden. Ein direkter Dateiimport und eine QR-Anmeldung sind ebenfalls verfügbar. Informationen zu Anmeldeformaten, SOCKS5, HTTP CONNECT, MTProxy und externen Hauptschlüsseln finden Sie in der Datei CONNECTION-SECURITY.md.

Beobachtung pausieren stoppt die Erfassung. Sperren schließt nur den Browserzugriff. Beim Schließen eines Tabs läuft der Erfassungsprozess weiter. Das Beenden des Prozesses unterbricht die Erfassung; eine Momentaufnahme des Verlaufs kann nicht alle verpassten Bearbeitungen oder Löschungen rekonstruieren. Einzelheiten zu Ereignisrichtlinien, Anhangswarteschlangen, Kontoisolierung und Neustarts finden Sie unter So funktioniert die Erfassung.

Sitzungen und Geheimnisse sind verschlüsselt. Nachrichteninhalte, Medien und Exporte erfordern eine verschlüsselte Festplatte oder ein verschlüsseltes Volume. Überprüfen Sie Journalsignaturen anhand eines vertrauenswürdigen Schlüssels und bewahren Sie Checkpoints separat auf. Überprüfen Sie Erfassungsdatensätze, externe Zeitbelege und Umgebungsbescheinigungen für den ausgewählten Erfassungsmodus.

Lesen Sie „OPERATIONS.md“ für Informationen zu Sicherung und Wiederherstellung, „DEPLOYMENT.md“ zum Thema Hosting sowie „deploy/“ für Anwendungsbeispiele. Das installierte Panel enthält zudem eine Anleitung zur Offline-Einrichtung unter „/guide.html“.

Die tatsächliche Verifizierung und die verbleibenden Einschränkungen sind in den Dateien „VERIFICATION.md“ und „READINESS.md“ dokumentiert.