文件位置（macOS）

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

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

数据文件夹：`~/Chute`

Chute Mac 会在引擎第一次启动之前创建它，连同一个空的 Content/；Tmp/ 和 Share/ 由引擎在启动时建好。三个子文件夹对应三种不同的生命周期。

路径	存放的内容
`GeoLite2-Country.mmdb`	`GEOIP` 规则背后的 GeoIP 数据库。Chute Mac 在应用内自带一份，此文件不存在时就用那一份；放在这里的文件会取代它。
`GeoLite2-ASN.mmdb`	`IP-ASN` 规则背后的 ASN 数据库。Chute Mac 应用内自带一份，此文件不存在时使用自带的；放在这里的文件会替代它，可用于换成更新的数据库。
`tailscale/`	本设备 Tailscale 节点密钥的后备存储，权限仅限所有者，只在登录钥匙串不可用时才会用到。Chute Mac 把密钥存放在钥匙串里（服务名 `com.r3.klnekit.tailscale`），在这里发现的密钥也会被移进钥匙串，所以删掉这个文件夹并不会重置节点：要让设备以新节点的身份加入 tailnet，请删除钥匙串里的这些项目。

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

路径	存放的内容
`rule_sets/`	下载下来的 `RULE-SET` 文件。按规则集的 `update-interval` 重新拉取；缓存没了，则在下次启动时重新拉取。
`ICON/`	进程视图与流量视图里显示的各个应用的图标。
`MitM/`	HTTPS 解密用你的 CA 为各主机签发的证书，每个 CA 一个文件夹，跨运行复用。缺少的会重新签发。
`db.connect`	Chute Dashboard 用来与运行中的引擎通信的本地套接字。只在引擎运行期间存在。Mac 应用自己不走它——引擎就在它自己的进程里，直接调用即可。

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

路径	存放的内容
`control-token`	配置里没有写 `external-http-secret` 时，HTTP 控制 API 生成的令牌。权限仅限所有者；重启后继续沿用。删掉它就会生成一个新的。
`last-run.json`	运行标记：引擎启动时写入，每 30 秒用当前内存占用刷新一次，正常停止时删除。下次启动时发现它还在，Chute 就知道上次运行是被杀掉的——这正是控制台的上次退出卡片和 `last_exit` 报告的依据。
`<run id>/`	引擎每启动一次就有一个文件夹，以 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` 表。控制台的历史标签页、`/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 及更新系统上特权 Helper 的 launchd 任务，由应用包内部通过 `SMAppService` 注册。Helper 在每次引擎启动时都会启动，不只是在用增强模式的Helper utun变体时——系统代理也是它设置的。
`/Library/PrivilegedHelperTools/com.R3Studio.ChuteHelper`、`/Library/LaunchDaemons/com.R3Studio.ChuteHelper.plist`	macOS 12 及更早系统上 Helper 的安装位置。在 macOS 13 及更新系统上，Chute 会替换在这里找到的 Helper：先询问你（需要更新 Helper），更新 Helper会删掉这些文件并安装新的 Helper。
`/Library/Application Support/Chute/PreviousDNSInfo_<接口>.json`	网络服务在被增强模式指向 Chute 之前使用的 DNS 服务器，每个接口一个文件，由 Helper 写入，并在拆除时读回来还原。

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

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