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ünftig 401. Lesen Sie entweder das erzeugte Token in der App aus, oder schreiben Sie external-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/features meldet jeden Schalter so, wie er gesetzt ist — record_traffic, mitm, mitm_h2, mitm_auto_quic_block, rewrite — sowie licensed. effective sagt, was tatsächlich läuft, und zwar nur für fünf Einträge: record_traffic, mitm, rewrite, scripts und lan_proxy. In der kostenlosen Edition sind alle fünf false, sodass ein Schalter auf an stehen kann, während sein effective-Eintrag false ist. inactive ist ein Objekt, das nennt, was die laufende Konfiguration verlangt, in dieser Edition aber nicht läuft: die Zähler scripts, scriptRules, dnsScripts, rewrites und mapLocals sowie die Flags mitm, bodyCapture, lanProxy und exitNode (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/connections akzeptiert limit (positive Ganzzahl, Standard und Maximum 1000) und cursor (liefert nur Verbindungen mit einer id größer als der Cursor). Das Antwortfeld data enthält connections, total, page_size, has_more, server_time und — wenn weitere Seiten existieren — next_cursor. since (Sekunden, die server_time einer früheren Antwort) liefert nur die Verbindungen, die sich nach diesem Zeitpunkt geändert haben, und fügt active_ids hinzu, die IDs aller jetzt offenen Verbindungen: Eine Verbindung, die eine frühere Antwort enthielt und die darin fehlt, wurde geschlossen. Ein since, das später als server_time liegt, wird als 0 gewertet, sodass jede Verbindung geliefert wird.
  • GET /api/connections/history akzeptiert limit (Standard 100, Maximum 1000) und cursor/before (Synonyme; beide zugleich zu übergeben wird abgelehnt).
  • GET /api/connections/:id/request und .../response liefern {"connection_id": <id>, "data": "<base64>"}. Mitschnitte größer als 2 MiB liefern 413. Ohne Chute Pro liefern beide 403 mit request data is not available bzw. response data is not available, auch für Bodies, die während eines früheren lizenzierten Laufs aufgezeichnet wurden.
  • GET /api/config liefert 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 an PUT /api/config gesendete Konfiguration, die irgendwo noch <redacted> enthält, wird mit 400 und einer Meldung abgewiesen, die die erste solche Zeile nennt. Senden Sie stattdessen die Originalkonfiguration.
  • GET und PUT /api/config sind auch unter /api/configs erreichbar sowie unter dem Clash-Alias /configs.
  • PUT /api/config akzeptiert 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üssel policy, name, selected, select; der Wert kann ein Richtlinienname oder ein numerischer Index als String sein. Der spezielle Gruppenname GLOBAL setzt die global ausgewählte Richtlinie.
  • In GET /api/policies trägt jede Richtlinie, jede Gruppe und jedes Gruppenmitglied endpoint, die Richtlinie, zu der es jetzt führt — durch Gruppen hindurch verfolgt und über das integrierte PROXY bis zu der für den globalen Modus ausgewählten Richtlinie —, und endpoint_ping, die Latenz dieser Richtlinie. Das eigene ping einer Gruppe ist 0, nicht gemessen, daher ist endpoint_ping der Wert, den man für eine Gruppe oder für PROXY liest.
  • PUT /api/mode erfordert eine JSON-Zahl: {"mode": 0} — 0 Regel, 1 direkt, 2 Proxy.
  • PUT /api/features/mitm und PUT /api/features/record-traffic nehmen {"enabled": true} entgegen.
  • GET /api/logs akzeptiert since (Unix-Sekunden); der In-Memory-Puffer behält die letzten 1000 Einträge, jeder als {timestamp, wall_time, level, section, message} — timestamp und wall_time tragen denselben Wert in Unix-Sekunden, der vorgerückt wird, wenn die Uhr nicht weiterläuft, damit die Einträge streng geordnet bleiben.
  • GET /api/health meldet, was die Engine gerade hält und warum sie zuletzt etwas abgewiesen hat, sowie wie der vorherige Lauf endete (clean, unclean oder suspected_memory — siehe Fehlerbehebung). addressFamily sagt, wie Chute den IPv6-Ausgang beurteilt — ipv6 ist healthy, confirming oder degraded —, mit Zählern dafür, was es deswegen unternommen hat; auf den Apple-Engines meldet selfLoop den Schutz vor Selbstschleifen. Keines von beiden enthält eine Adresse.
  • GET /api/events liefert den Ringpuffer im Speicher; ?persisted=1 liest stattdessen den gespeicherten Verlauf dieses Laufs und antwortet mit available: false, wenn die Aufzeichnung aus ist.
  • Ohne [Tailscale]-Abschnitt antwortet GET /api/tailscale mit state: "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/:policy weist einen nicht definierten Richtliniennamen zurück, statt REJECT zu messen.
  • GET /api/scripts listet die aktivierten generischen Skripte als {name, type}; POST /api/scripts/run nimmt name aus dem Body oder der Query, ist wie die Diagnoseprüfungen begrenzt und antwortet mit {name, timedOut, result} — timedOut unterscheidet ein Skript, das $done nie aufgerufen hat, von einem, das durchgelaufen ist. Ein Name, der kein aktiviertes generisches Skript ist, ergibt 404. Ohne Chute Pro antwortet es mit 403, script is not available.
  • POST /api/rules/match beantwortet, wohin eine Anfrage ginge, ohne eine Verbindung zu öffnen. Es nimmt host (oder eine url, aus der Host und Port stammen; eine URL-REGEX-Regel wird gegen diese url genau so geprüft, wie sie geschrieben ist, auch wenn sie im echten Verkehr nur schlichte http://-Anfragen sieht), port (Standard 443) sowie optional ip, 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 die matched-Regel (ihre Zeile, ihren Typ, die von ihr benannte Richtlinie und die resolved_policy, auf die eine Gruppe gerade zeigt), die policy, need_resolve sowie rule_count und match_generation, gegen die gerechnet wurde. Da eine Domain zweimal abgeglichen wird — einmal über den Namen und noch einmal, sobald eine Adresse bekannt ist —, enthält passes einen Eintrag je Durchgang; ohne ip gibt es nur den Durchgang vor der Auflösung, und die Antwort sagt das in note. Mit explain=true kommen die Kandidatenregeln dazu, die ebenfalls hätten passen können, bis zu 50, mitsamt der Zahl der nicht aufgeklappten Regelsätze.
  • POST /api/config/validate parst 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 aus valid, error_count, advisory_count, rule_count, policy_count und einer errors-Liste aus {line, severity, content, error} — severity trennt eine abgelehnte Zeile von einer mit Vorbehalt akzeptierten, und content ist 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 vor PUT /api/config, das den Lauf neu startet, den Sie gerade untersuchen.
  • GET /api/loglevel meldet das aktuelle level, das nslog_level, die in die Datei geschriebenen sections sowie die available_levels / available_sections, die Sie setzen dürfen. PUT (oder PATCH) nimmt level, sections oder beides: sections ist ein Array von Abschnittsnamen oder die Zeichenkette "all", ein leeres Array wird abgelehnt — zum Abschalten der Protokollierung nehmen Sie level mit none. Die Stufe auf diesem Weg zu ändern startet den Lauf nicht neu, und genau darum geht es: loglevel = verbose in der Datei braucht ein Neuladen, und ein Neuladen verliert das, was Sie sehen wollten.
  • GET /api/rules meldet zusätzlich rewrite_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 als rewrite_hit_dropped_rules. rules listet jede Regel, die der Matcher durchläuft, in Reihenfolge: zuerst die automatischen Tailscale-Regeln, dann die über /api/rules/user hinzugefügten Regeln, dann Modulregeln, dann den Abschnitt [Rule] der Konfiguration, zuletzt FINAL; rule_regions nennt zu jedem Index die Herkunft der Zeile (front, user, module, configuration).
  • /api/rules/user hä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. GET listet sie; PUT ersetzt sie, und POST fügt hinter den vorhandenen an, beide mit {"rules": ["<rule line>", ...]} oder einem einzelnen {"rule": "<rule line>"}, geschrieben wie in der Datei; DELETE entfernt alle. Ein Schreibvorgang gilt ganz oder gar nicht: Eine Zeile, die sich nicht parsen lässt, oder ein FINAL wird mit 400 abgewiesen, und die Regeln bleiben, wie sie waren. Eine Regel, deren Richtlinie die laufende Konfiguration nicht definiert, wird angenommen — sie fällt fail-closed auf REJECT — und in warnings genannt. close_rerouted, standardmäßig true, schließt die Verbindungen, die die geänderten Regeln anderswohin leiten, und nur diese; false lässt jede Verbindung offen — bei DELETE übergeben Sie es als ?close_rerouted=false. Jede Methode antwortet mit den aktuellen rules. Die Regeln bleiben über ein Neuladen hinweg erhalten und sind weg, sobald die Engine stoppt. PATCH wird auf diesem Pfad nicht akzeptiert.
  • POST /api/rewrites/:family nimmt {"rule": "<configuration line>"} — genau den Text, den Sie in die Datei schreiben würden. Eine Zeile, die sich nicht parsen lässt, wird mit 400 abgewiesen statt als Regel gespeichert, die nie passen kann. :family ist eines von url-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=har liefert ein HAR-1.2-Dokument, POST /api/diagnostics/bundle ein ZIP — beides sind Dateien und werden deshalb, anders als jeder andere Endpunkt, nicht in {"ok": ..., "data": ...} verpackt. export akzeptiert source (current als Standard oder history), limit (Standard 100, höchstens 300), ids sowie bodies=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/connections und GET /api/connections/history enthält chainPath, den Weg von diesem Gerät bis zum Ausgang, etwa Airport/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 von GET /api/traffic zä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 auch PATCH. 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 (/version liefert {"name", "run_id", "egress_probe"}, wobei egress_probe auf den Apple-Engines network_address und auf Android egress_ip ist), Clash-Dashboards funktionieren daher nicht ohne Weiteres.

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

Diese Seite ist eine Übersetzung der englischen Version. Bei Abweichungen ist die englische Version maßgeblich.

results matching ""

    No results matching ""