Emplacement des fichiers (macOS)

Où Chute Mac range ses données, à quoi sert chaque fichier et ce qui peut être supprimé sans risque. Rien ici n'a besoin d'être lu pour utiliser Chute — cette page est pour le moment où une demande de support réclame un fichier, où l'espace disque pose question, ou où vous voulez savoir de quoi est tiré un ensemble de diagnostic.

Sur macOS, le moteur proxy tourne dans l'application Chute Mac elle-même ; tout ce qui suit est donc écrit par l'app sous votre propre compte utilisateur. L'extension système PacketTunnel utilisée par le Mode amélioré ne fait que déplacer des paquets et ne conserve aucune donnée propre.

Les dossiers de données

Chute Mac conserve les données du moteur dans votre dossier Bibliothèque, que seul votre compte peut ouvrir. Les trois dossiers ont trois durées de vie différentes :

Dossier Emplacement
Content/, Share/ ~/Library/Application Support/com.R3Studio.Chute-Mac/
Tmp/ ~/Library/Caches/com.R3Studio.Chute-Mac/

Chute Mac crée les trois avant le premier démarrage du moteur, lisibles par vous seul, et exclut Share/ et Tmp/ des sauvegardes. Le Finder masque le dossier Bibliothèque : choisissez Aller › Aller au dossier… et collez le chemin.

Content/ — conservé d'une exécution à l'autre

Chemin Contenu
GeoLite2-Country.mmdb La base GeoIP derrière les règles GEOIP. Chute Mac en embarque une copie dans l'app et l'utilise quand ce fichier est absent ; un fichier placé ici la remplace.
GeoLite2-ASN.mmdb La base ASN derrière les règles IP-ASN. Chute Mac en embarque une copie dans l'app et l'utilise quand ce fichier est absent ; un fichier placé ici la remplace, ce qui permet d'utiliser une base plus récente.
tailscale/ Stockage de secours pour les clés de nœud Tailscale de cet appareil, avec des permissions réservées au propriétaire, utilisé seulement quand le trousseau de session est indisponible. Chute Mac conserve les clés dans le trousseau (service com.r3.klnekit.tailscale) et y déplace celles qu'il trouve ici ; supprimer ce dossier ne réinitialise donc pas le nœud : supprimez ces éléments du trousseau pour que l'appareil rejoigne le tailnet comme un nouveau nœud.

Tmp/ — espace de travail

Reconstruit dès qu'il manque ; peut être supprimé sans risque quand le moteur est arrêté.

Chemin Contenu
rule_sets/ Les fichiers RULE-SET téléchargés. Retéléchargés quand la configuration se charge avec une copie plus ancienne que l'update-interval du jeu de règles (l'ancienne copie continue de servir aux correspondances entre-temps), à la première correspondance une fois la copie devenue plus ancienne que cette valeur, après un téléchargement en échec (retenté avec un délai croissant), ou au prochain démarrage quand le cache a disparu.
ICON/ Les icônes des applications affichées dans les vues des processus et du trafic.
MitM/ Les certificats par hôte que le déchiffrement HTTPS émet avec votre CA, rangés dans un dossier par CA et réutilisés d'une exécution à l'autre. Ceux qui manquent sont émis à nouveau.
db.connect Le socket local par lequel Chute Dashboard dialogue avec le moteur en cours d'exécution. N'existe que pendant que le moteur tourne. L'app Mac elle-même ne passe pas par lui — elle héberge le moteur dans son propre processus et l'appelle directement.

Un second cache, pour les abonnements de fournisseurs de proxy, se trouve dans le répertoire temporaire du système sous kl_proxy_providers/.

Share/ — ce que chaque exécution a produit

Chemin Contenu
control-token Le jeton généré par l'API de contrôle HTTP quand la configuration ne nomme aucun external-http-secret. Permissions réservées au propriétaire ; réutilisé d'un redémarrage à l'autre. Supprimez-le pour en faire générer un nouveau.
last-run.json Le marqueur d'exécution : écrit au démarrage du moteur, rafraîchi toutes les 30 secondes avec l'empreinte mémoire courante, supprimé par un arrêt propre. Le retrouver au démarrage suivant est ce qui indique à Chute que l'exécution précédente a été tuée — c'est ce que rapportent la carte Sortie précédente de la console et last_exit.
<run id>/ Un dossier par démarrage du moteur, nommé d'après un id d'exécution de 8 caractères. Les fenêtres Journal et Trafic ainsi que la console web lisent dans le dossier courant. Les 10 plus récents sont conservés ; les dossiers d'exécution plus anciens sont supprimés au démarrage du moteur.

Dans un dossier d'exécution :

Chemin Contenu
<start time>.log, <start time>.1.log, … Le journal de session, découpé en fragments de 8 MiB. Au plus 8 fragments sont conservés, si bien qu'une longue session garde ses 64 derniers MiB ; la première ligne de chaque fragment indique à quelle exécution et à quel fragment elle appartient. Ni l'Exporter de l'onglet Journal ni l'Enregistrer l'ensemble de diagnostic… du menu n'emportent les fragments entiers : Exporter enregistre les entrées que l'onglet affiche — sa vue filtrée d'au plus les 2 000 dernières — et l'ensemble prend les 512 derniers KiB de chaque fragment. Joignez les fichiers .log eux-mêmes quand il faut le journal complet.
tunnel.db Une base SQLite des connexions de l'exécution — en-têtes de requête et de réponse, chronométrage, la règle et la politique qui ont traité chacune, attribution des réécritures — plus la table events. L'onglet Historique de la console, /api/connections/history et l'export HAR la lisent. Elle n'est pas créée quand disable-db-record est activé.
DUMP/ Les corps de requête et de réponse. Le dossier est créé à chaque démarrage, mais il ne contient de fichiers que pendant que l'enregistrement [Replica] est actif : <connection id>_send.dump, <connection id>_receive.dump, et un index de trames .idx à côté de chacun. Ils sont supprimés à l'arrêt du moteur.

Fichiers de l'application

Chemin Contenu
~/Library/Application Support/com.R3Studio.Chute-Mac/Profiles/ Les profils importés depuis une URL d'abonnement ou un lien de partage, et les profils convertis. Un fichier de configuration importé depuis le disque est référencé là où il est, pas copié ici — voir Premiers pas.
~/Library/Preferences/com.R3Studio.Chute-Mac.plist Les réglages de l'app : la configuration active, le mode de sortie, l'état des fenêtres, la liste des id d'exécution récents.
~/Library/Application Support/com.R3Studio.Chute-Mac.key Le certificat de licence. Révoquer la licence dans À propos le supprime et ramène Chute à l'édition gratuite ; l'app continue de tourner.
Chute.app/Contents/Library/LaunchDaemons/com.R3Studio.ChuteHelper.plist La tâche launchd de l'assistant privilégié sous macOS 13 et ultérieur, enregistrée depuis l'intérieur du paquet de l'app avec SMAppService. L'assistant est démarré à chaque démarrage du moteur, et pas seulement pour la variante Helper utun du Mode amélioré, car c'est aussi lui qui règle le proxy système.
/Library/PrivilegedHelperTools/com.R3Studio.ChuteHelper, /Library/LaunchDaemons/com.R3Studio.ChuteHelper.plist Là où l'assistant est installé sous macOS 12 et antérieur. Sous macOS 13 et ultérieur, Chute remplace un assistant trouvé ici : il demande d'abord (Mise à jour de l'assistant requise), et Mettre à jour l'assistant supprime ces fichiers et installe le nouveau.
/Library/Application Support/Chute/PreviousDNSInfo_<interface>.json Les serveurs DNS qu'un service réseau avait avant que le Mode amélioré ne le fasse pointer vers Chute, un fichier par interface, écrit par l'assistant et relu pour les rétablir au démontage.

Ce qui peut être supprimé sans risque

  • Tmp/ en entier, quand le moteur est arrêté. Jeux de règles et icônes sont retéléchargés au besoin.
  • N'importe quel dossier Share/<run id>/, sauf celui dans lequel le moteur en cours d'exécution écrit. Supprimer une exécution retire ensemble son journal, son historique de connexions et ses corps enregistrés.
  • Share/control-token, si vous voulez un nouveau jeton ; les signets et les sessions de console enregistrées cessent de fonctionner.
  • Content/GeoLite2-Country.mmdb et Content/GeoLite2-ASN.mmdb : les copies dans l'app prennent le relais.

Ne supprimez pas ces dossiers pendant que le moteur tourne : le journal, la base de connexions et le socket de contrôle de l'exécution courante y résident.

Déménager depuis ~/Chute

Les versions précédentes gardaient les trois dossiers dans ~/Chute, que les autres comptes du même Mac pouvaient lire. Quand Chute Mac démarre et y trouve des données, il propose de les déplacer avant que le moteur ne démarre :

  • Déplacer maintenant déplace tout le contenu de ~/Chute — y compris les fichiers que vous y avez placés vous-même, qui rejoignent Content/ dans le dossier Application Support — et le fusionne avec ce que contiennent déjà les nouveaux dossiers. Lorsqu'un élément du même nom existe des deux côtés, le plus récent est conservé et le plus ancien est placé dans la corbeille ; les anciens fichiers de cache de Tmp/ sont supprimés à la place. ~/Chute est supprimé une fois vide.
  • Les réglages qui désignaient un fichier dans ~/Chute, comme une configuration qui s'y trouvait, désignent désormais son nouvel emplacement. Une configuration dont le texte même cite un chemin dans ~/Chute n'est pas modifiée ; le résumé la liste pour que vous la corrigiez.
  • Ce qui n'a pas pu être déplacé reste dans ~/Chute, et Chute Mac propose de le déplacer à nouveau au prochain démarrage.
  • Plus tard continue d'utiliser ~/Chute, et Chute Mac redemande au prochain démarrage.

Chute Dashboard cherche le socket du moteur aux deux endroits ; une version plus ancienne de Chute Dashboard ne cherche que dans ~/Chute et ne peut plus se connecter localement une fois les données déplacées.

S. Smart Rabbit LLC © All Rights Reserved            updated 2026-11-19 16:07:29

Cette page est une traduction de la version anglaise. En cas de divergence, la version anglaise fait foi.

results matching ""

    No results matching ""