# 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)

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](https://phishdestroy.io/tgwitness/de/docs/reference/installation/) 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](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). 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.

Geltungsbereich, Berechtigungen und minimierte Freigabekopien helfen Betreibern bei der Auswahl dessen, was erfasst und offengelegt werden soll. Leitlinien zur Rechtshoheit und Berichtseinstellungen dokumentieren das ausgewählte Verfahren und die Vorbereitungsschritte. Siehe [Kontoexport](https://phishdestroy.io/tgwitness/de/docs/reference/account-export/), [Zugriff](https://phishdestroy.io/tgwitness/de/docs/reference/access/) und [Berichtskonfiguration](https://phishdestroy.io/tgwitness/de/docs/reference/case-reports/).

Die Anwendung läuft auf dem ausgewählten Computer oder Server. Die grundlegende Erfassung 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.

## 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. |
| Intel TDX-Attestierung | Das Zitat, der Plattformstatus, die erwarteten Betriebssystem-/Anwendungsmesswerte, die Aktualität und die Identität des Collectors bestehen ihre konfigurierten Prüfungen. |

Bei der beglaubigten Erfassung sind die authentifizierte Telegram-Verbindung des zugelassenen Collectors und dessen Ausgabe an die geprüfte Ausführungsumgebung gebunden. Das Archiv bewahrt den erfassten Inhalt und Kontext auf; Berichte und Analysen beziehen sich auf diese Datensätze. Verwenden Sie die modusspezifischen Verifizierungsschritte und vertrauenswürdigen Eingaben aus [dem Vertrauensleitfaden](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) und [dem Beweisformat](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/).

## 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 | Schreibgeschütztes Verzeichnis der gespeicherten Journale |
| 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 | Benchmark für die lokale Suche |
| 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](https://phishdestroy.io/tgwitness/de/docs/reference/verification/) enthält die Serverbestandsliste, Live- Erfassungsprüfungen und Suchmessungen. [Die Exportleistung](https://phishdestroy.io/tgwitness/docs/validation/) veröffentlicht die beiden tatsächlichen Durchläufe, die Hardware, die Dauer, Archiv-Hashes und signierte Messdateien, jeweils mit der aufgezeichneten Revision und den Bedingungen.

Die [Public-History-Qualifikation](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-BENCHMARK-2026-11-06.md) erfasst zudem **48 verifizierte Archive mit 3,598,381 Datensätzen** aus einer Eingabeliste mit 50 Quellen und 40 Konto-Arbeitsbereichen. Die Quelle A mit acht Konten erfasste **768,007 Verlaufsdatensätze in 1,117.082 Sekunden**, einschließlich Wartezeiten: **687.512 Datensätze/Sekunde**, wobei das Herunterladen von Anhängen deaktiviert war. Der gesamte Versuch, einschließlich der Validierung, dauerte 1,574.920 Sekunden. Diese Messungen beschreiben diese Arbeitslast neben den oben genannten kleineren Fresh-Export-Beispielen.

### Testverlauf und -dauer

TgWitness wurde über einen Zeitraum von etwa sechs Monaten entwickelt und getestet. Zunächst entstanden der Collector, das signierte Protokoll und der Verifier; das Web-Panel und die Zusatzmodule wurden später darauf aufbauend entwickelt. Dieses Repository wurde am 29. Oktober 2026 neu für die Veröffentlichung angelegt und basiert auf dem bestehenden Code, sodass sein Alter nicht dem Alter des Projekts ([Entwicklungsgeschichte](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#development-history)) entspricht. Die kumulierte Testlast liegt in der Größenordnung von 100 Millionen, einschließlich früherer Durchläufe, Fehler, Korrekturen und wiederholter Validierungen. Ausgewählte Durchläufe, jeweils mit eigener Revision, Methode und Ergebnis, sind in den [datierten öffentlichen Messungen](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#dates-of-the-published-measurements) dokumentiert.

## 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](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md), [Merkmale und Einschränkungen](https://phishdestroy.io/tgwitness/de/docs/reference/features/) sowie [die Verifizierung](https://phishdestroy.io/tgwitness/de/docs/reference/verification/) und [das Änderungsprotokoll](https://phishdestroy.io/tgwitness/de/docs/reference/changelog/) 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](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/)- und [-Befehlszeilenzugriff](https://phishdestroy.io/tgwitness/de/docs/reference/cli/) 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.
