파일 위치(macOS)
Chute Mac이 데이터를 어디에 두는지, 각 파일이 무엇을 위한 것인지, 무엇을 지워도 안전한지. Chute를 쓰기 위해 이 페이지를 읽을 필요는 없습니다 — 지원 문의에서 파일을 요청받거나, 디스크 공간이 문제가 되거나, 진단 번들이 무엇으로 만들어지는지 알고 싶을 때를 위한 것입니다.
macOS에서는 프록시 엔진이 Chute Mac 애플리케이션 안에서 직접 실행되므로, 아래의 모든 것은 앱이 사용자 본인의 계정으로 기록합니다. 향상 모드가 쓰는 PacketTunnel 시스템 확장은 패킷만 옮길 뿐 자체 데이터를 두지 않습니다.
데이터 폴더
Chute Mac은 엔진의 데이터를 '라이브러리' 폴더에 보관하며, 이 폴더는 사용자 계정만 열 수 있습니다. 세 폴더는 수명이 서로 다릅니다:
| 폴더 | 위치 |
|---|---|
Content/, Share/ |
~/Library/Application Support/com.R3Studio.Chute-Mac/ |
Tmp/ |
~/Library/Caches/com.R3Studio.Chute-Mac/ |
Chute Mac은 엔진이 처음 시작되기 전에 세 폴더를 모두 만들어 본인만 읽을 수 있게 하고, Share/와 Tmp/는 백업에서 제외합니다. Finder에서는 '라이브러리' 폴더가 숨겨져 있습니다: 이동 › 폴더로 이동…을 선택하고 경로를 붙여 넣으세요.
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를 무료 에디션으로 되돌립니다; 앱은 계속 실행됩니다. |
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에서 옮기기
이전 버전은 세 폴더를 ~/Chute에 두었고, 같은 Mac의 다른 계정도 읽을 수 있었습니다. Chute Mac은 시작할 때 그곳에 데이터가 있으면 엔진을 시작하기 전에 옮길지 묻습니다:
- 지금 옮기기는
~/Chute의 모든 항목 — 직접 넣어 둔 파일도 포함하며, 이 파일들은 Application Support 폴더의Content/옆으로 갑니다 — 을 옮기고 새 폴더에 이미 있는 항목과 병합합니다. 양쪽에 같은 이름의 항목이 있으면 더 최신 항목을 남기고 오래된 항목은 휴지통으로 옮깁니다.Tmp/의 오래된 캐시 파일은 대신 삭제합니다. 비게 된~/Chute는 삭제됩니다. ~/Chute안의 파일을 가리키던 설정(그곳에 둔 구성 등)은 새 위치를 가리키도록 바뀝니다. 구성 파일 본문에~/Chute경로가 적혀 있으면 수정하지 않으며, 결과 화면에 그 구성이 표시되므로 직접 고치면 됩니다.- 옮기지 못한 항목은
~/Chute에 남고, Chute Mac은 다음에 시작할 때 다시 옮기기를 제안합니다. - 나중에를 선택하면
~/Chute를 계속 사용하고, 다음에 시작할 때 다시 묻습니다.
Chute Dashboard는 두 위치 모두에서 엔진의 소켓을 찾습니다. 이전 버전의 Chute Dashboard는 ~/Chute만 찾으므로 데이터를 옮긴 뒤에는 로컬로 연결할 수 없습니다.
이 페이지는 영어판의 번역본입니다. 내용이 다를 경우 영어판이 우선합니다.