TgWitness / Documentation

Ce qui a été testé →

Certaines parties de cette page sont encore en anglais : le texte original en anglais a été modifié après sa traduction.

Référence / Configuration

Telegram · Déploiement

Exécutez TgWitness en tant que service sous Windows, Linux, macOS ou Docker, via HTTPS, avec des sauvegardes et des mises à jour.

TgWitness / Documentation

Déploiement et restauration

Anglais · Русский · Ukrainien · Español · Portugais (Brésil) · Türkçe · العربية · فارسی · Urdu · हिन्दी · Bahasa Indonesia · Tiếng Việt · Chinois simplifié

Choisissez une installation#

Pour le package portable, extrayez le fichier « TgWitness-<version>-windows-amd64-portable.zip » depuis GitHub Releases. Pour les autres méthodes, téléchargez et extrayez le fichier ZIP source ou clonez le dépôt, puis exécutez la commande suivante depuis le répertoire du projet :

Installation Début Fonctionne-t-il en arrière-plan ?
Pack portable pour Windows TgWitness.cmd Non ; veuillez laisser la fenêtre ouverte.
Natif Windows Start.cmd Non ; utilisez la tâche de connexion facultative pour une exécution en arrière-plan.
Natif sous Linux/macOS sh start.sh Non ; utilisez systemd/launchd pour une exécution en arrière-plan.
Docker sur n'importe quel hôte pris en charge docker compose up -d --build --wait Oui, tant que le démon Docker est en cours d'exécution.
Aide à l'utilisation de Docker sous Windows scripts\Docker.cmd Oui ; l’assistant attend que le serveur web soit opérationnel.
Aide à l'utilisation de Docker sous Linux/macOS sh scripts/docker-start.sh Oui ; l’assistant attend que le serveur web soit opérationnel.

Pour un serveur cloud pouvant être vérifié par un tiers — créé via l’ API du fournisseur, sans SSH, accessible uniquement via un tunnel Cloudflare —, veuillez consulter la section « Déploiement à haute sécurité ».

Le démarrage natif crée un fichier « .venv » privé et installe les dépendances épinglées. Docker les compile au sein de l’image, sans nécessiter Python sur l’hôte. La première configuration nécessite un accès à Internet. Si aucune version de Python 3.11 ou supérieure n’est détectée, Start.cmd vous demande votre accord avant d’installer Python 3.12 pour l’utilisateur Windows actuel (via winget, ou bien via le programme d’installation de python.org après vérification de la signature de la Python Software Foundation) ; il ne demande jamais de droits d’administrateur. Docker et les services du système d’exploitation restent des prérequis.

Les installations natives et portables utilisent « data/live » dans leur dossier. Docker utilise le volume nommé « tgwitness-data » à l’emplacement « /data ». Il s’agit d’installations distinctes jusqu’à ce que vous migriez délibérément l’ intégralité du répertoire de données. Ne vous attendez pas à ce qu’un nouveau conteneur Docker détecte automatiquement les comptes natifs.

Configuration requise#

L'installation native nécessite Python 3.11 ou une version ultérieure avec venv et ensurepip, un accès à Internet pour l'installation de la première dépendance, ainsi qu'un répertoire de projet accessible en écriture pour .venv. Le panneau fourni ne nécessite ni Node.js ni compilation front-end. Lancez le programme de démarrage depuis votre compte habituel sur le système d'exploitation ; TgWitness ne requiert pas de droits d'administrateur ou de root.

  • Windows : Start.cmd vérifie py -3, puis python, puis les dossiers d’installation par défaut par utilisateur et « Program Files », et nécessite la version 3.11 ou une version ultérieure. Si aucune de ces options ne fonctionne, il propose l’installation automatique par utilisateur décrite ci-dessus. py -3 start.py fonctionne également. Le package portable ne nécessite pas du tout Python.
  • Linux : start.sh tente python3.13, python3.12, python3.11, python3 et python, puis affiche la commande d'installation pour apt, dnf, pacman, zypper, apk ou Homebrew lorsqu'aucune ne correspond. Les installations Debian/Ubuntu peuvent nécessiter le paquet python3-venv correspondant à l'interpréteur sélectionné. L'ancienne version par défaut de Python d'une distribution doit être remplacée ou complétée par Python 3.11 ou une version ultérieure.
  • macOS : installez une distribution Python 3.11+ à jour ; ne partez pas du principe qu’un interpréteur fourni par le système d’exploitation répond aux exigences. Utilisez python3 start.py depuis le répertoire du projet.
  • Docker : utilisez Docker Engine/Desktop avec Compose v2.20 ou une version plus récente. Docker Desktop doit utiliser des conteneurs Linux sous Windows. Le conteneur installe ses propres dépendances Python ; l'hôte n'a pas besoin d'une installation Python distincte.

Ordinateur local#

Utilisez Start.cmd sous Windows ou sh start.sh sous Linux/macOS. scripts\Setup.cmd ou sh start.sh --setup-only permet de préparer l’environnement. Le lanceur installe les dépendances lors de la première utilisation ; les lancements suivants réutilisent l’environnement. Un accès à Internet est nécessaire pour la configuration et la collecte des données Telegram, mais la consultation des enregistrements existants et la création d’exportations fonctionnent hors ligne.

Exécutez la commande « python start.py --check » après l’installation pour vérifier les dépendances locales, Ed25519, le stockage, la configuration des clés et l’adresse d’écoute sans démarrer de collecteur. Utilisez --json pour obtenir une sortie structurée. Transmettez les commandes --data-dir, --host et --port prévues. Cette vérification n’installe pas de paquets, ne crée pas de journal et ne se connecte pas à Telegram ; il ne s’agit pas d’une qualification d’intégrité ou de couverture. Le démarrage vérifie séparément les journaux existants. python start.py --help évite également toute installation.

Après avoir exécuté start.py, lancez les commandes auxiliaires avec .venv\Scripts\python.exe sous Windows ou .venv/bin/python sous Linux/macOS, ou activez d'abord cet environnement. Les exemples python -m ... ci-dessous partent du principe que l'environnement est actif.

python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787

Variables d’environnement : TGWITNESS_DATA, TGWITNESS_HOST, TGWITNESS_PORT, TGWITNESS_TOKEN. TGWITNESS_VAULT_KEY_FILE sélectionne le mode clé externe pour une nouvelle installation ; voir Clé principale externe. TGWITNESS_TOKEN, s’il est fourni, doit contenir au moins 24 caractères ; utilisez une valeur aléatoire cryptographique. En son absence, l’application génère un jeton aléatoire de 256 bits dans le fichier panel-token.txt. La redéfinition via l’environnement ne réécrit pas ce fichier. Redémarrez pour renouveler les identifiants.

Un seul processus à la fois peut être propriétaire d’un répertoire de données. Un verrouillage de fichier multiplateforme au niveau du système d’exploitation empêche les écritures simultanées accidentelles. Utilisez un seul worker Uvicorn. Le panneau de configuration permet de gérer un nombre illimité d’ espaces de travail, avec des répertoires d’espaces de travail supplémentaires sous profiles/<id>/. Pour des instances de service distinctes, utilisez des répertoires et des ports distincts. Les fichiers WAL de SQLite doivent être stockés sur un support de stockage local persistant , et non sur un système de fichiers réseau. Ne partagez pas un même volume entre les répliques.

Pack portable pour Windows#

Chaque version GitHub comprend TgWitness-<version>-windows-amd64-portable.zip et son .sha256. Elle contient le runtime Python 3.12 officiel intégrable provenant de python.org (somme de contrôle fixée dans tools/build_portable.py), TgWitness et ses dépendances fixées, ainsi que trois lanceurs :

Fichier Objectif
TgWitness.cmd Lancez le panneau ; les options supplémentaires sont transmises, par exemple TgWitness.cmd --port 8790
TgWitness-Demo.cmd Lancez la démo synthétique à l'adresse data\demo
TgWitness-Check.cmd Lancez le contrôle de préparation sans démarrer

Le dictionnaire de morphologie russe épinglé et les profils de couleurs au format PDF sont intégrés pour une utilisation hors ligne. Le packaging n'autorise que leurs chemins d'accès connus à l'intérieur des répertoires de dépendances data ; la présence de fichiers inattendus dans ces répertoires entraîne l'échec de la compilation.

Décompressez l'intégralité de l'archive dans un dossier accessible en écriture, tel que « Documents\TgWitness » ; ne l'exécutez pas à partir du fichier ZIP ni du dossier « Program Files ». L'environnement d'exécution utilise un chemin d'accès isolé aux modules, de sorte que les autres installations Python et le dossier « PYTHONPATH » n'ont aucune incidence sur son fonctionnement. Les données sont conservées dans le dossier « data » du package. Pour effectuer une mise à jour, arrêtez TgWitness, extrayez la nouvelle version dans un nouveau dossier, puis copiez-y le dossier « data ».

Compilez-le vous-même sous Windows 64 bits avec Python 3.12 :

python tools/build_portable.py

Conteneur#

docker compose up -d --build --wait

Cela crée un volume persistant nommé pour /data. Le port web est mappé sur 127.0.0.1:8787. Le processus s’exécute sous l’UID 10001 avec des capacités supprimées, un système de fichiers racine en lecture seule, et des répertoires /data et /tmp accessibles en écriture. --wait vérifie l’état de santé du serveur web avant de renvoyer une réponse ; l’autorisation et la remise des messages Telegram s’affichent dans le panneau. Les utilitaires fournis utilisent un délai d’attente de 180 secondes après la compilation. Les téléchargements initiaux des dépendances peuvent prendre plus de temps que cela.

Les deux fichiers Compose de base utilisent le nom de projet « tgwitness » ; par conséquent, l’extraction d’une nouvelle version dans un autre répertoire ne sélectionne pas automatiquement un nouveau volume de données. Ne conservez qu’un seul déploiement actif pour ce projet. Pour les installations indépendantes, utilisez un « docker compose -p NAME ... » unique et un port hôte différent, et conservez les deux lors des mises à jour. Pour un déploiement plus ancien utilisant un nom de projet différent, continuez à utiliser son nom d’origine avec « -p » ; « docker compose ls » répertorie les projets existants.

Copiez deploy/env.example vers .env et modifiez TGWITNESS_PORT pour utiliser un autre port de bouclage. Par exemple, TGWITNESS_PORT=8788 expose le panneau à l'adresse http://127.0.0.1:8788 ; le conteneur reste à l'écoute sur le port 8787. .env est ignoré par Git.

Récupérer le jeton initial :

docker compose exec tgwitness cat /data/panel-token.txt

Commandes utiles :

docker compose ps
docker compose logs --tail 100 -f
docker compose stop
docker compose up -d --wait

restart: unless-stopped redémarre le collecteur après un plantage ou un redémarrage du démon Docker . Sur un serveur Linux, activez Docker au démarrage à l’aide du gestionnaire de services de votre distribution , généralement sudo systemctl enable --now docker. Sous Windows/macOS, activez le paramètre « Démarrer à la connexion » de Docker Desktop. La déconnexion du bureau, la mise en veille ou l’arrêt du peuvent interrompre la collecte. Un conteneur explicitement arrêté reste arrêté jusqu’à ce que vous le redémarriez.

Dans la configuration d’exemple, le volume /tmp est limité à 512 Mio. La création des exportations utilise plutôt le répertoire temporary-exports/ de chaque espace de travail, situé sur le volume persistant /data. Réservez de l’espace à cet endroit pour les exportations simultanées, la croissance du journal/WAL, les médias et les sauvegardes. Le lanceur utilise le fichier deploy/constraints.txt pour fixer les versions des dépendances d’exécution éligibles. Les serveurs Docker et à haute sécurité s’installent à partir des fichiers `deploy/requirements.lock` et `deploy/build.lock` avec `pip --require-hashes` : chaque fichier de paquet doit correspondre à une valeur SHA-256 enregistrée dans le commit, de sorte qu’un fichier remplacé sur PyPI ou un miroir est refusé. Les paquets qui ne fournissent que le code source (jieba, pyaes) sont compilés avec les setuptools fixés dans deploy/build.lock (--no-build-isolation) par le lanceur, le compilateur portable Windows et le Dockerfile, de sorte que pip ne résout pas un environnement de compilation distinct et non fixé. L’image de base Python et les paquets du système d’exploitation nécessitent toujours une qualification de version indépendante.

N’utilisez pas la commande « docker compose down -v » sauf si vous avez l’intention de détruire le journal et les clés. Le rapport d’état du conteneur indique la disponibilité du serveur web, et non la réussite de la capture des messages Telegram. Vérifiez l’état du collecteur, le signal de vie, les erreurs et les événements de couverture dans le panneau de contrôle.

Profil d’un témoin indépendant#

Le service optionnel witness exécute un témoin indépendant dans son propre conteneur, avec sa propre clé et son propre journal dans le volume witness-data, et uniquement un jeton de témoin en lecture seule pour le collecteur. Créez le jeton dans le panneau sous Plus d’outils → Extras → Témoin indépendant, ajoutez-le avec un jeton de bot et un canal dans .env, puis lancez le profil :

docker compose --profile witness up -d          # deploy/compose/compose.image.yaml: same flag
docker compose logs witness                     # witness key fingerprint

Le service accède au collecteur au sein du réseau Compose à l’adresse http://tgwitness:8787 (TGWITNESS_WITNESS_COLLECTOR le remplace, par exemple /profiles/<workspace ID> pour un autre espace de travail). Pour un témoin hébergé sur un serveur distinct, géré par un tiers, utilisez deploy/compose/compose.witness.yaml et définissez TGWITNESS_WITNESS_COLLECTOR sur l’adresse HTTPS du collecteur ; ce fichier ne contient que le témoin.

Installez une image publiée#

Copiez deploy/env.example vers .env. Définissez TGWITNESS_IMAGE sur la version publiée, en utilisant le chemin d'accès au dépôt en minuscules, par exemple :

TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3
TGWITNESS_PORT=8787

Exécutez ce fichier seul, à la place de compose.yaml :

docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait
docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt

Aucune compilation à partir du code source, ni Python, ni compilateur n’est nécessaire sur l’hôte. Le workflow de publication cible les conteneurs Linux AMD64 et ARM64, y compris la machine virtuelle Linux de Docker Desktop. Utilisez une balise de version ou « ghcr.io/owner/repository@sha256:... » issue du résumé du workflow. Aucune configuration de balise « latest » mobile ni de mise à niveau automatique de l’application n’est prévue. L’ image et les variantes de source utilisent le même volume de données lorsque leur nom de projet correspond.

HTTPS automatique sur un serveur#

Utilisez un serveur équipé de Docker, un nom de domaine que vous contrôlez et un stockage local persistant. Orientez les enregistrements A/AAAA du domaine vers le serveur ; ne publiez l’enregistrement AAAA que si l’IPv6 y accède. Autorisez le trafic entrant sur les ports TCP 80 et 443, ainsi que le trafic sortant DNS/HTTPS pour l’émission de certificats. Ces ports ne doivent pas être déjà utilisés par d’autres services.

Copiez deploy/env.example vers .env et définissez un nom d'hôte, sans schéma ni chemin d'accès :

TGWITNESS_DOMAIN=watch.your-domain.org

Lancez la compilation du code source avec la superposition HTTPS :

docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt
docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait

Pour une image publiée, utilisez plutôt deploy/compose/compose.image.yaml comme premier fichier. Conservez les deux arguments -f pour les commandes ultérieures de statut, de journalisation, de mise à jour et d’arrêt.

Caddy obtient et renouvelle un certificat, redirige le trafic HTTP vers HTTPS et transmet les requêtes au collecteur sur le réseau privé Compose. L’état du certificat dispose de son propre volume persistant. Le port hôte direct du collecteur reste réservé au loopback. La configuration Caddy fournie n’active pas la journalisation des accès.

Ouvrez https://watch.your-domain.org et saisissez le jeton du panneau. Vérifiez l’état de préparation des conteneurs ; l’émission des certificats et l’accessibilité externe dépendent du DNS et du pare-feu. Si le protocole HTTPS n’est pas opérationnel, vérifiez le DNS, les règles du pare-feu, ainsi que :

docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy

L'image Caddy fournie porte le tag « 2-alpine ». La commande « pull » actualise cette image ; épinglez un résumé testé dans votre déploiement si vous avez besoin de versions fixes de l'infrastructure.

Mises à jour et sauvegardes#

Conservez le nom du projet « Compose » et le volume de données lors des mises à jour. Arrêtez d’abord le collecteur et effectuez une sauvegarde complète. Pour le déploiement par défaut à partir du code source :

docker compose stop
docker compose cp tgwitness:/data ../tgwitness-backup-before-update

Utilisez à chaque fois une nouvelle destination de sauvegarde, en dehors du référentiel, et protégez-la comme du matériel d’accès au compte. Le chemin d’accès indiqué à titre d’exemple est donné à titre indicatif ; utilisez votre propre emplacement de sauvegarde privé. Copiez l’intégralité du répertoire, y compris les fichiers cachés, tous les espaces de travail, les clés, les journaux et les fichiers multimédias. Sauvegardez séparément la clé principale du coffre-fort externe si celle-ci est configurée. Un fichier ZIP de preuves n’est pas une sauvegarde d’application restaurable. Pour le protocole HTTPS, conservez également les volumes Caddy si vous devez préserver l’état de son certificat ou de son compte.

Pour un déploiement à partir du code source, procurez-vous les fichiers de la nouvelle version et exécutez la commande suivante :

docker compose up -d --build --wait

Pour le déploiement d’une image, remplacez TGWITNESS_IMAGE par la version souhaitée, puis exécutez :

docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait

Utilisez également le ou les fichiers Compose de votre installation pour les commandes « stop » et « copy » ci-dessus. Conservez .env, la configuration personnalisée et le même nom de projet. down conserve les volumes nommés ; down -v les supprime. Ne copiez pas .venv d’un système d’exploitation à l’autre ni d’une version de Python à l’autre. Pour les mises à jour natives, arrêtez TgWitness, sauvegardez l’intégralité de son répertoire de données, remplacez les fichiers source, puis exécutez python start.py --setup-only avant le redémarrage.

Vérifier l’accès au panneau, l’identité du compte, l’état des observations et la couverture après une mise à jour. Après le redémarrage, TgWitness reprend la position de mise à jour de Telegram enregistrée et demande les mises à jour manquées pendant la mise à jour. Une restauration peut nécessiter la sauvegarde antérieure à la mise à jour si une version future modifie les formats de stockage.

Serveur distant#

Limitez le service au loopback et utilisez un tunnel SSH, ou terminez la connexion HTTPS au niveau d’un proxy inverse. Le fichier Compose de base est accessible uniquement en local ; la superposition optionnelle deploy/compose/compose.https.yaml fournit Caddy pour un domaine configuré. Veillez à ce que le jeton « bearer » n’apparaisse pas dans les URL ni dans les journaux du proxy. Un proxy inverse doit limiter la taille des requêtes et le débit des connexions. N’exposez pas le protocole HTTP en clair sur Internet.

Des exemples concernant systemd, une tâche de connexion Windows, un agent utilisateur macOS et Caddy sont fournis dans le répertoire deploy/. Vérifiez et adaptez leurs chemins d’accès avant l’installation. Il s’agit de modèles fournis, et non de configurations de plate-forme exécutées localement. Aucun service ou tâche en arrière-plan n’est enregistré par le lanceur standard.

Sous Windows, un lancement de pythonw.exe sans fenêtre stocke les diagnostics de démarrage et du serveur dans logs/server.log, sous le répertoire de données (5 Mio par fichier, deux sauvegardes en rotation). Les lancements en mode console conservent les journaux de la console. La journalisation des accès HTTP est désactivée dans les deux modes. Protégez les journaux avec le répertoire de données et examinez-les avant de les partager.

Redémarrage et lacunes#

Le dernier état d’observation demandé est conservé. Si l’observation était active, le démarrage tente de se reconnecter et de reprendre les sources sélectionnées. Une mise en pause manuelle annule cette intention. Un redémarrage ayant échoué est enregistré et affiché dans le panneau.

TgWitness stocke la position de mise à jour de Telegram pour le compte et pour chaque chaîne (pts, qts, seq et date) dans le coffre-fort de l’espace de travail et la restaure au démarrage suivant. Le client demande alors les mises à jour manquées pendant l’arrêt du processus, et la vérification périodique récupère les messages manqués et enregistre ceux que Telegram ne renvoie plus. Les dialogues sont rechargés au démarrage. Chaque démarrage enregistre l’en-tête du journal précédent, la limite hors ligne et la position de mise à jour à partir de laquelle il a repris. Le moniteur vérifie la connectivité toutes les 10 secondes et ajoute un signal de vie toutes les minutes (Plus d’outils → Paramètres → Enregistrement de présence toutes les). Les déconnexions et les périodes de silence sont enregistrées comme des lacunes de couverture avec leur motif. Les instantanés de l’historique sont stockés sous forme d’observations distinctes de l’historique actuel à côté des enregistrements en temps réel.

La file d’attente des médias est stockée dans la base de données SQLite de chaque espace de travail. Un message et sa tâche sont validés de manière atomique. Les tâches en cours d’exécution qui ont été interrompues sont récupérées pour être réessayées au démarrage. Chaque téléchargement dispose d’un délai d’expiration de base de 120 secondes, auquel s’ajoute un temps de 256 KiB/s en fonction de sa taille, ainsi qu’une limite de 1 à 2,000 MiB par type de pièce jointe ; le délai d’expiration, la vitesse et les tentatives de réessai se configurent sous Plus d’outils → Paramètres. Le collecteur ignore les fichiers dont la taille est inconnue. La mise en pause conserve les tâches en file d’attente. Le réessai utilise le descripteur de fichier d’origine observé, jamais la dernière version d’un message modifié par la suite. Les échecs temporaires font l’objet d’un nombre limité de tentatives de réessai ; les pauses de FloodWait pour les médias sont conservées après le redémarrage. La récupération des médias est distincte de la récupération des mises à jour de Telegram et ne permet pas de recréer les fichiers disparus.

Sauvegarde, restauration et capacité#

tgwitness backup FOLDER copie le répertoire de données pendant que le panneau continue de fonctionner : les points de contrôle d'abord, puis les fichiers SQLite via l'API de sauvegarde en ligne, puis les clés, les médias et les profils, de sorte qu'aucun point de contrôle copié ne soit plus récent que le journal copié. Le fichier backup-manifest.json répertorie le SHA-256 de chaque fichier ainsi que les en-têtes de journal. Pour restaurer, arrêtez TgWitness et remplacez l’ intégralité du répertoire de données par ce dossier. Au démarrage suivant, le système enregistre que le journal a été restauré à partir d’une copie plus ancienne. Cet enregistrement compare le journal avec l’en-tête conservé dans TGWITNESS_STATE_DIR , un dossier situé en dehors du répertoire de données : le volume tgwitness-state dans Compose, /var/lib/tgwitness-state dans les unités systemd, et le dossier d’état local de l’utilisateur dans les autres cas. En l’absence de dossier d’état accessible en écriture, la restauration n’est pas détectée et le journal l’indique une seule fois.

Without the command, stop the process before copying the entire data directory, including vault.key, signing.enc, credentials.enc, SQLite database/WAL files, media, token, checkpoints, and all profiles/ subdirectories. Restore the complete copy while the destination service is stopped. Missing vault keys or signing-key mismatch cause startup to fail; do not regenerate keys to force access.

Conservez les sauvegardes secrètes chiffrées et soumises à un contrôle d’accès. Les fichiers ZIP de preuves sont des artefacts d’analyse portables, et non des sauvegardes d’application ou de session Telegram. Il n’y a pas de suppression automatique après une certaine durée de conservation. Prévoyez suffisamment d’espace disque pour tous les messages, les métadonnées brutes, les fichiers multimédias, les exportations temporaires et les sauvegardes.

Lancer la vérification et exporter les enregistrements de flux au lieu de charger l’intégralité du journal. Une exportation fige un instantané en lecture tandis que les nouvelles écritures WAL peuvent se poursuivre ; les exportations de longue durée peuvent conserver des pages WAL, la capacité du disque reste donc importante. Les fichiers ZIP sont limités à 4 Gio non compressés, conformément à la valeur par défaut du vérificateur indépendant ; Outils → Paramètres → Largest signed ZIP permet d’augmenter cette limite, et ces archives sont vérifiées avec verify.py --max-gib N. Les autres formats ne sont soumis à aucune limite de nombre d’événements. Les navigateurs pris en charge transmettent les blocs de réponse en flux continu vers un fichier sélectionné par l’utilisateur. Les autres navigateurs mettent en mémoire tampon au maximum 128 Mio et redirigent les transferts plus volumineux vers l’interface CLI authentifiée :

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

Utilisez --profile ID dans Exports → Workspace ID pour un autre espace de travail, --format zip|jsonl|csv|html ou --url https://your-server pour un serveur distant, ou --max-mib pour modifier la limite de transfert de 5 GiB. Le protocole HTTP simple n’est autorisé que pour le loopback. Les jetons transitent dans les en-têtes, les redirections sont refusées, les fichiers existants ne sont pas écrasés et les téléchargements incomplets ne sont pas publiés comme des fichiers terminés. Si TGWITNESS_TOKEN remplace le jeton généré, utilisez un fichier protégé séparément contenant cette valeur active : panel-token.txt n’est pas réécrit par la substitution. Le SHA-256 de la commande n’est qu’une somme de contrôle de transfert ; vérifiez indépendamment le fichier ZIP signé.

Le panneau affiche les médias en file d’attente ou ayant échoué, les médias en attente les plus anciens, l’espace disque disponible, les suspensions de requêtes Telegram, ainsi que les sources dont l’accès n’est pas confirmé. Ces diagnostics ne constituent pas un outil complet de surveillance de la transmission de bout en bout. Les espaces de travail partagent un même processus ; un compte générant beaucoup de trafic peut tout de même affecter les autres. Les processus de travail distincts, la conservation/rotation, la récupération durable des mises à jour et la qualification complète du déploiement restent d’actualité. L’accès limité au panneau est documenté dans la section « Accès et autorisations » ; les points de contrôle indépendants sont traités dans le guide du témoin.

Procédures détaillées : connexion/sécurité et modes de fonctionnement.