ファイルの場所（macOS）
Chute Mac がデータをどこに置き、各ファイルが何のためにあり、何を削除しても安全か。Chute を使うためにここを読む必要はありません — サポートへの問い合わせでファイルを求められたとき、ディスク容量が気になったとき、あるいは診断バンドルが何から作られているかを知りたいときのためのページです。
macOS ではプロキシエンジンは Chute Mac アプリケーションそのものの中で動くため、以下はすべてアプリがあなた自身のユーザーアカウントで書き出すものです。拡張モードが使う PacketTunnel システム拡張はパケットを運ぶだけで、自身のデータは何も保持しません。
データフォルダー: ~/Chute
エンジンの初回起動時に作られます。寿命の異なる 3 つのサブフォルダーがあります。
Content/ — 実行をまたいで保持
| パス | 中身 |
|---|---|
GeoLite2-Country.mmdb |
GEOIP ルールの背後にある GeoIP データベース。Chute Mac はアプリ内に 1 部同梱しており、このファイルが無いときはそちらを使います。ここに置いたファイルがそれを置き換えます。 |
GeoLite2-ASN.mmdb |
IP-ASN ルールの背後にある ASN データベース。Chute Mac には同梱されていません — これらのルールを使うには MaxMind GeoLite2 ASN データベースをここに置いてください。 |
tailscale/ |
この端末の Tailscale ノード状態。[Tailscale] セクションを使ったときにだけ、所有者のみのパーミッションで作られます。削除すると、次回この端末は新しいノードとして tailnet に参加します。 |
Tmp/ — 作業領域
無ければ作り直されます。エンジン停止中なら削除しても安全です。
| パス | 中身 |
|---|---|
rule_sets/ |
ダウンロードした RULE-SET ファイル。ルールセットの update-interval ごとに、あるいはキャッシュが消えていれば次回起動時に取得し直されます。 |
ICON/ |
プロセスビューとトラフィックビューに表示されるアプリケーションのアイコン。 |
db.connect |
メニューバー、メインウィンドウ、Chute Dashboard が動作中のエンジンと通信するためのローカルソケット。エンジンの動作中にだけ存在します。 |
プロキシプロバイダーの購読用のもう 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 が残ります。各シャードの先頭行に、どの実行の何番目のシャードかが書かれています。ログを共有と診断バンドルが集めるのはこれです。 |
tunnel.db |
この実行の接続を記録した SQLite データベース — リクエストとレスポンスのヘッダー、タイミング、各接続を処理したルールとポリシー、書き換えの帰属 — に加えて events テーブル。コンソールの History（履歴） タブ、/api/connections/history、HAR エクスポートがこれを読みます。 |
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/PrivilegedHelperTools/com.R3Studio.ChuteHelper、/Library/LaunchDaemons/com.R3Studio.ChuteHelper.plist |
特権ヘルパーとその launchd ジョブ。拡張モードの Helper utun 方式のために必要に応じてインストールされます。 |
/Library/Application Support/Chute/ChuteMac_Proxy_Helper |
あなたに代わってシステムプロキシ設定を変更するヘルパー。 |
削除しても安全なもの
Tmp/全体。エンジン停止中に限ります。ルールセットとアイコンは必要に応じて再取得されます。- 動作中のエンジンが書き込んでいるもの以外の
Share/<run id>/フォルダー。実行を削除すると、そのログ、接続履歴、記録されたボディがまとめて消えます。 Share/control-token。新しいトークンが欲しいときに。ブックマークと保存済みのコンソールセッションは使えなくなります。Content/GeoLite2-Country.mmdb: アプリ内のコピーが引き継ぎます。GeoLite2-ASN.mmdbを削除するとIP-ASNルールは何も引けなくなります。
エンジンの動作中に ~/Chute を削除しないでください: 現在の実行のログ、接続データベース、コントロールソケットがそこにあります。
本ページは英語版からの翻訳です。内容に相違がある場合は、英語版が優先されます。