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 대시보드가 바로 작동하지는 않습니다.
이 페이지는 영어판의 번역본입니다. 내용이 다를 경우 영어판이 우선합니다.