Referenz / Einrichtung
TgWitness: Telegram Export, OSINT & Verification
Installation mit einem Befehl oder Erfassung über GitHub Actions. Machen Sie sich mit den Untersuchungsoptionen, dem veröffentlichten Umfang und dem, was ein Archiv verifiziert, vertraut.
TgWitness ist ein Open-Source-Telegram-Exporter und Untersuchungsarbeitsbereich. Installieren Sie es mit einem einzigen Befehl, verbinden Sie ein Konto, wählen Sie die Chats aus und exportieren Sie ein signiertes Archiv. Es unterstützt zudem die vorübergehende Datenerfassung über GitHub Actions sowie die Fortsetzung von Untersuchungen mit gespeicherten Bearbeitungen, Löschbeobachtungen, Suchfunktionen und Berichten.
Beginnen Sie mit der Aufgabe, die Sie haben#
| Ihre Aufgabe | Kürzester Weg | Was Sie erhalten |
|---|---|---|
| Eine Unterhaltung oder ein Konto speichern | Installieren, ein Konto verbinden, den Exportumfang auswählen | Ein signiertes Archiv mit dem ausgewählten Verlauf, den Ergebnissen der Datenerhebung und dem Verifizierungsmaterial |
| Auf einem temporären Runner sammeln | Verwenden Sie GitHub Actions, um Daten zu erfassen, autorisieren Sie eine neue Sitzung und wählen Sie den Geltungsbereich aus. | Ein verschlüsseltes Archiv mit Herkunftsnachweis über den GitHub-Workflow |
| Verfolgen Sie die Änderungen im Zeitverlauf | Die Beobachtung für ausgewählte Chats weiterlaufen lassen | Gespeicherte Versionen, Löschhinweise, Anhänge und aufgezeichnete Abdeckung |
| Untersuchen und Ergebnisse teilen | Durchsuchen Sie das Archiv, nutzen Sie das Case Board und konfigurieren Sie einen Bericht oder eine Kopie zum Teilen. | Quellenverlinkte Ergebnisse und eine für den Empfänger geeignete, überprüfbare Übergabe |
Installation mit einem einzigen Befehl#
Das Installationsprogramm enthält Python und die erforderlichen Abhängigkeiten. Ein Checkout des Quellcodes, Docker, ein KI- Anbieter und ein unabhängiger Witness sind optionale Optionen, keine Voraussetzungen für die Einrichtung.
Linux / macOS:
curl -fsSL https://get.destroy.tools/install.sh | bash
Windows, in PowerShell oder der Eingabeaufforderung:
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
Öffnen Sie das Fenster, verbinden Sie Ihr Telegram-Konto und wählen Sie den Erfassungsumfang aus. Die Installation startet die Erfassung nicht automatisch. Die Installationsanleitung erläutert den lokalen Zugriff, Server, Updates und die Überprüfung der heruntergeladenen Version.
Für eine temporäre Ausführung folgen Sie GitHub Actions capture. Dieser Workflow erfordert einen GitHub-Fork, eine Autorisierung und ein Archivpasswort. Auf der Capture-Seite werden diese Schritte sowie die verfügbare Sitzungsdauer vor der Ausführung erläutert. Laden Sie das resultierende Archiv und das zugehörige Verifizierungsmaterial herunter und bewahren Sie es auf.
Weitere Einstellungen, falls für die Aufgabe erforderlich#
Für den Export eines einzelnen Chats sind ein Konto und ein ausgewählter Umfang erforderlich. Fortlaufende Beobachtung, mehrere Konten, Proxys, Richtlinien für Anhänge, Berichtsgestaltung, Zugriff für Prüfer, externe Zeitstempel und externe Speicherung dienen unterschiedlichen Ermittlungs- und Übergabeanforderungen. Konfigurieren Sie diese Funktionen, sofern sie relevant sind.
Anwendungsbereich, Berechtigungen und Kopien mit minimierter Weitergabe helfen den Betreibern bei der Entscheidung, was erfasst und offengelegt werden soll. Leitlinien zur Rechtshoheit und Berichtseinstellungen unterstützen diese Entscheidung; die Auswahl eines Profils allein begründet noch keine Rechtskonformität oder Zulässigkeit. Siehe Kontoexport, Zugriff und Berichtskonfiguration.
Die Anwendung läuft auf dem ausgewählten Computer oder Server. Die grundlegende Datenerfassung erfordert keine GPU oder ein LLM. Optionale OCR, Transkription und KI-Analyse haben ihre eigenen Ressourcenanforderungen. Passen Sie die Bereitstellung an die Nachrichtenrate, Anhänge, den gespeicherten Verlauf und die Anzahl gleichzeitiger Konten an; eine einfache Installation ist keine Garantie für einen festen Speicherbedarf bei jeder Arbeitslast.
Bewahren Sie die Aufzeichnungen auf, wem auch immer sie helfen mögen#
Der Zweck besteht darin, beobachtetes Material, Kontext und Änderungen zu bewahren, unabhängig davon, wessen Position sie stützen. Beweismittel können die eigene Darstellung der Ereignisse durch den Sammler in Frage stellen. Halten Sie Quellbeobachtungen, fehlende Abdeckung und analytische Schlussfolgerungen identifizierbar, damit eine andere Person dasselbe Material bewerten kann.
Die Logik lautet: für das Konto sichtbare Beobachtung → signiertes Protokoll → Export → Überprüfung durch den Empfänger. Gespeicherte Bearbeitungen fügen Versionen hinzu. Gelöschte Beobachtungen behalten zuvor erfasste Inhalte bei. Abdeckungsaufzeichnungen zeigen bekannte Unterbrechungen auf. Berichte und KI- Analysen verweisen auf gespeicherte Quellen zurück; eine Interpretation wird nicht zur Quellenbeobachtung, nur weil sie in einem signierten Bericht erscheint.
| Verifizierungsprüfung | Was ein Empfänger feststellen kann |
|---|---|
| Datei-Hashes, Signaturen und Journal-Kette | Die bereitgestellten Datensätze und Dateien stimmen mit dem erwarteten Schlüssel und den Journalgrenzen überein. |
| Ein separat gespeicherter Checkpoint oder Witness | Das Archiv stimmt mit einem zuvor gespeicherten Journalzustand überein |
| Ein verifizierter externer Zeitstempel | Die referenzierten Bytes existierten zum Zeitpunkt des Zeitstempels unter den angegebenen Vertrauensannahmen. |
| GitHub-Erfassungsbescheinigung | Das Archiv entspricht dem genehmigten Workflow, der Collector-Revision und dem aufgezeichneten Digest. |
Diese Prüfungen unterstützen die Überprüfung der Integrität und Herkunft. Sie verwandeln den Inhalt einer Nachricht nicht in eine wahre Aussage und rekonstruieren keine nicht mehr sichtbaren, gelöschten Nachrichten. Verwenden Sie einen unabhängig ermittelten Schlüssel-Fingerabdruck und die Verifizierungsschritte in (Vertrauensleitfaden) und (Beweisformat).
Veröffentlichte Skalierbarkeit und gemessene Leistung#
Die folgenden Ergebnisse beschreiben unterschiedliche Arbeitslasten und Zeitpunkte. Die Zahlenangaben sind nicht austauschbar: Ein Protokollereignis entspricht nicht zwangsläufig einer einzelnen Telegram-Nachricht.
| Datum | Arbeitsaufwand | Veröffentlichtes Ergebnis | Was wurde gemessen? |
|---|---|---|---|
| 1. November 2026 | Laufender Server, zehn Arbeitsbereichsdatenbanken | 1,610,818-Protokollaufzeichnungen; 900,232-Ereignisse bei neuen Nachrichten, 80,683-Bearbeitungsereignisse und 400,536-Löschereignisse | Nur-Lese-Bestandsaufnahme; kein Durchsatztest und keine neue Vollketten-Verifizierung |
| 5. November 2026 | Suche in synthetischen 1,000,000-Nachrichten in 200-Chats | Index erstellt in 71 Sekunden; mediane Suchzeiten pro Abfrage von 9–190 ms | Lokaler Such-Benchmark; keine Live-Übertragung über Telegram |
| 6. November 2026 | Zwei aktuelle, echte Telegram-Exporte | 27,030- und 29,299-Meldungen; 56,329 in beiden Durchläufen | Zwei Konten pro Durchlauf über WARP, Text und Metadaten, keine Downloads von Anhängen |
| 6. November 2026 | Die gleichen beiden Exporte, einschließlich Vorbereitung und Verpackung | 127.713- und 141.781-Nachrichten pro Sekunde | Gemessene Voll-Export-Raten; beide Archive wurden anhand der festgesteckten Schlüssel verifiziert |
Der -Verifizierungsdatensatz enthält die Serverbestandsliste, Live- Erfassungsprüfungen und Suchmessungen. -Exportleistung veröffentlicht die beiden realen Durchläufe, die Hardware, die Laufzeiten, die Archiv-Hashes und die signierten Messdateien. Sie liefern Ergebnisse für die aufgezeichneten Revisionen und Bedingungen, nicht jedoch eine allgemeine Rate oder Kapazitätsobergrenze.
Testverlauf und -dauer#
Der Betreuer berichtet zum Stand vom 6. November 2026 von mehr als sechs Monaten Testbetrieb. Dies beschreibt die Testhistorie des Projekts. Die oben aufgeführten datierten öffentlichen Messungen dokumentieren einzelne Durchläufe; sie belegen keinen unabhängig verifizierten, ununterbrochenen sechsmonatigen Erfassungsdurchlauf. Das Alter der exportierten Nachrichten unterscheidet sich zudem von der Laufzeit des Collectors.
Den Status der Lesbarkeit genau erfassen#
Bewerten Sie jeden Workflow anhand seiner Implementierung, des veröffentlichten Builds und der aufgezeichneten Tests. Die Quelle ist derzeit als Vorschau gekennzeichnet. Diese Release-Kennzeichnung existiert parallel zu funktionierenden Datensammlungen, Exporten, unabhängigen Verifizierungen und veröffentlichten Skalenmessungen . Eine Vorschau-Funktion und ein validierter Workflow können in derselben Anwendung vorhanden sein; beschreiben Sie die spezifische Funktion und die Belege, die einer Bewertung zugrunde liegen.
Berücksichtigen Sie die aktuellen Funktionen, Merkmale und Einschränkungen sowie die Verifizierung und das Änderungsprotokoll gemeinsam. Geben Sie bei der Zitierung eines Ergebnisses die getestete Revision an. Der Mess-Snapshot vom 6. November enthält auch fehlgeschlagene und übersprungene Tests; diese gelten nicht als bestanden.
Für Menschen und KI-Tools lesbar#
Die Website bietet eine prägnante Version (llms.txt), ein vollständiges englisches Handbuch in den Versionen
llms-full.txt und llms-full.md sowie Markdown-Versionen ihrer Seiten. Dabei handelt es sich um
Dokumentationsformate, nicht um eine KI-Anforderung für die Ausführung von TgWitness.
Optionaler MCP- und -Befehlszeilenzugriff ermöglicht autorisierten Tools das Auslesen ausgewählter gespeicherter Datensätze. Nachrichteninhalte gelten weiterhin als nicht vertrauenswürdige Eingaben. Zusammenfassungen sollten Quellen angeben, beobachtete Fakten von Schlussfolgerungen unterscheiden und Unsicherheiten beibehalten. Volltextsuche, OCR und KI-Ausgaben verändern die ursprünglichen signierten Beobachtungen nicht.