Dateispeicherorte (macOS)
Wo Chute Mac seine Daten ablegt, wozu jede Datei dient und was sich gefahrlos löschen lässt. Nichts davon muss man lesen, um Chute zu benutzen — die Seite ist für den Moment gedacht, in dem eine Support-Anfrage nach einer Datei fragt, der Speicherplatz zur Frage wird oder Sie wissen wollen, woraus ein Diagnosepaket gespeist wird.
Auf macOS läuft die Proxy-Engine in der Chute-Mac-Anwendung selbst, sodass alles Folgende von der App unter Ihrem eigenen Benutzerkonto geschrieben wird. Die vom Erweiterten Modus verwendete PacketTunnel-Systemerweiterung bewegt nur Pakete und hält keine eigenen Daten.
Der Datenordner: ~/Chute
Chute Mac legt ihn vor dem ersten Start der Engine an, zusammen mit einem leeren Content/; Tmp/ und Share/ legt die Engine beim Start an. Die drei Unterordner haben drei verschiedene Lebensdauern.
Content/ — bleibt über Läufe hinweg erhalten
| Pfad | Inhalt |
|---|---|
GeoLite2-Country.mmdb |
Die GeoIP-Datenbank hinter GEOIP-Regeln. Chute Mac bringt eine Kopie in der App mit und verwendet diese, wenn die Datei fehlt; eine hier abgelegte Datei ersetzt sie. |
GeoLite2-ASN.mmdb |
Die ASN-Datenbank hinter IP-ASN-Regeln. Chute Mac liefert eine Kopie in der App mit und nutzt sie, wenn diese Datei fehlt; eine hier abgelegte Datei ersetzt sie — so lässt sich eine neuere Datenbank verwenden. |
tailscale/ |
Ersatzspeicher für die Tailscale-Knotenschlüssel dieses Geräts, mit Rechten nur für den Eigentümer, der nur verwendet wird, wenn der Schlüsselbund „Anmeldung“ nicht verfügbar ist. Chute Mac bewahrt die Schlüssel im Schlüsselbund auf (Dienst com.r3.klnekit.tailscale) und verschiebt alle, die es hier findet, dorthin; das Löschen dieses Ordners setzt den Knoten also nicht zurück: Löschen Sie diese Schlüsselbundeinträge, damit das Gerät dem Tailnet als neuer Knoten beitritt. |
Tmp/ — Arbeitsbereich
Wird neu aufgebaut, wann immer er fehlt; kann bei gestoppter Engine gefahrlos gelöscht werden.
| Pfad | Inhalt |
|---|---|
rule_sets/ |
Heruntergeladene RULE-SET-Dateien. Werden nach dem update-interval des Regelsatzes erneut geholt, oder beim nächsten Start, wenn der Cache fehlt. |
ICON/ |
Symbole der Anwendungen, die in der Prozess- und der Verkehrsansicht gezeigt werden. |
MitM/ |
Die hostbezogenen Zertifikate, die die HTTPS-Entschlüsselung mit Ihrer CA ausstellt, in einem Ordner je CA abgelegt und über Läufe hinweg wiederverwendet. Fehlende werden neu ausgestellt. |
db.connect |
Der lokale Socket, über den Chute Dashboard mit der laufenden Engine spricht. Existiert nur, während die Engine läuft. Die Mac-App selbst geht nicht darüber — sie beherbergt die Engine im eigenen Prozess und ruft sie direkt auf. |
Ein zweiter Cache, für Proxy-Provider-Abonnements, liegt im temporären Verzeichnis des Systems als kl_proxy_providers/.
Share/ — was jeder Lauf erzeugt hat
| Pfad | Inhalt |
|---|---|
control-token |
Das Token, das die HTTP-Control-API erzeugt hat, wenn die Konfiguration kein external-http-secret nennt. Rechte nur für den Eigentümer; wird über Neustarts hinweg wiederverwendet. Löschen Sie es, um ein neues erzeugen zu lassen. |
last-run.json |
Die Laufmarkierung: beim Start der Engine geschrieben, alle 30 Sekunden mit dem aktuellen Speicherbedarf aufgefrischt, bei einem sauberen Stopp gelöscht. Sie beim nächsten Start vorzufinden ist, woran Chute erkennt, dass der vorherige Lauf nicht sauber beendet, sondern abgebrochen wurde — genau das melden die Karte Letzte Beendigung der Konsole und last_exit. |
<run id>/ |
Ein Ordner pro Engine-Start, benannt nach einer 8-stelligen Lauf-ID. Die Fenster Protokoll und Datenverkehr sowie die Web-Konsole lesen aus dem aktuellen. Die jüngsten 10 werden behalten; ältere Laufordner werden beim Start der Engine gelöscht. |
In einem Laufordner:
| Pfad | Inhalt |
|---|---|
<start time>.log, <start time>.1.log, … |
Das Sitzungsprotokoll, in Shards von 8 MiB geteilt. Höchstens 8 Shards werden behalten, eine lange Sitzung hält also ihre letzten 64 MiB; die erste Zeile jedes Shards sagt, zu welchem Lauf und welchem Shard er gehört. Weder Exportieren im Tab Protokoll noch Diagnosepaket sichern … im Menü nehmen die Shards vollständig mit: Exportieren speichert die Einträge, die der Tab gerade zeigt — seine gefilterte Ansicht von höchstens den letzten 2.000 —, und das Paket nimmt die letzten 512 KiB jedes Shards. Hängen Sie die .log-Dateien selbst an, wenn das ganze Protokoll gebraucht wird. |
tunnel.db |
Eine SQLite-Datenbank der Verbindungen des Laufs — Anfrage- und Antwort-Header, Zeiten, die Regel und Richtlinie, die jede behandelt hat, Umschreibungs-Zuordnung — plus die Tabelle events. Der Tab Verlauf der Konsole, /api/connections/history und der HAR-Export lesen sie. Wird nicht angelegt, wenn disable-db-record aktiv ist. |
DUMP/ |
Anfrage- und Antwort-Bodys. Der Ordner wird bei jedem Start angelegt, enthält aber nur Dateien, während die [Replica]-Aufzeichnung läuft: <connection id>_send.dump, <connection id>_receive.dump und neben jedem ein .idx-Frame-Index. Sie werden gelöscht, wenn die Engine stoppt. |
Anwendungsdateien
| Pfad | Inhalt |
|---|---|
~/Library/Application Support/com.R3Studio.Chute-Mac/Profiles/ |
Profile, die aus einer Abonnement-URL oder einem Share-Link importiert wurden, sowie konvertierte Profile. Eine von der Festplatte importierte Konfigurationsdatei wird an ihrem Ort referenziert, nicht hierher kopiert — siehe Erste Schritte. |
~/Library/Preferences/com.R3Studio.Chute-Mac.plist |
Die Einstellungen der App: die aktive Konfiguration, der ausgehende Modus, der Fensterzustand, die Liste der letzten Lauf-IDs. |
~/Library/Application Support/com.R3Studio.Chute-Mac.key |
Das Lizenz-Zertifikat. Lizenz widerrufen unter Über löscht es und holt das Lizenzfenster zurück. |
Chute.app/Contents/Library/LaunchDaemons/com.R3Studio.ChuteHelper.plist |
Der launchd-Job des privilegierten Helfers ab macOS 13, aus dem App-Bundle heraus mit SMAppService registriert. Der Helfer wird bei jedem Start der Engine gestartet, nicht nur für die Variante Helper utun des Erweiterten Modus, denn er setzt auch den Systemproxy. |
/Library/PrivilegedHelperTools/com.R3Studio.ChuteHelper, /Library/LaunchDaemons/com.R3Studio.ChuteHelper.plist |
Wo der Helfer unter macOS 12 und älter installiert wird. Unter macOS 13 und neuer ersetzt Chute einen hier gefundenen Helfer: Es fragt zuerst (Aktualisierung des Helfers erforderlich), und Helfer aktualisieren entfernt diese Dateien und installiert den neuen. |
/Library/Application Support/Chute/PreviousDNSInfo_<interface>.json |
Die DNS-Server, die ein Netzwerkdienst hatte, bevor der Erweiterte Modus ihn auf Chute gelenkt hat — eine Datei je Schnittstelle, vom Helfer geschrieben und beim Abbau zurückgelesen, um sie wiederherzustellen. |
Was sich gefahrlos löschen lässt
Tmp/vollständig, bei gestoppter Engine. Regelsätze und Symbole werden bei Bedarf erneut geholt.- Jeder
Share/<run id>/-Ordner außer dem, in den die laufende Engine gerade schreibt. Das Löschen eines Laufs entfernt sein Protokoll, seine Verbindungshistorie und seine aufgezeichneten Bodys zusammen. Share/control-token, wenn Sie ein frisches Token möchten; Lesezeichen und gespeicherte Konsolensitzungen funktionieren dann nicht mehr.Content/GeoLite2-Country.mmdbundContent/GeoLite2-ASN.mmdb: Die Kopien in der App übernehmen.
Löschen Sie ~/Chute nicht, während die Engine läuft: Protokoll, Verbindungsdatenbank und Steuer-Socket des aktuellen Laufs liegen dort.
Diese Seite ist eine Übersetzung der englischen Version. Bei Abweichungen ist die englische Version maßgeblich.