Расположение файлов (macOS)
Где Chute Mac хранит свои данные, для чего нужен каждый файл и что можно безопасно удалить. Читать это, чтобы пользоваться Chute, не нужно — страница на тот случай, когда поддержка просит прислать файл, когда встаёт вопрос о месте на диске или когда вы хотите знать, из чего собирается диагностический пакет.
На macOS прокси-движок работает внутри самого приложения Chute Mac, поэтому всё перечисленное ниже приложение записывает под вашей учётной записью. Системное расширение PacketTunnel, которое использует Расширенный режим, только перемещает пакеты и своих данных не хранит.
Папка данных: ~/Chute
Создаётся при первом запуске движка. В ней три подпапки с тремя разными сроками жизни.
Content/ — сохраняется между запусками
| Путь | Что содержит |
|---|---|
GeoLite2-Country.mmdb |
База GeoIP, на которой работают правила GEOIP. Chute Mac несёт копию внутри приложения и использует её, когда этого файла нет; файл, положенный сюда, её заменяет. |
GeoLite2-ASN.mmdb |
База ASN, на которой работают правила IP-ASN. Chute Mac её не поставляет — положите сюда базу MaxMind GeoLite2 ASN, чтобы эти правила заработали. |
tailscale/ |
Состояние узла Tailscale этого устройства; создаётся только при использовании секции [Tailscale], с правами только для владельца. Если удалить, в следующий раз устройство войдёт в tailnet как новый узел. |
Tmp/ — рабочее пространство
Пересоздаётся, когда отсутствует; можно безопасно удалить при остановленном движке.
| Путь | Что содержит |
|---|---|
rule_sets/ |
Загруженные файлы RULE-SET. Перезагружаются по update-interval набора правил или при следующем запуске, если кэш пропал. |
ICON/ |
Значки приложений, показываемые в представлениях процессов и трафика. |
db.connect |
Локальный сокет, через который строка меню, главное окно и Chute Dashboard общаются с работающим движком. Существует только пока движок работает. |
Второй кэш — для подписок прокси-провайдеров — лежит во временном каталоге системы как kl_proxy_providers/.
Share/ — что произвёл каждый запуск
| Путь | Что содержит |
|---|---|
control-token |
Токен, который HTTP Control API сгенерировал, когда в конфигурации нет external-http-secret. Права только для владельца; переиспользуется между перезапусками. Удалите его, чтобы был сгенерирован новый. |
last-run.json |
Маркер запуска: записывается при старте движка, каждые 30 секунд обновляется текущим потреблением памяти, удаляется при чистой остановке. Обнаружив его при следующем старте, Chute понимает, что предыдущий запуск был убит — именно это сообщают карточка Previous exit (Предыдущее завершение) в консоли и last_exit. |
<run id>/ |
По одной папке на каждый старт движка, названной 8-символьным id запуска. Окна Лог и Трафик и веб-консоль читают из текущей. Хранятся 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, пока движок работает: там лежат журнал, база соединений и управляющий сокет текущего запуска.
Эта страница — перевод английской версии. При расхождениях приоритет имеет английская версия.