HTTP 제어 API 및 웹 콘솔

[General]
external-http-controller = 127.0.0.1:9090
external-http-secret = your-secret-token
external-http-ui = true
external-http-cors = false

Chute는 Clash 및 Surge 대시보드와 유사한 내장 HTTP 제어 API 및 웹 콘솔을 제공합니다. API는 REST 엔드포인트를 통해 엔진 상태, 트래픽, 연결, DNS, 정책 제어 및 구성 관리를 노출합니다.

Surge의 http-api = <secret>@<host>:<port>는 external-http-controller와 external-http-secret으로 읽힙니다. 각 부분을 따로 적어도 됩니다. http-api-secret, http-api-ui, http-api-cors는 각각 external-http-secret, external-http-ui, external-http-cors로, http-api-web-dashboard도 external-http-ui로 읽히며, 구성은 external-http-* 키로 저장됩니다. http-api-tls는 지원되지 않고(컨트롤러는 평문 HTTP로 동작), 알림만 남깁니다.

external-http-controller (기본값: 비활성화)

external-http-controller = 127.0.0.1:9090

콘솔이 서비스하는 동안 메모리에 유지하는 요청은 macOS에서 4 MB, iOS·tvOS·Android에서 1 MB로 제한됩니다.

HTTP 제어 서버의 주소와 포트입니다. 로컬 전용으로 쓰려면 127.0.0.1을 사용하세요. 루프백이 아닌 주소(예: 192.168.1.5:9090)에 바인딩하려면 external-http-secret을 명시해야 합니다. 없으면 서버는 시작을 거부하고 무엇이 빠졌는지 로그에 남깁니다.

와일드카드 주소(0.0.0.0, ::, *)는 이 검사에서 루프백이 아닌 것으로 취급됩니다. 모든 인터페이스에서 수신하므로 로컬 전용의 정반대이기 때문입니다. 허용되는 표기는 0.0.0.0:9090, *:9090(같은 뜻), IPv6는 [::]:9090입니다 — 대괄호 없이 쓴 :::9090에는 대괄호가 자동으로 붙습니다. 파싱할 수 없는 주소는 컨트롤러를 조용히 꺼 두는 대신 구성 오류로 보고됩니다. 127.0.0.1뿐 아니라 127.0.0.0/8 전체가 루프백입니다.

external-http-secret (기본값: 자동 생성된 토큰)

external-http-secret = your-secret-token

API 인증에 사용하는 Bearer 토큰입니다. 요청에는 Authorization: Bearer <secret> 헤더가 있어야 합니다. 토큰은 이 헤더로만 받으며 쿼리 파라미터로는 받지 않고, 비교는 상수 시간으로 수행됩니다. 인증 실패는 401과 {"ok": false, "error": {"code": "unauthorized", "message": "missing or invalid token"}}을 반환합니다. 데이터를 다루는 경로는 모두 보호됩니다: /api/* 경로, Clash 호환 별칭, 그리고 Chute Android만 아직 제공하는 예전 경로들(/status, /policies, /dns, /records 등)로, 이들도 토큰을 이 헤더로만 받습니다. Chute Android 자체의 원격 대시보드는 이제 /api/* 경로만 씁니다. 웹 콘솔의 페이지와 정적 자원(/, /assets/…, Chute Android에서는 /ui도)에는 토큰이 필요 없습니다(external-http-ui = false이면 아예 사라져 페이지가 404가 됩니다).

이 키가 없으면 Chute는 인증 없이 서비스하는 대신 토큰을 생성합니다. 생성된 토큰은 Chute의 공유 폴더에 있는 control-token에 소유자만 읽을 수 있는 권한으로 기록되며 — 구성 파일 옆이 아니라 iOS와 tvOS에서는 App Group 컨테이너, Android에서는 앱의 비공개 데이터 디렉터리입니다 — 재시작 후에도 재사용되고 각 앱이 보여 줍니다 — 웹 콘솔 열기를 참고하세요. 제어 API는 연결 데이터베이스를 넘겨줄 수 있고, 그 기록에는 이번 실행에서 본 모든 URL과 헤더, 프로세스 이름이 담깁니다. 인증 없이 열린 컨트롤러는 합리적인 기본값이 아닙니다.

그래도 인증 없이 서비스하려면 구성에 분명히 적으세요:

external-http-secret = none

이 값은 루프백 바인딩에서만 허용됩니다. 루프백이 아닌 곳에서는 none도, 키를 빼는 것도 충분하지 않습니다. 제어 서버는 시작을 거부하고 무엇이 필요한지 알려 줍니다.

업그레이드 참고: external-http-secret이 없는 것을 '인증 없음'으로 사용해 왔다면 로컬 스크립트가 401을 받기 시작합니다. 앱에서 생성된 토큰을 읽거나, external-http-secret = none을 적어 기존 동작을 의도적으로 유지하세요.

external-http-ui (기본값: true)

external-http-ui = true

활성화되면 Chute는 컨트롤러 주소에서 내장 웹 콘솔을 제공합니다. 웹 콘솔은 개요, 연결 관리, DNS 검사, 트래픽 모니터링, 정책 제어 및 구성 편집을 제공합니다. false로 설정하면 API는 활성화된 상태에서 UI를 비활성화합니다.

웹 콘솔 열기

콘솔은 제어 서버 주소에서 제공되며, 각 앱이 주소와 토큰을 건네줍니다 — 자동 생성된 토큰까지 포함해서입니다. 그렇지 않으면 그 값을 읽을 방법이 없습니다:

  • Chute Mac: 메뉴 막대 → 웹 콘솔 열기, 그리고 웹 콘솔 토큰 복사. 연결 상세 창에도 요청 및 기록이 있어 콘솔을 엽니다 — 열리는 것은 홈이지 그 연결 자체는 아닙니다.
  • Chute iOS: 제어판 → 웹 콘솔 행 → 열기, 주소 복사, 액세스 토큰 복사.
  • Chute tvOS: 제어판에는 별도의 웹 콘솔 주소 행이 있어 호스트와 포트를 보여 줍니다. 선택하면 리스너에 다른 기기에서 접근할 수 있을 때 QR 코드를 표시하며 — 로그인 토큰은 화면이 아니라 코드 안에만 들어 있습니다 — 컨트롤러가 루프백에 바인딩되어 있으면 대신 설명을 보여 줍니다. 루프백 콘솔은 휴대전화에서 열 수 없기 때문입니다.
  • Chute Android: 제어판 → 웹 콘솔 주소 → 열기 또는 주소 복사, 그리고 누르면 복사되는 생성된 액세스 토큰 행. 토큰이 직접 설정한 시크릿이면 두 행 모두 나타나지 않으며, 그 시크릿은 결코 표시되지 않습니다.

이 진입점들이 만들어 주는 주소에는 토큰이 쿼리 파라미터로 담겨 있습니다. 페이지는 로드 시 그것을 소비하고 주소 표시줄에서 지우므로, 링크를 여는 것만으로 로그인이 끝나며 32자리 16진수를 옮겨 적을 필요가 없습니다.


external-http-cors (기본값: false)

external-http-cors = true

CORS(Cross-Origin Resource Sharing) 헤더를 API 응답에서 활성화합니다. 웹 콘솔 또는 서드파티 도구가 다른 오리진에서 API에 접근해야 할 때 유용합니다.

API 엔드포인트:

메서드 엔드포인트 설명
GET /api/status 런타임 상태, 포트, 가동 시간
GET /api/traffic 전체 및 정책별 트래픽 카운터
GET /api/connections 현재 활성 연결
DELETE /api/connections/:id 연결 종료
GET /api/connections/history 과거 연결 기록
GET /api/connections/processes 프로세스별 연결 통계
GET /api/connections/:id/request 연결에 대해 캡처된 요청 데이터
GET /api/connections/:id/response 연결에 대해 캡처된 응답 데이터
GET /api/dns DNS 캐시 레코드
DELETE /api/dns/cache DNS 캐시 삭제
DELETE /api/dns/records/:domain 단일 DNS 레코드 제거
GET /api/config 현재 구성
PUT /api/config 구성 재로드
POST /api/config/validate 구성을 파싱해 오류를 보고(로드하지는 않음)
GET /api/policies 정책 그룹 및 현재 선택. 각 항목에 hidden이 붙으며, hidden=true인 그룹은 true
PUT /api/policies/:group 정책 그룹 선택 변경
PUT /api/mode 아웃바운드 모드 설정
GET /api/features 기능 스위치 상태
PUT /api/features/mitm MitM 토글
PUT /api/features/record-traffic 트래픽 기록 토글
GET /api/rules 매처가 실제로 훑는 규칙 표, 각 규칙의 출처, 그리고 적중한 재작성 규칙
POST /api/rules/match 요청이 어디로 갈지, 실제로 보내지 않고 확인
GET /api/rules/user 실행 중에 추가한 규칙. 모듈과 구성보다 먼저 일치
PUT /api/rules/user 실행 중 규칙을 교체
POST /api/rules/user 실행 중 규칙 뒤에 규칙 추가
DELETE /api/rules/user 실행 중 규칙을 모두 제거
GET /api/logs 최근 로그 항목
GET /api/loglevel 현재 로그 수준과 기록 중인 섹션
PUT /api/loglevel 재시작 없이 로그 수준이나 섹션 변경
GET /api/health 엔진 상태: 거부 횟수, 세대, 메모리 사용량, 이전 종료
GET /api/events 이번 실행에서 주목할 사건
GET /api/tailscale Tailscale 엔진의 현재 상태
GET /api/scripts 요청에 따라 실행할 수 있는 generic 스크립트 목록
POST /api/scripts/run 이름으로 generic 스크립트 하나 실행
POST /api/diagnostics/ping ICMP 또는 TCP 도달성 검사
POST /api/diagnostics/dns-query 실행 중인 리졸버로 도메인 해석
POST /api/diagnostics/egress-probe 주소 확인: Apple 엔진에서는 기기 자신의 주소, Android에서는 프록시의 출구가 아니라 물리 네트워크에서의 기기 공인 주소
POST /api/diagnostics/internet-test 직접 인터넷 테스트: 프록시를 거치지 않고 internet-test-url 가져오기
POST /api/diagnostics/url-test/:policy 정책의 지연 시간 테스트 실행
POST /api/diagnostics/bundle 민감 정보를 지운 진단 아카이브 생성
GET /api/connections/export 연결을 HAR 1.2로 내보내기
GET /api/rewrites 모든 재작성/모의 응답 계열과 MitM 호스트 목록
GET /api/rewrites/:family 한 계열의 규칙
POST /api/rewrites/:family 규칙 추가
DELETE /api/rewrites/:family/:id 규칙 제거
DELETE /api/rewrites/:family 계열 비우기
GET /api/mitm/hosts 현재 복호화 중인 호스트
POST /api/mitm/hosts 호스트 추가
DELETE /api/mitm/hosts/:host 호스트 제거
DELETE /api/mitm/hosts 목록 비우기
GET /api/rules/providers 규칙 제공자와 규칙 세트, 각각의 상태 — 어떤 것이 왜 로드되지 않았는지 포함

엔드포인트 참고 사항:

  • GET /api/features는 각 스위치를 설정된 그대로 — record_traffic, mitm, mitm_h2, mitm_auto_quic_block, rewrite — 보고하고, licensed도 보고합니다. effective는 실제로 실행되는 것을 다섯 항목에 대해서만 알려 줍니다: record_traffic, mitm, rewrite, scripts, lan_proxy. 무료 에디션에서는 다섯 항목이 모두 false이므로, 스위치가 켜짐으로 읽히면서 해당 effective 항목은 false일 수 있습니다. inactive는 실행 중인 구성이 요구하지만 이 에디션에서는 실행되지 않는 것을 알려 주는 객체입니다: 개수 scripts, scriptRules, dnsScripts, rewrites, mapLocals와 플래그 mitm, bodyCapture, lanProxy, exitNode(Tailscale 광고. Chute Mac만 합니다)입니다. 라이선스가 있거나 엔진이 멈춰 있으면 모든 개수는 0이고 모든 플래그는 false입니다.
  • GET /api/connections는 limit(양의 정수, 기본값과 최대값 모두 1000)과 cursor(id가 커서보다 큰 연결만 반환)를 받습니다. 응답 data에는 connections, total, page_size, has_more, server_time이 담기고 — 더 많은 페이지가 있을 때는 — next_cursor도 담깁니다. since(초 단위, 이전 응답의 server_time)는 그 시점 이후 바뀐 연결만 반환하고, 지금 열려 있는 모든 연결의 id인 active_ids를 덧붙입니다: 이전 응답에 있었는데 여기에 없는 연결은 닫힌 것입니다. server_time보다 늦은 since는 0으로 간주되어 모든 연결이 반환됩니다.
  • GET /api/connections/history는 limit(기본값 100, 최대 1000)과 cursor/before(동의어; 둘 다 전달하면 거부됨)를 받습니다.
  • GET /api/connections/:id/request 및 .../response는 {"connection_id": <id>, "data": "<base64>"}를 반환합니다. 2 MiB보다 큰 캡처는 413을 반환합니다. Chute Pro가 없으면 둘 다 request data is not available 또는 response data is not available과 함께 403을 반환하며, 이전에 라이선스가 있던 실행 중 기록된 본문도 마찬가지입니다.
  • GET /api/config는 실행 중인 구성을 작성된 그대로, 자격 증명까지 포함해 반환합니다 — http-auth, external-http-secret, ca-p12, ca-passphrase, WireGuard 키, 그리고 모든 프록시의 비밀번호까지 — 따라서 제어 API에 접근할 수 있으면 이 모두에 접근할 수 있습니다. 자격 증명을 <redacted>로 바꾸는 것은 진단 번들뿐이며, 그 사본은 다시 로드할 수 없습니다: PUT /api/config로 보낸 구성의 어디에든 <redacted>가 남아 있으면 400으로 거부되고, 그런 첫 번째 줄을 알려 주는 메시지가 돌아옵니다. 대신 원래 구성을 제출하세요.
  • GET과 PUT /api/config는 /api/configs로도, 그리고 Clash 별칭 /configs로도 닿을 수 있습니다.
  • PUT /api/config는 JSON {"configuration": "<full text>"} 또는 요청 본문으로 전달된 원시 구성 텍스트를 받습니다(1 MB 제한). 성공하면 엔진이 다시 로드되며 — 실행 중이 아니었다면 시작됩니다.
  • PUT /api/policies/:group은 본문 키 policy, name, selected, select 중 첫 번째 것에서 선택 값을 가져옵니다; 값은 정책 이름이거나 문자열로 된 숫자 인덱스일 수 있습니다. 특수 그룹 이름 GLOBAL은 글로벌 선택 정책을 설정합니다.
  • GET /api/policies에서 모든 정책, 그룹, 그룹 멤버는 endpoint — 지금 이어지는 정책으로, 그룹을 따라가고 내장 PROXY를 거쳐 글로벌 모드용 선택 정책까지 따라간 결과 — 와 그 정책의 지연 시간인 endpoint_ping을 담습니다. 그룹 자신의 ping은 측정되지 않은 0이므로, 그룹이나 PROXY에서는 endpoint_ping을 읽어야 합니다.
  • PUT /api/mode는 JSON 숫자를 요구합니다: {"mode": 0} — 0 규칙, 1 다이렉트, 2 프록시.
  • PUT /api/features/mitm과 PUT /api/features/record-traffic은 {"enabled": true}를 받습니다.
  • GET /api/logs는 since(Unix 초)를 받습니다; 메모리 내 버퍼는 최근 1000개 항목을 유지하며, 각 항목은 {timestamp, wall_time, level, section, message}입니다 — timestamp와 wall_time은 같은 Unix 초 값을 담으며, 시계가 나아가지 않을 때는 항목의 순서가 엄격히 유지되도록 조금씩 앞으로 밀립니다.
  • GET /api/health는 엔진이 무엇을 붙들고 있는지, 마지막으로 무엇을 왜 거절했는지, 그리고 이전 실행이 어떻게 끝났는지(clean, unclean, suspected_memory — 문제 해결 참고)를 보고합니다. addressFamily는 Chute가 IPv6 출구를 어떻게 판단하는지 — ipv6가 healthy, confirming, degraded 중 무엇인지 — 와 그에 대해 한 일의 횟수를 알려 주며, Apple 엔진에서는 selfLoop가 자기 루프 방지 장치를 보고합니다. 둘 다 주소는 담지 않습니다.
  • GET /api/events는 메모리 링을 제공합니다. ?persisted=1은 이번 실행의 저장된 기록을 읽으며, 기록이 꺼져 있으면 available: false로 답합니다.
  • [Tailscale] 섹션이 없으면 GET /api/tailscale은 state: "idle"을 반환합니다. 오류가 아니라 정상적인 답입니다.
  • POST /api/diagnostics/* 검사들은 쿼리 문자열이나 JSON 본문에서 인자를 받고, 10초로 제한되며, 정확히 한 번만 응답합니다. url-test/:policy는 정의되지 않은 정책 이름을 거부하며 REJECT를 측정하지 않습니다.
  • GET /api/scripts는 활성화된 generic 스크립트를 {name, type}으로 나열합니다. POST /api/scripts/run은 본문이나 쿼리 문자열에서 name을 받고, 진단 검사들과 같은 시간 제한이 걸리며, {name, timedOut, result}로 답합니다 — timedOut은 $done을 끝내 부르지 않은 스크립트와 끝까지 실행된 스크립트를 구분해 줍니다. 활성화된 generic 스크립트가 아닌 이름은 404입니다. Chute Pro가 없으면 403, script is not available로 답합니다.
  • POST /api/rules/match는 연결을 열지 않고 요청이 어디로 갈지 답합니다. host(또는 호스트와 포트를 가져올 url. URL-REGEX 규칙은 이 url을 적힌 그대로 대조합니다(실제 트래픽에서는 평문 http:// 요청만 봅니다)), port(기본 443), 그리고 선택적으로 ip, protocol, process, process_path, src_ip, src_port, in_port, in_type, in_user, in_name, network, ssid, bssid, from_tun, user_agent를 받습니다 — 모르는 필드는 무시되지 않고 허용 목록과 함께 거부됩니다. 응답에는 matched 규칙(규칙 줄, 종류, 그것이 지목하는 정책, 그리고 그룹이 현재 가리키는 resolved_policy), policy, need_resolve, 그리고 계산의 근거가 된 rule_count와 match_generation이 담깁니다. 도메인은 두 번 — 이름으로 한 번, 주소를 알고 나서 다시 한 번 — 일치하므로 passes에는 패스마다 한 항목이 들어갑니다. ip를 주지 않으면 해석 전 패스만 존재하고, 응답이 note로 그렇게 말합니다. explain=true를 더하면 함께 일치할 수 있었던 후보 규칙을 최대 50개까지, 펼치지 않은 규칙 세트의 수와 함께 돌려줍니다.
  • POST /api/config/validate는 구성을 파싱한 뒤 버립니다: 실행 중인 엔진은 아무것도 받아들이지 않습니다. {"configuration": "<full text>"}로 보내거나 원문 텍스트를 그대로 보내세요. 응답은 valid, error_count, advisory_count, rule_count, policy_count, 그리고 {line, severity, content, error}로 이루어진 errors 목록입니다 — severity는 거부된 줄과 단서를 달아 받아들인 줄을 구분하고, content는 문제의 줄을 작성된 그대로 — 자격 증명까지 포함해서, 잘못된 [Proxy] 줄은 바로 비밀번호를 담는 필드가 잘못된 경우가 많기 때문입니다 — 4096자에서 잘라 담습니다. PUT /api/config 전에 쓰세요. 그쪽은 디버깅 중인 실행을 재시작시킵니다.
  • GET /api/loglevel은 현재 level, nslog_level, 파일에 기록 중인 sections, 그리고 설정할 수 있는 available_levels / available_sections를 보고합니다. PUT(또는 PATCH)은 level, sections 또는 둘 다를 받습니다: sections는 섹션 이름의 배열이거나 문자열 "all"이고, 빈 배열은 거부됩니다 — 기록을 멈추려면 level을 none으로 하세요. 이 방법으로 수준을 바꿔도 실행은 재시작되지 않으며, 그것이 요점입니다: 파일에 적은 loglevel = verbose는 재로드가 필요하고, 재로드는 보려던 것을 잃게 만듭니다.
  • GET /api/rules는 rewrite_hits도 함께 보고합니다 — 이번 실행에서 적용된 모든 재작성/모의 응답 규칙과 횟수입니다. 거기에 없는 규칙은 한 번도 일치한 적이 없습니다. 재작성이 아무 일도 하지 않는 것처럼 보이는 흔한 이유가 바로 이것입니다. 이 표는 서로 다른 규칙을 최대 512개까지 추적하며, 그 이상은 rewrite_hit_dropped_rules로 보고합니다. rules는 매처가 훑는 모든 규칙을 순서대로 나열합니다. Tailscale 자동 규칙, /api/rules/user로 추가한 규칙, 모듈 규칙, 구성의 [Rule] 섹션 순이며 마지막은 FINAL입니다. rule_regions는 각 줄의 출처를 같은 인덱스로 알려 줍니다(front, user, module, configuration).
  • /api/rules/user는 엔진 실행 중에 재로드 없이, 구성 파일을 건드리지 않고 추가한 규칙을 담습니다. 이 규칙은 Tailscale 자동 규칙 다음, 모듈 규칙과 구성의 [Rule] 섹션보다 앞에서 주어진 순서대로 일치합니다. GET은 이 규칙을 나열합니다. PUT은 교체하고 POST는 기존 규칙 뒤에 추가하며, 둘 다 {"rules": ["<rule line>", ...]} 또는 단일 {"rule": "<rule line>"}를 파일에 적는 것과 같은 형식으로 받습니다. DELETE는 모두 제거합니다. 쓰기는 전부 아니면 전무입니다: 파싱되지 않는 줄이나 FINAL이 있으면 400으로 거부되고 규칙은 그대로 남습니다. 실행 중인 구성에 정의되지 않은 정책을 가리키는 규칙은 받아들여지되 — REJECT로 닫힌 채 실패합니다 — warnings에 이름이 오릅니다. 기본값이 true인 close_rerouted는 바뀐 규칙이 다른 곳으로 라우팅하는 연결만 닫습니다; false면 모든 연결을 열어 둡니다 — DELETE에서는 ?close_rerouted=false로 넘기세요. 모든 메서드는 현재 rules로 답합니다. 규칙은 재로드를 거쳐도 유지되고 엔진이 멈추면 사라집니다. 이 경로에서는 PATCH를 받지 않습니다.
  • POST /api/rewrites/:family는 {"rule": "<configuration line>"}을 받습니다 — 파일에 적을 바로 그 텍스트입니다. 파싱되지 않는 줄은 400으로 거부되며, 결코 일치할 수 없는 규칙으로 저장되지 않습니다. :family는 url-rewrite, header-rewrite, body-rewrite, mock 중 하나입니다. 이렇게 추가한 규칙은 실행 중인 엔진에만 존재하며 구성 파일로 다시 쓰이지 않습니다.
  • GET /api/connections/export?format=har는 HAR 1.2 문서를, POST /api/diagnostics/bundle은 zip을 반환합니다. 둘 다 파일이므로 다른 엔드포인트와 달리 {"ok": ..., "data": ...} 봉투로 감싸지 않습니다. export는 source(기본 current, 또는 history), limit(기본 100, 최대 300), ids, 그리고 캡처된 페이로드를 포함하는 bodies=1을 받습니다. 각 항목에는 HAR에 대응 필드가 없는 정보 — 선택된 정책, 일치한 규칙, 적용된 재작성 — 가 _kl 객체로 담깁니다.
  • 체이닝된 연결의 GET /api/connections와 GET /api/connections/history 레코드에는 chainPath가 있습니다. 이 기기부터 출구까지의 경로로, 예를 들면 Airport/HK-01 → Landing입니다. 정책 하나만 쓴 연결에서는 비어 있으며, HAR 내보내기에서는 _kl.chain입니다. GET /api/traffic의 정책별 카운터에서는 상위 정책에도 체이닝된 연결을 위해 나른 바이트가 집계되며, 전체 합계에는 한 번만 집계됩니다.

예시 — 상태를 읽은 다음 정책 그룹을 전환합니다:

curl -H "Authorization: Bearer your-secret-token" http://127.0.0.1:9090/api/status
{"ok":true,"data":{"running":true,"outbound_mode":0,"mitm":false, ...}}

curl -X PUT -H "Authorization: Bearer your-secret-token" \
     -d '{"policy": "ProxyB"}' http://127.0.0.1:9090/api/policies/MainGroup
{"ok":true,"data":{"outbound_mode":0,"selectable_groups":[...], ...}}

예시 — 요청을 보내기 전에 그것이 어디로 갈지 묻습니다:

curl -X POST -H "Authorization: Bearer your-secret-token" \
     -d '{"url": "https://api.example.com/v1/orders", "explain": true}' \
     http://127.0.0.1:9090/api/rules/match
{"ok":true,"data":{"policy":"MainGroup","matched":{"rule":"DOMAIN-SUFFIX,example.com,MainGroup", ...}, ...}}

재현하는 동안 실행을 재시작하지 않고 로그를 한 하위 시스템으로 좁힙니다:

curl -X PUT -H "Authorization: Bearer your-secret-token" \
     -d '{"level": "verbose", "sections": ["MitM", "DNS"]}' \
     http://127.0.0.1:9090/api/loglevel

참고: 이 기능은 기본적으로 비활성화되어 있습니다. 모든 응답은 성공 시 {"ok": true, "data": {...}}, 오류 시 {"ok": false, "error": {"code": "...", "message": "..."}} 형식의 봉투(envelope)를 사용합니다; 요청 본문은 1 MB로 제한됩니다.

PUT 엔드포인트는 PATCH도 허용합니다. 서드파티 대시보드를 위해 Clash 호환 별칭 경로를 사용할 수 있습니다: /version, /traffic, /connections, /configs, /proxies, /rules — 경로에는 도달할 수 있지만, 응답은 Clash의 스키마가 아닌 Chute의 봉투와 필드 이름을 사용하므로(/version은 {"name", "run_id", "egress_probe"}를 반환하며, egress_probe는 Apple 엔진에서 network_address, Android 엔진에서 egress_ip입니다) Clash 대시보드가 바로 작동하지는 않습니다.

S. Smart Rabbit LLC © All Rights Reserved            updated 2026-11-19 16:07:28

이 페이지는 영어판의 번역본입니다. 내용이 다를 경우 영어판이 우선합니다.

results matching ""

    No results matching ""