Chute Dashboard

Chute Dashboard는 무료 macOS 앱으로, 실행 중인 Chute — Wi-Fi나 USB 케이블로 연결한 Chute iOS, 네트워크나 adb로 연결한 Chute Android, 또는 같은 Mac의 Chute Mac — 에 접속해 그 인스턴스가 무엇을 하고 있는지 보여 줍니다: 모든 연결과 그것을 결정한 규칙·정책, HTTPS 복호화 대상 호스트의 복호화된 요청과 응답, DNS 응답, UDP 세션. 보면서 트래픽을 바꿀 수도 있습니다: MitM 호스트 목록과 모든 재작성·모의 응답 규칙 계열을 실시간으로 편집할 수 있습니다.

이것은 웹 콘솔이 아닙니다. 콘솔은 엔진 자체가 제공하며 브라우저로 열지만, Dashboard는 별도의 앱으로 엔진의 바이너리 제어 채널을 통해 대화합니다. 그래서 기기에 필요한 것은 external-http-controller가 아니라 external-controller-access입니다. 둘은 겹치는 부분도 있고, 서로에게 없는 것도 있습니다 — Dashboard가 닿지 못하는 것을 보세요. 엔진과 같은 Mac에서 도는 Dashboard는 예외입니다: 엔진이 언제나 여는 로컬 소켓으로 접속하므로 아무 설정도 필요하지 않습니다.

Dashboard의 인터페이스는 이 매뉴얼과 같은 언어로 현지화되어 있습니다(아랍어 제외; 아랍어 시스템에서는 영어로 표시됩니다).

Dashboard 연결 허용하기

기기가 허락하기 전까지는 아무것도 수신 대기하지 않습니다.

Chute iOS — 구성 편집기에서 외부 컨트롤러를 엽니다:

1. 외부 컨트롤러 접근을 켭니다 — 각주에 Chute Dashboard/Chute CLI 연결 허용이라고 적힌 스위치입니다.
2. 포트와 비밀번호를 설정합니다. 비밀번호는 비워 둘 수 없고, 직접 정한 것이어야 합니다: 네트워크에서 접근할 수 있는 리스너는 빈 비밀번호나 기본 비밀번호로는 시작을 거부합니다.
3. 꼭 필요하지 않다면 Wi-Fi 접근 허용은 꺼 두세요. 꺼짐이 기본값이며, 리스너가 휴대전화 자체에만 머문다는 뜻입니다 — USB 케이블로는 닿지만 Wi-Fi의 다른 기기는 닿지 못합니다. 켜면 그 네트워크에서 비밀번호를 아는 누구나 이번 실행이 본 모든 것을 읽을 수 있습니다.
4. 저장한 뒤 터널을 시작(또는 재시작)합니다. 제어판에 외부 접근 포트: <port>가 표시됩니다 — 이 줄이 리스너가 올라왔다는 확인입니다.

Chute Mac — 같은 세 값이 [General]에 있습니다:

[General]
external-controller-access = password@127.0.0.1:6170

127.0.0.1은 지금 쓰는 Mac으로 한정하고, LAN 주소나 0.0.0.0으로 바꾸면 다른 기기에도 열립니다. 구성 창의 일반 섹션에 같은 키를 위한 필드가 있습니다. 같은 Mac에서 도는 Dashboard에는 이 키가 아예 필요 없습니다 — 아래의 로컬 컴퓨터에 연결을 보세요.

Chute Android — 구성 편집기에서 외부 컨트롤러를 열고 외부 접근에 같은 값을 적습니다:

• USB로 연결에는 password@127.0.0.1:6170이면 충분합니다: Dashboard가 그 포트에 대해 adb forward를 실행하고 케이블로 연결하므로, 리스너는 휴대전화 자체에만 머물러도 됩니다. 이를 위해서는 Mac에 adb가 있어야 하고 — Dashboard는 ANDROID_HOME과 ANDROID_SDK_ROOT 아래, PATH, /usr/local/bin과 /opt/homebrew/bin, 그리고 ~/Library/Android/sdk에서 찾습니다 — 휴대전화에서는 USB 디버깅이 켜져 있고 이 Mac이 허용되어 있어야 합니다.
• password@0.0.0.0:6170은 원격 컴퓨터에 연결을 위해 리스너를 네트워크에 엽니다. iOS와 마찬가지로, 네트워크에서 접근할 수 있는 리스너는 빈 비밀번호나 기본 비밀번호로는 시작을 거부합니다.

저장한 뒤 VPN을 시작(또는 재시작)합니다. 그러면 제어판의 외부 접근 스위치가 리스너가 수신 대기하는 주소를 보여 주고, VPN이 실행되는 동안 리스너를 끄고 켭니다.

연결하기

Dashboard는 새 대시보드 창으로 열립니다. 연결마다 창이 하나씩 생기므로 여러 기기를 동시에 열 수 있습니다. 들어가는 방법은 세 가지입니다:

원격 컴퓨터는 저장해야만 기억됩니다. 저장은 호스트·포트·비밀번호를 직접 정한 이름으로 보관하며, 다음에 저장된 원격 컴퓨터 탭에 나열되는 것이 그 이름들입니다.

비밀번호가 틀리면 창에 비밀번호가 일치하지 않음이 표시되며, USB든 네트워크든 같습니다. 기기에 닿지 않을 때도 창은 열리고 연결 중…을 표시합니다: USB로 연결한 iPhone은 Dashboard가 계속 재시도하는 동안 이 상태로 머물다가 휴대전화가 응답하거나 닫기를 누르면 끝나고, 그 밖의 연결은 결국 연결이 종료되었습니다로 끝납니다. 연결된 뒤 기기가 사라지면 — 터널이 멈췄거나, 케이블이 뽑혔거나, 휴대전화가 네트워크를 바꿨거나 — Dashboard 창은 연결이 종료되었습니다를 알리고 다시 연결을 제안합니다.

창

도구 막대는 다섯 보기 — 최근, 활성, DNS, UDP, MitM — 사이를 전환하고, 오른쪽의 필터 필드는 호스트 패턴을 찾는 검색 상자로 필터 막대와 값을 공유합니다. 그 막대는 최근과 활성에서만 따로 나타나고 DNS·UDP·MitM에서는 숨겨집니다. 왼쪽 아래 패널은 실시간 업로드·다운로드 속도이며, 누르면 그래프가 펼쳐집니다.

최근과 활성 보기에는 각각 새로고침 버튼이 있고, 최근에는 목록을 비우는 지우기가 하나 더 있습니다. 그 옆에는 실행 중인 엔진에 작용하는 스위치 두 개가 있으며, 앱의 스위치와 똑같이 동작합니다:

• 트래픽 캡처 사용 → 트래픽 캡처 사용 안 함: 요청과 응답 본문 캡처(replica 설정)를 켭니다. 없으면 행은 경로 정보와 함께 나타나지만 데이터 탭을 선택할 수 없습니다. 기기가 어느 쪽으로 설정되어 있는지 알려 주기 전까지 버튼에는 트래픽 캡처라고만 적혀 있습니다.
• MitM 사용(규칙 N개) → MitM 사용 안 함(규칙 N개): MitM 호스트 목록의 N개 호스트에 대해 HTTPS 복호화를 켭니다. 목록이 비어 있으면 개수는 빠집니다. 기기에 신뢰된 CA와 호스트가 하나 이상 있기 전까지 이 스위치는 실질적으로 아무것도 하지 않습니다 — HTTPS 복호화 페이지를 보세요.

두 스위치 모두 구성 파일을 수정하지 않습니다. 재시작하면 파일에 적힌 대로 돌아갑니다.

사이드바는 연결을 클라이언트별로 묶습니다: 모든 클라이언트, 그다음 기기 자체의 클라이언트인 로컬과 이 Chute를 프록시로 쓰는 다른 기기인 원격. 하나를 고르면 모든 목록이 거기로 좁혀집니다. 기기가 Chute Mac이면 로컬 클라이언트는 이름과 아이콘이 있는 응용 프로그램이며, 컨텍스트 메뉴에 Finder에서 보기가 있습니다.

활성과 최근

활성은 지금 열려 있는 것이고, 최근은 기기의 기록으로, 이번 실행의 기록에서 다시 읽어 와 연결 번호순으로 나열합니다 — 가장 새로운 것이 맨 아래입니다. 대신 열 머리글을 누르면 그 열로 정렬됩니다. 둘은 같은 열을 씁니다:

플래그 열은 작성한 규칙이 적용되고 있는지 가장 빨리 알 수 있는 방법입니다:

B는 본문 내용이 실제로 바뀌었는지만 봅니다: Chute가 규칙과 대조하려고 잡아 두기만 한 본문이나, 내용은 그대로 두고 청크를 다시 나누거나 다시 압축하기만 한 본문에는 붙지 않습니다.

최근은 최대 5,000행을 보관합니다. 목록 맨 아래의 이전 항목 불러오기가 기기에서 다음 페이지를 가져오고, 목록은 몇 초마다 스스로 새로 고쳐집니다. 활성 목록이 제어 패킷 하나에 담기지 않을 만큼 길면 표 아래에 엔진이 잘랐다는 안내가 나옵니다 — 그 행들은 기기에 있으며, 닫히면 최근에 나타납니다.

행을 오른쪽 클릭하면 curl 명령 복사, 선택 항목을 HAR로 내보내기… / CSV로 내보내기…, 모두 HAR로 내보내기… / CSV로 내보내기…, <host>(으)로 필터가 있습니다. 활성 행에는 기기에서 그 연결을 닫는 연결 종료도 있습니다. 여러 행을 선택한 범위 안에서 오른쪽 클릭하면 선택이 유지되므로 선택 항목을 HAR로 내보내기… / CSV로 내보내기…는 선택한 모든 행을 대상으로 합니다. 연결 하나에 대한 항목은 오른쪽 클릭한 행에 작용합니다. 네 항목이 더 있어 그 호스트에 대한 기기의 규칙에 작용하는데, 지금 보고 있는 연결에서 그것을 바꾸는 규칙까지 가는 가장 짧은 길입니다: <host>에 MitM 규칙 추가, <host>에 MitM 사용, <host>에 헤더 재작성 추가, <host>에 본문 재작성 추가.

주의: 한 행은 연결이지 요청이 아닙니다. 여러 요청을 실어 나른 keep-alive 연결도 여전히 한 행이며, 캡처된 데이터에는 그 메시지들이 잇따라 담겨 있습니다. 표시되는 헤더는 그중 한 요청의 것입니다. 따라서 브라우저가 페이지 하나를 열어도 페이지의 리소스 수보다 적은 행이 생깁니다.

필터 막대

필터 막대는 보이는 것을 좁힙니다. 기기가 무엇을 기록하는지는 바꾸지 않습니다 — 그건 기기의 [Replica]로 합니다.

필터 지우기로 전체로 돌아갑니다.

연결 상세

행을 선택하면 목록 아래의 패널에 상세 정보가 열립니다. 탭은 왼쪽부터:

일반 — 목록에 있는 것을 여유 있게 펼친 것: 연결 유형과 상태 코드, 아웃바운드 모드, 정책, 일치한 규칙, 전송량과 최대 속도, 로컬·원격 주소, 시작 시간, SSL/MitM 상태(가로챔, 헤더 수정됨, 본문 수정됨, 모의 응답 처리됨), 그리고 적용된 규칙 — 이 연결을 바꾼 재작성·모의 응답 규칙을 규칙 자신의 문장으로 인용한 것. 이 목록은 양쪽에서 잘립니다: 엔진은 연결당 최대 16건까지만 보관하고, Dashboard는 그중 8건을 보여 준 뒤 … N개 더를 덧붙입니다. 그래서 청크마다 적용되는 규칙 하나가 나머지를 밀어냅니다.

타이밍 — 연결을 준비하는 데 시간이 어떻게 쓰였는지, 엔진이 측정한 대로:

값이 0인 줄은 0으로 표시되는 대신 아예 빠지므로, 규칙에 주소가 필요 없던 연결에는 DNS 확인 줄 자체가 없습니다. 느린 요청은 대개 나머지 줄 중 정확히 하나만 느리며, 어느 줄인지가 어디를 봐야 하는지 말해 줍니다: DNS면 DNS 섹션, 원격 준비면 정책이나 그 뒤의 서버입니다.

요청 헤더 / 응답 헤더 — 헤더를 표로. 요청 쪽은 쿼리 매개변수와 쿠키를, 응답 쪽은 쿠키를 따로 보여 줍니다. 규칙이 수정한 헤더는 강조됩니다. 선택 항목 복사는 선택한 행을 복사합니다.

요청 데이터 / 응답 데이터 — 캡처된 본문을 16진수, 텍스트, JSON(검색이 있는 펼칠 수 있는 트리), 이미지(맞춤 / 실제 크기)로 봅니다. 본문이 무엇이든 텍스트로 열리며, multipart 본문은 부분별로 나뉩니다. bin으로 내보내기는 원시 바이트를 저장하고, 텍스트 보기에서는 Sublime Text나 VSCode가 설치되어 있으면 Sublime Text에서 열기와 VSCode에서 열기를 쓸 수 있습니다. 두 탭은 캡처된 데이터가 있을 때만 선택할 수 있습니다: 연결이 실행될 때 기록이 켜져 있었고, [Replica] 필터가 호스트를 통과시킨 경우입니다.

주의: 본문은 캡처된 그대로 표시됩니다. 압축된 응답 — Content-Encoding: gzip — 은 여기서 풀리지 않으므로 텍스트와 JSON 보기는 잡음이 됩니다. 16진수 보기와 bin으로 내보내기로 바이트를 꺼내 다른 곳에서 압축을 푸세요. 기기는 2 MiB보다 큰 본문을 넘겨주기를 거부하고 — 그러면 탭에 본문을 불러올 수 없습니다라고 표시됩니다 — 16진수 보기는 앞 1 MiB만 보여 줍니다.

DNS와 UDP

DNS는 기기 리졸버의 캐시입니다: 각 도메인과 그것이 해석된 주소, 가장 먼저 답한 서버(Chute는 설정된 모든 서버에 동시에 질의합니다 — DNS 참조), TTL, 그리고 그 레코드가 어디서 왔는지. 마지막 열은 출처 — Config, System, Dynamic — 이지 DNS 레코드 유형이 아닙니다. TTL은 최소 600초로 보고되므로 그보다 짧아도 600으로 보입니다.

오른쪽 클릭으로 도메인 복사, IP 복사, DNS 서버 복사, <domain>(으)로 필터를 할 수 있고, 동적으로 해석된 레코드에는 <domain>의 DNS 레코드 삭제도 있습니다. 맨 아래의 DNS 캐시 비우기는 캐시를 통째로 비웁니다. 뒤의 두 가지는 Dashboard가 보여 주는 화면이 아니라 기기의 캐시에 작용합니다.

UDP는 UDP 세션 — 호스트, 서버, 정책, 상태 — 을 나열합니다. UDP에는 본문이 없습니다.

MitM 도구

MitM 보기는 기기의 다섯 규칙 계열을 다섯 패널로 관리합니다: MitM 규칙, 헤더 재작성, 본문 재작성, 모의 응답, URL 재작성. 모두에 해당하는 것:

• 목록은 실행 중인 엔진이 가진 규칙 사본이며, 출발점은 구성 파일이 선언한 내용입니다.
• 규칙을 추가하면 기기로 보내지고, 기기는 구성 줄을 파싱하듯 파싱합니다. 파싱되지 않는 줄은 저장되지 않고 오류와 함께 거부됩니다. MitM 규칙의 호스트는 예외입니다 — 그것은 규칙 줄이 아니라 패턴이므로, 비어 있지 않은 문자열이면 입력한 그대로 덧붙습니다.
• 변경은 실행 중인 엔진에만 존재합니다. 구성 파일에 되쓰이지 않으며, 다시 로드하거나 재시작하면 파일에 적힌 대로 돌아갑니다. 패널로 동작하는 규칙을 찾은 뒤 구성에 적으세요.
• 규칙이 적용되는지는 목록의 플래그 열(R, K)과 상세 패널의 적용된 규칙에 나타납니다.

MitM 규칙 — 규칙 하나에 호스트 패턴 하나, host[:port][/path], 제외는 - 접두사: *.google.com, api.example.com:8443, api.example.com/v2/*, -*.apple.com. HTTPS 복호화 페이지의 hostname 키와 같은 문법입니다. 도구 막대 MitM 스위치의 숫자가 이 목록의 길이입니다.

헤더 재작성 — 양식: URL 정규식, 요청 또는 응답, 추가 / 대체 / 삭제 / 대체(정규식), 헤더 이름, 헤더 값. 대체(정규식)에서는 값 정규식도 입력하며, 헤더 값에서 그와 일치하는 부분이 대체 값으로 바뀝니다. 구성 줄은 Dashboard가 대신 만들어 줍니다. 문법은 헤더 재작성 페이지에 있습니다.

본문 재작성 — 파일에 쓰듯 구성 줄 하나를 입력합니다. 엔진이 읽는 표기는 다음과 같습니다: Surge의 http-response url-regex pattern replacement(또는 http-request)와 http-response-jq url-regex jq-program(또는 http-request-jq), url-regex response regex pattern replacement(또는 request), url-regex jsonpath-response jsonpath $.path value(또는 jsonpath-request). 본문 재작성을 보세요.

모의 응답 — URL 정규식, 응답 본문의 유형(file은 경로이며 찾아보기…를 쓸 수 있음, text, base64, 내용이 필요 없는 내장 1×1 투명 GIF인 tiny-gif), 선택 사항인 상태 코드, 선택 사항인 응답 헤더(|로 구분한 Name: Value).

주의: file 경로는 Chute를 실행하는 기기가 요청 시점에 읽습니다. Dashboard가 같은 기기의 Chute Mac에 연결되어 있을 때는 Mac의 경로가 의미가 있지만, iPhone에 연결되어 있을 때는 의미가 없습니다 — 휴대전화에는 /Users/…가 없습니다. 원격 기기에는 text나 base64를 골라 내용을 규칙에 담아 보내거나(모의 응답 참조), 파일을 URL로 제공하고 URL 재작성을 쓰세요.

URL 재작성 — URL 정규식, 대상, 유형: header는 요청을 그 자리에서 재작성하고(Surge의 Map Remote), 302와 307은 클라이언트를 리디렉션하며, reject, reject-200, reject-img, reject-dict, reject-array, reject-tinygif는 서버에 접속하지 않고 응답합니다. URL 재작성을 보세요.

내보내기

• HAR — 목록에서 오른쪽 클릭: 선택한 행 또는 전체를 HAR 1.2 파일로. 브라우저 개발자 도구(Network → 가져오기), Charles, Proxyman에서 열 수 있습니다. HTTP 요청이 캡처된 행마다 항목 하나이며, 그 밖의 행(예: 일반 TCP)은 빠지고 파일의 주석(comment)에 몇 개를 뺐는지 적힙니다. 기록이 켜져 있었다면 본문이 포함됩니다: Dashboard는 먼저 기기에서 본문을 가져오며, 그동안 HAR로 내보내는 중… — 기기에서 캡처된 본문을 가져오는 중입니다. — 이라는 시트를 진행 막대와 취소와 함께 보여 줍니다. 취소를 누르면 내보내기를 그만둡니다. 512 KiB를 넘는 본문은 크기만 기록되고, 한 번의 내보내기에는 본문이 최대 64 MiB까지 담깁니다.
• CSV — 스프레드시트용으로 고정된 열 집합: ID,Method,URL,Status Code,Status,Duration,Upload,Download,Process,Start Time. 목록의 열 그대로가 아니며, 날짜·클라이언트·서버·정책·플래그 열은 들어 있지 않습니다. Method는 요청의 메서드, URL은 전체 URL로, HAR 내보내기와 같습니다. HTTP 프록시를 거쳐 복호화되지 않은 HTTPS는 CONNECT와 https://host가 됩니다. HTTP 요청이 없는 행 — 일반 TCP나 TUN이 복호화하지 않고 전달한 HTTPS — 에는 대신 연결 유형과 호스트가 들어갑니다.
• curl 명령 복사 — 메서드, 헤더, 본문을 포함해 그 요청을 Mac에서 다시 보내는 curl 호출. 본문은 먼저 기기에서 가져옵니다. Content-Length는 curl이 계산하도록 둡니다. 터널일 뿐인 행 — 복호화되지 않은 CONNECT나 일반 TCP — 은 curl과 URL만 나옵니다.
• bin으로 내보내기 — 캡처된 그대로의 본문 하나.

Dashboard는 목록과 기기에서 가져온 본문으로 HAR를 만듭니다. 엔진도 콘솔의 Export HAR(HAR 내보내기)나 GET /api/connections/export?format=har로 직접 만들 수 있습니다 — 항목마다 _kl 객체에 일치한 규칙, 정책, 적용된 재작성을 담고, 송수신 타이밍은 캡처에서 가져옵니다.

Dashboard가 닿지 못하는 것

Dashboard는 엔진의 바이너리 제어 채널로 말하며, 엔진이 할 수 있는 것 중 일부는 HTTP 제어 API에만 있습니다. 이런 것에는 웹 콘솔이나 API를 쓰세요:

• 진단 번들, 상태, 거부 카운터, 이벤트;
• 콘솔 Rules 페이지의 규칙별 적용 횟수와 그것이 주는 이 규칙이 한 번이라도 적용되었나의 답;
• 위의 엔진 자체 HAR;
• 로그.

의지하기 전에 알아 둘 것이 하나 더 있습니다:

• iPhone, Apple TV, Android에서 HTTPS 복호화와 본문 캡처는 라이선스가 필요한 기능입니다. 라이선스가 없어도 Dashboard는 연결되고 모든 연결을 규칙·정책과 함께 보여 주지만, HTTPS 행은 결코 복호화되지 않고 — M 플래그가 없습니다 — 데이터 탭은 선택할 수 없습니다. iPhone과 Android에서는 앱의 MitM 스위치가 켜진 채로 있지 않고 대신 구매 안내가 나타나며, Apple TV의 제어 화면에는 MitM 줄 자체가 없습니다. 라이선스와 활성화를 보세요.