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.
Le dossier de données : ~/Chute
Chute Mac le crée, avec un Content/ vide, avant le premier démarrage du moteur ; le moteur ajoute Tmp/ et Share/ à son démarrage. Les trois sous-dossiers ont des durées de vie différentes.
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 selon l'update-interval du jeu de règles, 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 fait revenir la fenêtre de licence. |
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.mmdbetContent/GeoLite2-ASN.mmdb: les copies dans l'app prennent le relais.
Ne supprimez pas ~/Chute 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.