KI-Agent (MCP) PRO PREVIEW
PREVIEW Hinweis: Der MCP-Server befindet sich im internen Test und ist noch nicht veröffentlicht. Diese Seite beschreibt den Build im Test: Schlüssel, Routen, Werkzeugnamen und App-Oberflächen können sich vor der Veröffentlichung noch ändern.
[General]
external-mcp-server = 127.0.0.1:6180
Die Engine von Chute Mac, Chute iOS und Chute tvOS hat einen eigenen MCP-Server (Model Context Protocol). Ein KI-Agent — Claude Code, Codex oder jeder andere Client, der MCP spricht — verbindet sich damit, liest, was die Engine gerade tut (Status, Richtlinien, Regeln, Verbindungen, DNS, Log, Konfiguration), und ändert es: wählt eine Richtlinie, probiert eine Regel aus, schreibt einen Abschnitt der Konfiguration neu, misst die Mitglieder einer Gruppe.
Er baut auf den Routen der HTTP-Control-API auf und meldet sich mit demselben Secret an, ist aber ein eigener Listener, unter /mcp auf einem eigenen Port: Er braucht weder external-http-controller noch die Web-Konsole. Standardmäßig ist er aus.
PRO Hinweis: Der MCP-Server gehört zu Chute Pro. Ohne Lizenz startet die Engine ihn nicht:
external-mcp-serveröffnet keinen Port, und die Konfiguration lässt sich weiterhin bearbeiten. Sobald eine Lizenz gilt, startet der Server, ohne dass Chute neu gestartet werden muss, und er stoppt, wenn die Lizenz wegfällt; die kostenlose Testphase von Chute Mac zählt als Lizenz. Die HTTP-Control-API selbst ist nicht betroffen. Was die Apps in der Zwischenzeit zeigen, steht unter Ohne Chute Pro; siehe auch Lizenz und Aktivierung.
Wofür er gut ist
Das Lesen übernimmt der Agent, Sie können also in eigenen Worten fragen. Zum Beispiel:
- „Warum geht
api.example.comüber HK-01 raus?“ — der Agent fragtmatch_rule, das die Regel und die Richtlinie nennt, probiert mitedit_user_ruleseine Korrektur aus und schreibt sie, sobald sie wirkt, mitreplace_profile_sectionin[Rule]. - „Welche Knoten in Auto funktionieren noch?“ —
test_policyauf die Gruppe misst jedes Mitglied der Reihe nach und meldet jedes, sobald es fertig ist. - „Die App erreicht seit heute Morgen ihren Server nicht.“ —
list_connectionsmit dem Filterfailed,get_logsmit einem Stichwort undrun_diagnosticsfür das Netzwerk selbst. - „Blockiere die Werbung auf dieser Seite.“ —
add_rewriteundadd_mitm_host, um es in der laufenden Engine auszuprobieren, dann die Zeilen, die in die Konfiguration sollen.
Einschalten
external-mcp-server (Standard: deaktiviert)
external-mcp-server = 127.0.0.1:6180
Adresse und Port des MCP-Servers. Dieser Schlüssel gehört Chute allein: Surge und Clash haben nichts Vergleichbares, und der Import ihrer Konfigurationen erzeugt ihn nicht. Die Adresse wird geschrieben wie bei external-http-controller: 127.0.0.1:6180 nur für dieses Gerät, 0.0.0.0:6180 oder *:6180 für alle Schnittstellen, [::]:6180 für IPv6; ganz 127.0.0.0/8, ::1 und localhost gelten als Loopback. Eine Adresse, die sich nicht lesen lässt, ist ein Konfigurationsfehler. Die Apps verwenden Port 6180, wenn sie ihn einschalten.
Anmeldung. Der Agent sendet Authorization: Bearer <token>, und das Token ist das der HTTP-Control-API:
external-http-secret, wenn die Konfiguration eines hat;- sonst das Token, das Chute erzeugt und in der Datei
control-tokenseines Share-Ordners aufbewahrt — erzeugt auch dann, wennexternal-http-controlleraus ist, und in den Apps angezeigt; external-http-secret = nonebedeutet gar keine Anmeldung und wird nur auf einer Loopback-Adresse akzeptiert.
Außerhalb von Loopback braucht der MCP-Server ein ausdrückliches external-http-secret: Weder das erzeugte Token noch none reicht. Ohne startet er nicht, und die Apps zeigen, warum.
Er läuft mit der Engine. Er startet, wenn Chute startet, und stoppt, wenn Chute stoppt; ein Agent kann Chute also weder starten noch stoppen noch die App zu einer anderen Konfiguration wechseln lassen. Ein Neuladen startet den Listener nur neu, wenn sich seine Adresse oder das Secret geändert hat, und erst nachdem die Antworten, die schon unterwegs sind, geschrieben wurden — ein Agent, der die Adresse des MCP-Servers selbst ändert, bekommt seine Antwort trotzdem.
external-mcp-mask-secrets (Standard: true)
external-mcp-mask-secrets = false
Ob Passwörter, Schlüssel und Tokens den Agenten als Handles erreichen — siehe Maskieren von Geheimnissen. Ebenfalls ein eigener Schlüssel von Chute; er wird nur in die Konfiguration geschrieben, wenn er false ist.
In den Apps
- Chute iOS: im Konfigurationseditor Externer Controller → MCP-Server: der Schalter, Port, Zugriff über WLAN erlauben (lauscht auf
0.0.0.0; die dann nötige Zeile Token ist das Secret der HTTP-Control-API) und Geheimnisse maskieren. Die Zeile KI-Agent (MCP) im Bedienfeld, unter der Web-Konsole, zeigt Läuft, Nicht gestartet oder Nicht eingerichtet und öffnet eine Seite mit dem Grund, warum der Server nicht lauscht, der Adresse für Dieses Gerät und, außerhalb von Loopback, für Andere Geräte, dem Token (verborgen bis Token anzeigen; Tippen auf eine Zeile kopiert sie), CLIENT-EINRICHTUNG mit einem fertigenclaude mcp add-Befehl und JSON sowie SCHNELLAKTIONEN. Der MCP-Server läuft im VPN: Ist das VPN aus, sagt die Seite, was die aktuelle Konfiguration tun wird. - Chute Mac: Tab Konfiguration im Hauptfenster → Allgemein → MCP-Server: MCP-Server aktivieren, Adresse und Port, das Secret, das er mit der HTTP-Control-API teilt, Zugangsdaten maskieren und Status & Client-Einrichtung…. Solange Chute läuft, öffnet KI-Agent (MCP)… im Menüleistenmenü (und im …-Menü des Menüleisten-Panels) ein Fenster mit dem Status, den Adressen, dem Token (Anzeigen, Kopieren), ob Geheimnisse maskiert werden, und Agent verbinden: den Einrichtungen für Claude Code über HTTP, für Claude Code über den Befehl
chuteund JSON für andere Clients. - Chute tvOS: Konfiguration bearbeiten → ALLGEMEIN → MCP-Server: an oder aus, Listen-Adresse (
127.0.0.1oder0.0.0.0), der Port und Geheimnisse maskieren. Auf derselben Seite wird auch das Secret gesetzt, dasexternal-http-secretder HTTP-Control-API: Es wird maskiert angezeigt, bis Sie es aufdecken; leer bedeutet das Token, das Chute erzeugt, undnoneschaltet die Anmeldung ab, nach einer Warnung. Es darf keine Leerzeichen oder Zeilenumbrüche enthalten. Wer es ändert, ändert auch die Anmeldung der Web-Konsole und des Befehlschute. Bei0.0.0.0ohne Secret sagt die Seite, dass der Server nicht startet, und lässt Sie es gleich dort setzen. Die Zeile KI-Agent (MCP) im Bedienfeld zeigt den Status, die Adresse, die LAN-Adresse und das Token, verborgen bis zur Auswahl; auf dem Fernseher wird nichts kopiert.
Die Schnellschalter — SCHNELLAKTIONEN auf iOS, MCP einschalten / MCP ausschalten und Zugangsdaten maskieren im Mac-Fenster, MCP-Server und Geheimnisse maskieren auf der Seite des Fernsehers — ändern diese beiden Schlüssel in der aktuellen Konfigurationsdatei und wenden sie sofort an; dort eingeschaltet, lauscht der Server auf 127.0.0.1:6180. Auf iOS sind sie bei einem Abonnement deaktiviert, dessen nächste Aktualisierung sie rückgängig machen würde.
Ohne Chute Pro
Ohne Lizenz sagen die Apps, dass der Server Chute Pro braucht, statt ihn als nicht lauschend zu melden:
- Chute Mac: KI-Agent (MCP)… im Menüleistenmenü und im …-Menü des Menüleisten-Panels sowie MCP-Server aktivieren auf der Seite Allgemein tragen die PRO-Kapsel. Das Fenster KI-Agent (MCP) beginnt mit einem Chute-Pro-Hinweis und der Schaltfläche Chute Pro holen, sein Status lautet Erfordert Chute Pro, ohne Adresse und ohne Token. MCP einschalten öffnet das Chute-Pro-Fenster, statt den Server einzuschalten; Ausschalten und Zugangsdaten maskieren funktionieren wie immer. Das Chute-Pro-Fenster führt KI-Agent (MCP) unter seinen Funktionen.
- Chute iOS und Chute tvOS: Die Zeile KI-Agent (MCP) im Bedienfeld und der MCP-Schalter im Konfigurationseditor tragen die PRO-Kapsel. Die Statusseite zeigt Erfordert Chute Pro und anstelle von Adresse und Token den Weg zu Chute Pro; wer den Server mit dem Schnellschalter dort einschaltet, wird zuerst nach Chute Pro gefragt, wie bei den anderen Chute-Pro-Schaltern der Apps.
- In allen drei Apps bleiben die Felder des Konfigurationseditors bearbeitbar, und der Hinweis, der die in diesem Lauf nicht aktiven Chute-Pro-Funktionen aufzählt, nennt den MCP-Server.
Einen Agenten verbinden
Über HTTP
Ein Client, der Streamable HTTP spricht, verbindet sich direkt:
- Adresse:
http://<host>:<port>/mcp— für einen Agenten auf demselben Geräthttp://127.0.0.1:6180/mcp; - Header:
Authorization: Bearer <token>, mit dem Token, das die App zeigt.
Für Claude Code:
claude mcp add --transport http chute http://127.0.0.1:6180/mcp --header "Authorization: Bearer <token>"
Für einen Client, der per JSON eingerichtet wird:
{"mcpServers": {"chute": {"type": "http", "url": "http://127.0.0.1:6180/mcp", "headers": {"Authorization": "Bearer <token>"}}}}
Chute iOS und Chute Mac kopieren beides mit eingesetzter Adresse und eingesetztem Token. Auf einem iPhone erreicht eine Agenten-App auf demselben iPhone den Server ebenfalls unter 127.0.0.1.
Der Server spricht MCP 2026-07-28 und akzeptiert Clients von 2025-11-25, 2025-06-18 und 2025-03-26. Er hält keine Sitzung: Jede JSON-RPC-Nachricht ist ein POST an /mcp, beantwortet mit JSON — oder, bei den langen Werkzeugen, mit einem Event-Stream —, und danach wird die Verbindung geschlossen. GET, DELETE und OPTIONS werden mit 405 beantwortet, Batches (ein JSON-Array) abgelehnt, ein Request-Body ist auf 1 MB begrenzt, und höchstens 8 Verbindungen werden gleichzeitig bedient.
Über chute mcp
Ein Client, der MCP-Server nur als Programme kennt, die er selbst startet — oder einer, in dessen Konfiguration das Token nicht stehen soll —, nutzt das Kommandozeilenwerkzeug chute als Relais: chute mcp reicht jede gelesene Zeile an den MCP-Server weiter und schreibt jede Antwort als Zeile zurück.
claude mcp add chute -- chute mcp
{"mcpServers": {"chute": {"command": "chute", "args": ["mcp"]}}}
Auf einem Mac, auf dem Chute läuft, ist das alles: chute mcp liest Adresse und Token bei jeder Nachricht aus der Endpunkt-Datei, findet also auch ein Chute, das nach dem Client gestartet wurde. Das Token kommt aus der ersten dieser Quellen:
--token-file <path>;- der Umgebungsvariable
CHUTE_MCP_TOKEN; - nur für einen Server auf diesem Mac: der Endpunkt-Datei, dann
control-tokenim Share-Ordner.
--url http://<host>:<port>/mcp richtet es auf ein anderes Gerät. CHUTE_MCP_ENDPOINT nennt eine Endpunkt-Datei, die stattdessen gelesen wird. --token und --token-stdin werden abgelehnt: Die Standardeingabe ist der MCP-Kanal selbst, und ein Token auf der Kommandozeile landet in der Konfiguration des Clients und in der Prozessliste. Ist der Server nicht erreichbar, bekommt der Agent einen Fehler, der sagt, warum — ein geschlossener Port verweist auf external-mcp-server, ein 401 auf das Token.
Vom Computer zu einem iPhone oder Apple TV
Auf dem Gerät im Netzwerk lauschen und ein Secret setzen:
[General] external-mcp-server = 0.0.0.0:6180 external-http-secret = a-long-random-secretAuf iOS sind das Zugriff über WLAN erlauben und die Zeile Token; auf tvOS Listen-Adresse
0.0.0.0und das Secret, auf derselben Seite.- Das VPN verbinden und die Adresse unter Andere Geräte (iOS) oder LAN-Adresse (tvOS) ablesen — zum Beispiel
http://192.168.1.20:6180/mcp. Auf dem Computer, im selben Netzwerk:
claude mcp add --transport http chute-phone http://192.168.1.20:6180/mcp --header "Authorization: Bearer a-long-random-secret"oder, mit dem Secret in einer Datei:
chute mcp --url http://192.168.1.20:6180/mcp --token-file ~/.config/chute/phone.token
Die Adresse ist die des Geräts im Netzwerk; sie ändert sich, wenn das Netzwerk dem Gerät eine andere gibt.
Die Endpunkt-Datei
Solange der MCP-Server lauscht, schreibt die Engine mcp-endpoint in ihren Share-Ordner, nur für den Eigentümer lesbar, und löscht die Datei, wenn der Server stoppt. Sie ist ein JSON-Objekt aus Strings: running, configured, url, lan_url (außerhalb von Loopback), bind, port, loopback, token, anonymous und mask_secrets — das, was die Apps zeigen. Auf einem Mac liegt sie unter ~/Library/Application Support/com.R3Studio.Chute-Mac/Share/mcp-endpoint (siehe Dateispeicherorte); deshalb braucht ein lokaler Client weder Port noch Token. Auf iPhone und Apple TV bleibt sie im Container der App: Nehmen Sie die Adresse aus der App.
Maskieren von Geheimnissen
Was ein Agent liest, geht an den Modellanbieter des Agenten. Deshalb erreichen ihn die Geheimnisse der Konfiguration standardmäßig nie: Jedes wird, wo immer es vorkommt — in der Konfiguration und in jedem anderen Ergebnis, das Log eingeschlossen —, durch ein Handle wie <secret:password:3f9c0a1b2e> ersetzt, seine Art und eine Kennung. Serveradressen bleiben sichtbar, der Agent erkennt also weiterhin, auf welchen Server ein Knoten oder ein Download zeigt.
[Proxy]
HK-01 = trojan, hk.example.com, 443, password=<secret:password:3f9c0a1b2e>, sni=hk.example.com
[Proxy Group]
Sub = select, policy-path=https://sub.example.com<secret:url_secret:8d2e4f6a1c>
Was maskiert wird: Proxy-Passwörter, UUIDs, Pre-Shared Keys, private Schlüssel, obfs- und shadow-tls-Passwörter und Tokens wie das von MASQUE — auch die aus WireGuard- und AmneziaWG-Abschnitten und aus den Knoten von Proxy-Providern; die Passwörter von http-auth, external-http-secret und das Passwort von external-controller-access; ca-p12 und ca-passphrase; der Tailscale-Auth-Key; das argument= eines Skripts; Pfad, Query und Benutzerteil von Abonnement-, policy-path-, Regelsatz-, Modul- und #!MANAGED-CONFIG-URLs (Schema, Host und Port bleiben); und die Werte von [Header Rewrite]-Headern namens Authorization, Proxy-Authorization oder mit token, key, secret, auth, password oder cookie im Namen. Ein Geheimnis mit weniger als 8 Zeichen wird dort ersetzt, wo es als Wert eines Felds steht, aber nicht in freiem Text wie einer Log-Zeile, wo es sich von einem gewöhnlichen Wort nicht unterscheiden ließe.
Zurückschreiben. Schreibt der Agent Konfigurationstext zurück, wird ein unverändert gelassenes Handle wieder zu dem Wert, für den es steht; so kann der Agent den Port eines Knotens ändern, ihn umbenennen oder einen Abschnitt umordnen, ohne sein Passwort zu kennen. Ein Handle darf auch verschoben oder kopiert werden, mit zwei Grenzen:
- Es geht nur in ein Feld derselben Art zurück — ein Passwort-Handle in ein Passwortfeld;
- die Zeile muss denselben Server erreichen, von dem das Geheimnis stammt: den Server des Proxys, den Host der URL oder denselben
[General]-Schlüssel.
Ein Handle an anderer Stelle — auf einer Zeile für einen anderen Server, in einer Regel, erfunden oder abgelaufen (siehe unten) — wird mit Zeilennummer und Grund abgelehnt, und nichts wird angewendet: Diesen Wert müssen Sie selbst eintragen. Ein neues Geheimnis, das der Agent ausschreibt, wird so übernommen; es steht dann natürlich bereits im Kontext des Agenten.
Derselbe Wert bekommt immer dasselbe Handle, sodass ein Agent sieht, dass zwei Knoten ein Passwort teilen. Ein Handle gilt, solange der Prozess lebt, der es ausgegeben hat — bis Chute Mac beendet wird oder bis das VPN von Chute iOS oder Chute tvOS getrennt wird; danach wird es abgelehnt, und der Agent liest die Konfiguration neu.
Das Maskieren betrifft die Geheimnisse der Konfiguration. Zugangsdaten in Ihrem eigenen Verkehr — die Cookies einer Website, ein Authorization-Header, den eine App gesendet hat — sind keine Konfigurationsgeheimnisse und werden nicht maskiert; ein Grund mehr, warum es sie nur auf ausdrückliche Anfrage gibt (siehe unten).
Ausschalten. external-mcp-mask-secrets = false — oder der Maskierungsschalter in den Apps — gibt dem Agenten jedes Geheimnis im Klartext, und der Agent erfährt das. Tun Sie das nur, wenn Sie akzeptieren, dass diese Zugangsdaten in den Kontext des Modellanbieters des Agenten gelangen.
Inhalte Dritter
Header und Bodys von Anfragen und Antworten, Log-Zeilen, Skriptausgaben und der Text eines Moduls, das von einer URL geladen wurde, stammen von anderen — einer Website, einer App, dem Betreiber eines Servers. Eine Webseite kann Text enthalten, der wie eine Anweisung an einen Agenten aussehen soll. Deshalb:
- liefern Werkzeuge standardmäßig nur Metadaten: Hosts, URLs, Ports, Richtlinien, Regeln, Prozessnamen, Byte-Zahlen, Zeiten und Status;
- kommt der Inhalt nur, wenn der Agent danach fragt —
get_connectionmitinclude,get_logs,run_script,get_module—, und zwar unter einem Schlüsseluntrusted, den der Agent als Daten lesen soll, nie als Anweisungen.
Das hält den Kontext des Agenten sauber und seine Token-Rechnung klein; eine Zugriffskontrolle ist es nicht. Ein Agent mit dem Token kann die HTTP-Control-API direkt aufrufen und alles lesen.
Werkzeuge
Jedes Werkzeug ist als eine von vier Arten gekennzeichnet; Clients entscheiden danach, was sie Sie vor dem Aufruf fragen.
Nur lesend
| Werkzeug | Was es tut |
|---|---|
get_status |
Ob und wie die Engine läuft: ausgehender Modus, Schalter, TUN, Listener, Speicher, Verbindungen, wie der vorige Lauf endete |
get_network_summary |
Das Netzwerk, in dem das Gerät ist — Art, WLAN-Name, Router —, ob eine SSID-Einstellung Chute dort anhält, und die Adressen des Geräts |
get_traffic |
Bytes hoch und runter und die aktuellen Geschwindigkeiten |
list_policies |
Gruppen mit ihrer aktuellen Wahl, dem Knoten, bei dem sie enden, und dessen Latenz; group für eine Gruppe vollständig, detail für alle Mitglieder |
get_policy |
Die Konfigurationszeile einer Richtlinie und was die Engine jetzt über sie weiß: Server, Port, UDP, Latenz, wohin sie führt |
list_rules |
Die Regeln in Abgleichreihenfolge und woher jede stammt; filter grenzt ein |
match_rule |
Welche Regel und Richtlinie eine Anfrage nähme, vor und nach der Namensauflösung, ohne sie zu senden |
list_user_rules |
Die zur Laufzeit hinzugefügten Regeln |
list_connections |
Offene oder aufgezeichnete Verbindungen, nur Metadaten; Filter nach Host, Prozess, Richtlinie oder Fehlschlag |
get_connection |
Eine Verbindung; Header und Bodys nur, wenn sie in include genannt sind |
get_logs |
Zeilen des Engine-Logs, nach Mindeststufe und Stichwort |
get_events |
Wichtige Momente dieses Laufs; after für nur die neuen |
list_dns_cache |
Die DNS-Einträge und welcher Server jeweils geantwortet hat |
query_dns |
Löst einen Namen über die eigenen Resolver der Engine auf und sagt, welcher geantwortet hat |
geoip_lookup |
Land und ASN einer Adresse oder eines Namens |
get_profile |
Die laufende Konfiguration, seitenweise, mit ihrer revision |
list_profile_sections |
Die Abschnitte der Konfiguration, jeder mit Revision und ob er geschrieben werden kann |
get_profile_section |
Text und Revision eines Abschnitts |
validate_profile |
Liest eine Konfiguration so, wie ein Neuladen es täte, ohne sie anzuwenden |
get_log_level |
Die Log-Stufe und die protokollierten Bereiche |
list_scripts |
Die generic-Skripte, die run_script ausführen kann |
list_rewrites |
Die geltenden Rewrite- und Mock-Response-Regeln und die MitM-Host-Liste |
list_mitm_hosts |
Die Hosts, die entschlüsselt werden |
list_modules |
Die geladenen Module, ihre IDs und ob jedes an ist |
get_module |
Der Text eines Moduls |
list_external_resources |
Regelsätze, Regel-Provider, Proxy-Provider und Module von anderswo: wann jedes aktualisiert wurde, wie viele Einträge es lieferte, sein letzter Fehler |
get_tailscale |
Der Tailscale-Knoten: Identität, Exit-Node, DERP, Peers mit detail |
watch_events |
Beobachtet die Ereignisse der Engine 1 bis 60 Sekunden lang und gibt alle zurück |
Tests
Diese senden eigenen Verkehr.
| Werkzeug | Was es tut |
|---|---|
test_policy |
Eine HTTPS-Anfrage über eine Richtlinie, mit Statuscode und Zeit; bei einer Gruppe jedes Mitglied, einzeln gemeldet |
test_policies |
Mehrere Richtlinien oder alle, einzeln gemeldet |
ping |
ICMP oder die Zeit bis zu einer TCP-Verbindung, direkt vom Gerät |
egress_probe |
Die eigene Adresse dieses Geräts im physischen Netzwerk |
internet_test |
Eine Anfrage an internet-test-url ohne Proxy: Gibt es überhaupt Internet? |
run_diagnostics |
Engine-Zustand, Internettest, Ausgangsadresse und eine DNS-Abfrage, Schritt für Schritt, dann ein Bericht |
Die Zeiten, die test_policy für die Mitglieder einer Gruppe meldet, sind HTTPS-Umläufe; der eigene Test einer Gruppe holt meist eine Klartext-HTTP-URL, daher weichen die Zahlen von denen ab, nach denen die Gruppe wählt. Der eigene Test der Gruppe läuft danach und wählt wie immer.
Einstellungen
| Werkzeug | Was es tut |
|---|---|
set_outbound_mode |
Regel, global oder direkt |
select_policy |
Ein Mitglied einer select-Gruppe oder die globale Auswahl (GLOBAL); automatische Gruppen wählen selbst und lehnen ab |
set_feature |
MitM oder Verkehrsaufzeichnung an oder aus |
set_log_level |
Log-Stufe und protokollierte Bereiche, ohne Neuladen |
edit_user_rules |
Ersetzt, ergänzt oder leert die Laufzeitregeln; eine Zeile, die keine Regel ist, lässt die ganze Änderung scheitern |
add_mitm_host, remove_mitm_host |
Die MitM-Host-Liste |
add_rewrite, remove_rewrite |
Eine URL-, Header- oder Body-Rewrite- oder eine Mock-Response-Regel, geschrieben als Konfigurationszeile |
set_modules_enabled |
Schaltet Module an oder aus |
update_external_resource |
Holt einen Regelsatz, einen Regel-Provider oder einen Proxy-Provider sofort |
replace_profile_section |
Ersetzt einen Abschnitt der Konfiguration oder fügt ihn hinzu und lädt neu |
replace_profile |
Ersetzt die ganze Konfiguration und lädt neu |
Destruktiv
| Werkzeug | Was es tut |
|---|---|
reload_profile |
Macht die Laufzeitänderungen rückgängig: Rewrites, MitM-Hosts und Modulschalter gehen auf den Stand der Konfiguration zurück |
kill_connection |
Schließt eine offene Verbindung; die App am anderen Ende sieht sie abbrechen |
flush_dns |
Leert den DNS-Cache oder den Eintrag eines Namens |
run_script |
Führt eines der generic-Skripte der Konfiguration aus und gibt seine Ausgabe zurück |
Wie Werkzeuge antworten
- Standardmäßig eine Zusammenfassung. Listenwerkzeuge liefern die wichtigsten Felder jedes Eintrags;
detail: trueliefert alle, für mehr Tokens. - Seiten. Lange Listen und Texte nehmen
offsetundlimitund liefernnext_offset, solange es weitergeht. - Höchstens 256 KB. Ein größeres Ergebnis wird nach Einträgen oder Zeilen gekürzt, nie mitten in einem, und meldet
truncated: truemit demnext_offsetzum Weiterlesen — was ankommt, ist immer gültiges JSON. - Fehler in Worten. Ein Werkzeug, das scheitert, sagt in einem Satz, mit dem der Agent etwas anfangen kann, warum — statt eines nackten Statuscodes.
Wie lange eine Änderung hält
Auf Chute iOS und Chute tvOS wird jede Änderung nur in der laufenden Engine vorgenommen. Nichts wird in die Konfigurationsdatei oder in die eigenen Einstellungen der App geschrieben; ein Neustart bringt also zurück, was dort steht, wie bei der Web-Konsole.
Auf Chute Mac behält die App diese Änderungen, so wie sie dieselben Änderungen aus ihren eigenen Menüs behält; sie überstehen also einen Neustart — ob ein Agent sie vornimmt oder die Web-Konsole, der Befehl chute oder die HTTP-Control-API:
- der ausgehende Modus und die Richtlinienauswahl, die globale eingeschlossen (
set_outbound_mode,select_policy): Die App merkt sie sich; - MitM und die Datenverkehrsaufzeichnung (
set_feature): in die aktuelle Konfigurationsdatei geschrieben; - die Konfiguration selbst (
replace_profile,replace_profile_section): in die aktuelle Konfigurationsdatei geschrieben und dann so angewendet, wie Speichern & anwenden der App sie anwendet.
Ihre Ergebnisse sagen persisted: true, und die Beschreibungen, die der Agent liest, sagen es ihm vorab. Ein Schreiben der Konfiguration wird in diesen Fällen abgelehnt, und es wird nichts geschrieben:
| Situation | Code | Was zu tun ist |
|---|---|---|
| Das Hauptfenster hat ungesicherte Änderungen | user_editing |
Sie zuerst in der App sichern oder verwerfen |
| Die Konfigurationsdatei wurde außerhalb von Chute geändert | file_changed |
Sie zuerst in Chute neu laden |
| Die aktuelle Konfiguration ist keine lokale Datei | profile_missing |
— |
| Die App zeigt einen Dialog | needs_user_action |
Ihn beantworten, dann erneut versuchen |
Eine Konfiguration, die die Engine ablehnt, wird ebenfalls nicht in die Datei geschrieben. Ist die App nach 10 Sekunden nicht fertig, erhält der Agent host_busy: Die Änderung kann trotzdem noch wirksam werden, deshalb liest der Agent den Zustand erneut, bevor er es noch einmal versucht. Gut zu wissen: set_feature schaltet MitM oder die Datenverkehrsaufzeichnung sofort um und schreibt den Schalter in die Datei, lädt die Konfiguration aber nicht neu; Text und revision, die get_profile gleich danach liefert, sind deshalb bis zum nächsten Neuladen noch die alten.
Auf allen Plattformen gelten Log-Stufe, Rewrites, MitM-Hosts, Modulschalter und Laufzeitregeln nur für diesen Lauf, und ein Neuladen der Konfiguration aus der App macht Rewrites, MitM-Hosts und Modulschalter ebenfalls rückgängig. reload_profile macht Rewrites, MitM-Hosts und Modulschalter ohne Neuladen rückgängig; Log-Stufe, der LAN-Verbindungsschalter der App, ausgehender Modus und Richtlinienauswahl bleiben, wie sie sind. Die Laufzeitregeln von edit_user_rules überstehen ein Neuladen und verschwinden, wenn die Engine stoppt.
Die Konfiguration bearbeiten
Lassen Sie den Agenten die Konfiguration abschnittsweise ändern: get_profile_section liest einen Abschnitt und seine Revision, replace_profile_section schreibt ihn mit dieser Revision zurück. Hat sich der Abschnitt dazwischen geändert, wird das Schreiben abgelehnt und der Agent aufgefordert, neu zu lesen; eine Änderung an einem anderen Abschnitt stört nicht, sodass zwei Agenten verschiedene Abschnitte bearbeiten können. Das Paar für die ganze Datei, get_profile und replace_profile, funktioniert genauso mit der revision der Konfiguration, aber eine große Konfiguration passt nicht in eine Antwort, und replace_profile nimmt höchstens 1 MB.
- Ein Abschnitt mit einer
#!include-Zeile, jeder Abschnitt danach und der Abschnitt mit#!MANAGED-CONFIGlassen sich so nicht schreiben. - Ein geschriebener Abschnitt wird aus der neu geladenen Konfiguration zurückgelesen: Werte von
[General]und[MITM]werden so geschrieben, wie Chute sie schreibt, und Schlüssel von[WireGuard …]umsortiert, daher kann der Text vom Gesendeten abweichen. Die Antwort enthält die neue Revision für das nächste Mal. - Eine Konfiguration, die Chute ablehnt, wird nicht angewendet; der Agent erfährt den Grund. Bei einer verwalteten Konfiguration ersetzt die nächste verwaltete Aktualisierung die Änderung.
Fortschritt bei langen Werkzeugen
test_policy auf eine Gruppe, test_policies, run_diagnostics und watch_events melden unterwegs. Ein Client, der Fortschritt anfordert (ein progressToken) und einen Event-Stream annimmt, erhält je Mitglied, Richtlinie, Schritt oder Ereignis ein notifications/progress, dann das Ergebnis, und der Stream schließt sich; andere Clients erhalten nur das Ergebnis, wenn das Werkzeug fertig ist. Ein langes Werkzeug läuft höchstens 60 Sekunden und liefert dann, was es hat; höchstens vier streamen gleichzeitig. Ein Client, der den Stream schließt, bricht den Aufruf ab; bereits gesendete Messungen laufen trotzdem zu Ende und aktualisieren die Gruppe.
Sicherheit
- Das Token ist volle Kontrolle. Wer es hat, kann Ihre Konfiguration, Ihren Verbindungsverlauf und Ihr Log lesen, Ihr Routing ändern und Ihre Skripte ausführen — und es ist zugleich das Token der HTTP-Control-API. Halten Sie es aus geteilten Dateien und Bildschirmfotos heraus; um es zu ändern, geben Sie
external-http-secreteinen neuen Wert. - Lauschen im Netzwerk lässt es jedes Gerät in diesem Netzwerk versuchen. Die Verbindung ist Klartext-HTTP, das Token geht also unverschlüsselt durchs Netz, und Fehlversuche werden nicht gesperrt: Verwenden Sie ein langes zufälliges
external-http-secret, nur in Netzen, denen Sie vertrauen, und kehren Sie danach zu127.0.0.1zurück. run_scriptführt Code aus. Es führt nur die generic-Skripte aus, die die Konfiguration definiert, aber was ein Skript tut — Anfragen, gespeicherte Werte, Mitteilungen —, tut es, wenn der Agent es verlangt. Ein Agent, der die Konfiguration schreiben darf, kann auch ein Skript hinzufügen und es dann ausführen; lesen Sie, was er ändert.- Webseiten bleiben draußen. Eine Anfrage mit dem
Origineiner anderen Webseite als des Servers selbst wird mit403abgelehnt, und es werden keine Cross-Origin-Header gesendet; eine Website, die Sie besuchen, kann den Server also nicht über Ihren Browser erreichen.
Diese Seite ist eine Übersetzung der englischen Version. Bei Abweichungen ist die englische Version maßgeblich.