HTTP-Control-API und Web-Konsole
[General]
external-http-controller = 127.0.0.1:9090
external-http-secret = your-secret-token
external-http-ui = true
external-http-cors = false
Chute bietet eine eingebettete HTTP-Control-API und eine Web-Konsole, ähnlich wie Clash- und Surge-Dashboards. Die API stellt Engine-Status, Verkehr, Verbindungen, DNS, Richtliniensteuerungen und Konfigurationsverwaltung über REST-Endpunkte bereit.
Surges http-api = <secret>@<host>:<port> wird als external-http-controller plus external-http-secret gelesen. Ein Profil darf die Teile auch getrennt schreiben: http-api-secret, http-api-ui und http-api-cors werden als external-http-secret, external-http-ui und external-http-cors gelesen, http-api-web-dashboard ebenfalls als external-http-ui; gespeichert wird die Konfiguration mit den external-http-*-Schlüsseln. http-api-tls wird nicht unterstützt — der Controller spricht unverschlüsseltes HTTP — und erzeugt nur einen Hinweis.
external-http-controller (Standard: deaktiviert)
external-http-controller = 127.0.0.1:9090
Die Anfragen, die die Konsole während des Betriebs im Speicher hält, sind auf 4 MB unter macOS und 1 MB unter iOS, tvOS und Android begrenzt.
Adresse und Port des HTTP-Controllers. Für rein lokalen Zugriff 127.0.0.1 verwenden. Eine Bindung an eine Adresse außerhalb von Loopback (etwa 192.168.1.5:9090) verlangt ein ausdrückliches external-http-secret — ohne dieses verweigert der Server den Start und protokolliert, was fehlt.
Eine Wildcard-Adresse (0.0.0.0, ::, *) gilt bei dieser Prüfung als nicht-Loopback: Sie lauscht auf allen Schnittstellen, also dem Gegenteil von „nur lokal“. Akzeptierte Schreibweisen sind 0.0.0.0:9090, *:9090 (dasselbe) und für IPv6 [::]:9090 — ein nacktes :::9090 wird automatisch eingeklammert; eine Adresse, die sich nicht parsen lässt, wird als Konfigurationsfehler gemeldet, statt den Controller stillschweigend ausgeschaltet zu lassen. Als Loopback gilt der gesamte Bereich 127.0.0.0/8, nicht nur 127.0.0.1.
external-http-secret (Standard: ein generiertes Token)
external-http-secret = your-secret-token
Das Bearer-Token für die API-Authentifizierung. Anfragen müssen den Header Authorization: Bearer <secret> enthalten — das Token wird nur in diesem Header angenommen, nie als Query-Parameter, und in konstanter Zeit verglichen. Fehlgeschlagene Authentifizierung liefert 401 mit {"ok": false, "error": {"code": "unauthorized", "message": "missing or invalid token"}}. Geschützt ist jede Datenroute: /api/*, die Clash-kompatiblen Aliase und die älteren Routen, die nur noch Chute Android anbietet (/status, /policies, /dns, /records und ähnliche) — auch sie nehmen das Token nur in diesem Header an. Das eigene Remote-Dashboard von Chute Android nutzt inzwischen nur noch die /api/*-Pfade. Die Seite und die statischen Dateien der Web-Konsole (/, /assets/…, unter Chute Android zusätzlich /ui) brauchen kein Token (mit external-http-ui = false gibt es sie gar nicht — die Seite ist ein 404).
Fehlt der Schlüssel, erzeugt Chute ein Token, statt ohne Authentifizierung auszuliefern. Das erzeugte Token wird in eine Datei control-token in Chutes Share-Ordner geschrieben — nicht neben die Konfiguration: der App-Group-Container auf iOS und tvOS, das private Datenverzeichnis der App auf Android —, lesbar nur für den Eigentümer, über Neustarts hinweg weiterverwendet, und die Apps zeigen es an — siehe Web-Konsole öffnen. Die Control-API kann die Verbindungsdatenbank herausgeben, deren Einträge jede URL, jeden Header und jeden Prozessnamen dieses Laufs enthalten; ein offener Controller ist keine vertretbare Voreinstellung.
Wenn Sie trotzdem ohne Authentifizierung ausliefern wollen, sagen Sie es in der Konfiguration:
external-http-secret = none
Das wird nur bei einer Loopback-Bindung akzeptiert. Außerhalb von Loopback genügt weder none noch ein fehlender Schlüssel: Der Controller verweigert den Start und nennt, was er braucht.
Beim Upgrade: Wenn Sie sich darauf verlassen haben, dass ein fehlendes
external-http-secret„keine Authentifizierung“ bedeutet, erhalten lokale Skripte künftig401. Lesen Sie entweder das erzeugte Token in der App aus, oder schreiben Sieexternal-http-secret = none, um das alte Verhalten bewusst beizubehalten.
external-http-ui (Standard: true)
external-http-ui = true
Wenn aktiviert, stellt Chute eine eingebettete Web-Konsole unter der Controller-Adresse bereit. Die Web-Konsole bietet eine Übersicht, Verbindungsverwaltung, DNS-Inspektion, Verkehrsüberwachung, Richtliniensteuerungen und Konfigurationsbearbeitung. Setzen Sie auf false, um die API aktiviert zu lassen, während die UI deaktiviert wird.
Die Web-Konsole öffnen
Die Konsole wird unter der Adresse des Controllers ausgeliefert, und jede App kann Ihnen Adresse und Token übergeben — auch das generierte Token, das Sie sonst gar nicht lesen könnten:
- Chute Mac: Menüleiste → Web-Konsole öffnen und Web-Konsolen-Token kopieren. Das Detailfenster einer Verbindung hat zusätzlich Anfragen & Verlauf, das ebenfalls die Konsole öffnet — ihre Startseite, nicht diese Verbindung.
- Chute iOS: Bedienfeld → Zeile „Web-Konsole“ → Öffnen, Adresse kopieren oder Zugriffstoken kopieren.
- Chute tvOS: Das Bedienfeld hat eine eigene Zeile Adresse der Web-Konsole, die Host und Port zeigt. Sie auszuwählen zeigt einen QR-Code, wenn der Listener von anderen Geräten erreichbar ist — das Anmelde-Token steckt im Code, nicht auf dem Bildschirm —, und, wenn der Controller an Loopback gebunden ist, stattdessen eine Erklärung, weil sich eine Loopback-Konsole nicht vom Telefon aus öffnen lässt.
- Chute Android: Bedienfeld → Adresse der Web-Konsole → Öffnen oder Adresse kopieren, dazu eine Zeile Generiertes Zugriffstoken, die beim Antippen kopiert. Keine der beiden Zeilen erscheint, wenn das Token ein selbst konfiguriertes Secret ist; ein solches wird nie angezeigt.
Die so erzeugte Adresse trägt das Token als Query-Parameter. Die Seite verbraucht es beim Laden und entfernt es aus der Adresszeile, sodass das Öffnen des Links eine vollständige Anmeldung ist und niemand 32 Hex-Zeichen abtippen muss.
external-http-cors (Standard: false)
external-http-cors = true
Aktiviert CORS (Cross-Origin Resource Sharing)-Header auf API-Antworten. Nützlich, wenn die Web-Konsole oder Drittanbieter-Tools von einem anderen Origin auf die API zugreifen müssen.
API-Endpunkte:
| Methode | Endpunkt | Beschreibung |
|---|---|---|
GET |
/api/status |
Laufzeitstatus, Ports, Betriebszeit |
GET |
/api/traffic |
Globale und richtlinienbezogene Verkehrszähler |
GET |
/api/connections |
Aktuell aktive Verbindungen |
DELETE |
/api/connections/:id |
Eine Verbindung schließen |
GET |
/api/connections/history |
Historische Verbindungsaufzeichnungen |
GET |
/api/connections/processes |
Verbindungsstatistik pro Prozess |
GET |
/api/connections/:id/request |
Erfasste Anfragedaten einer Verbindung |
GET |
/api/connections/:id/response |
Erfasste Antwortdaten einer Verbindung |
GET |
/api/dns |
DNS-Cache-Einträge |
DELETE |
/api/dns/cache |
DNS-Cache leeren |
DELETE |
/api/dns/records/:domain |
Einen einzelnen DNS-Eintrag entfernen |
GET |
/api/config |
Aktuelle Konfiguration |
PUT |
/api/config |
Konfiguration neu laden |
POST |
/api/config/validate |
Eine Konfiguration parsen und ihre Fehler melden, ohne sie zu laden |
GET |
/api/policies |
Richtliniengruppen und aktuelle Auswahl; jeder Eintrag trägt hidden, das bei einer Gruppe mit hidden=true true ist |
PUT |
/api/policies/:group |
Richtliniengruppenauswahl ändern |
PUT |
/api/mode |
Ausgehenden Modus festlegen |
GET |
/api/features |
Status der Funktionsschalter |
PUT |
/api/features/mitm |
MitM umschalten |
PUT |
/api/features/record-traffic |
Datenverkehrsaufzeichnung umschalten |
GET |
/api/rules |
Die Regeltabelle, die der Matcher durchläuft, die Herkunft jeder Regel und welche Umschreibungsregeln gegriffen haben |
POST |
/api/rules/match |
Wohin eine Anfrage geroutet würde, ohne sie zu stellen |
GET |
/api/rules/user |
Zur Laufzeit hinzugefügte Regeln, die vor den Modulen und der Konfiguration abgeglichen werden |
PUT |
/api/rules/user |
Die Laufzeitregeln ersetzen |
POST |
/api/rules/user |
Regeln hinter den Laufzeitregeln anfügen |
DELETE |
/api/rules/user |
Alle Laufzeitregeln entfernen |
GET |
/api/logs |
Aktuelle Protokolleinträge |
GET |
/api/loglevel |
Aktuelle Protokollstufe und die geschriebenen Abschnitte |
PUT |
/api/loglevel |
Protokollstufe oder Abschnitte ohne Neustart ändern |
GET |
/api/health |
Zustand der Engine: Ablehnungen, Generationen, Speicherbedarf, letztes Ende |
GET |
/api/events |
Bemerkenswerte Momente dieses Laufs |
GET |
/api/tailscale |
Aktueller Zustand der Tailscale-Engine |
GET |
/api/scripts |
Die generischen Skripte, die sich auf Anforderung ausführen lassen |
POST |
/api/scripts/run |
Ein generisches Skript anhand seines Namens ausführen |
POST |
/api/diagnostics/ping |
Erreichbarkeitstest per ICMP oder TCP |
POST |
/api/diagnostics/dns-query |
Eine Domain über den laufenden Resolver auflösen |
POST |
/api/diagnostics/egress-probe |
Adresse prüfen: auf den Apple-Engines die eigenen Adressen des Geräts; auf Android die öffentliche Adresse des Geräts in seinem physischen Netzwerk, nicht der Ausgang eines Proxys |
POST |
/api/diagnostics/internet-test |
Der direkte Internettest: internet-test-url ohne Proxy abrufen |
POST |
/api/diagnostics/url-test/:policy |
Latenztest einer Richtlinie ausführen |
POST |
/api/diagnostics/bundle |
Ein bereinigtes Diagnosearchiv erstellen |
GET |
/api/connections/export |
Verbindungen als HAR 1.2 exportieren |
GET |
/api/rewrites |
Alle Umschreibungs-/Mock-Antwort-Familien und die MitM-Hostliste |
GET |
/api/rewrites/:family |
Die Regeln einer Familie |
POST |
/api/rewrites/:family |
Eine Regel hinzufügen |
DELETE |
/api/rewrites/:family/:id |
Eine Regel entfernen |
DELETE |
/api/rewrites/:family |
Eine Familie leeren |
GET |
/api/mitm/hosts |
Derzeit entschlüsselte Hosts |
POST |
/api/mitm/hosts |
Einen Host hinzufügen |
DELETE |
/api/mitm/hosts/:host |
Einen Host entfernen |
DELETE |
/api/mitm/hosts |
Die Liste leeren |
GET |
/api/rules/providers |
Regel-Provider und Regelsätze mit dem Status jedes einzelnen — einschließlich des Grunds, warum einer nicht geladen wurde |
Endpunkt-Hinweise:
GET /api/featuresmeldet jeden Schalter so, wie er gesetzt ist —record_traffic,mitm,mitm_h2,mitm_auto_quic_block,rewrite— sowielicensed.effectivesagt, was tatsächlich läuft, und zwar nur für fünf Einträge:record_traffic,mitm,rewrite,scriptsundlan_proxy. In der kostenlosen Edition sind alle fünf false, sodass ein Schalter auf an stehen kann, während seineffective-Eintrag false ist.inactiveist ein Objekt, das nennt, was die laufende Konfiguration verlangt, in dieser Edition aber nicht läuft: die Zählerscripts,scriptRules,dnsScripts,rewritesundmapLocalssowie die Flagsmitm,bodyCapture,lanProxyundexitNode(Tailscale-Ankündigungen, die nur Chute Mac vornimmt). Mit Lizenz oder während die Engine gestoppt ist, ist jeder Zähler 0 und jedes Flag false.GET /api/connectionsakzeptiertlimit(positive Ganzzahl, Standard und Maximum 1000) undcursor(liefert nur Verbindungen mit eineridgrößer als der Cursor). Das Antwortfelddataenthältconnections,total,page_size,has_more,server_timeund — wenn weitere Seiten existieren —next_cursor.since(Sekunden, dieserver_timeeiner früheren Antwort) liefert nur die Verbindungen, die sich nach diesem Zeitpunkt geändert haben, und fügtactive_idshinzu, die IDs aller jetzt offenen Verbindungen: Eine Verbindung, die eine frühere Antwort enthielt und die darin fehlt, wurde geschlossen. Einsince, das später alsserver_timeliegt, wird als0gewertet, sodass jede Verbindung geliefert wird.GET /api/connections/historyakzeptiertlimit(Standard 100, Maximum 1000) undcursor/before(Synonyme; beide zugleich zu übergeben wird abgelehnt).GET /api/connections/:id/requestund.../responseliefern{"connection_id": <id>, "data": "<base64>"}. Mitschnitte größer als 2 MiB liefern413. Ohne Chute Pro liefern beide403mitrequest data is not availablebzw.response data is not available, auch für Bodies, die während eines früheren lizenzierten Laufs aufgezeichnet wurden.GET /api/configliefert die laufende Konfiguration so, wie sie geschrieben ist, einschließlich der Zugangsdaten —http-auth,external-http-secret,ca-p12,ca-passphrase, WireGuard-Schlüssel und das Passwort jedes Proxys —, Zugriff auf die Steuerungs-API ist also Zugriff auf all diese. Nur ein Diagnosepaket ersetzt Zugangsdaten durch<redacted>, und diese Kopie lässt sich nicht zurückladen: Eine anPUT /api/configgesendete Konfiguration, die irgendwo noch<redacted>enthält, wird mit400und einer Meldung abgewiesen, die die erste solche Zeile nennt. Senden Sie stattdessen die Originalkonfiguration.GETundPUT /api/configsind auch unter/api/configserreichbar sowie unter dem Clash-Alias/configs.PUT /api/configakzeptiert entweder JSON{"configuration": "<full text>"}oder den rohen Konfigurationstext als Request-Body (Limit 1 MB). Bei Erfolg lädt die Engine neu — oder startet, falls sie nicht lief.PUT /api/policies/:groupübernimmt die Auswahl aus dem ersten vorhandenen der Body-Schlüsselpolicy,name,selected,select; der Wert kann ein Richtlinienname oder ein numerischer Index als String sein. Der spezielle GruppennameGLOBALsetzt die global ausgewählte Richtlinie.- In
GET /api/policiesträgt jede Richtlinie, jede Gruppe und jedes Gruppenmitgliedendpoint, die Richtlinie, zu der es jetzt führt — durch Gruppen hindurch verfolgt und über das integriertePROXYbis zu der für den globalen Modus ausgewählten Richtlinie —, undendpoint_ping, die Latenz dieser Richtlinie. Das eigenepingeiner Gruppe ist0, nicht gemessen, daher istendpoint_pingder Wert, den man für eine Gruppe oder fürPROXYliest. PUT /api/modeerfordert eine JSON-Zahl:{"mode": 0}—0Regel,1direkt,2Proxy.PUT /api/features/mitmundPUT /api/features/record-trafficnehmen{"enabled": true}entgegen.GET /api/logsakzeptiertsince(Unix-Sekunden); der In-Memory-Puffer behält die letzten 1000 Einträge, jeder als{timestamp, wall_time, level, section, message}—timestampundwall_timetragen denselben Wert in Unix-Sekunden, der vorgerückt wird, wenn die Uhr nicht weiterläuft, damit die Einträge streng geordnet bleiben.GET /api/healthmeldet, was die Engine gerade hält und warum sie zuletzt etwas abgewiesen hat, sowie wie der vorherige Lauf endete (clean,uncleanodersuspected_memory— siehe Fehlerbehebung).addressFamilysagt, wie Chute den IPv6-Ausgang beurteilt —ipv6isthealthy,confirmingoderdegraded—, mit Zählern dafür, was es deswegen unternommen hat; auf den Apple-Engines meldetselfLoopden Schutz vor Selbstschleifen. Keines von beiden enthält eine Adresse.GET /api/eventsliefert den Ringpuffer im Speicher;?persisted=1liest stattdessen den gespeicherten Verlauf dieses Laufs und antwortet mitavailable: false, wenn die Aufzeichnung aus ist.- Ohne
[Tailscale]-Abschnitt antwortetGET /api/tailscalemitstate: "idle"— das ist eine normale Antwort, kein Fehler. - Die Prüfungen unter
POST /api/diagnostics/*nehmen ihre Argumente aus der Query oder einem JSON-Body, sind auf zehn Sekunden begrenzt und antworten genau einmal.url-test/:policyweist einen nicht definierten Richtliniennamen zurück, stattREJECTzu messen. GET /api/scriptslistet die aktivierten generischen Skripte als{name, type};POST /api/scripts/runnimmtnameaus dem Body oder der Query, ist wie die Diagnoseprüfungen begrenzt und antwortet mit{name, timedOut, result}—timedOutunterscheidet ein Skript, das$donenie aufgerufen hat, von einem, das durchgelaufen ist. Ein Name, der kein aktiviertes generisches Skript ist, ergibt404. Ohne Chute Pro antwortet es mit403,script is not available.POST /api/rules/matchbeantwortet, wohin eine Anfrage ginge, ohne eine Verbindung zu öffnen. Es nimmthost(oder eineurl, aus der Host und Port stammen; eineURL-REGEX-Regel wird gegen dieseurlgenau so geprüft, wie sie geschrieben ist, auch wenn sie im echten Verkehr nur schlichtehttp://-Anfragen sieht),port(Standard 443) sowie optionalip,protocol,process,process_path,src_ip,src_port,in_port,in_type,in_user,in_name,network,ssid,bssid,from_tun,user_agent— ein unbekanntes Feld wird mitsamt der Liste der zulässigen zurückgewiesen statt ignoriert. Die Antwort trägt diematched-Regel (ihre Zeile, ihren Typ, die von ihr benannte Richtlinie und dieresolved_policy, auf die eine Gruppe gerade zeigt), diepolicy,need_resolvesowierule_countundmatch_generation, gegen die gerechnet wurde. Da eine Domain zweimal abgeglichen wird — einmal über den Namen und noch einmal, sobald eine Adresse bekannt ist —, enthältpasseseinen Eintrag je Durchgang; ohneipgibt es nur den Durchgang vor der Auflösung, und die Antwort sagt das innote. Mitexplain=truekommen die Kandidatenregeln dazu, die ebenfalls hätten passen können, bis zu 50, mitsamt der Zahl der nicht aufgeklappten Regelsätze.POST /api/config/validateparst eine Konfiguration und wirft sie weg: Die laufende Engine übernimmt nichts davon. Schicken Sie sie als{"configuration": "<full text>"}oder als rohen Text. Die Antwort besteht ausvalid,error_count,advisory_count,rule_count,policy_countund einererrors-Liste aus{line, severity, content, error}—severitytrennt eine abgelehnte Zeile von einer mit Vorbehalt akzeptierten, undcontentist die beanstandete Zeile so, wie sie geschrieben ist — einschließlich der Zugangsdaten, denn eine fehlerhafte[Proxy]-Zeile ist oft gerade in dem Feld fehlerhaft, das ihr Passwort enthält —, gekürzt auf 4096 Zeichen. Verwenden Sie es vorPUT /api/config, das den Lauf neu startet, den Sie gerade untersuchen.GET /api/loglevelmeldet das aktuellelevel, dasnslog_level, die in die Datei geschriebenensectionssowie dieavailable_levels/available_sections, die Sie setzen dürfen.PUT(oderPATCH) nimmtlevel,sectionsoder beides:sectionsist ein Array von Abschnittsnamen oder die Zeichenkette"all", ein leeres Array wird abgelehnt — zum Abschalten der Protokollierung nehmen Sielevelmitnone. Die Stufe auf diesem Weg zu ändern startet den Lauf nicht neu, und genau darum geht es:loglevel = verbosein der Datei braucht ein Neuladen, und ein Neuladen verliert das, was Sie sehen wollten.GET /api/rulesmeldet zusätzlichrewrite_hits: jede Umschreibungs- oder Mock-Antwort-Regel, die in diesem Lauf gegriffen hat, mit Zähler. Eine Regel, die dort nicht auftaucht, hat nie gepasst — das ist die übliche Erklärung für eine Umschreibung, die scheinbar nichts tut. Die Tabelle verfolgt bis zu 512 verschiedene Regeln und meldet alles darüber hinaus alsrewrite_hit_dropped_rules.ruleslistet jede Regel, die der Matcher durchläuft, in Reihenfolge: zuerst die automatischen Tailscale-Regeln, dann die über/api/rules/userhinzugefügten Regeln, dann Modulregeln, dann den Abschnitt[Rule]der Konfiguration, zuletztFINAL;rule_regionsnennt zu jedem Index die Herkunft der Zeile (front,user,module,configuration)./api/rules/userhält Regeln, die hinzugefügt werden, während die Engine läuft — ohne Neuladen und ohne die Konfigurationsdatei anzutasten. Sie werden nach den automatischen Tailscale-Regeln und vor den Modulregeln und dem Abschnitt[Rule]der Konfiguration abgeglichen, in der angegebenen Reihenfolge.GETlistet sie;PUTersetzt sie, undPOSTfügt hinter den vorhandenen an, beide mit{"rules": ["<rule line>", ...]}oder einem einzelnen{"rule": "<rule line>"}, geschrieben wie in der Datei;DELETEentfernt alle. Ein Schreibvorgang gilt ganz oder gar nicht: Eine Zeile, die sich nicht parsen lässt, oder einFINALwird mit400abgewiesen, und die Regeln bleiben, wie sie waren. Eine Regel, deren Richtlinie die laufende Konfiguration nicht definiert, wird angenommen — sie fällt fail-closed aufREJECT— und inwarningsgenannt.close_rerouted, standardmäßigtrue, schließt die Verbindungen, die die geänderten Regeln anderswohin leiten, und nur diese;falselässt jede Verbindung offen — beiDELETEübergeben Sie es als?close_rerouted=false. Jede Methode antwortet mit den aktuellenrules. Die Regeln bleiben über ein Neuladen hinweg erhalten und sind weg, sobald die Engine stoppt.PATCHwird auf diesem Pfad nicht akzeptiert.POST /api/rewrites/:familynimmt{"rule": "<configuration line>"}— genau den Text, den Sie in die Datei schreiben würden. Eine Zeile, die sich nicht parsen lässt, wird mit400abgewiesen statt als Regel gespeichert, die nie passen kann.:familyist eines vonurl-rewrite,header-rewrite,body-rewrite,mock. So hinzugefügte Regeln leben nur in der laufenden Engine und werden nicht in die Konfigurationsdatei zurückgeschrieben.GET /api/connections/export?format=harliefert ein HAR-1.2-Dokument,POST /api/diagnostics/bundleein ZIP — beides sind Dateien und werden deshalb, anders als jeder andere Endpunkt, nicht in{"ok": ..., "data": ...}verpackt.exportakzeptiertsource(currentals Standard oderhistory),limit(Standard 100, höchstens 300),idssowiebodies=1, um die aufgezeichneten Nutzdaten mitzugeben. Jeder Eintrag trägt ein_kl-Objekt mit dem, wofür HAR kein Feld hat: gewählte Richtlinie, passende Regel und die Umschreibungen, die gegriffen haben.- Der Eintrag einer verketteten Verbindung in
GET /api/connectionsundGET /api/connections/historyenthältchainPath, den Weg von diesem Gerät bis zum Ausgang, etwaAirport/HK-01 → Landing; bei einer Verbindung über eine einzige Richtlinie ist er leer, und der HAR-Export führt ihn als_kl.chain. In den Zählern je Richtlinie vonGET /api/trafficzählt auch ein Upstream die Bytes, die er für verkettete Verbindungen getragen hat; die globalen Summen zählen sie einmal.
Beispiel — den Status lesen, dann eine Richtliniengruppe umschalten:
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":[...], ...}}
Beispiel — fragen, wohin eine Anfrage ginge, bevor man sie stellt:
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", ...}, ...}}
Das Protokoll beim Reproduzieren auf ein Teilsystem eingrenzen, ohne den Lauf neu zu starten:
curl -X PUT -H "Authorization: Bearer your-secret-token" \
-d '{"level": "verbose", "sections": ["MitM", "DNS"]}' \
http://127.0.0.1:9090/api/loglevel
Hinweis: Diese Funktion ist standardmäßig deaktiviert. Jede Antwort verwendet den Umschlag
{"ok": true, "data": {...}}bei Erfolg und{"ok": false, "error": {"code": "...", "message": "..."}}bei Fehlern; Request-Bodys sind auf 1 MB begrenzt.
PUT-Endpunkte akzeptieren auchPATCH. Für Dashboards von Drittanbietern stehen Clash-kompatible Alias-Pfade zur Verfügung:/version,/traffic,/connections,/configs,/proxies,/rules— die Pfade sind erreichbar, aber die Antworten verwenden Chutes Umschlag und Feldnamen statt des Clash-Schemas (/versionliefert{"name", "run_id", "egress_probe"}, wobeiegress_probeauf den Apple-Enginesnetwork_addressund auf Androidegress_ipist), Clash-Dashboards funktionieren daher nicht ohne Weiteres.
Diese Seite ist eine Übersetzung der englischen Version. Bei Abweichungen ist die englische Version maßgeblich.