Installation, vérification et mise à jour

TgWitness / Documentation · Pour commencer

Projet · Mise en route rapide · Déploiement

Sur cette page

• Installation en une seule commande
• Où tout fonctionne
• Paramètres de recherche en texte intégral
• Accès en ligne de commande
• Vérifier avant l'exécution
• Mise à jour d'une installation existante
• Commandes courantes sous Ubuntu
• Supprimer TgWitness

Installation en une seule commande#

Le programme d'installation guidé inclut un environnement d'exécution Python privé. Utilisez la même adresse pour les futures installations : chaque publication met à jour le programme d'installation, les hachages, les signatures et les informations de compilation.

Linux / macOS (Bash) :

curl -fsSL https://get.destroy.tools/install.sh | bash

Sur un serveur Ubuntu, exécutez la commande en tant qu'administrateur pour installer un service en arrière-plan. Sur un ordinateur de bureau, exécutez la commande en tant qu'utilisateur normal.

Windows (PowerShell ou Invite de commandes) :

powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"

Aucun administrateur n’est nécessaire sous Windows. Le processus enfant PowerShell laisse votre terminal ouvert avec le résultat. Python et ses dépendances restent dans le répertoire d’installation.

Sous Ubuntu, choisissez « Cet ordinateur », « Lien HTTPS temporaire » ou « Propre domaine ». Le programme d'installation affiche l'adresse du panneau et la clé d'accès. Pour obtenir un lien temporaire, ouvrez cette adresse HTTPS dans votre navigateur et saisissez la clé. En cas d'accès local sur un serveur distant , utilisez un transfert SSH depuis votre ordinateur (ssh -L 8787:127.0.0.1:8787 user@server) et ouvrez http://127.0.0.1:8787. Sous macOS et Windows, le panneau local s’ouvre dans votre navigateur ; laissez son terminal en cours d’exécution.

Connectez-vous à Telegram dans le panneau et choisissez les éléments à collecter. L'installation seule ne lance pas la collecte sur Telegram.

Là où tout fonctionne#

get.destroy.tools Il s'agit d'un Cloudflare Worker servant des téléchargements statiques. Il ne contient ni panneau TgWitness, ni session Telegram, ni base de données de preuves utilisateur. Il n'est pas redirigé vers un VPS de projet. L'application s'exécute sur la machine où vous lancez la commande.

Cliquez TGWITNESS_INSTALL_DIR pour choisir un autre dossier. Les versions installées et les données sont séparées. Le programme d’installation ne télécharge pas vos comptes, messages ou clés vers le site de téléchargement. Choisir un tunnel Cloudflare achemine le trafic du panneau via Cloudflare ; utiliser votre propre domaine redirige vers votre propre serveur.

With TGWITNESS_TRUSTED_PROXIES, the panel accepts a single X-Forwarded-Proto: https from a trusted proxy to set Secure download cookies.

Chaque installation comprend les fichiers START-HERE.html et START-HERE.txt, contenant les chemins d'accès locaux, les commandes et les liens vers le dépôt. Exécutez tgwitness guide pour ouvrir le guide. Sous Windows, utilisez & "$env:LOCALAPPDATA\TgWitness\bin\tgwitness.cmd" guide dans PowerShell.

Paramètres de recherche en texte intégral#

La recherche en texte intégral (aperçu) ne nécessite aucune configuration. Son index est créé en arrière-plan après une mise à jour.

Le choix de l’administrateur dans Journal → Filtres → Index de recherche remplace la variable pour cet espace de travail. Les commandes recherchent le répertoire de données de l’installation qui les exécute ; ailleurs, ajoutez --data-dir le chemin d’accès à partir de tgwitness paths. Pour disposer d'un dictionnaire ukrainien complet (données sous licence GPL-3.0), installez pymorphy3-dicts-uk dans l’ environnement Python de l’installation.

Accès en ligne de commande#

La ligne de commande (aperçu) analyse l'archive à la recherche de scripts et d'agents.

Vérifier avant l'exécution#

La commande d'une ligne fait confiance au protocole HTTPS pour son script initial. Ce script vérifie SHA-256 ainsi que la signature RSA du projet sur l'application et les contraintes avant l'installation. Vous pouvez également télécharger et vérifier le script initial au préalable.

La clé publique de publication est release-signing.pub. Son SHA-256 est :

039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d

Conservez cette empreinte provenant d'une révision du dépôt à laquelle vous faites confiance. Une somme de contrôle provenant du même serveur de téléchargement détecte toute divergence ; la clé publique, dont la fiabilité est vérifiée de manière indépendante, permet d'authentifier la signature d'une version.

Utilisez un nouveau répertoire vide pour les téléchargements de vérification ci-dessous.

Linux / macOS — à exécuter dans un nouveau répertoire de téléchargement vide (nécessite curl et OpenSSL) :

curl -fSLO https://get.destroy.tools/install.sh &&
curl -fSLO https://get.destroy.tools/install.sh.sig &&
curl -fSLO https://get.destroy.tools/release-signing.pub &&
test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \
  '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' &&
openssl dgst -sha256 -verify release-signing.pub -signature install.sh.sig install.sh &&
bash install.sh

La && chaîne s'arrête avant l'exécution si un téléchargement, une vérification d'empreinte de clé ou de signature échoue. Si une publication a lieu entre le téléchargement du script et sa signature, téléchargez à nouveau les deux. Les anciens programmes d'installation conservent leurs URL de paquets immuables.

Windows — vérifiez l'SHA-256 avant de lancer l'application :

Invoke-WebRequest https://get.destroy.tools/install.ps1 -OutFile install.ps1 -UseBasicParsing
Get-FileHash .\install.ps1 -Algorithm SHA256
Invoke-RestMethod https://get.destroy.tools/SHA256SUMS.txt

Comparez le hachage avec la install.ps1 ligne. Pour une vérification indépendante de la signature, utilisez OpenSSL (par exemple, depuis Git Bash) et la même empreinte de clé publique que ci-dessus :

curl -fSLO https://get.destroy.tools/install.ps1 &&
curl -fSLO https://get.destroy.tools/install.ps1.sig &&
curl -fSLO https://get.destroy.tools/release-signing.pub &&
test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \
  '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' &&
openssl dgst -sha256 -verify release-signing.pub -signature install.ps1.sig install.ps1 &&
powershell.exe -NoProfile -ExecutionPolicy Bypass -File install.ps1

L'installation sous Windows vérifie elle-même les signatures des paquets à l'aide de .NET et ne nécessite pas OpenSSL. Il s'agit de signatures détachées RSA-3072 / SHA-256, et non d'Authenticode. Le manifeste enregistre la version du logiciel, le commit Git exact, l'ID de version immuable et l'SHA-256 de chaque artefact. La page renvoie vers la source correspondante. Le manifeste et la liste des sommes de contrôle comportent également des signatures détachées (manifest.json.sig et SHA256SUMS.txt.sig).

Mettre à jour une installation existante#

Une nouvelle publication met à jour le site de téléchargement ; les programmes installés se mettent à jour lorsque vous relancez le programme d’installation. Il n’y a pas de programme de mise à jour en mode silencieux ni de redémarrage automatique d’une collection en cours d’exécution. Le canal d’installation actuel est « preview » ; il suit les versions publiées et vérifiées provenant de main, dont le commit peut être plus récent que la dernière version numérotée sur GitHub. La version de la page provient de pyproject.toml; son commit et son identifiant de build permettent de distinguer les mises à jour au sein d’une même version « preview ».

La publication est automatique dès que ce commit précis a passé les contrôles d’application et de sécurité et que le paquet signé a réussi les tests d’installation sur le service Ubuntu et Windows PowerShell. Pendant l’exécution des contrôles, ou en cas d’échec de ceux-ci, les mêmes commandes continuent d’installer la version précédemment validée. Le manifeste de la version indique quel commit est actuellement disponible ; le numéro de version seul peut rester le même entre les mises à jour de préversion.

Utilisez le même dossier d’installation et le même utilisateur du système d’exploitation que précédemment. Sauvegardez l’intégralité du répertoire de données une fois la collecte arrêtée ; tgwitness paths qui l’identifie. Une exportation signée ne constitue pas une sauvegarde complète de l’installation.

Installation en tant qu’administrateur sur Ubuntu à l’adresse /opt/tgwitness:

curl -fsSL https://get.destroy.tools/install.sh | TGWITNESS_INSTALL_DIR=/opt/tgwitness bash -s -- --no-start

Une fois l'installation réussie :

/opt/tgwitness/bin/tgwitness restart
/opt/tgwitness/bin/tgwitness status
/opt/tgwitness/bin/tgwitness open

Pour une installation sur Linux/macOS, utilisez son TGWITNESS_INSTALL_DIR ou les paramètres par défaut, puis relancez la première commande d’installation. Fermez un panneau au premier plan avant la mise à jour, puis relancez-le après celle-ci. Pour un service Linux déjà configuré, exécutez sa tgwitness restart commande.

Windows : fermez le panneau en cours d'exécution, relancez la commande d'installation Windows, puis ouvrez bin\tgwitness.cmd dans la même installation. Le programme d’installation conserve les données, les sessions, les paramètres d’accès et les clés de signature. Il ne remplace le lanceur qu’une fois que le nouvel environnement a passé ses vérifications ; en cas d’échec de l’installation, l’ancien lanceur reste en place. Conservez la sauvegarde pré-mise à niveau en cas de modification du format de stockage.

Commandes courantes sous Ubuntu#

Consultez la section « Accès » pour les jetons de collègues, les sessions et les restrictions d’adresse IP, ainsi que la section « Publication de l’installateur » pour le workflow de publication de GitHub vers Cloudflare.

Supprimer TgWitness#

Il n'y a pas de programme de désinstallation : il suffit d'arrêter le panneau et de supprimer ses dossiers. La suppression du dossier « data » détruit définitivement les journaux, les clés de signature, les sessions Telegram et les fichiers enregistrés. Avant cela :

1. Exportez ce dont vous avez besoin (Exports → Télécharger ZIP signé) et conservez l’empreinte digitale de la clé de signature ainsi que les points de contrôle hors de cette machine. Pour conserver l’espace de travail lui-même, copiez l’intégralité du dossier de données après avoir arrêté la collecte.
2. Supprimez les serveurs créés sous « Extras → Server 24/7 » dans « Vos serveurs » ou via python -m tgwitness.cloud destroy; le fournisseur les facture jusqu’à ce qu’ils soient supprimés.
3. Mettez fin à la session de chaque compte dans Telegram via Paramètres → Appareils. La suppression des fichiers ne déconnecte pas la session côté Telegram.

Installation en tant qu’administrateur sous Ubuntu. Notez l’emplacement du dossier de données, arrêtez le service, puis supprimez le service, les dossiers et le raccourci :

/opt/tgwitness/bin/tgwitness paths
/opt/tgwitness/bin/tgwitness stop
systemctl list-unit-files 'tgwitness-*'
systemctl disable tgwitness-<ID>
rm /etc/systemd/system/tgwitness-<ID>.service
systemctl daemon-reload
rm -rf /opt/tgwitness /var/lib/tgwitness-<ID> /usr/local/bin/tgwitness

Installation pour les utilisateurs de Linux ou macOS. Fermez le panneau. Un service utilisateur Linux configuré est arrêté avec systemctl --user disable --now tgwitness-<ID>; son unité se trouve dans ~/.config/systemd/user/. Supprimez ensuite ~/.local/share/tgwitness (ou votre TGWITNESS_INSTALL_DIR) ainsi que le ~/.local/bin/tgwitness raccourci.

Windows. Fermez le panneau et supprimez %LOCALAPPDATA%\TgWitness (ou votre TGWITNESS_INSTALL_DIR). Le programme d'installation n'ajoute ni service, ni tâche planifiée, ni raccourci.