파일 위치(macOS)
Chute Mac이 데이터를 어디에 두는지, 각 파일이 무엇을 위한 것인지, 무엇을 지워도 안전한지. Chute를 쓰기 위해 이 페이지를 읽을 필요는 없습니다 — 지원 문의에서 파일을 요청받거나, 디스크 공간이 문제가 되거나, 진단 번들이 무엇으로 만들어지는지 알고 싶을 때를 위한 것입니다.
macOS에서는 프록시 엔진이 Chute Mac 애플리케이션 안에서 직접 실행되므로, 아래의 모든 것은 앱이 사용자 본인의 계정으로 기록합니다. 향상 모드가 쓰는 PacketTunnel 시스템 확장은 패킷만 옮길 뿐 자체 데이터를 두지 않습니다.
데이터 폴더: ~/Chute
엔진이 처음 시작될 때 만들어집니다. 수명이 서로 다른 세 개의 하위 폴더가 있습니다.
Content/ — 실행 간에 유지됨
| 경로 | 담고 있는 것 |
|---|---|
GeoLite2-Country.mmdb |
GEOIP 규칙 뒤의 GeoIP 데이터베이스. Chute Mac은 앱 안에 사본을 함께 제공하며 이 파일이 없으면 그것을 씁니다. 여기에 놓은 파일이 그것을 대체합니다. |
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가 실행 중인 엔진과 통신하는 데 쓰는 로컬 소켓. 엔진이 실행 중일 때만 존재합니다. |
프록시 제공자 구독용 캐시는 따로 시스템 임시 디렉터리 아래 kl_proxy_providers/에 있습니다.
Share/ — 각 실행이 남긴 것
| 경로 | 담고 있는 것 |
|---|---|
control-token |
설정에 external-http-secret이 없을 때 HTTP 제어 API가 생성한 토큰. 소유자 전용 권한이며 재시작 후에도 재사용됩니다. 지우면 새로 생성됩니다. |
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를 지우지 마십시오: 현재 실행의 로그, 연결 데이터베이스, 제어 소켓이 거기에 있습니다.
이 페이지는 영어판의 번역본입니다. 내용이 다를 경우 영어판이 우선합니다.