ファイルの場所（macOS）
Chute Macがデータをどこに置き、各ファイルが何のためにあり、何を削除しても安全か。Chuteを使うためにここを読む必要はありません — サポートへの問い合わせでファイルを求められたとき、ディスク容量が気になったとき、あるいは診断バンドルが何から作られているかを知りたいときのためのページです。
macOSではプロキシエンジンはChute Macアプリケーションそのものの中で動くため、以下はすべてアプリがあなた自身のユーザーアカウントで書き出すものです。拡張モードが使うPacketTunnelネットワーク機能拡張はパケットを運ぶだけで、自身のデータは何も保持しません。
データフォルダー: ~/Chute
Chute Macがエンジンの初回起動より前に、空の Content/ とともに作成し、Tmp/ と Share/ はエンジンが起動時に作ります。3 つのサブフォルダーはそれぞれ寿命が異なります。
Content/ — 実行をまたいで保持
| パス | 中身 |
|---|---|
GeoLite2-Country.mmdb |
GEOIP ルールの背後にあるGeoIPデータベース。Chute Macはアプリ内にコピーを同梱しており、このファイルが無いときはそちらを使います。ここに置いたファイルがそれを置き換えます。 |
GeoLite2-ASN.mmdb |
IP-ASN ルールの背後にあるASNデータベース。Chute Macはアプリ内にコピーを同梱しており、このファイルが無いときはそちらを使います。ここに置いたファイルがそれを置き換え、より新しいデータベースに差し替えられます。 |
tailscale/ |
この端末のTailscale ノードキーの予備の保存場所。所有者のみのパーミッションで、ログインキーチェーンが使えないときにだけ使われます。Chute Macはキーをキーチェーン（サービス com.r3.klnekit.tailscale）に保存し、ここで見つけたキーはキーチェーンへ移すため、このフォルダーを削除してもノードはリセットされません: この端末を新しいノードとしてtailnetに参加させるには、それらのキーチェーン項目を削除してください。 |
Tmp/ — 作業領域
無ければ作り直されます。エンジン停止中なら削除しても安全です。
| パス | 中身 |
|---|---|
rule_sets/ |
ダウンロードした RULE-SET ファイル。ルールセットの update-interval ごとに、あるいはキャッシュが消えていれば次回起動時に取得し直されます。 |
ICON/ |
プロセスビューとトラフィックビューに表示されるアプリケーションのアイコン。 |
MitM/ |
HTTPS復号があなたのCAで発行するホストごとの証明書。CAごとのフォルダーに保存され、実行をまたいで再利用されます。無いものは発行し直されます。 |
db.connect |
Chute Dashboard が動作中のエンジンと通信するためのローカルソケット。エンジンの動作中にだけ存在します。Mac版アプリ自身はここを通りません — エンジンをプロセス内でホストし、直接呼び出しています。 |
プロキシプロバイダーのサブスクリプション用のもう1つのキャッシュは、システムの一時ディレクトリ配下の kl_proxy_providers/ にあります。
Share/ — 各実行が生み出したもの
| パス | 中身 |
|---|---|
control-token |
設定に external-http-secret が無いときにHTTPコントロールAPI が生成したトークン。所有者のみのパーミッションで、再起動をまたいで再利用されます。削除すると新しいものが生成されます。 |
last-run.json |
実行マーカー: エンジン起動時に書かれ、30 秒ごとに現在のメモリ使用量で更新され、正常停止で削除されます。次回起動時にこれが残っていれば、Chuteは前回の実行が強制終了されたと判断します — コンソールのPrevious exit（前回の終了） カードと last_exit が報告しているのはこれです。 |
<run id>/ |
エンジンの起動 1 回につき 1 つのフォルダー。8 文字の実行 id で名付けられます。ログとトラフィックのウィンドウ、およびWebコンソールは現在のものを読みます。最新 10 個が保持され、それより古い実行フォルダーはエンジン起動時に削除されます。 |
実行フォルダーの中身:
| パス | 中身 |
|---|---|
<start time>.log、 <start time>.1.log、… |
セッションログ。8 MiBのシャードに分割されます。保持されるシャードは最大 8 個なので、長いセッションでは最後の 64 MiBが残ります。各シャードの先頭行に、どの実行の何番目のシャードかが書かれています。ログタブのエクスポートもメニューの診断バンドルを保存…も、シャードを丸ごとは含みません: エクスポートはタブに表示中のエントリ（最大で直近 2,000 件をフィルターした表示）を保存し、診断バンドルは各シャードの末尾 512 KiBを取り込みます。ログ全体が必要なときは .log ファイルそのものを添付してください。 |
tunnel.db |
この実行の接続を記録したSQLiteデータベース — リクエストとレスポンスのヘッダー、タイミング、各接続を処理したルールとポリシー、書き換えの帰属 — に加えて events テーブル。コンソールのHistory（履歴） タブ、/api/connections/history、HARエクスポートがこれを読みます。disable-db-record がオンのときは作られません。 |
DUMP/ |
リクエストとレスポンスのボディ。フォルダー自体は起動のたびに作られますが、ファイルが入るのは [Replica] の記録がオンのときだけです: <connection id>_send.dump、 <connection id>_receive.dump、そしてそれぞれの横にある .idx フレームインデックス。エンジンが停止すると削除されます。 |
アプリケーションのファイル
| パス | 中身 |
|---|---|
~/Library/Application Support/com.R3Studio.Chute-Mac/Profiles/ |
サブスクリプションURLや共有リンクからインポートしたプロファイルと、変換されたプロファイル。ディスクからインポートした設定ファイルは元の場所のまま参照され、ここにはコピーされません — クイックスタートを参照してください。 |
~/Library/Preferences/com.R3Studio.Chute-Mac.plist |
アプリの設定: 現在の設定ファイル、アウトバウンドモード、ウィンドウの状態、最近の実行 id の一覧。 |
~/Library/Application Support/com.R3Studio.Chute-Mac.key |
ライセンス証明書。情報のライセンスを取り消すでこれが削除され、ライセンスウィンドウが再び表示されます。 |
Chute.app/Contents/Library/LaunchDaemons/com.R3Studio.ChuteHelper.plist |
macOS 13 以降における特権ヘルパーの launchd ジョブ。アプリバンドルの中から SMAppService で登録されます。ヘルパーは拡張モードのHelper utun 方式のときだけでなく、エンジンの起動ごとに起動されます。システムプロキシを設定するのもこのヘルパーだからです。 |
/Library/PrivilegedHelperTools/com.R3Studio.ChuteHelper、 /Library/LaunchDaemons/com.R3Studio.ChuteHelper.plist |
macOS 12 以前でヘルパーがインストールされる場所。macOS 13 以降では、Chuteはここで見つけたヘルパーを置き換えます: まず確認を求め（ヘルパーの更新が必要です）、ヘルパーを更新でこれらのファイルを削除して新しいヘルパーをインストールします。 |
/Library/Application Support/Chute/PreviousDNSInfo_<interface>.json |
拡張モードがネットワークサービスをChuteに向ける前に、そのサービスに設定されていたDNSサーバー。インターフェースごとに 1 ファイルで、ヘルパーが書き出し、終了時に読み戻して元に戻します。 |
削除しても安全なもの
Tmp/全体。エンジン停止中に限ります。ルールセットとアイコンは必要に応じて再取得されます。- 動作中のエンジンが書き込んでいるもの以外の
Share/<run id>/フォルダー。実行を削除すると、そのログ、接続履歴、記録されたボディがまとめて消えます。 Share/control-token。新しいトークンが欲しいときに。ブックマークと保存済みのコンソールセッションは使えなくなります。Content/GeoLite2-Country.mmdbとContent/GeoLite2-ASN.mmdb: アプリ内のコピーが引き継ぎます。
エンジンの動作中に ~/Chute を削除しないでください: 現在の実行のログ、接続データベース、コントロールソケットがそこにあります。
本ページは英語版からの翻訳です。内容に相違がある場合は、英語版が優先されます。