Verschiedene Optionen

[General]
ipv6 = true
loglevel = notify

skip-proxy = 127.0.0.1, 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12, 100.64.0.0/10, localhost, *.local

tun-excluded-routes = 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12
tun-included-routes = 192.168.1.12/32

Allgemeine Optionen

Vollständige IPv6-Unterstützung aktivieren (Standard: true)

ipv6 = true

Bei false verlieren DNS-Antworten ihre AAAA-Records und IPv6-Hinweise, und der Fake-IP-Pool antwortet auf AAAA nicht; der Rest der Antwort — ihre A-Records und alle anderen Records — bleibt erhalten.

loglevel (Standard: warning)

loglevel = notify

Einer von none, fatal, warning, notify, info oder verbose. Es wird nicht empfohlen, verbose im täglichen Gebrauch zu aktivieren, da dies die Leistung erheblich verlangsamt.

skip-proxy

skip-proxy = 127.0.0.1, 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12, 100.64.0.0/10, localhost, *.local

In der iOS- und der tvOS-Version wird ein Hostname-Eintrag der Proxy-Ausnahmeliste des Tunnels hinzugefügt, sodass Verbindungen dorthin von Chute TUN statt von Chute Proxy verarbeitet werden; ein Eintrag mit IP-Adresse oder CIDR wird zusätzlich zu einer ausgeschlossenen Route des Tunnels, sodass Verkehr in diesen Bereich den Tunnel ganz verlässt, statt von Chute TUN verarbeitet zu werden. Chute Android macht es im VPN-Modus genauso: Solange System-HTTP-Proxy eingeschaltet ist, kommen Hostnamen, *-Platzhalter und IPv4-Adressen in die Ausnahmeliste des Proxys, den das VPN an die Apps übergibt, und ab Android 13 wird jeder Eintrag mit IP-Adresse oder CIDR zu einer ausgeschlossenen Route des VPN — eine einzelne Adresse als /32- oder /128-Route; Loopback-Einträge werden ausgelassen, da Loopback-Verkehr den Tunnel nie betritt. In der macOS-Version werden diese Einstellungen auf das System angewendet, wenn „Als Systemproxy festlegen“ aktiviert ist. Solange der Erweiterte Modus eingeschaltet ist, bleiben Einträge mit IP-Adresse oder CIDR außerdem außerhalb des Tunnels, in beiden Typen des Erweiterten Modus, wie unter iOS — siehe Ausgeschlossene Routen; beim Typ PacketTunnel gelten dieselben Ausnahmen zudem für den HTTP/HTTPS-Proxy, den der Tunnel trägt, solange der Systemproxy eingeschaltet ist. Diese Option wird verwendet, um Kompatibilitätsprobleme mit einigen Apps zu beheben.

  • Um eine einzelne Domain anzugeben, geben Sie den Domainnamen ein - zum Beispiel apple.com.
  • Um alle Websites auf einer Domain anzugeben, verwenden Sie ein Sternchen vor dem Domainnamen - zum Beispiel *apple.com.
  • Um einen bestimmten Teil einer Domain anzugeben, geben Sie jeden Teil an - zum Beispiel store.apple.com.
  • Um Hosts oder Netzwerke nach IP-Adressen anzugeben, geben Sie eine bestimmte IP-Adresse wie 192.168.2.11 oder einen Adressbereich wie 192.168.2.* oder 192.168.2.0/24 ein.

Hinweis: Wenn Sie eine IP-Adresse oder einen Adressbereich eingeben, können Sie den Proxy nur umgehen, wenn Sie über diese Adresse eine Verbindung zu diesem Host herstellen, nicht wenn Sie über einen Domainnamen eine Verbindung herstellen, der zu dieser Adresse aufgelöst wird.


Proxy-Server-Listening

interface = 127.0.0.1
port = 8118
socks-interface = 127.0.0.1
socks-port = 8119

interface / port steuern die Lauschadresse und den Port des HTTP-Proxy-Servers (Standard 127.0.0.1:8118). socks-interface / socks-port steuern den SOCKS5-Proxy-Server (Standard 127.0.0.1:8119). Unter iOS und tvOS laufen die beiden Listener nur, wenn sie an alle Schnittstellen gebunden sind — mit allow-wifi-access = true, einem interface / socks-interface von 0.0.0.0 oder unter iOS dem Schalter LAN-Verbindungen erlauben der App —, mit dem Standard 127.0.0.1 lauscht dort also nichts auf diesen Ports; Chute Mac und Chute Android starten sie immer. Andere Geräte zu bedienen ist auf jeder Plattform Chute Pro: Ohne Chute Pro wird eine Nicht-Loopback-Adresse ignoriert, die Bindung bleibt auf 127.0.0.1, sodass die Listener unter iOS und tvOS gar nicht starten.

Ist ein Port belegt, weicht der Server auf den jeweils nächsten aus und versucht bis zu 20 Ports, beginnend mit dem konfigurierten; ist keiner frei, startet dieser Server nicht, und der Rest der Engine läuft weiter. Welcher Port tatsächlich verwendet wird, melden http_port und socks_port in GET /api/status, und die Übersicht der Web-Konsole zeigt ihn an. Das UDP-Relay des SOCKS5-Servers bindet einen eigenen Port und wandert nicht mit dem TCP-Listener: Nach einem Ausweichen kann es noch auf dem konfigurierten Port liegen oder auf einem ganz anderen. Die Antwort auf UDP ASSOCIATE nennt immer den Port, den das Relay tatsächlich verwendet; ein Client, der seine Datagramme gemäß RFC 1928 an die Adresse aus dieser Antwort schickt, ist daher nicht betroffen.

Geben Sie port und socks-port einen Wert von 1 bis 65535: Beim Laden der Konfiguration wird ihr Bereich nicht geprüft, und mit einem Wert außerhalb dieses Bereichs startet der Server entweder nicht oder lauscht am Ende auf einem anderen Port. Über http-listen / socks5-listen geschrieben, ist ein solcher Port ein Konfigurationsfehler.

Für eine unverschlüsselte http://-Anfrage wickelt der HTTP-Proxy-Server pro Verbindung genau einen Anfrage-Antwort-Austausch ab: Jede Antwort geht mit Connection: close hinaus, danach wird die Verbindung geschlossen, und der Client sendet seine nächste Anfrage über eine neue Verbindung. Eine hinter der ersten per Pipelining gesendete Anfrage wird verworfen; der Client sendet sie auf der neuen Verbindung erneut. Ein Authentifizierungsverfahren, das mehrere Durchgänge auf derselben Verbindung braucht, etwa NTLM oder Negotiate, kann darüber nicht abgeschlossen werden. Ein nicht entschlüsselter CONNECT-Tunnel ist davon nicht betroffen. Ein WebSocket-Upgrade behält seine Verbindung: Nach der 101-Antwort laufen die Daten in beide Richtungen unverändert durch.

Kompatibilitäts-Aliase: doh-server und doh-service werden als Aliase von doh akzeptiert; http-listen / socks5-listen (z. B. 0.0.0.0:6152, [::]:6153 oder ein bloßer Port) werden auf die obigen interface/port-Einstellungen abgebildet. Ein Wildcard-Listen-Host (0.0.0.0, :: oder *) setzt außerdem allow-wifi-access = true.


Eingehende Proxy-Authentifizierung

http-auth = username:password

Erfordert, dass sich Clients authentifizieren, bevor sie die HTTP- und SOCKS5-Proxy-Server von Chute verwenden. Die Zeile kann wiederholt werden, um mehrere Anmeldedaten zu erlauben.

Der HTTP-Proxy beantwortet eine Anfrage ohne gültige Anmeldedaten — eine gewöhnliche Anfrage ebenso wie ein CONNECT — mit 407 Proxy Authentication Required und Proxy-Authenticate: Basic realm="KLNEKit" und schließt dann die Verbindung. Der SOCKS5-Server nimmt dieselben Anmeldedaten über die Benutzername/Passwort-Authentifizierung von SOCKS5 entgegen und schließt eine Verbindung, die diese nicht anbietet oder daran scheitert.


Systemanfragen umgehen

bypass-system = true

Wenn aktiviert, hängt Chute eine feste Liste von 18 Apple-Hostnamen — Push, iCloud-Gateway, Captive-Portal-Prüfung, OCSP und ähnliche — an skip-proxy an und hängt IP-CIDR,17.0.0.0/8,DIRECT,no-resolve hinter Ihre Regeln an, unmittelbar vor FINAL — eine eigene Regel, die 17.0.0.0/8 zuerst trifft, hat also weiterhin Vorrang. Es gibt keine prozessbasierte Zuordnung: Die Option ist genau diese feste Host- und Adressliste, kein Filter darauf, welcher Prozess die Anfrage gestellt hat.

Standard: true.


Immer echte IP

always-real-ip = *.example.com, tracker.example.org

Wenn Chute gefälschte IP-Adressen für gekaperte DNS-Abfragen bereitstellt (siehe hijack-dns), werden Hostnamen, die dieser durch Kommas getrennten Liste entsprechen, immer mit ihren echten aufgelösten IP-Adressen beantwortet. Wildcards werden unterstützt. always-ip-address (Shadowrockets Schreibweise) wird als dieser Schlüssel gelesen: Ein boolescher Wert (true, yes, on, 1) meint jeden Host und wird zu always-real-ip = * umgeschrieben; false wird verworfen; jeder andere Wert wird als Hostliste gelesen. Gespeichert wird die Konfiguration mit der Schreibweise always-real-ip.


System-Hosts-Datei lesen

read-etc-hosts = false

Legt fest, ob die Hosts-Datei des Systems in die [Host]-Tabelle eingelesen wird. Setzen Sie den Wert auf false, um diese Datei zu ignorieren; eine Änderung wird beim Neuladen wirksam. Siehe Lokale DNS-Zuordnung.

Standard: true.


Bestehende Verbindungen unterbrechen

interrupt-exist-connections = true

Wenn aktiviert, schließt eine Änderung der Route die bestehenden Verbindungen, die unter der alten aufgebaut wurden, sodass sie sofort die neue Route verwenden, statt bis zu ihrem Ende auf der alten zu verweilen. Diese Änderungen zählen:

  • Eine Richtliniengruppe wählt ein anderes Mitglied — von selbst (URL-Test, Fallback, SSID) oder durch manuelle Auswahl. Die Verbindungen, die das verlassene Mitglied verwendeten, werden geschlossen. Eine Load-Balance-Gruppe verteilt Verbindungen auf ihre Mitglieder und zählt nie als Wechsel.
  • Eine Änderung der für den globalen Modus ausgewählten Richtlinie, der das integrierte PROXY folgt: Die Verbindungen, die der globale Modus an die alte Richtlinie geschickt hat, und die, die sie über PROXY erreicht haben, werden geschlossen.
  • Ein Wechsel des ausgehenden Modus zwischen Regel, Global und Direkt: Jede Verbindung wird geschlossen.
  • Ein Neuladen, das die DNS-Server, [Host], die Richtlinien, Richtliniengruppen oder Proxy-Provider oder die Regeln oder Regelsätze ändert: Jede Verbindung wird geschlossen.

Das gilt für jede Richtliniengruppe, die eine Verbindung durchläuft: die Gruppe, die ihre Regel nennt, eine darin verschachtelte Gruppe, die Upstream-Gruppe einer verketteten Richtlinie (underlying-proxy) und die Mitgliedsgruppen einer Relay-Gruppe.

Nach einem Gruppenwechsel oder einer Änderung der Richtlinie des globalen Modus wird jede betroffene Verbindung ordnungsgemäß mit einer 3-Sekunden-Zeitüberschreitung geschlossen, bevor sie zwangsweise getrennt wird; ein Moduswechsel oder ein Neuladen schließt sie sofort. Ein gewöhnlicher UDP-Flow wird durch nichts davon geschlossen. Regeln, die über /api/rules/user hinzugefügt wurden, unterliegen dieser Option nicht: Standardmäßig schließen sie die Verbindungen, die sie anderswohin leiten, ob die Option an oder aus ist.

Standard: false. Dies ist eine globale Einstellung — sie betrifft alle Richtliniengruppen.


Network Framework (macOS / iOS / tvOS)

network-framework = true

Aktiviert Apple Network.framework für ausgehende Verbindungen. Die Verwendung von Network.framework kann eine bessere Leistung und moderne TLS-Stack-Integration auf unterstützten Plattformen bieten.

Standard: true auf macOS, false auf iOS und tvOS.


Einfache Hostnamen ausschließen

exclude-simple-hostnames = true

Wenn aktiviert, umgehen Anfragen an einfache Hostnamen (einzelne Bezeichnungen ohne Punkt, z. B. localhost) die Proxy-Regeln und werden lokal aufgelöst. Dies hilft, unnötige DNS-Abfragen für lokale Netzwerknamen zu vermeiden. Dies ist die Einstellung „Einfache Hostnamen ausschließen“ des macOS-Systemproxys selbst: Chute Mac schreibt sie in die Systemproxy-Konfiguration, sie gilt also nur für Anwendungen, die dem Systemproxy folgen — nicht für den Erweiterten Modus oder TUN-Verkehr. Unter iOS und tvOS wird sie auf dieselbe Weise in die Proxy-Einstellungen des Tunnels geschrieben; ein einfacher Hostname wird dann von Chute TUN statt von Chute Proxy verarbeitet, wie ein Hostname in skip-proxy. Chute Android verwendet sie nicht.

Auf Chute Mac aktiviert eine einmalige Migration diese Option beim ersten Start standardmäßig; eine explizite Aus-Einstellung des Benutzers wird respektiert.

Standard: false.


Datenbankaufzeichnung deaktivieren

disable-db-record = true

Wenn aktiviert, stoppt Chute das Schreiben von Verkehrsaufzeichnungen in die lokale Datenbank. Dies kann die Leistung verbessern und die Speichernutzung reduzieren, jedoch ist der Verkehrsverlauf dann im Chute Dashboard nicht verfügbar.

Standard: false.


menu-bar-show-speed = true

Wenn aktiviert, zeigt Chute Mac die aktuelle Upload- und Download-Geschwindigkeit in der Menüleiste an.

Wird geparst, von der aktuellen Engine aber nicht angewendet — nichts in Chute Mac liest diesen Schlüssel. Die Geschwindigkeit in der Menüleiste wird über den Menüeintrag Verbindungsgeschwindigkeit anzeigen geschaltet, der in den eigenen Einstellungen der App abgelegt ist. Der Schlüssel wird beim Speichern der Konfiguration weiterhin zurückgeschrieben.


Andere DNS-Server kapern

hijack-dns = 8.8.8.8:53

Standardmäßig gibt Chute nur gefälschte IP-Adressen für DNS-Abfragen zurück, die an die Chute-DNS-Adresse (198.18.0.2) gesendet werden. Abfragen, die an Standard-DNS gesendet werden, werden einfach weitergeleitet.

Einige Geräte oder Software verwenden immer einen fest codierten DNS-Server. (Zum Beispiel verwenden Google Speakers immer 8.8.8.8). Sie können diese Option verwenden, um die Abfrage zu kapern und eine gefälschte Adresse zu erhalten.

Sie können hijack-dns = *:53 verwenden, um alle DNS-Abfragen zu kapern.

Ein Eintrag ohne Port meint Port 53, hijack-dns = 8.8.8.8 ist also 8.8.8.8:53. Ein Eintrag, der sich nicht lesen lässt, wird mit einem Hinweis übersprungen; der Rest der Zeile gilt weiterhin.

Fake IP ist auch auf Apple TV verfügbar (tvOS 17 und neuer). Es war dort deaktiviert; die Überprüfung auf einem Gerät läuft noch.


Ausgeschlossene Routen

tun-excluded-routes = 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12

Chute VIF kann nur TCP- und UDP-Protokolle verarbeiten. Verwenden Sie diese Option, um bestimmte IP-Bereiche zu umgehen, damit der gesamte Verkehr durchgelassen wird.

Hinweis: Diese Option gilt für die Packet-Tunnel unter iOS und tvOS, wo die Bereiche zu ausgeschlossenen Routen der IP-Einstellungen des Tunnels werden, sowie für Chute Android ab Android 13, wo sie zu ausgeschlossenen Routen des VPN werden — Android 11 und 12 bieten keine Schnittstelle für ausgeschlossene Routen, dort werden die Bereiche ignoriert. Anfragen, die vom Chute Proxy Server verarbeitet werden, sind nicht betroffen. Kombinieren Sie 'skip-proxy' und 'tun-excluded-routes', um sicherzustellen, dass bestimmter HTTP-Verkehr Chute umgeht.

Unter macOS gilt sie in beiden Typen des Erweiterten Modus, und außerhalb des Tunnels bleibt dieselbe Liste wie bei den Tunneln von iOS und tvOS: die Bereiche dieser Option, die Bereiche von bypass-tun und die IP-Adress- und CIDR-Einträge von skip-proxy — Hostname-Einträge sind keine Routen und spielen keine Rolle. Beim Typ PacketTunnel werden die Bereiche zu ausgeschlossenen Routen der IP-Einstellungen des Tunnels, wie unter iOS. Beim Typ Helper utun lässt der Helfer sie aus den Routen heraus, die er auf das utun richtet, sodass Verkehr dorthin den gewöhnlichen Routen des Systems folgt; von IPv6 richtet der Helfer nur 2000::/3 auf das utun, dort ändern also nur IPv6-Bereiche innerhalb von 2000::/3 etwas. IPv6-Bereiche zählen nur, wenn der Tunnel IPv6 trägt (ipv6 = true). Ein Eintrag mit der Präfixlänge 0 (0.0.0.0/0, ::/0) oder einer, der sich mit Loopback (127.0.0.0/8, ::1) oder den eigenen Subnetzen des Tunnels (198.18.0.0/15, fd12:1:1:1::/64) überschneidet, wird übersprungen und im Protokoll vermerkt — das 127.0.0.1, das skip-proxy meist enthält, wird also einfach übersprungen. Ein Eintrag in tun-included-routes, der spezifischer ist als ein ausgeschlossener Bereich, gewinnt weiterhin, denn Routen werden nach Präfixlänge gewählt. Eine geänderte Liste wirkt, sobald die Konfiguration neu geladen wird.

Diese Option könnte einen Systemfehler ENOMEM (Cannot allocate memory) verursachen. Es scheint ein Fehler im iOS-System zu sein. Bitte verwenden Sie diese Option nach Möglichkeit nicht.


Eingeschlossene Routen

tun-included-routes = 192.168.1.12/32

Standardmäßig deklariert sich die Chute-VIF-Schnittstelle als Standardroute. Da die WLAN-Schnittstelle jedoch eine kleinere Route hat, kann ein Teil des Verkehrs möglicherweise nicht über die Chute-VIF-Schnittstelle laufen. Verwenden Sie diese Option, um eine kleinere Route hinzuzufügen.

Warum eine Standardroute nicht genügt: Das System wählt eine Route nach Präfixlänge, nicht nach Reihenfolge. Das eigene On-Link-Subnetz der physischen Schnittstelle — etwa 192.168.1.0/24 — ist spezifischer als das 0.0.0.0/0 des Tunnels, dieser Verkehr erreicht Chute also nie. Ein Eintrag hier installiert eine noch spezifischere Route und gewinnt. Die Routen kommen zur Standardroute hinzu und schränken niemals ein, was der Tunnel erfasst.

Hinweis: Führen Sie die privaten Bereiche (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) nicht pauschal auf. Das ist normalerweise unnötig und kann das Routing des Systems durcheinanderbringen; Chute befolgt einen solchen Eintrag, protokolliert aber eine Warnung — außer in der Variante „Network Extension“ des Erweiterten Modus unter macOS, die ihn ohne Warnung befolgt. Der übliche Grund für diese Option ist, einen Bereich zu erreichen, der dem Tunnel einer anderen VPN-App gehört.

Hinweis: Ein Eintrag, der den Ast absägen würde, auf dem Chute sitzt, wird abgelehnt, mit der Begründung im Protokoll: Loopback, die eigenen Subnetze des VIF (198.18.0.0/15 und fd12:1:1:1::/64), Link-Local, Multicast, Broadcast sowie eine Präfixlänge von 0. Die Variante „utun des Helfers“ des Erweiterten Modus unter macOS lehnt zusätzlich einen Eintrag ab, der das aktuelle Standard-Gateway abdeckt. In der Variante „Network Extension“ landet die Begründung im Systemprotokoll statt in dem von Chute.

Hinweis: Auf dem iPhone entscheidet das System getrennt darüber, ob das lokale Netzwerk erfasst wird. Ein hier aufgeführtes lokales Subnetz wird nur berücksichtigt, wenn in den Einstellungen der App zusätzlich Lokale Netzwerke einbeziehen aktiv ist — ein Schalter, der sich nur einschalten lässt, solange Alle Netzwerke einbeziehen aktiv ist; ein Bereich, der dem Tunnel einer anderen App gehört, braucht keinen solchen Schalter. Chute tvOS zeigt dieselben Schalter, wendet sie aber nicht auf den Tunnel an. Unter macOS werden die Routen direkt installiert, dort gibt es keine solche Hürde.

Hinweis: Unter macOS installiert die Variante „utun des Helfers“ des Erweiterten Modus diese Routen, sobald die Schnittstelle angehängt wird; eine geänderte Liste hängt die Schnittstelle beim Neuladen also erneut an. Diese Option setzt Helfer-Version 0.8.6 oder neuer voraus — genehmigen Sie nach einem Update von Chute einmal die Abfrage zur Neuinstallation des Helfers, sonst meldet die Variante „utun des Helfers“, dass der Helfer nicht läuft.


Protokollerkennung

sniffing-enabled = true
sniffing-timeout = 100

Chute kann das tatsächliche Protokoll einer Verbindung erkennen, indem es die ersten Bytes untersucht. Dies ermöglicht, dass Regeln wie PROTOCOL,TLS,Proxy auch für eingehende Nicht-HTTP-Verbindungen korrekt funktionieren.

sniffing-enabled (Standard: false)

sniffing-enabled = true

Aktiviert die Protokollerkennung für TCP-Verbindungen. Im Erweiterten Modus erlaubt derselbe Schalter, einen HTTP/3-(QUIC-)Datenstrom zu einer nackten IP-Adresse nach Namen zu behandeln: Chute liest den Servernamen aus dem QUIC-ClientHello, DOMAIN-Regeln sehen diesen Namen statt der Adresse, und jedes weitere Paket des Datenstroms folgt dem Urteil des ersten. Ein ClientHello, das nicht in ein Paket passt — bei Post-Quanten-Schlüsselaustausch üblich —, wird je Datenstrom aus den Initial-Paketen, die es tragen, wieder zusammengesetzt, bis zu einem zusammengesetzten Hello von 16 KiB, sodass auch sein Name gelesen wird. Solange der Rest des Hellos noch aussteht, werden die Datagramme des Datenstroms zurückgehalten, statt mit ihrer nackten Adresse gesendet zu werden, und gehen gemeinsam hinter dem Namen hinaus, sobald dieser gelesen ist — das erste Fragment eines geteilten Hellos nimmt also nicht mehr einen anderen Weg als der Rest. Die Sicherungen sind eine Wartezeit von einer Sekunde, acht Datagramme oder 16 KiB je Datenstrom sowie 64 gleichzeitig zusammengesetzte Datenströme; ein Datenstrom jenseits davon — oder einer, dessen Initial-Pakete das ClientHello nie vervollständigen — wird wie bisher nach Adresse behandelt.

Bei einer Verbindung zu einer echten Adresse sehen die Regeln den Namen, den der Client selbst nennt – die TLS-SNI oder den HTTP-Host –, auch wenn der DNS-Cache von Chute für diese Adresse bereits einen Namen kennt: Der Cache hält je Adresse nur einen Namen, den zuletzt dorthin aufgelösten, und hinter einer geteilten Adresse kann das der einer anderen Website sein. Der Name aus dem Cache wird verwendet, wenn sich aus der Verbindung keiner lesen lässt. Eine Anfrage, die für einen HTTP-Proxy geschrieben ist – CONNECT oder eine Anfrage, deren Ziel eine vollständige URL ist –, wird weiterhin als HTTP erkannt, doch der darin genannte Host ist das nächste Ziel dieses Proxys und nicht der Name dieser Verbindung; die Verbindung behält den Namen aus dem Cache oder die Adresse. Ein Protokoll, bei dem der Server zuerst sendet, liefert keinen Namen zum Auslesen: Verbindungen zu den Ports 21, 22, 23, 25, 110, 119, 143, 587, 2222, 2525, 3306 und 5900 werden ohne Erkennung sofort verbunden; auf jedem anderen Port wartet ein solches Protokoll sniffing-timeout ab, bevor es verbunden wird.

sniffing-timeout (Standard: 100ms)

sniffing-timeout = 200

Maximale Zeit in Millisekunden, um auf die ersten Daten zur Protokollbestimmung zu warten. Erhöhen Sie diesen Wert, wenn die Protokollerkennung bei langsamen Verbindungen fehlschlägt.


QUIC blockieren

block-quic = auto

Steuert, ob Chute erkannten QUIC-Datenverkehr einschließlich HTTP/3 abweist. QUIC läuft über UDP und kann durch Chutes HTTP-MitM nicht entschlüsselt werden. Das Abweisen von QUIC kann kompatible Clients dazu veranlassen, die Verbindung über TCP erneut aufzubauen. Dadurch können die TCP-basierte Proxy-Verarbeitung und, sofern konfiguriert, die HTTPS-Entschlüsselung angewendet werden.

Wert Verhalten
off Keine globale QUIC-Blockierung anwenden (Standard). Erkannter QUIC-Datenverkehr folgt den normalen Routing-Regeln.
on Jeden erkannten QUIC-Datenstrom abweisen, einschließlich des zu DIRECT gerouteten Datenverkehrs.
auto Erkanntes QUIC nur abweisen, wenn die endgültige ausgehende Richtlinie ein Proxy ist. Zu DIRECT gerouteter Datenverkehr wird zugelassen; zu REJECT gerouteter Datenverkehr bleibt durch diese Regel abgewiesen.
all Surges Schreibweise für on.
all-proxy, per-policy Surges Schreibweisen, beide als auto gelesen — Chute kennt kein QUIC-Blockieren je Richtlinie, sodass per-policy QUIC auf jedem über einen Proxy geführten Datenstrom blockiert. Das geschriebene Wort bleibt beim Speichern des Profils erhalten.

Bei über TUN eingehendem Datenverkehr antwortet Chute auf einen abgewiesenen QUIC-Datenstrom mit einer ICMP/ICMPv6-Port-Unreachable-Meldung. Kompatible Clients können dadurch auf TCP zurückfallen, ohne auf einen QUIC-Timeout zu warten.

Ein abgewiesener QUIC-Datenstrom wird mit REJECT als Richtlinie aufgezeichnet, gleich welche Richtlinie die Regel gewählt hat.

Die QUIC-Erkennung für block-quic erfolgt automatisch und benötigt sniffing-enabled nicht. sniffing-enabled steuert die Protokollerkennung — TLS auf TCP und den Servernamen eines QUIC-Datenstroms. Verwenden Sie eine Regel vom Typ PROTOCOL,QUIC,..., um einzelne QUIC-Datenströme regelbasiert zu behandeln.


ICMP im Tunnel beantworten

icmp-auto-reply = false

Eine ICMP-Echo-Anfrage, die in den Tunnel gelangt — IPv4 wie IPv6 —, beantwortet Chute selbst: Die Antwort entsteht lokal, und an das Ziel wird nichts gesendet. Deshalb antwortet jedes Ziel, auch eine Adresse, die eine Regel mit REJECT belegen würde, und ein Host, der nicht erreichbar ist — ein erfolgreicher ping im Tunnel sagt also nichts darüber aus, ob das Ziel erreichbar ist. Auf false gesetzt, wird nicht mehr geantwortet: Die Anfrage wird dann aus dem Gerät hinausgeleitet, ihre Antwort kommt aber nie durch den Tunnel zurück, sodass der Ping nie beantwortet wird.

Standard: true. Gilt für Verkehr, der über TUN eintrifft; ICMP wird nie über einen Proxy geleitet.


TUN umgehen

bypass-tun = 192.168.0.0/16, 10.0.0.0/8

Ähnlich wie skip-proxy, arbeitet jedoch auf der TUN/VIF-Routing-Ebene. Verbindungen zu diesen IP-Bereichen umgehen die TUN-Schnittstelle vollständig und gehen direkt durch den Systemnetzwerkstack.

Hinweis: Diese Option gilt für die Packet-Tunnel unter iOS und tvOS, wo ihre Bereiche zusammen mit tun-excluded-routes zu ausgeschlossenen Routen des Tunnels werden, und ebenso für Chute Android ab Android 13 (Android 11 und 12 ignorieren sie). Unter macOS kommen ihre Bereiche in beiden Typen des Erweiterten Modus zu tun-excluded-routes hinzu — siehe Ausgeschlossene Routen.


Fehlerseite für Ablehnung anzeigen

show-error-page-for-reject = true

Wenn aktiviert, gibt Chute eine benutzerfreundliche Fehlerseite für abgelehnte Anfragen zurück. Das gilt nur für eine Anfrage, die über den HTTP-Proxy-Eingang eingetroffen ist; ist die Option aus, wird eine solche Anfrage stattdessen mit HTTP/1.1 503 Service Unavailable beantwortet. Eine abgelehnte Anfrage aus jedem anderen Eingang wird so oder so verworfen.

Standard: false.


Optimistisches DNS

optimistic-dns = false

Wenn aktiviert, wird ein zwischengespeicherter Eintrag auch nach Ablauf seiner TTL sofort zurückgegeben, während er im Hintergrund erneut abgefragt wird. Dies reduziert die Verbindungslatenz auf Kosten möglicherweise veralteter DNS-Einträge. Ein abgelaufener Eintrag wird nur für begrenzte Zeit so zurückgegeben: so lange wie seine eigene TTL, mindestens aber fünf Minuten; danach wartet die Abfrage auf die Antwort des Upstreams. Ist sie aus, wird ein Eintrag, dessen TTL abgelaufen ist, nicht ausgeliefert, und die Abfrage geht zum Upstream; dessen Antwort füllt den Cache wieder, sodass die nächste Abfrage aus dem Cache beantwortet wird. Beim Wechsel in ein anderes Netzwerk oder wenn sich die Liste der DNS-Server ändert, gelten alle zwischengespeicherten Einträge als abgelaufen. Sie steuert außerdem — auf jeder Plattform —, ob der Tunnel mehrere Adressen eines Namens gleichzeitig anwählt.

Standard: true. Setzen Sie optimistic-dns = false zum Deaktivieren.


WLAN-Zugriff erlauben PRO

allow-wifi-access = true

Erlaubt anderen Geräten im selben Netzwerk den Zugriff auf Chutes HTTP- und SOCKS5-Proxy-Ports, indem beide Listener auf 0.0.0.0 erweitert werden. Konfigurationen im Surge-Stil — und die allow-lan-Zuordnung des sing-box-Imports — führen nur dieses Flag und belassen interface beim Standard 127.0.0.1; deshalb muss das Flag die Bind-Adresse selbst erweitern. Dies ist eine Chute-Pro-Funktion: Ohne Chute Pro werden das Flag und ein Wildcard-interface ignoriert, beide Listener bleiben auf 127.0.0.1, und unter iOS und tvOS starten sie daher nicht.

Die Apps haben dafür auch einen Schalter, LAN-Verbindungen erlauben: unter Chute Mac im Menü der Menüleiste (LAN-Verbindungen im Menüleisten-Panel) und im Bedienfeld unter Chute iOS und Chute Android; Chute tvOS hat keinen. Er startet in dem Zustand, den die Konfiguration verlangt, und verlegt beide Listener nur für den aktuellen Lauf auf alle Schnittstellen oder zurück auf 127.0.0.1; unter iOS, wo die Listener nur auf allen Schnittstellen laufen, startet und stoppt er sie auch. In die Konfiguration wird nichts geschrieben: Der nächste Start oder ein angenommenes Neuladen kehrt zu dem zurück, was die Konfiguration sagt. Das Einschalten braucht Chute Pro, das Ausschalten nicht.

Das Flag und ein ausdrückliches Wildcard-interface sind zwei Schreibweisen derselben Absicht, und Chute bildet die Vereinigung: Eine Konfiguration, die bereits 0.0.0.0 schreibt, verhält sich unverändert. Eine Änderung des Flags bindet beide Listener neu, ein Entzug des Zugriffs wirkt also beim Neuladen statt erst beim nächsten Start.

Dies sind die Proxy-Ports, und sie haben keine Authentifizierung, solange http-auth nicht gesetzt ist. Setzen Sie in einem fremden Netzwerk zusätzlich Zugangsdaten.


Verwaltete Konfiguration

#!MANAGED-CONFIG https://example.com/config.conf interval=86400 strict=false

Eine Konfiguration, deren erste Zeile ein #!MANAGED-CONFIG-Header ist, wird automatisch von der URL neu abgerufen. Die Header-Parameter und das Aktualisierungsverhalten sind unter Verwaltete Konfiguration dokumentiert.


Replikat / Datenverkehrsaufzeichnung PRO

replica = true

Der Schlüssel replica in [General] (replica = true) aktiviert die Datenverkehrsaufzeichnung; der Abschnitt [Replica] filtert, was das Chute Dashboard anzeigt — seine Schlüssel sind unter Replikat dokumentiert.

Auf jeder Plattform ist zusätzlich eine aktive Chute-Pro-Lizenz erforderlich: Ohne sie zeichnet replica = true nichts auf, und Bodies aus einem früheren lizenzierten Lauf lassen sich nicht zurücklesen.


Externer Controller-Zugriff (Chute Dashboard)

external-controller-access = password@0.0.0.0:6155

Startet den Fernsteuerungsserver, der von Chute Dashboard verwendet wird. Der Wert ist password@host:port; ein Benutzername kann optional dem Passwort vorangestellt werden (user:password@host:port). Auf iOS und tvOS wird ein begleitender USB-Kanal auf port + 1 geöffnet (nicht auf macOS). Wie Sie Chute Dashboard verbinden, steht auf der Seite Chute Dashboard.


HTTP-Control-API und Web-Konsole

Dieser Inhalt steht auf einer eigenen Seite: HTTP-Control-API und Web-Konsole.


Proxy-Test-URL

[General]
proxy-test-url = http://cp.cloudflare.com/generate_204
test-timeout = 3

proxy-test-url ist die Test-URL jeder url-test-, fallback- und load-balance-Gruppe ohne eigenes url, und test-timeout (Sekunden) die Zeitüberschreitung jeder solchen Gruppe ohne timeout. Die Gruppen folgen diesen Schlüsseln auch nach dem Speichern der Konfiguration; nur ein url oder timeout in der Gruppenzeile setzt sie außer Kraft. Eine ungültige proxy-test-url ist ein Konfigurationsfehler. internet-test-url wird vom direkten Internettest der Web-Konsole verwendet und ohne Proxy abgerufen; ohne Angabe nutzt die Engine ihre eingebaute Erfolgs-URL.


UDP über eine Richtlinie ohne UDP

udp-policy-not-supported-behaviour = DIRECT

Was mit einem UDP-Datagramm geschieht, dessen Richtlinie kein UDP weiterleiten kann, etwa ein reiner HTTP-Proxy: REJECT (Standard) verwirft es, DIRECT sendet es stattdessen direkt. block-quic wird vorher entschieden, anhand der Richtlinie, die die Regel gewählt hat: Mit block-quic = auto wird QUIC, das an einen Proxy ohne UDP-Weiterleitung geht, abgewiesen statt direkt gesendet. Anderes UDP fällt weiterhin auf DIRECT zurück. Ebenso wird das UDP einer verketteten Richtlinie behandelt, das nicht über ihren Upstream laufen kann, und ebenso ein DoQ- oder DoH3-Upstream, der dem ausgehenden Modus folgt und dabei auf eine Richtlinie ohne UDP trifft: REJECT überspringt diesen Upstream, DIRECT fragt ihn direkt.


Front-Proxy

[General]
global-underlying-proxy = Airport

Sendet jede Proxy-Richtlinie ohne eigenes underlying-proxy über die genannte Richtlinie oder Gruppe — was Shadowrocket Front-Proxy (前置代理) nennt und nur in seiner App einstellen lässt. Die Richtlinien von Proxy-Providern gehören dazu. Unverändert bleiben: jede Richtlinie, die eine Verbindung über die Front-Richtlinie selbst durchlaufen kann — ihre Mitglieder, deren Upstreams und die Hops eines Relays darunter —, damit die Front-Richtlinie nie über sich selbst läuft; eine Richtlinie mit underlying-proxy=DIRECT, die sich damit ausnimmt; Richtliniengruppen, bei denen ihre Mitglieder entscheiden; sowie DIRECT, REJECT und TAILSCALE. Lassen Sie den Schlüssel weg oder schreiben Sie DIRECT, um ihn auszuschalten. Ein nicht definierter Name lehnt jede Richtlinie ab, die er erfassen würde, statt sie direkt verbinden zu lassen.

close-if-proxy-chain-missing (Shadowrocket) wird gelesen und beim Speichern des Profils zurückgeschrieben. Chute verhält sich immer wie bei true: Eine verkettete Richtlinie, deren Upstream fehlt, wird abgelehnt. false — Shadowrockets Standard, der den fehlenden Hop überspringt und den Knoten direkt verbindet — wird nicht befolgt, und ein Hinweis sagt das einmal.


Client-Fingerabdruck

global-client-fingerprint = chrome

Legt den TLS-Client-Fingerabdruck für jede Richtlinie fest, die keinen eigenen fingerprint trägt, die Richtlinien eines Proxy-Providers eingeschlossen. Der Wert der Richtlinie hat immer Vorrang; dies ist also eine Vorgabe und keine Übersteuerung.

Unterstützte Werte sind chrome, firefox, safari und ios sowie edge, 360, qq, android und random, die alle als Chrome behandelt werden, sowie die übrigen unter fingerprint genannten Namen. Ein unbekannter Wert wird mit der Warnung Ignoring unsupported global-client-fingerprint '<value>' ignoriert und der TLS-Stack der Plattform verwendet.

Standard: leer, also der TLS-Stack der Plattform. ShadowTLS- und AnyTLS-Richtlinien lesen ihn immer, Trojan-, VMess- und VLESS-Richtlinien mit tls=true oder reality=true und Shadowsocks-Richtlinien, die sowohl ws=true als auch tls=true oder die shadow-tls-password setzen; eine Richtlinie mit gRPC-Transport ohne REALITY braucht ebenfalls ein geschriebenes tls=true. ShadowsocksR-Richtlinien lesen ihn nie.

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 ""