# Telegram · Arbeitsabläufe und Funktionen

Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/operations/

Täglicher Betrieb des Dashboards: Betriebsmodi, Überwachungskategorien, Parameter, Benachrichtigungen, Exporte, Datensicherung und Kapazität.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt)

Translation coverage: this edition includes material from the English original.

Täglicher Betrieb des Dashboards: Betriebsmodi, Überwachungskategorien, Parameter, Benachrichtigungen, Exporte, Datensicherung und Kapazität.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bereitstellung und Wiederherstellung](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/)

![Bereitstellung und Wiederherstellung](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

Verwenden Sie für Ihre erste Verbindung [Konten und Sitzungsformate](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/). Eine Erläuterung zu gespeicherten Versionen, Ereignisrichtlinien und Lücken finden Sie unter [„So funktioniert die Erfassung](https://phishdestroy.io/tgwitness/de/docs/reference/collection/)“. Dieser Leitfaden behandelt den täglichen Betrieb und die Wiederherstellung.

Eine verwaltete Installation umfasst **, START-HERE.html,** und **, START-HERE.txt sowie** neben dem Startprogramm, wobei der Repository-Link und die Befehle auf den jeweiligen Installationspfad zugeschnitten sind. Führen Sie `tgwitness guide --print` über SSH aus oder `tgwitness paths`, um das tatsächliche Datenverzeichnis zu ermitteln. Bei einer Root-Installation über systemd werden private Zustandsdaten unter `/var/lib/tgwitness-…` gespeichert; `/opt/tgwitness` enthält das Programm.

Bei einem verwalteten temporären Cloudflare-Tunnel sperrt „`tgwitness tunnel off`“ den öffentlichen Zugriff, während das lokale Panel und die Datenerfassung weiterlaufen. „`tgwitness tunnel on`“ aktiviert ihn; „`tgwitness tunnel restart`“ erstellt eine neue Tunnelverbindung. Verwenden Sie „`tgwitness open`“, um die aktuelle Adresse anzuzeigen. Eine explizite Deaktivierung bleibt auch nach einem Neustart des Dienstes bestehen. „`tgwitness stop`“ stoppt sowohl das Panel als auch die Datenerfassung.

**Auf dieser Seite**

- [Ablauf für den Operator](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#operator-workflow)
- [Arbeit teilen, ohne den Hauptschlüssel weiterzugeben](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#share-work-without-sharing-the-main-key)
- [Laufzeitmodi](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#runtime-modes)
- [Überwachungskategorien](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#monitoring-categories)
- [Benachrichtigungen](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#notifications)
- [Anordnung der Bedienelemente](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#panel-layout)
- [Bereitstellungsumgebungen](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#deployment-environments)
- [Startprüfungen und Exporte](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#startup-checks-and-exports)
- [Sicherung, Wiederherstellung und Unterbrechungen](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#backup-restore-and-interruptions)
- [Kapazität und Aufbewahrungsdauer](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#capacity-and-retention)

## Arbeitsablauf für Bediener

Ablaufdiagramm · Wählen Sie Speicherort und Schlüsselschutz → Öffnen Sie das Fenster mit dem entsprechenden Token; Öffnen Sie das Fenster mit dem entsprechenden Token → Wählen Sie einen Arbeitsbereich aus; Wählen Sie einen Arbeitsbereich aus → Direkte oder Proxy-Route konfigurieren; Direkte oder Proxy-Route konfigurieren → Geben Sie Ihre Telefonnummer ein oder wählen Sie Dateien / QR-Code aus; Geben Sie Ihre Telefonnummer ein oder wählen Sie Dateien / QR-Code aus → Überprüfen Sie die Kontoidentität und wählen Sie zugängliche Gruppen aus; Überprüfen Sie die Kontoidentität und wählen Sie zugängliche Gruppen aus → Richten Sie Richtlinien für Ereignisse und Anhänge ein und beginnen Sie anschließend mit der Überwachung; Richten Sie Richtlinien für Ereignisse und Anhänge ein und beginnen Sie anschließend mit der Überwachung → Fehler, Zugriff, Warteschlangen und Festplattenspeicher überwachen; Fehler, Zugriff, Warteschlangen und Festplattenspeicher überwachen → Unabhängige Kontrollpunkte beibehalten; Unabhängige Kontrollpunkte beibehalten → Material exportieren und verifizieren · Wählen Sie Speicherortund Schlüsselschutz · Öffnen Sie das Fenstermit dem entsprechendenToken · Wählen Sie einenArbeitsbereich aus · Direkte oderProxy-Routekonfigurieren · Geben Sie IhreTelefonnummer ein oderwählen Sie Dateien /QR-Code aus · Überprüfen Sie dieKontoidentität undwählen Sie zugänglicheGruppen aus · Richten SieRichtlinien fürEreignisse und Anhängeein und beginnen Sieanschließend mit derÜberwachung · Fehler, Zugriff,Warteschlangen undFestplattenspeicherüberwachen · UnabhängigeKontrollpunktebeibehalten · Material exportierenund verifizieren

**Diagramm als Text**

1. Wählen Sie Speicherort und Schlüsselschutz → Öffnen Sie das Fenster mit dem entsprechenden Token
2. Öffnen Sie das Fenster mit dem entsprechenden Token → Wählen Sie einen Arbeitsbereich aus
3. Wählen Sie einen Arbeitsbereich aus → Direkte oder Proxy-Route konfigurieren
4. Direkte oder Proxy-Route konfigurieren → Geben Sie Ihre Telefonnummer ein oder wählen Sie Dateien / QR-Code aus
5. Geben Sie Ihre Telefonnummer ein oder wählen Sie Dateien / QR-Code aus → Überprüfen Sie die Kontoidentität und wählen Sie zugängliche Gruppen aus
6. Überprüfen Sie die Kontoidentität und wählen Sie zugängliche Gruppen aus → Richten Sie Richtlinien für Ereignisse und Anhänge ein und beginnen Sie anschließend mit der Überwachung
7. Richten Sie Richtlinien für Ereignisse und Anhänge ein und beginnen Sie anschließend mit der Überwachung → Fehler, Zugriff, Warteschlangen und Festplattenspeicher überwachen
8. Fehler, Zugriff, Warteschlangen und Festplattenspeicher überwachen → Unabhängige Kontrollpunkte beibehalten
9. Unabhängige Kontrollpunkte beibehalten → Material exportieren und verifizieren

Authentifizierung, Transportverbindung, Zugriff auf eine Gruppe und Vollständigkeit der Übermittlung sind unterschiedliche Eigenschaften. Ein grüner Verbindungsstatus bedeutet nicht, dass alle Ereignisse erfasst wurden.

## Arbeiten teilen, ohne den Hauptschlüssel weiterzugeben

Öffnen Sie **Weitere Tools → Zugriff**, um einem Prüfer oder Analysten ein eigenes Token zuzuweisen. Wählen Sie die Konten und Chats aus, die diese Personen öffnen dürfen, und erteilen Sie ihnen anschließend Berechtigungen zum Anzeigen, Exportieren oder Ausführen von Aktionen. Ein Operator, der die Erfassung startet oder stoppt, benötigt Zugriff auf den gesamten Arbeitsbereich; ein Prüfer kann auf einen einzelnen Chat beschränkt werden. Sitzungslimits, Ablaufzeiten und IP-Regeln sind unabhängig von der Telegram-Kontoautorisierung. Siehe [Zugriff und Berechtigungen](https://phishdestroy.io/tgwitness/de/docs/reference/access/).

Verwenden Sie **„Offene Sitzungen“,** um eine Verbindung zu beenden, oder widerrufen Sie den Zugriff, um alle zugehörigen Sitzungen zu beenden. Die Administratorkonsole fasst die Aktivitäten der laufenden Prozesse über alle Arbeitsbereiche hinweg zusammen. Beim Schließen einer Sitzung läuft die Erfassung weiter.

## Ausführungsmodi

| Modus | Maßnahme | Verhalten |
| --- | --- | --- |
| Demo | scripts\Demo.cmd oder `--demo` | Synthetische Daten; Verknüpfungen zu echten Konten deaktiviert |
| Anmerkung | Beobachtung starten | Erfassung der bereitgestellten Aktualisierungen für ausgewählte Quellen |
| Historischer Überblick | Chats → Chat-Aktionen → Verlauf laden | Bis zu 500 aktuelle Nachrichten; keine Rekonstruktion aller vergangenen Änderungen |
| Pause | Beobachtung unterbrechen | Erfassung unterbrechen, dabei Daten und Aufträge in der Warteschlange beibehalten |
| Überprüfung/Übergabe | Exporte | ZIP, JSONL/CSV/HTML, Checkpoint, Prozessbestätigung und Zeitstempelanforderung |
| Mehrere Konten | Arbeitsbereiche oder die oberste Schaltfläche „**+**“ | Beliebig viele separate Arbeitsbereiche in einem Prozess |

Der lokale Demo-Zugriff wird automatisch ohne manuelle Token-Eingabe freigeschaltet. Dabei kommt eine auf die Prozesslaufzeit begrenzte Funktion zum Einsatz, die ausschließlich für den direkten Loopback-Zugriff auf eine isolierte synthetische Demo gilt; das Token für das Hauptpanel wird nicht offengelegt. Bei echten Arbeitsbereichen sowie beim Remote- oder Proxy-Zugriff auf die Demo bleibt die Token-Authentifizierung bestehen. Der Demo-Zugang gewährt keine Telegram-Berechtigung.

## Überwachungskategorien

![Überwachungseinstellungen pro Konto mit synthetischen Quelldaten](https://phishdestroy.io/tgwitness/assets/sources.png?v=761b8bfa296c)

Wählen Sie unter **Weitere Tools → Quellen → Aufzeichnung → Zu beibehaltende Änderungen auswählen** neue Nachrichten, Bearbeitungen, Löschhinweise, Reaktionsaktualisierungen und Mitgliedschaftsereignisse separat aus. Die Standardeinstellung behält alle Kategorien bei. **Nachrichten, Bearbeitungen & Löschungen** behält den ursprünglichen Kontext bei, während separate Reaktions- und Mitgliederaktualisierungen deaktiviert werden. **Alle sichtbaren Aktivitäten** stellt alle fünf wieder her. Voreinstellungen ändern das Formular; klicken Sie auf**Aufzeichnungseinstellungen speichern,** um sie anzuwenden.

Die gespeicherte Richtlinie gilt für alle ausgewählten Quellen in diesem Arbeitsbereich. Andere Arbeitsbereiche behalten ihre eigenen Einstellungen bei. Bei jeder tatsächlichen Änderung werden signierte Vorher-Nachher-Werte aufgezeichnet; die aktuelle Richtlinie wird zudem in Prozessbelegen und Beobachtungsstartprotokollen erfasst. Das Deaktivieren einer Kategorie löscht frühere Beobachtungen nicht. Durch erneutes Aktivieren werden versäumte Änderungen nicht nachträglich erfasst. In dieser Version gibt es keine gruppenspezifische Übersteuerung von Kategorien.

Behalten Sie die Erfassung neuer Nachrichten bei, wenn frühere Inhalte von Bedeutung sind: Eine Löschmeldung kann keinen Text wiederherstellen, der nie erfasst wurde. Betriebs- und Erfassungsprotokolle sowie andere Ereignisse im Zusammenhang mit Gruppendiensten werden stets beibehalten. Explizite Verlaufs-Snapshots sind unabhängig von der Auswahl der Live-Kategorien und können Dienstmeldungen enthalten. Diese Einstellungen führen nicht zur Schwärzung von Reaktions- oder Mitglieder-Metadaten, die in einem ansonsten erfassten Telegram-Objekt eingebettet sind.

Ein Verlaufs-Snapshot kann Anhänge in die Warteschlange stellen, während er angehalten ist. Starten Sie die Beobachtung, um diese zu verarbeiten. „In der Warteschlange“ bedeutet nicht „heruntergeladen“. Eine nicht verfügbare Originaldatei wird nicht durch eine neuere bearbeitete Version ersetzt; die Ergebnisse werden separat aufgezeichnet.

**Mit „Lock“** werden der Browserzugriff und geheime Felder gelöscht, die Erfassung läuft jedoch weiter. Auch beim Schließen eines Tabs läuft der Prozess weiter. Das Beenden des Python-Prozesses oder -Dienstes stoppt die Erfassung unabhängig vom Status des Browsers.

Ein zusätzlicher Arbeitsbereich kann gelöscht werden, sobald ein signierter ZIP- oder ASiC-E-Container, der das Journal und die Case-Board-Notizen enthält, vollständig heruntergeladen wurde. Das Vorbereiten des Archivs reicht nicht aus: Ein Eintrag außerhalb der Einrichtungsereignisse oder eine nach dem Herunterladen hinzugefügte Notiz verhindert, dass **die Option Löschen** verfügbar ist.

Wenn das Panel die Datei selbst empfängt, zählt es den Export erst, nachdem es jedes einzelne Byte empfangen hat, und meldet dann die Größe an `POST /api/exports/{id}/received`; ein abgebrochener Download wird nicht gezählt. Bei Verwendung eines Browser-Speicherauswahlfensters (Dateisystemzugriff) meldet das Panel den Vorgang, nachdem die Datei geschrieben und geschlossen wurde. Ohne diesen übergibt das Panel die empfangene Datei an die Downloads des Browsers und kann nicht erkennen, ob der Browser sie beibehalten hat, beispielsweise wenn der Speicherdialog abgebrochen wird; das Panel meldet dann, dass der Download gestartet wurde, nicht jedoch, dass die Datei gespeichert wurde. Eine Datei, die der Browser eigenständig herunterlädt (ein Export, der größer ist als der Browser-Puffer des Panels), sowie ein Download durch einen anderen HTTP-Client werden gezählt, sobald der Server die gesamte Antwort gesendet hat. Das Betriebssystem und ein Reverse-Proxy puffern mehrere Megabyte einer Antwort, sodass der Server bei diesen Downloads eine Unterbrechung kurz vor dem Ende nicht erkennen kann. Sofern das Panel nicht anzeigt, dass die Datei gespeichert wurde, überprüfen Sie die heruntergeladene Datei, bevor Sie sie löschen. Ein Gruppenexport wird für die betreffenden Konten gezählt, wenn er unmittelbar nach seiner Erstellung heruntergeladen wird; ein erneutes Herunterladen aus **den vorbereiteten Exporten** zählt nicht.

Vor dem Löschen zeigt das Fenster das Format, die Größe, die Erstellungszeit und den SHA-256-Hash des zuletzt heruntergeladenen signierten Archivs an und fordert zur Bestätigung auf, dass dieses Archiv außerhalb des Arbeitsbereichs gespeichert ist. Der Server lehnt den Befehl `DELETE /api/profiles/{id}` ab, wenn `kept_copy` nicht auf diesen SHA-256-Wert gesetzt ist (oder auf `confirmed` für ein Archiv, das vor der Erfassung des Fingerabdrucks heruntergeladen wurde).

Das Löschen eines zusätzlichen Arbeitsbereichs stoppt dessen Datenerfassung und entfernt dessen lokale Daten. Sollte eine gesperrte Datei oder ein Dateisystemfehler den Löschvorgang unterbrechen, meldet das Bedienfeld den Fehler und führt den Arbeitsbereich weiterhin als nicht verfügbar (`DeletionPending`) auf. Schließen Sie Programme, die dessen Dateien öffnen, und versuchen Sie **den Löschvorgang** erneut. Ein Neustart von TgWitness belässt diesen Arbeitsbereich im angehaltenen Zustand und stellt das teilweise entfernte Protokoll oder die Schlüssel nicht wieder her. Eine erfolgreiche Löschung wird erst dann protokolliert, wenn das Verzeichnis entfernt wurde; separat exportierte oder gesicherte Kopien unterliegen weiterhin ihrer eigenen Aufbewahrungsrichtlinie.

## Benachrichtigungen

Öffnen Sie **Einstellungen → Benachrichtigungen und externe Kopie → Benachrichtigungsziele** oder **Weitere Tools → Extras → Benachrichtigungen → Konfigurieren**. TgWitness nutzt Apprise, um Benachrichtigungen an Matrix, Telegram, Discord, Slack, ntfy, E-Mail und andere unterstützte Dienste zu senden. Sie können einem Arbeitsbereich mehrere Ziele hinzufügen.

1. Geben Sie pro Zeile eine Apprise-Ziel-URL ein. Verwenden Sie den [Servicekatalog und die URL-Formate](https://appriseit.com/services/) für Ihren Dienst.
2. Aktivieren Sie die Option **„Benachrichtigungen senden**“ und wählen Sie anschließend Problemwarnungen, Änderungen in beobachteten Chats sowie eine tägliche Zusammenfassung aus. Die Uhrzeit in der Zusammenfassung richtet sich nach der Serverzeit.
3. Aktivieren Sie die Option**„Kurze Auszüge einbeziehen“,** wenn Sie möchten, dass Text aus gelöschten und bearbeiteten Nachrichten in den Benachrichtigungen gespeichert wird.
4. Klicken Sie auf **„Benachrichtigungen speichern**“ und anschließend auf **„Test senden“**, um die Zustellung zu überprüfen.

Verwenden Sie für Ihren eigenen Empfänger [den JSON-Webhook](https://appriseit.com/services/json/) von Apprise. Beispielsweise sendet „`jsons://notify.example.org/tgwitness`“ JSON über HTTPS an diesen Endpunkt. Dies ist ein fiktives Beispiel; ersetzen Sie es durch Ihr eigenes Ziel.

Ziele und Einstellungen gehören zum ausgewählten Arbeitsbereich. Änderungsbenachrichtigungen umfassen die überwachten Quellen, einschließlich neu hinzugefügter Chats. Die Glocke in der oberen Leiste listet zudem aktuelle Probleme und Änderungen in Chats auf.

In der Demo sind die Benachrichtigungssteuerelemente sichtbar, das Versenden ist jedoch deaktiviert. Konfigurieren Sie die Zustellung in einem realen Arbeitsbereich. Benachrichtigungen nutzen die Direct-, SOCKS5- oder HTTP-Route dieses Arbeitsbereichs; MTProxy kann sie nicht weiterleiten. Nicht-HTTP-Ziele wie SMTP erfordern eine direkte Route.

## Layout der Seiten

![Arbeitsbereich für die Anbindung unter Verwendung synthetischer Daten](https://phishdestroy.io/tgwitness/assets/connection.png?v=c8781089fe29)

**Das Protokoll** zeigt Beobachtungen, Suchfunktionen und Filter an. Bei einer Bearbeitung werden die erfassten Versionen angezeigt; bei einer Löschung wird der vorherige Inhalt angezeigt, sofern verfügbar. Unbekannte Quellenangaben bleiben ausdrücklich gekennzeichnet. Zahlenangaben sind unter **„Übersicht“** verfügbar; Details zur Erfassung verbleiben im lokalen Leitfaden.

Öffnen Sie eine bearbeitete Nachricht, um ihre Versionen über **Änderungen im Text** oder **Nebeneinander** zu vergleichen; **Rohdaten** zeigt die gespeicherten Felder an. Änderungen an versteckten Links und Bot-Schaltflächen werden separat angezeigt. Öffnen Sie eine Anhangsvorschau, um gespeicherte Bilder, Audio- oder Videodateien zu prüfen; über die Download-Schaltfläche bleibt das gesicherte Original verfügbar.

**Live** aktualisiert das Journal und die Chats, sobald Datensätze eintreffen. Pausieren Sie es während der Überprüfung oder nutzen Sie die Schaltfläche für neue Ereignisse, wenn Sie bereit sind; die Erfassung läuft im Hintergrund weiter. **Ctrl/Cmd+K** findet Panel-Aktionen und durchsucht das Journal.

**Weitere Tools → Quellen** enthält den Beobachtungsumfang (ausgewählte Chats, einen Telegram-Ordner oder das gesamte Konto), zugängliche Chats aller Art, ausgewählte Quellen mit Prioritätssternen, Einstellungen für Anhänge und Nachprüfungen sowie Verlaufs-Snapshots. Private Quellen werden über Dialog/ID ohne öffentlichen Link ausgewählt. Der Zugriffsstatus beschreibt die letzte Überprüfung, nicht dauerhafte Berechtigungen.

Filtern Sie Quellen, aktivieren Sie deren Kontrollkästchen und aktivieren, pausieren oder markieren Sie sie anschließend gemeinsam als prioritär. In der Liste der verfügbaren Chats verwendet **Ausgewählte hinzufügen** Ihre Auswahl; **Alle Treffer hinzufügen** nutzt die aktuelle Suche und den Typfilter.

Unter **„Chats → Personen“** werden alle Personen mit gespeicherten Nachrichten aufgelistet; sind die Personenprofile für den Chat aktiviert, öffnet ein Klick das Profil der jeweiligen Person mit Links zu den Protokollen.

**Weitere Tools → Extras → Independent Witness** erstellt schreibgeschützte Witness-Token, zeigt an, wann jeder Witness zuletzt eine Überprüfung durchgeführt hat, und stellt die Befehle und Optionen zur Ausführung eines [Independent Witness](https://phishdestroy.io/tgwitness/de/docs/reference/witness/) bereit.

**Weitere Tools → Parameter** enthält alle Grenzwerte und Raten des Arbeitsbereichs, die nicht auf einer anderen Seite aufgeführt sind: wie viele Dialoge gelesen werden, wie oft die Chat-Liste neu gelesen wird, Heartbeat- und Checkpoint- Intervalle, den Startpuffer, wie Nachprüfungen ihre Anfragen verteilen (erste Verzögerung, Chats pro Durchlauf, Pause zwischen Chats, wiederhergestellte und erneut angeforderte Nachrichten), Festplattenreserve, Timeouts und Wiederholungsversuche bei Downloads, wonach Benutzerprofile suchen (einschließlich Ihrer eigenen regulären Ausdrücke), Größe und Häufigkeit von Benachrichtigungen, Snapshot-, ZIP- und Browser-Download-Limits sowie Telegram- Client-Timeouts und Wiederholungsversuche. Jedes Feld zeigt seinen Bereich und seinen Standardwert an; geänderte Felder sind markiert und können einzeln oder alle zusammen wiederhergestellt werden. Jede Änderung wird als ``parameters.changed`` mit den Werten vor und nach der Änderung protokolliert, und die Aufzeichnungen zum Beginn der Beobachtung nennen die geltenden Werte. Die Werte gelten ab ihrer nächsten Verwendung; Client-Timeouts und Wiederholungsversuche ab der nächsten Verbindung. Intervalle für erneute Überprüfungen, Anhangstypen und -größen, Nachweise sowie Intervalle für externe Kopien bleiben auf ihren eigenen Seiten und können beliebige Werte innerhalb ihres Bereichs annehmen, nicht nur voreingestellte Werte.

Die Glocke in der oberen Leiste listet aktuelle Probleme und Änderungen in den überwachten Chats auf; ungelesene Einträge werden gezählt, bis sie als gelesen markiert werden. Änderungen werden nach Chat und Stunde gruppiert („12 gelöscht, 1 bearbeitet, 0 nicht gefunden“), und Probleme wie eine Abmeldung oder ein voller Speicherplatz bleiben in der Liste, unabhängig davon, wie aktiv die Chats sind.

**Weitere Tools → Die Kontoerstellung** beginnt im Feld für die Telefonnummer. **Weiter** führt direkt zur Codeeingabe, wobei API-Anmeldedaten nur abgefragt werden, wenn sie fehlen. QR-Code und Dateiimport sind alternative Registerkarten. Gespeicherte API-Anmeldedaten werden nur innerhalb des eigenen Arbeitsbereichs wiederverwendet. Der Eingabebildschirm verfügt über keine Seitenleiste, Statistiken oder Einrichtungsabschnitte. Das Symbol **Einstellungen** öffnet die Steuerelemente für API, Proxy, Speicher und zusätzliche Konten. Ein neuer Arbeitsbereich öffnet [die Ersteinrichtung](https://phishdestroy.io/tgwitness/de/docs/reference/settings/) ; nach der Anmeldung öffnet sich ein Arbeitsbereich mit gespeicherten Quellen und Datensätzen sowie **dem Bereich „Chats** “. Das Ändern der Route erfordert die Unterbrechung der Beobachtung und bricht eine noch nicht abgeschlossene Anmeldung ab. Ein bestehendes Journal kann nicht im Hintergrund mit einem anderen Telegram-Konto neu verknüpft werden.

**Der Export** überprüft die Integrität des Journals und erzeugt portable Dateien. Seine Arbeitsbereichs-ID kann an die Download-Befehlszeilenschnittstelle übergeben werden. Jeder Export fixiert ein vollständiges Journal-Präfix; spätere Ereignisse fließen in einen nachfolgenden Export ein. Suchfilter ändern den Paketbereich nicht. Detaillierte Informationen zu Signatur und Abdeckung finden Sie unter **Verifizierung und Nachweis**.

Das Dashboard zeigt unter „Collector**-Status“** den Status des Collectors, Medien in der Warteschlange bzw. fehlgeschlagene Medien, die ältesten ausstehenden Medien, freien Speicherplatz, angehaltene Anfragen sowie Quellen an, deren Zugriff unter **„Collector-Status“**noch nicht bestätigt ist. Diese Details sind zunächst ausgeblendet und auf der Registerkarte „Konto“ verborgen. Eine Einrichtungskarte zeigt den nächsten Schritt an: ein Konto verbinden, Quellen auswählen oder die Überwachung starten. Die Konto-Liste ist eine Momentaufnahme zum Zeitpunkt des Ladens; der ausgewählte Arbeitsbereich wird regelmäßig aktualisiert. Es handelt sich hierbei nicht um einen SLA-Monitor mit mehreren Prozessen.

Die Oberfläche nutzt lokale Assets und Textdarstellung für Quellinhalte. Desktop- und schmale Chromium-Layouts sind getestet.

## Bereitstellungsumgebungen

| Umfeld | Installation | Verifizierungsstatus |
| --- | --- | --- |
| Windows-PC/Server | Python 3.11+, Skripte: „Setup.cmd/Start.cmd“, Verzeichnis für private Daten | Lokal getestet unter Windows/Python 3.12 |
| Linux-Server/VPS | Python-venv, dedizierter Service-Benutzer, HTTPS/SSH | Beispiele für Code, CI und systemd werden bereitgestellt; die Ausführung erfolgt nicht auf diesem Host |
| macOS | Python-venv, Vordergrundprozess oder User-Agent | Beispiel für „launchd“ bereitgestellt; separate Installationsprüfung erforderlich |
| Docker/Compose | Persistenter Speicher, ein Worker | Definition und CI-Laufzeitprüfung werden bereitgestellt; Docker ist lokal nicht verfügbar |
| Mobilbrowser | Stellen Sie eine Verbindung zum geschützten Panel auf einem laufenden Server her | Getestet mit schmalem Chromium-Layout; der Collector läuft nicht unter iOS/Android |

Portabilität bedeutet, dass kein Cloud-Dienst und kein Frontend-Build zwingend erforderlich sind. Jedes Zielsystem benötigt jedoch weiterhin kompatible Python-/Krypto-Abhängigkeiten sowie lokalen Festplatten- und Netzwerkzugriff. Siehe [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/) und [die Service-Vorlagen](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md).

Arbeitsbereiche teilen sich CPU, Arbeitsspeicher und eine Ereignisschleife. Verwenden Sie zur Prozessisolierung unterschiedliche Instanzen, Ports, Datenverzeichnisse und Kontoberechtigungen. Es gibt kein einheitliches Kontrollpanel für separate Instanzen. Richten Sie niemals mehrere Worker auf eine einzige Datenbank aus.

## Startvorgänge und Exporte

Führen Sie `python start.py --check` aus, bevor Sie eine vorbereitete Umgebung starten. Fügen Sie `--json` hinzu für maschinenlesbare Prüfungen oder übergeben Sie die gewünschten Parameter `--data-dir`, `--host` und `--port`. Der Befehl prüft die Voraussetzungen, ohne sich bei Telegram anzumelden oder ein Journal anzulegen. Die Journalüberprüfung läuft während des Anwendungsstarts ab, und die Erfassungsbereitschaft wird im Panel angezeigt. Ein belegter Port kann einfach eine bereits vorhandene Instanz sein.

Browser, die die File System Access API unterstützen, speichern Exporte über einen beschreibbaren Stream. Andere Browser puffern maximal 128 MiB. Verwenden Sie die Streaming-CLI für größere Exporte oder für Browser ohne Datei-Streaming:

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

Fügen Sie „`--profile ID` “ aus „Exports“ für einen untergeordneten Arbeitsbereich hinzu. Verwenden Sie „`--url https://server` “ für den Fernzugriff. Einfaches HTTP wird nur für Loopback-Ziele akzeptiert. Das Token wird aus einer Datei gelesen und in einem Header gesendet; es wird weder ausgegeben noch in eine URL eingefügt. Weiterleitungen werden abgelehnt. Vorhandene Ziele werden nicht überschrieben. Bei fehlgeschlagenen Übertragungen wird die temporäre Teil-Datei entfernt. Der gemeldete SHA-256-Wert ist eine Übertragungsprüfsumme; überprüfen Sie die signierte ZIP-Datei separat anhand eines vertrauenswürdigen Fingerabdrucks/Checkpoints.

## Sicherung, Wiederherstellung und Unterbrechungen

1. Die Überwachung unterbrechen und den Vorgang ordnungsgemäß beenden.
2. Kopieren Sie das gesamte Datenverzeichnis: Datenbanken, WAL/SHM (falls vorhanden), Medien, `credentials.enc`, `signing.enc`, `network.enc`, Tresorschlüssel/Metadaten, Token, Checkpoints und jedes `profiles/`-Verzeichnis.
3. Im Modus mit externem Schlüssel sind der Hauptschlüssel separat aufzubewahren und jeder „ `vault.external.json`“-Wert zu sichern. Durch die Generierung eines neuen Schlüssels lassen sich die alten Geheimnisse nicht wiederherstellen.
4. Führen Sie die Wiederherstellung durch, während das Zielsystem angehalten ist; konfigurieren Sie den ursprünglichen Schlüssel, beschränken Sie den Zugriff und überprüfen Sie die Integrität, bevor Sie den Vorgang fortsetzen.
5. Erfassen Sie Ausfallzeiten und Verifizierungsergebnisse. Die Ausfallzeit bleibt als aufgezeichnete Lücke bestehen; ein Verlaufs-Snapshot fügt den Zustand danach hinzu.

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](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/#updates-and-backups). Four things are protected differently:

| Was | Schutz |
| --- | --- |
| Dateien ohne Passwort exportieren (Standardeinstellung) | Signiert, sodass Änderungen nachweisbar sind; legen Sie ein Passwort fest, um den Export zu verschlüsseln |
| Dateien mit einem Passwort exportieren | Wenn Sie ein Passwort festlegen, wird der fertige Export unverändert in eine WinZip-ZIP-Datei mit AES-256-Verschlüsselung gespeichert, die sich mit 7-Zip und WinRAR öffnen lässt; das Passwort wird nicht gespeichert ([Beweismittelbehandlung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/)). |
| Die Protokoll-Datenbank und die auf der Festplatte gespeicherten Anhänge | Eine verschlüsselte Festplatte oder ein verschlüsseltes Volume und Ordnerberechtigungen |
| Telegram-Sitzungen und Signaturschlüssel | Verschlüsselt im Datenverzeichnis (`credentials.enc`, `signing.enc`, `network.enc`) |

Ein Vollsicherungs-Backup ist das oben beschriebene Verzeichnis mit den gesicherten Daten, kein Export. Verwenden Sie für beides einen geschützten Speicher und einen kontrollierten Übertragungsmechanismus. Vorläufige Server-Exporte werden im Verzeichnis „ `temporary-exports/`“ des jeweiligen Arbeitsbereichs gespeichert; abgeschlossene Antworten werden bereinigt, und unterbrochene Exportdateien werden beim nächsten Start entfernt, solange die Instanzsperre dieses Arbeitsbereichs aufrechterhalten wird.

Nach einem Ereignis zur Wiederherstellung der Verbindung fordert der Collector versäumte Aktualisierungen ab der gespeicherten Aktualisierungsposition an. Persistente Medienaufträge und die Telegram-Aktualisierungsposition bleiben nach einem Neustart erhalten; siehe [Nachweisformat](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#durable-collection-and-process-receipts-02).

## Kapazität und Aufbewahrungsdauer

Standardgrenzwerte, die alle unter **Weitere Tools → Parameter** geändert werden können: die ersten 1,000 Dialoge, 500 Nachrichten pro Snapshot, 4 GiB unkomprimierter signierter ZIP-Inhalt (größere Archive erfordern `verify.py --max-gib N`) und ein 128-MiB-Browser-Fallback. Anhänge beanspruchen 1–2,000 MiB pro Typ unter **Weitere Tools → Quellen → Aufzeichnung → Anhänge**. Die Download-CLI ist standardmäßig auf 5 GiB übertragen eingestellt. Der verfügbare Speicherplatz kann eine untere Grenze darstellen. Reservieren Sie Speicherplatz für Journale, Medien, WAL, temporäre Exporte und Backups. Exporte nutzen das Datenvolumen anstelle des 512-MiB-Verzeichnisses `/tmp` von Compose.

Messen Sie Ereignisse pro Sekunde, das Alter der Warteschlange, Medienbytes und die Festplattenlatenz, anstatt nur Gruppen zu zählen. Die Live-Übertragung wird auf dem laufenden Collector gemessen. Es gibt keine automatische Löschung bei Ablauf der Aufbewahrungsfrist. Das Entfernen des Endes eines Journals macht dessen Beziehung zu aufbewahrten Checkpoints ungültig.

Priorisierte Nachprüfungen gibt es bereits: Mit Stern markierte Quellen werden standardmäßig alle 15 Minuten nachgeprüft, andere alle 6 Stunden (siehe [Nachprüfungsstufen](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#recheck-tiers)). Passwortgeschützte Exporte funktionieren wie oben beschrieben. Eingeschränkter Zugriff ist unter [Zugriff und Berechtigungen](https://phishdestroy.io/tgwitness/de/docs/reference/access/) dokumentiert. Siehe [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md), [LIVE_ACCEPTANCE.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md) und [VERIFICATION.md](https://phishdestroy.io/tgwitness/de/docs/reference/verification/).
