# Telegram · Verbindung, Proxys und Datenschutz

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

Authentifizierung, automatische Proxy-Pools, IP-Modi, Fallback-Richtlinie, externe Anfragen und Speicherung von Geheimnissen.

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

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

Authentifizierung, automatische Proxy-Pools, IP-Modi, Fallback-Richtlinie, externe Anfragen und Speicherung von Geheimnissen.

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

Dieses Dokument beschreibt das Verhalten von TgWitness0.9.3 und dessen Grenzen. Authentifizierung, Quellenzugriff, Netzwerkverbindung und Erfassungsvollständigkeit sind separate Zustände. Informationen zu Anmeldeschritten, Dateiformaten und mehreren Konten finden Sie unter [Konten und Sitzungsformate](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/). Informationen zu Ereignisrichtlinien und zum Verhalten bei Neustarts finden Sie unter [So funktioniert die Erfassung](https://phishdestroy.io/tgwitness/de/docs/reference/collection/).

## Anleitung zur Verbindungsherstellung

Unter **Weitere Tools → Konto → Verbindungsroute** kann der Administrator zwischen **Dieses Konto**, **Eine Kontogruppe** oder **Alle Konten** wählen und anschließend eine Route auswählen. **Unter Auswahl überprüfen** werden die betroffenen Konten aufgelistet. **Mit Vorbereiten und prüfen** wird die vorgeschlagene Route getestet, ohne die gespeicherte Route zu ändern. **Mit Geprüfte Verbindung anwenden** wird die Vorschau validiert, die Überwachung bei Bedarf angehalten, die Route gespeichert und die bereits laufende Überwachung fortgesetzt. Die Erfassung wird niemals in einem zuvor inaktiven Konto gestartet. Historische Downloads bleiben angehalten und können separat fortgesetzt werden. Halten Sie aktive Exporte vor dem Wechsel an.

Bei Gruppenänderungen behalten Konten standardmäßig ihre eigene Route bei. Deaktivieren Sie diese Option erst, wenn die Vorschau die von Ihnen beabsichtigten Änderungen anzeigt. Die Anwendung meldet das Ergebnis für jedes einzelne Konto; es handelt sich nicht um eine „Alles-oder-Nichts“-Transaktion über alle Datenbanken hinweg. Bei einem fehlgeschlagenen Wechsel werden die vorherigen Einstellungen des jeweiligen Kontos wiederhergestellt. Ein Fehlschlag bei der Wiederaufnahme wird ausdrücklich angezeigt. Vorschauen verfallen nach zehn Minuten, und Änderungen an den Verbindungseinstellungen oder der Gruppenmitgliedschaft erfordern eine neue Überprüfung.

„Apply“ verwendet ein erfolgreiches Preflight-Ergebnis bis zu 90 Sekunden lang wieder, sofern die Route, der Modus und die Richtlinie unverändert bleiben. Bei einem verwalteten Tunnel muss weiterhin derselbe laufende Prozess vorhanden sein. Ältere Ergebnisse, geänderte Tunnelprozesse und automatische MTProxy-Pool-Routen werden erneut überprüft. Der signierte Anwendungsdatensatz behält den ursprünglichen Prüfzeitpunkt bei und protokolliert die Wiederverwendung sowie deren Alter. Jeder Preflight schließt seinen temporären, nicht authentifizierten Client; der Collector stellt die Verbindung über seine eigene autorisierte Sitzung her.

| Route | Was „TgWitness“ verwaltet |
| --- | --- |
| Direkt | Verbindungen vom Host; ein VPN eines externen Hosts wird nicht erkannt oder erzwungen. |
| VPN | Ein WireGuard-Profil mit Volltunnel pro Konto, das von einem lokalen SOCKS5-Prozess im Userspace ausgeführt wird. Es wird keine Host-Schnittstelle und kein Treiber installiert. |
| Mein Proxy | SOCKS5, HTTP CONNECT oder MTProxy-Anmeldedaten. Eine URL kann die Felder SOCKS5/HTTP ausfüllen. Bei Auswahl mehrerer Konten wird dieser eingegebene Proxy gemeinsam genutzt. |
| Öffentliches MTProto | Der bestehende Pool weist „Telegram“-Routen zu. Externe Anfragen sind deaktiviert, bis in den erweiterten Einstellungen ein separater geeigneter Proxy konfiguriert wurde. |
| WARP | Ein separater lokaler Tunnel für jedes ausgewählte Konto, mit WARP-Registrierung und einem WireGuard-Profil, das im Tresor dieses Kontos gespeichert ist. |

Die Überprüfung der aktuellen Route nutzt eine neue, nicht authentifizierte Telegram-Transportverbindung und nicht die Sitzung des Kontos. Dabei wird eine Transportverbindung über die Route zum Rechenzentrum des Kontos hergestellt und ein nicht authentifizierter MTProto-Roundtrip durchgeführt (`req_pq_multi`); dabei wird kein Autorisierungsschlüssel erstellt und kein Konto verwendet. Die gemeldete Latenz setzt sich aus der Verbindungszeit und dem Roundtrip zusammen, und die Prüfung erfasst beide Teile separat. Bei HTTP-fähigen Routen wird zusätzlich den HTTPS-Trace von Cloudflare über diese Route an und zeigt die gemeldete Ausgangs-IP, das Land, den WARP-Status und den Prüfzeitpunkt an. Die WARP-Vorbereitung schlägt fehl, sofern der Trace nicht „WARP aktiv“ meldet. Diese Vorabprüfungen melden die Routenkonnektivität und den beobachteten Ausgang. Überprüfen Sie die erfassten Datensätze anhand der Erfassungs- und Verifizierungsergebnisse des Archivs. Ein laufender lokaler Prozess allein stellt noch keine erfolgreiche Ausgangsprüfung dar.

Das Panel berechnet einen gleitenden Durchschnitt der letzten fünf Überprüfungen. Eine Route gilt als **langsam,** wenn der Durchschnitt 5 Sekunden überschreitet oder drei Überprüfungen in Folge diesen Wert überschreiten, und **als nicht verfügbar,** nachdem zwei Überprüfungen in Folge fehlgeschlagen sind; `network.slow_route` und `network.route_recovered` die Änderungen werden protokolliert. Bei einer langsamen WARP-Route startet **Re-roll WARP** den Tunnel des Kontos über andere Cloudflare-WARP-Endpunkte neu, behält den schnellsten bei und protokolliert `network.warp_rerolled` die Zeiten davor und danach auf; **New WARP Identity** registriert ein neues WARP-Gerät und behält es nur bei, wenn es schneller ist. Die lokale Proxy-Adresse, das Telegram-Konto und dessen Sitzung bleiben unverändert; Telegram-Verbindungen werden über den neu gestarteten Tunnel wiederhergestellt. Eine langsame WARP- Route wird automatisch höchstens einmal alle 30 Minuten neu generiert; wenn das nicht hilft, warten weitere Neugenerierungen auf den Betreiber.

### Portables WARP und WireGuard

Dies ist eine inoffizielle WARP-Integration **** unter Verwendung von [wgcf 2.3.1](https://github.com/ViRb3/wgcf/releases/tag/v2.3.1) und [wireproxy 1.1.3](https://github.com/windtf/wireproxy/releases/tag/v1.1.3). Der Administrator stimmt der Einrichtung vor dem ersten Download oder der WARP- Registrierung ausdrücklich zu. Diese Einrichtungsverbindungen laufen direkt über GitHub und Cloudflare und geben die IP-Adresse des Rechners preis. Der normale Datenverkehr des Kontos behält seine bestehende Route bis zur Anwendung bei. Cloudflare wählt die Ausgangsadresse und das Land aus; separate Tunnel können sich eine Ausgangsadresse teilen. Die Länderauswahl, die periodische IP-Rotation und ein hostweiter VPN-Kill-Switch werden von dieser Funktion nicht bereitgestellt.

Unterstützte Helper-Downloads: Linux und macOS x86-64/ARM64 sowie Windows x86-64. Die Artefakte werden anhand der im geprüften Quellcode enthaltenen „SHA-256“-Hashes überprüft, und zwischengespeicherte ausführbare Dateien werden vor dem Start erneut überprüft. Es wird kein Hilfsprogramm zum PATH hinzugefügt, als Systemdienst installiert oder mit einem öffentlichen Listener versehen. Alle Dateien befinden sich im Verzeichnis „`portable-routes/`“ des Arbeitsbereichs und in verschlüsselten Tresoreinträgen. Der Loopback-Listener „SOCKS5“ erfordert unabhängig generierte Anmeldedaten.

Private Profile und WARP-Kontodaten werden mit dem vorhandenen Workspace-Tresor verschlüsselt. Während des Betriebs benötigt der Helper eine nur für den Eigentümer zugängliche Konfigurationsdatei im Klartext; diese wird bei einem normalen Beenden entfernt. Bei einem Host-Absturz kann diese Datei im nur für den Eigentümer zugänglichen Datenordner zurückbleiben. Dies verschlüsselt weder die Festplatte noch schützt es vor dem Administrator. Der Supervisor schließt den Tunnel, wenn die übergeordnete Pipe des Panels verschwindet. Ein fehlgeschlagener Tunnel ermöglicht niemals einen direkten Fallback. Ein Neustart des Panels stellt einen ausgewählten Tunnel wieder her; fehlgeschlagene Starts werden mit einer begrenzten Verzögerung erneut versucht. **„Stop tunnel** “ pausiert ebenfalls die Überwachung und behält den gestoppten Zustand bei. **„Start tunnel** “ startet den Tunnel; die Überwachung separat fortsetzen, sobald bereit.

Hochgeladene WireGuard-Profile müssen eine Schnittstelle und einen Peer sowie vollständige IPv4- und IPv6-Routen enthalten und dürfen keine Hooks, Includes, Umgebungsersetzungen oder zusätzliche Listener enthalten. Öffentliche Endpunktadressen werden vor dem Start aufgelöst und festgelegt. Verwenden Sie ein externes VPN oder das SOCKS5-Gateway für OpenVPN/IPsec und private Endpunkte.

## Authentifizierungsmethoden

**Die API-ID und der API-Hash identifizieren eine Anwendung; sie ersetzen nicht die Kontoanmeldung.** Sie sind in TgWitness optional. Prioritätsreihenfolge: ein im Formular eingegebenes Paar, dann eines aus einer importierten Konto-JSON-Datei, dann das im Arbeitsbereich gespeicherte Paar, dann der integrierte Pool von 50 öffentlichen Paare, die in zufälliger Reihenfolge ausprobiert werden, mit automatischer Rotation, wenn Telegram eines ablehnt. Nur das Telegram-Desktop-Paar (2040) wird zusammen mit einer passenden Beschreibung des Telegram-Desktop-Clients gesendet. Ihr eigenes Paar aus den API-Entwicklungstools unter [my.telegram.org](https://my.telegram.org) kann für alle Ihre Konten verwendet werden; jedes Konto verfügt weiterhin über eine eigene Autorisierung.

| Vorgehensweise | Anforderungen | TgWitness-Support |
| --- | --- | --- |
| Telefonnummer, Code, optionale 2FA | Zugriff auf das Konto; API-Paar optional | Anmeldung im Panel |
| Authentifizierungsschlüssel (HEX) + DC-ID | Vollständiger 512-Zeichen-Schlüssel und DC 1–5 | Registerkarte „Direct **Auth Key“**; optionale Benutzer-ID wird vor dem Speichern der Autorisierung überprüft |
| Telethon StringSession | Eine gültige Sitzungs-Zeichenkette | Anmeldung im Panel |
| Telethon SQLite `.session` | Abgeschlossener, konsistenter Text | Direkter Import von Schemata über das Bedienfeld 7/8; optionale Offline-Befehlszeilenschnittstelle (CLI) |
| Pyrogram SQLite `.session` | Geschlossene Produktionssitzung | Direkter Import von Schemata über das Bedienfeld 2/3 |
| Telegram Desktop TData ZIP | Ein modernes Konto; lokaler Passcode, falls geschützt | In-Memory-Konvertierung mit Prüfsummen- und Entschlüsselungsprüfungen |
| JSON-Datei für das Konto | Unterstützte API-/Sitzungs-/Schlüssel-Felder | Die Metadaten allein reichen nicht aus, um die API-Anmeldedaten zu füllen; eine Anmeldung per Sitzung/Schlüssel oder per Telefon/QR-Code ist weiterhin erforderlich. |
| QR-Anmeldung | Bestätigung durch eine autorisierte Telegram-App | Lokale QR-Code-Generierung, Ablauf/Wiederholungsversuch, optionale 2FA |
| TDLib / Pyrogram StringSession | Weitere bibliotheksspezifische Formate | Nicht unterstützt |
| Bot-Token | Ein Bot mit eigenem Zugriffs- und Aktualisierungsmodell | Wird von diesem Sammler nicht verwendet |

Telegram wählt die Art der Codeübermittlung, einschließlich der Entscheidung, ob eine SMS gesendet wird. Ein API-Hash kann keine widerrufene Sitzung wiederherstellen oder ein vergessenes 2FA-Passwort ersetzen. TgWitness speichert weder Anmeldecodes noch das Telegram-2FA-Passwort auf der Festplatte.

Bei einer privaten Quelle muss das Konto bereits über Zugriffsrechte verfügen. Ein Gruppennutzername ist nicht erforderlich. Ein Proxy oder ein Sitzungsimport gewährt weder Mitgliedschafts- noch Administratorrechte. Die Chat-Einstellungen legen fest, ob Mitglieder den Verlauf aus der Zeit vor ihrem Beitritt sehen können.

## Eine Telethon-Sitzungsdatei importieren

Telethon SQLite, Pyrogram SQLite und Telegram Desktop TData verwenden unterschiedliche Formate. Das Fenster erkennt die unterstützten Strukturen und konvertiert sie; das Umbenennen einer Datei gilt nicht als Konvertierung. Wählen Sie unter **Dateien** eine Sitzung und die dazugehörige JSON-Datei aus, klicken Sie auf **Dateien prüfen** und anschließend auf**Konto verbinden**. Es werden bis zu vier übereinstimmende Dateien mit einer Gesamtgröße von 8 MiB akzeptiert. Einzelheiten zu TData/JSON finden Sie unter [Formatbeschränkungen](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/). Es gibt keine Passwortwiederherstellung. Die Anmeldung per Telefon/2FA oder QR-Code erstellt eine separate Autorisierung.

Der optionale, ausschließlich für Telethon vorgesehene Befehlszeilenpfad steht weiterhin zur Verfügung:

1. Beenden Sie den Client unter Verwendung der ursprünglichen Sitzung und erstellen Sie eine konsistente Kopie. Der Konverter lehnt Dateien mit einem unvollständigen WAL/Journal ab. Schließen Sie den ursprünglichen Client ordnungsgemäß, anstatt diese Dateien zu löschen, um die Überprüfung zu umgehen.
2. Führen Sie in der TgWitness-Umgebung folgenden Befehl aus:

```
python -m tgwitness.sessions account.session --out account.tgwitness-session
```

1. Laden Sie unter **„Konto hinzufügen“ → „Dateien**“ das Ergebnis hoch oder fügen Sie den entsprechenden Text ein und fahren Sie fort.
2. Überprüfen Sie die angezeigte numerische Konto-ID, wählen Sie die Quellen aus und beginnen Sie mit der Beobachtung.

**Die konvertierte Datei ist ein unverschlüsseltes Passwort für den Kontozugang.** Bewahren Sie ihn an einem geschützten Ort auf und übertragen Sie ihn niemals in ein Repository oder senden Sie ihn an einen externen Konvertierungsdienst. TgWitness speichert die autorisierte Sitzung in seinem verschlüsselten Tresor. Das Kopieren einer Sitzung führt nicht zur Erstellung einer separaten Autorisierung: Führen Sie keine parallelen Clients mit geklonten Authentifizierungsschlüsseln aus und gehen Sie nicht davon aus, dass Aktualisierungen unabhängig voneinander bereitgestellt werden.

Die Konvertierung überträgt die Autorisierung, nicht jedoch die Originalnachrichten, den Entity-Cache oder einen dauerhaften Aktualisierungszeiger. Sie gewährleistet keine Wiederherstellung von Aktualisierungen über Prozessneustarts hinweg.

## MTProto, Telethon und Proxys

MTProto ist das Protokoll von Telegram. Telethon ist die Python-Client-Bibliothek, die TgWitness verwendet. MTProxy ist ein Telegram-Transport-Proxy; SOCKS5 und HTTP CONNECT stellen allgemeine Tunnel bereit. Keines dieser Verfahren ersetzt die Kontoauthentifizierung.

Speichern Sie die Route für jeden Arbeitsbereich unter **Weitere Tools → Konto → Einstellungen → Verbindungseinstellungen → Verbindungsroute ändern,** bevor Sie sich anmelden. Für neue Arbeitsbereiche ist standardmäßig **Automatischer MTProxy eingestellt – öffentliche Listen** mit **der Option Adresse verbergen**. Bestehende Arbeitsbereiche, die explizit Direkt verwendet haben, behalten einen Modus bei, der dies zulässt.

Dateien werden über separate Verbindungen gelesen, die sich von der Verbindung zum Lesen von Nachrichten unterscheiden, so wie es auch bei den offiziellen Apps der Fall ist. Im eigenen Rechenzentrum des Kontos wird der Autorisierungsschlüssel des Kontos für eine neue MTProto-Sitzung wiederverwendet; für ein anderes Rechenzentrum wird ein Schlüssel erstellt und autorisiert, während das Konto verbunden ist, und dieser wird ausschließlich im Arbeitsspeicher gehalten. Jede Dateiverbindung nutzt denselben Weg wie das Konto. Ihre Anzahl pro Rechenzentrum wird durch **„Parameter → Leistung → Dateiverbindungen pro Telegram-Rechenzentrum**; bei 0 werden Dateien ausschließlich über die Hauptverbindung des Kontos gelesen. Es werden höchstens fünf Telegram-Verbindungen gleichzeitig über alle Konten einer Installation hinweg aufgebaut.

## IP-Modi

Die Route bestimmt die Verbindung. Der IP-Modus, **der IP-Schutz** im Abschnitt „Konto“ des Panels, legt fest, wann die Adresse des Servers offengelegt werden darf. Diese Einstellungen führen nicht zur Installation eines VPNs und leiten auch nicht den gesamten Datenverkehr des Computers um.

| Modus | Telegram | Externe Anfragen |
| --- | --- | --- |
| Adresse ausblenden (`hide`) | Verwenden Sie einen Proxy; warten Sie, falls keiner funktioniert. Es gibt keine direkte Ausweichmöglichkeit. | SOCKS5/HTTP ist erforderlich; Anfragen ohne entsprechenden Proxy werden abgelehnt. |
| Direkt als letztes Mittel (`fallback`) | Der automatische MTProxy kann nach Ablauf der konfigurierten Verzögerung „Direct“ verwenden und anschließend wieder zu einem funktionierenden Proxy zurückkehren. | Bevorzugen Sie einen konfigurierten externen Proxy oder die SOCKS5/HTTP-Route des Kontos; andernfalls ist „Direct“ zulässig. |
| Server hinter einem Tunnel oder VPN (`tunnel`) | Direkte Zugriffe und ein sofortiger automatischer Fallback auf den Pool sind zulässig. | Eine direkte Verbindung ist zulässig, wenn kein entsprechender Proxy konfiguriert ist. |

Der Tunnel- oder VPN-Modus setzt voraus, dass Sie dieses Netzwerk separat verwalten. Ohne einen funktionierenden Tunnel können die Empfänger die eigene Adresse des Servers sehen. Wählen Sie den Modus entsprechend Ihrer tatsächlichen Netzwerkkonfiguration aus, nicht anhand des Namens der Option.

### Wählen Sie einen Pfad

| Route | Einstellungen | Grenze |
| --- | --- | --- |
| Automatischer MTProxy | Integrierte Listen oder ein Operator-Katalog | Unterhält eine funktionierende Telegram-Verbindung; der direkte Fallback hängt vom IP-Modus ab |
| Direkt | Tunnel- oder VPN-Modus | Telethon nutzt die Netzwerkroute des Hosts |
| SOCKS5 | Host, Port, optionaler Benutzername/Passwort | python-socks, Remote-Destination-DNS aktiviert |
| HTTP CONNECT | Host, Port, optionaler Benutzername/Passwort | Einfaches HTTP-CONNECT; TLS zum Proxy selbst ist nicht implementiert |
| MTProxy | Host, Port, Geheimnis | Experimenteller Telethon-Transport; 32 Hexadezimalziffern oder „`dd`“ + 32 Hexadezimalziffern |

Gefälschte TLS-`ee`-Geheimnisse werden abgelehnt. Die Normalisierung von Telethon 1.45 kann ein Präfix und eine Domain entfernen, implementiert jedoch kein Fake TLS. Fügen Sie `tg://proxy?server=…&port=…&secret=…` oder `https://t.me/proxy?server=…&port=…&secret=…` ein und wählen Sie **„Felder aus Link ausfüllen**“. Dadurch werden die Felder validiert und ausgefüllt, ohne dass eine Verbindung hergestellt oder gespeichert wird; überprüfen und speichern Sie die Route separat. Manuelle Felder bleiben verfügbar. Siehe [Telegram-Proxy-Links](https://core.telegram.org/api/links#proxy-links).

### Öffentliche Proxys, die von Ihrer Installation bereitgestellt werden

Die integrierte Liste vereint sieben Quellen: [SoliSpirit/mtproto](https://github.com/SoliSpirit/mtproto), [zakky8/mtproto-proxy-pro](https://github.com/zakky8/mtproto-proxy-pro), [kort0881/telegram-proxy-collector](https://github.com/kort0881/telegram-proxy-collector), [3yed-61/MTP-Collector](https://github.com/3yed-61/MTP-Collector), [Therealwh/MTPproxyLIST](https://github.com/Therealwh/MTPproxyLIST), [KhodeJav/telegram-proxy-collector](https://github.com/KhodeJav/telegram-proxy-collector) und [tgmtproxy/telegram-mtproto-proxy-list](https://github.com/tgmtproxy/telegram-mtproto-proxy-list). Der gebündelte Snapshot enthält Endpunktdaten, Quellenangaben und Download-Daten. Die Einträge dienen als Eingaben; die nachfolgenden Konnektivitätsprüfungen entscheiden, welche Proxys verwendet werden.

**MTProxy überprüft automatisch** die Telegram-Transportverbindung, hält einen funktionierenden Proxy bereit und wechselt zu einem anderen, wenn dieser ausfällt. Arbeitsbereiche bevorzugen unterschiedliche Proxys, wenn genügend funktionierende Einträge verfügbar sind; Proxys können sich eine Ausgangsadresse teilen. Ausgefallene Proxys ruhen, bevor ein weiterer Versuch unternommen wird. Wenn keiner funktioniert, bestimmt der IP-Modus, ob die Erfassung warten muss oder eine direkte Verbindung nutzen darf. Ein Wechsel des Proxys hat keine Auswirkungen auf das Konto und löscht dessen Journal nicht. Routenauswahlen und -änderungen werden im signierten Journal aufgezeichnet.

Solange automatische Routen aktiv sind, werden die Listen stündlich aktualisiert und Transportprüfungen standardmäßig alle zehn Minuten durchgeführt. Diese Intervalle sind konfigurierbar. **Das Aktualisieren öffentlicher Listen** löst eine Aktualisierung aus; das bloße Anzeigen der Liste ändert nichts an einer gespeicherten manuellen Route.

**Telegram-Datenverkehr und HTTPS-Anfragen nutzen unterschiedliche Routen.** Listen-Downloads verwenden eine separate HTTPS-Verbindung sowie die bereitgestellte Route für externe Anfragen. „`TGWITNESS_PROXY_FEED_PROXY`“ überschreibt diese Route explizit durch einen HTTP/SOCKS5-Proxy; beide „Compose“-Varianten des Collectors leiten diese weiter. Der Hintergrundpool folgt dem Hauptarbeitsbereich. Es werden keine Telegram-Sitzungen, API-Zugangsdaten, Panel-Token oder Bot-Token an Feed-Anbieter gesendet. Anbieternamen, Erfassungsdaten und die Download-Route werden unter **„Woher die Liste stammt“** angezeigt.

Ein MTProxy überträgt ausschließlich Telegram-Datenverkehr. HTTP-Vorgänge des Arbeitsbereichs wie Zeitstempel, Benachrichtigungen, externe Kopien und Quellprüfungen nutzen einen separaten SOCKS5/HTTP-Proxy, sofern konfiguriert, andernfalls die SOCKS5/HTTP-Route des Kontos. Fehlt beides, lehnt „Hide the address“ die Anfrage ab; die anderen Modi erlauben „Direct“. Externe Anfragen können deaktiviert werden. Ein explizit konfigurierter Feed-Download-Proxy bleibt eine separate Operator-Übersteuerung. Der unabhängige Witness-Dienst behält seine eigene Route bei.

Bei vom Betreiber verwalteten privaten Diensten erlaubt die vorhandene Serverumgebungseinstellung „ `TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1`“ private Ziele und behält die Hostnamenauflösung auf Proxy-Seite bei. Sie kann nicht über das Panel aktiviert werden. Der „Nur-öffentlich“-Modus lehnt „`.onion`“-Ziele ab, bevor der öffentliche Resolver abgefragt wird; Tor-Onion-Dienste erfordern diese explizite Einstellung für private Ziele sowie einen geeigneten Proxy. Dieses DNS-Verhalten gilt für externe HTTP-Vorgänge, nicht für den Telegram-Transport. Cloudflare dokumentiert den [JSON-DNS-Endpunkt](https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/).

****Automatische Pool-Parameter****

Konfigurieren Sie unter **Weitere Tools → Parameter → Automatischer MTProxy** die Fehlerschwelle, die Abkühlphase, die geplante Rotation, die Proxy-Freigabe und die zulässige Fallback-Verzögerung.

| Kontrolle | Standard |
| --- | --- |
| Trennt die Verbindung vor dem Austausch | 3 innerhalb von 10 Minuten |
| Proxy-Server, die pro Verbindungsversuch ausprobiert wurden | 3 |
| Erste / maximale Pause nach einem Fehler | 10 Minuten / 6 Stunden |
| Geplante Rotation | Deaktiviert; bei Fehler aktivieren |
| Konten pro Proxy | 0: Bevorzuge separate Einträge, füge sie bei Bedarf zusammen. Setze 1 auf Warten auf einen exklusiven Eintrag. |
| Verzögerung vor zulässigem direktem Fallback | 10-Minuten; Das Ausblenden der Adresse wird weiterhin abgelehnt Direct |
| Feed-Aktualisierung / Transportprüfungen | 60-/10-Minuten; die Werte des Hauptarbeitsbereichs gelten für den gemeinsamen Pool |

Verschiedene Proxys können sich eine Ausgangsadresse teilen. Die Beschränkungen von Telegram gelten für jede Route.

Um die öffentliche Liste durch Ihren eigenen Betreiberkatalog zu ersetzen, konfigurieren Sie die folgende Überschreibung. Dadurch werden externe Abonnements vollständig deaktiviert, auch wenn das Array „`proxies`“ leer ist.

Kopieren Sie [den leeren Katalog](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proxies.config.example) nach „`proxy-config/proxies.json` “ und fügen Sie Ihre bereitgestellten öffentlichen Endpunkte hinzu:

```
{"format": "tgwitness-proxy-catalog-v1", "proxies": [
  {"id": "project-eu", "label": "Project EU",
   "link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"}
]}
```

Die Beispielwerte müssen ersetzt werden. Es werden bis zu 32 unterschiedliche Einträge akzeptiert. Die authentifizierte Auflistung gibt Labels/Hosts/Ports ohne gemeinsame Geheimnisse zurück; bei Auswahl eines Eintrags werden dessen Anmeldedaten im Workspace-Tresor gespeichert. Die Verfügbarkeit bleibt bis zu einem expliziten Transporttest ungeprüft. Bei einem fehlerhaften Katalog ist eine manuelle Konfiguration möglich.

Native Ausführung: Legen Sie „`TGWITNESS_PROXY_CATALOG`“ als lokalen JSON-Pfad fest. Docker:

```
docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build
```

Das Overlay wird schreibgeschützt unter dem Namen „`proxy-config`“ eingebunden; die Dateien müssen für die Container-UID 10001 lesbar sein. Dieses Verzeichnis ist von Git, dem Docker-Build-Kontext und den Quellarchiven ausgeschlossen. Dieser Katalog konfiguriert die Erfassungskonten; [der Witness-Bot](https://phishdestroy.io/tgwitness/de/docs/reference/witness/) verwendet seine eigene HTTP/SOCKS5-Route, nicht MTProxy.

Der direkte Fallback unterliegt dem oben beschriebenen IP-Modus. Unterbrechen Sie die Überwachung, bevor Sie eine Route ändern. Durch das Speichern werden alte Clients getrennt und unvollendete Anmeldungen abgebrochen; ein neuer Client verwendet die gespeicherte Route. Die Verknüpfung zwischen Konto und Protokoll/Sitzung bleibt bestehen. Einstellungen ersetzen die vorherige Route: Geben Sie die Proxy-Anmeldedaten bei der Bearbeitung erneut ein.

Anmeldedaten werden mit `network.enc` verschlüsselt. Die API gibt weder den Benutzernamen, noch das Passwort oder den geheimen Schlüssel zurück. Signierte Datensätze enthalten den Routentyp und die Angabe, ob Anmeldedaten vorhanden sind, wobei der Endpunkt und geheime Schlüssel ausgeschlossen sind. Der Betreiber kann den Endpunkt im Bedienfeld einsehen. Geheime Felder werden nach dem Speichern, Sperren oder Wechseln von Arbeitsbereichen gelöscht.

**Die Telegram-Verbindungsprüfung**, **die** auch vor der Anmeldung verfügbar ist, öffnet und schließt eine temporäre, nicht autorisierte Telegram-Verbindung über die Route. Es wird keine Verbindung zu einer IP-Prüfungs- Website hergestellt. Ein erfolgreicher Test stellt lediglich die Transportverbindung her, nicht jedoch den Zugriff auf Gruppen, die vollständige Zustellung oder Anonymität.

Der Proxy gilt für die Verbindungen des Telegram-Clients, einschließlich der Medien-Downloads von Telegram-DCs. Browser, pip, SSH und manuell aufgerufene TSA-Tools verfügen über separate Routen. Der Proxy-Hostname kann lokal aufgelöst werden. „`rdns`“ wirkt sich auf Ziel-Hostnamen aus; Telegram stellt häufig numerische DC-IP-Adressen bereit.

SOCKS5 und einfaches HTTP CONNECT verschlüsseln an sich weder die Proxy-Anmeldedaten noch den Tunnel zwischen Client und Proxy. MTProto schützt den Telegram-Datenverkehr separat. Verwenden Sie einen geeigneten sicheren Kanal zum Proxy in einem nicht vertrauenswürdigen Netzwerk. Private Gruppen sind Cloud-Chats, die während der Übertragung durch MTProto geschützt sind; End-to-End-Secret-Chats sind ein separater Chat-Typ, der vom [Secret-Chat-Modul](https://phishdestroy.io/tgwitness/de/docs/reference/secret-chats/) aufgezeichnet wird.

## Verschlüsselung und Signaturen

| Ebene | Umsgesetzt | Verantwortung des Betreibers |
| --- | --- | --- |
| Telegram-Datenverkehr | Telethon MTProto | Vertrauen in die Plattform, Übertragungsweg und Verfügbarkeit |
| Web-Panel | Bearer-Token, Standard-Loopback, Anforderungslimits | HTTPS oder SSH-Tunnel für den Fernzugriff |
| Geheimnisse | Fernet für API-Zugangsdaten, Sitzungsdaten, Proxy-Zugangsdaten und den privaten Signaturschlüssel | Schützen Sie den Entschlüsselungsschlüssel und den laufenden Host |
| Tresorschlüssel | Lokaler Schlüssel oder externer Hauptschlüssel für eine Neuinstallation | Getrennter, geschützter Speicher und Schlüssel-Backup |
| Nachrichten und Anhänge | Speicherung der Anwendung im Klartext | Verschlüsselte Festplatte/Datenträger |
| ZIP/JSONL/CSV/HTML | Integritätsprüfungen, keine Verschlüsselung der Inhalte | Schützen Sie exportierte Kopien und Übertragungen |
| Herkunft und Zeitpunkt | Signiertes Protokoll, Prozessbeleg, RFC 3161-Tools | Vertrauenswürdiger Schlüssel, unabhängige Kontrollpunkte/TSA und Aufbewahrungsverfahren |

**Der Speicherschutz** im Konto zeigt diese Zustände an. Das Panel-Token ist ein Zugriffsgeheimnis, kein Verschlüsselungspasswort. Es gewährt Administratorzugriff; [ausgestellte Token](https://phishdestroy.io/tgwitness/de/docs/reference/access/) können auf Konten und Chats beschränkt werden. Arbeitsbereiche teilen sich den Host-Prozess und sind keine isolierten Mandanten.

BitLocker, LUKS, FileVault oder ein verwaltetes verschlüsseltes Volume können Speichermedien im Rahmen ihrer jeweiligen Bedrohungsmodelle schützen. Ein Administrator eines entsperrten, laufenden Rechners kann die Daten weiterhin lesen. Berücksichtigen Sie SQLite-WAL/SHM, Medien, temporäre Exporte, Auslagerungsspeicher, Backups sowie Browser-Downloads bei der Speicherplanung. Ein Docker-Volume ist nicht allein deshalb verschlüsselt, weil es sich um ein Volume handelt.

## Externer Hauptschlüssel

Bei einer Neuinstallation legen Sie den Hauptschlüssel außerhalb des Datenverzeichnisses ab. Dadurch wird ein bestehender Tresor mit lokalem Schlüssel nicht automatisch migriert. Richten Sie ein Schlüsselverzeichnis ein, auf das nur die Dienstidentität Zugriff hat, und führen Sie anschließend folgenden Befehl aus:

```
python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key
export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key
python -m tgwitness --data-dir /private/observations/new-case
```

PowerShell unter Verwendung der installierten Projektumgebung:

```
python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key
$env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key'
python -m tgwitness --data-dir E:\PrivateData\new-case
```

Binden Sie die Datei in Docker schreibgeschützt außerhalb von „`/data`“ ein, beispielsweise unter „ `/run/secrets/tgwitness-master.key`“, und setzen Sie die Umgebungsvariable auf diesen Pfad. Die UID des Dienstes muss Lesezugriff darauf haben. Übergeben Sie den Pfad – nicht die Schlüsselbytes – über Umgebungs- bzw. Konfigurationsdateien.

Jeder Arbeitsbereich erhält ein zufälliges öffentliches Salt sowie einen eigenen Fernet-Schlüssel, der mittels HKDF-SHA256 abgeleitet wird. „`vault.external.json`“ speichert die Metadaten der Ableitung, nicht den Hauptschlüssel. Ein fehlender oder falscher Schlüssel führt zum Fehlschlagen des Startvorgangs, ohne dass dieser stillschweigend ersetzt wird. Bewahren Sie sowohl die Salt-Metadaten als auch den Hauptschlüssel zur Wiederherstellung auf.

Alle Arbeitsbereiche leiten sich vom selben Hauptschlüssel ab; dessen Kompromittierung wirkt sich auf die gesamte Installation aus. Der laufende Prozess kann Geheimnisse entschlüsseln. Es handelt sich hierbei nicht um ein HSM oder ein Passwort-KDF. Beliebige, von Menschen festgelegte Passwörter werden nicht anstelle eines Zufallsschlüssels akzeptiert.

Behalten Sie den bestehenden Schlüssel für bestehende Installationen bei, bis eine gezielte Migration durchgeführt und verifiziert wurde. Das Löschen von „`vault.key`“ oder das Ersetzen eines Hauptschlüssels kann den Zugriff auf Sitzungen/Signaturschlüssel zunichte machen. Bewahren Sie verschlüsselte Sicherungskopien und Schlüssel getrennt auf und testen Sie die Wiederherstellung in einer isolierten Instanz.
