파일 위치(macOS)
Chute Mac이 데이터를 어디에 두는지, 각 파일이 무엇을 위한 것인지, 무엇을 지워도 안전한지. Chute를 쓰기 위해 이 페이지를 읽을 필요는 없습니다 — 지원 문의에서 파일을 요청받거나, 디스크 공간이 문제가 되거나, 진단 번들이 무엇으로 만들어지는지 알고 싶을 때를 위한 것입니다.
macOS에서는 프록시 엔진이 Chute Mac 애플리케이션 안에서 직접 실행되므로, 아래의 모든 것은 앱이 사용자 본인의 계정으로 기록합니다. 향상 모드가 쓰는 PacketTunnel 시스템 확장은 패킷만 옮길 뿐 자체 데이터를 두지 않습니다.
데이터 폴더: ~/Chute
Chute Mac이 엔진이 처음 시작되기 전에 빈 Content/와 함께 만들고, Tmp/와 Share/는 엔진이 시작할 때 만듭니다. 세 하위 폴더는 수명이 서로 다릅니다.
Content/ — 실행 간에 유지됨
| 경로 | 담고 있는 것 |
|---|---|
GeoLite2-Country.mmdb |
GEOIP 규칙이 사용하는 GeoIP 데이터베이스. Chute Mac은 앱 안에 사본을 함께 제공하며 이 파일이 없으면 그것을 씁니다. 여기에 놓은 파일이 그것을 대체합니다. |
GeoLite2-ASN.mmdb |
IP-ASN 규칙이 사용하는 ASN 데이터베이스. Chute Mac은 앱 안에 사본을 함께 제공하며 이 파일이 없으면 그것을 씁니다. 여기에 놓은 파일이 그것을 대신하므로 더 새로운 데이터베이스로 바꿀 수 있습니다. |
tailscale/ |
이 기기의 Tailscale 노드 키를 위한 대체 저장소. 소유자 전용 권한이며, 로그인 키체인을 쓸 수 없을 때만 사용됩니다. Chute Mac은 키를 키체인(서비스 com.r3.klnekit.tailscale)에 보관하고 여기서 발견한 키는 키체인으로 옮기므로, 이 폴더를 지워도 노드는 초기화되지 않습니다: 이 기기를 새 노드로 tailnet에 합류시키려면 해당 키체인 항목을 지우세요. |
Tmp/ — 임시 공간
없으면 다시 만들어집니다. 엔진이 멈춰 있는 동안에는 지워도 안전합니다.
| 경로 | 담고 있는 것 |
|---|---|
rule_sets/ |
내려받은 RULE-SET 파일. 규칙 세트의 update-interval마다, 또는 캐시가 사라졌으면 다음 시작 때 다시 받습니다. |
ICON/ |
프로세스 화면과 트래픽 화면에 표시되는 애플리케이션 아이콘. |
MitM/ |
HTTPS 복호화가 사용자의 CA로 발급하는 호스트별 인증서. CA마다 폴더 하나에 보관되며 실행 간에 재사용됩니다. 없어진 인증서는 다시 발급됩니다. |
db.connect |
Chute Dashboard가 실행 중인 엔진과 통신하는 데 쓰는 로컬 소켓. 엔진이 실행 중일 때만 존재합니다. Mac 앱 자체는 이를 거치지 않습니다 — 엔진을 앱 프로세스 안에 품고 직접 호출합니다. |
프록시 제공자 구독용 캐시는 따로 시스템 임시 디렉터리 아래 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를 담고 있습니다. 각 샤드의 첫 줄에 어느 실행의 몇 번째 샤드인지 적혀 있습니다. 로그 탭의 내보내기도, 메뉴의 진단 번들 저장…도 샤드를 통째로 담지 않습니다: 내보내기는 탭이 보여 주는 항목 — 최대 마지막 2,000개 중 필터를 거친 것 — 만 저장하고, 번들은 각 샤드의 마지막 512 KiB를 가져갑니다. 전체 로그가 필요하면 .log 파일 자체를 첨부하세요. |
tunnel.db |
이번 실행의 연결을 담은 SQLite 데이터베이스 — 요청과 응답 헤더, 타이밍, 각 연결을 처리한 규칙과 정책, 재작성 귀속 — 그리고 events 테이블. 콘솔의 History(기록) 탭, /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 이상에서 권한 있는 도우미의 launchd 작업. 앱 번들 안에서 SMAppService로 등록됩니다. 이 도우미는 시스템 프록시를 설정하는 주체이기도 하므로, 향상 모드의 Helper utun 방식일 때만이 아니라 엔진이 시작될 때마다 함께 시작됩니다. |
/Library/PrivilegedHelperTools/com.R3Studio.ChuteHelper, /Library/LaunchDaemons/com.R3Studio.ChuteHelper.plist |
macOS 12 이하에서 도우미가 설치되는 자리. macOS 13 이상에서는 여기서 발견한 도우미를 Chute가 교체합니다: 먼저 묻고(도우미 업데이트 필요), 도우미 업데이트를 누르면 이 파일들을 지우고 새 도우미를 설치합니다. |
/Library/Application Support/Chute/PreviousDNSInfo_<interface>.json |
향상 모드가 네트워크 서비스를 Chute로 돌리기 전에 그 서비스가 갖고 있던 DNS 서버. 인터페이스마다 파일 하나씩 도우미가 기록하며, 해제할 때 다시 읽어 원래대로 되돌립니다. |
지워도 안전한 것
Tmp/전체, 엔진이 멈춰 있는 동안. 규칙 세트와 아이콘은 필요할 때 다시 받습니다.- 실행 중인 엔진이 기록하고 있는 것을 제외한 모든
Share/<run id>/폴더. 실행 하나를 지우면 그 로그, 연결 기록, 기록된 본문이 함께 사라집니다. Share/control-token, 새 토큰을 원할 때. 북마크와 저장된 콘솔 세션은 더 이상 동작하지 않습니다.Content/GeoLite2-Country.mmdb와Content/GeoLite2-ASN.mmdb: 앱 안의 사본이 대신합니다.
엔진이 실행 중일 때는 ~/Chute를 지우지 마세요: 현재 실행의 로그, 연결 데이터베이스, 제어 소켓이 거기에 있습니다.
이 페이지는 영어판의 번역본입니다. 내용이 다를 경우 영어판이 우선합니다.