文件位置（macOS）

Chute Mac 把数据放在哪里、每个文件是做什么用的、哪些可以安全删除。使用 Chute 不需要读这一页——它是留给这样的时刻的：支持请求向你要某个文件、磁盘空间成了问题，或者你想知道诊断包是从哪些东西里取材的。

在 macOS 上，代理引擎运行在 Chute Mac 应用自身之内，所以下面的一切都是应用以你自己的用户账户写出来的。增强模式所用的 PacketTunnel 系统扩展只负责搬运数据包，自己不保存任何数据。

数据文件夹：`~/Chute`

引擎第一次启动时创建。它有三个子文件夹，对应三种不同的生命周期。

路径	存放的内容
`GeoLite2-Country.mmdb`	`GEOIP` 规则背后的 GeoIP 数据库。Chute Mac 在应用内自带一份，此文件不存在时就用那一份；放在这里的文件会取代它。
`GeoLite2-ASN.mmdb`	`IP-ASN` 规则背后的 ASN 数据库。Chute Mac 没有自带——把一份 MaxMind GeoLite2 ASN 数据库放在这里，这些规则才能用。
`tailscale/`	本设备的 Tailscale 节点状态，只在使用了 `[Tailscale]` 段时才会创建，权限仅限所有者。删掉它，设备下次会以新节点的身份加入 tailnet。

缺失时会自动重建；引擎停止期间可以安全删除。

路径	存放的内容
`rule_sets/`	下载下来的 `RULE-SET` 文件。按规则集的 `update-interval` 重新拉取；缓存没了，则在下次启动时重新拉取。
`ICON/`	进程视图与流量视图里显示的各个应用的图标。
`db.connect`	菜单栏、主窗口和 Chute Dashboard 用来与运行中的引擎通信的本地套接字。只在引擎运行期间存在。

另有一份缓存用于代理提供者订阅，位于系统临时目录下的 kl_proxy_providers/。

路径	存放的内容
`control-token`	配置里没有写 `external-http-secret` 时，HTTP 控制 API 生成的令牌。权限仅限所有者；重启后继续沿用。删掉它就会生成一个新的。
`last-run.json`	运行标记：引擎启动时写入，每 30 秒用当前内存占用刷新一次，正常停止时删除。下次启动时发现它还在，Chute 就知道上次运行是被杀掉的——这正是控制台的 Previous exit（上次退出）卡片和 `last_exit` 报告的依据。
`<run id>/`	引擎每启动一次就有一个文件夹，以 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`	特权 helper 及其 launchd 任务，在使用增强模式的 Helper utun 变体时按需安装。
`/Library/Application Support/Chute/ChuteMac_Proxy_Helper`	代你修改系统代理设置的 helper。

整个 Tmp/，在引擎停止期间。规则集和图标会按需重新获取。
任何 Share/<run id>/ 文件夹，除了运行中的引擎正在写的那一个。删除一次运行会把它的日志、连接历史和录制的报文体一并删掉。
Share/control-token，如果你想换一个新令牌；书签和已保存的控制台会话会随之失效。
Content/GeoLite2-Country.mmdb：应用内的那份会接管。删除 GeoLite2-ASN.mmdb 则会让 IP-ASN 规则无从查询。

引擎运行期间不要删除 ~/Chute：当前运行的日志、连接数据库和控制套接字都在那里。

本页为英文版的翻译。如内容有出入，以英文版为准。