TgWitness / Dokumentation

Was wurde getestet? →

Referenz / Einrichtung

Telegram · Verbindung, Proxys und Datenschutz

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

TgWitness / Dokumentation · Bereitstellung und Wiederherstellung

Bereitstellung und Wiederherstellung

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. Informationen zu Ereignisrichtlinien und zum Verhalten bei Neustarts finden Sie unter So funktioniert die Erfassung.

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 und wireproxy 1.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 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. 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.

Öffentliche Proxys, die von Ihrer Installation bereitgestellt werden#

Die integrierte Liste vereint sieben Quellen: SoliSpirit/mtproto, zakky8/mtproto-proxy-pro, kort0881/telegram-proxy-collector, 3yed-61/MTP-Collector, Therealwh/MTPproxyLIST, KhodeJav/telegram-proxy-collector und 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.

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 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 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 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 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.