Options diverses
[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
Options courantes
Activer la prise en charge complète d'IPv6 (par défaut : true)
ipv6 = true
Avec false, les réponses DNS perdent leurs enregistrements AAAA et leurs indications IPv6, et le pool fake-IP ne répond pas aux AAAA ; le reste de la réponse — ses enregistrements A et tous les autres — est conservé.
loglevel (par défaut : warning)
loglevel = notify
L'une des valeurs none, fatal, warning, notify, info ou verbose. Il n'est pas recommandé d'activer verbose au quotidien, car cela dégrade nettement les performances.
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
Sur les versions iOS et tvOS, une entrée de type nom d'hôte est ajoutée à la liste d'exceptions du proxy du tunnel, si bien que les connexions vers cet hôte sont traitées par le TUN de Chute plutôt que par le proxy de Chute ; une entrée de type adresse IP ou CIDR devient en outre une route exclue du tunnel, si bien que le trafic vers cette plage quitte entièrement le tunnel au lieu d'être traité par le TUN de Chute. Chute Android fait de même en mode VPN : tant que Proxy HTTP système est activé, les noms d'hôte, les jokers * et les adresses IPv4 rejoignent la liste d'exceptions du proxy que le VPN transmet aux applications, et à partir d'Android 13 chaque entrée d'adresse IP ou de CIDR devient une route exclue du VPN — une adresse seule comme route /32 ou /128 ; les entrées de bouclage (loopback) sont laissées de côté, puisque le trafic de bouclage n'entre jamais dans le tunnel. Sur la version macOS, ces réglages sont appliqués au système lorsque « Définir comme proxy système » est activé. Tant que le mode amélioré est activé, les entrées d'adresse IP et de CIDR restent en outre hors du tunnel, quel que soit le type de mode amélioré, comme sur iOS — voir Routes exclues ; avec le type PacketTunnel, les mêmes exceptions s'appliquent aussi au proxy HTTP/HTTPS que porte le tunnel tant que le Proxy système est activé. Cette option sert à corriger des problèmes de compatibilité avec certaines apps.
- Pour indiquer un seul domaine, saisissez le nom de domaine — par exemple, apple.com.
- Pour indiquer tous les sites d'un domaine, placez un astérisque devant le nom de domaine — par exemple, *apple.com.
- Pour indiquer une partie précise d'un domaine, précisez chaque partie — par exemple, store.apple.com.
- Pour indiquer des hôtes ou des réseaux par adresse IP, saisissez une adresse IP précise telle que 192.168.2.11 ou une plage d'adresses, telle que 192.168.2.* ou 192.168.2.0/24.
Remarque : si vous saisissez une adresse IP ou une plage d'adresses, vous ne pourrez contourner le proxy que lorsque vous vous connecterez à cet hôte par cette adresse, et non lorsque vous vous y connecterez par un nom de domaine qui résout vers cette adresse.
Écoute du serveur proxy
interface = 127.0.0.1
port = 8118
socks-interface = 127.0.0.1
socks-port = 8119
interface / port contrôlent l'adresse et le port d'écoute du serveur proxy HTTP (par défaut 127.0.0.1:8118). socks-interface / socks-port contrôlent le serveur proxy SOCKS5 (par défaut 127.0.0.1:8119). Sur iOS et tvOS, les deux écouteurs ne tournent que lorsqu'ils sont liés à toutes les interfaces — avec allow-wifi-access = true, un interface / socks-interface valant 0.0.0.0, ou sur iOS l'interrupteur Autoriser les connexions du réseau local de l'app — si bien qu'avec la valeur par défaut 127.0.0.1 rien n'y écoute sur ces ports ; Chute Mac et Chute Android les démarrent toujours. Servir d'autres appareils relève de Chute Pro sur toutes les plateformes : sans cela, une adresse non-loopback est ignorée et l'écoute reste sur 127.0.0.1, si bien que sur iOS et tvOS les écouteurs ne démarrent pas du tout.
Quand un port est occupé, le serveur passe au suivant et essaie jusqu'à 20 ports en tout, à partir du port configuré ; si aucun n'est libre, ce serveur ne démarre pas, et le reste du moteur continue de tourner. Le port réellement utilisé est celui que rapporte GET /api/status dans http_port et socks_port, et celui qu'affiche la page Vue d'ensemble de la console web. Le relais UDP du serveur SOCKS5 se lie à un port qui lui est propre et ne suit pas l'écouteur TCP : après un changement de port, il peut rester sur le port configuré, ou se trouver sur un tout autre port. La réponse à UDP ASSOCIATE indique toujours le port réellement utilisé par le relais ; un client qui envoie ses datagrammes à l'adresse donnée par cette réponse, comme l'exige RFC 1928, n'est donc pas concerné.
Donnez à port et socks-port une valeur de 1 à 65535 : leur plage n'est pas vérifiée au chargement de la configuration, et avec une valeur hors de cette plage, le serveur soit ne démarre pas, soit finit par écouter sur un autre port. Écrit via http-listen / socks5-listen, un tel port est une erreur de configuration.
Pour une requête http:// en clair, le serveur proxy HTTP ne porte qu'un échange par connexion : chaque réponse part avec Connection: close et la connexion se ferme ensuite, si bien que le client envoie sa requête suivante sur une nouvelle connexion. Une requête envoyée en pipeline derrière la première est abandonnée, et le client la renvoie sur la nouvelle connexion. Un schéma d'authentification qui a besoin de plusieurs allers-retours sur la même connexion, comme NTLM ou Negotiate, ne peut pas aboutir à travers lui. Un tunnel CONNECT non déchiffré n'est pas concerné. Une mise à niveau WebSocket conserve sa connexion : après la réponse 101, les données passent telles quelles dans les deux sens.
Alias de compatibilité :
doh-serveretdoh-servicesont acceptés comme alias dedoh;http-listen/socks5-listen(par ex.0.0.0.0:6152,[::]:6153, ou un simple port) sont associés aux réglages d'interface/port ci-dessus. Un hôte d'écoute joker (0.0.0.0,::ou*) définit égalementallow-wifi-access = true.
Authentification du proxy entrant
http-auth = username:password
Exige des clients qu'ils s'authentifient avant d'utiliser les serveurs proxy HTTP et SOCKS5 de Chute. La ligne peut être répétée pour autoriser plusieurs jeux d'identifiants.
Le proxy HTTP répond à une requête sans identifiants valides — requête ordinaire comme CONNECT — par 407 Proxy Authentication Required avec Proxy-Authenticate: Basic realm="KLNEKit", puis ferme la connexion. Le serveur SOCKS5 reçoit les mêmes identifiants par l'authentification nom d'utilisateur/mot de passe de SOCKS5 et ferme une connexion qui ne la propose pas ou qui y échoue.
Contourner les requêtes système
bypass-system = true
Lorsque cette option est activée, Chute ajoute à skip-proxy une liste fixe de 18 noms d'hôte Apple — push, passerelle iCloud, vérification de portail captif, OCSP et autres — et ajoute IP-CIDR,17.0.0.0/8,DIRECT,no-resolve après vos règles, juste avant FINAL — une règle à vous qui correspond d'abord à 17.0.0.0/8 l'emporte donc toujours. Il n'y a aucune correspondance par processus : l'option est cette liste fixe d'hôtes et d'adresses, pas un filtre sur le processus à l'origine de la requête.
Par défaut :
true.
Toujours IP réelle
always-real-ip = *.example.com, tracker.example.org
Lorsque Chute fournit de fausses adresses IP pour les requêtes DNS détournées (voir hijack-dns), les noms d'hôte correspondant à cette liste séparée par des virgules reçoivent toujours en réponse leurs véritables adresses IP résolues. Les jokers sont pris en charge. always-ip-address (graphie de Shadowrocket) est lu comme cette clé : une valeur booléenne (true, yes, on, 1) signifie tous les hôtes et est réécrite en always-real-ip = * ; false est abandonné ; toute autre valeur est lue comme une liste d'hôtes. La configuration est enregistrée avec la graphie always-real-ip.
Lire le fichier hosts du système
read-etc-hosts = false
Indique si le fichier hosts du système est lu dans la table [Host]. Mettez false pour ignorer ce fichier ; une modification prend effet au rechargement. Voir Mappage DNS local.
Par défaut :
true.
Interrompre les connexions existantes
interrupt-exist-connections = true
Lorsque cette option est activée, un changement de route ferme les connexions existantes établies sous l'ancienne, afin qu'elles empruntent immédiatement la nouvelle route plutôt que de s'attarder sur l'ancienne jusqu'à leur fin. Ces changements comptent :
- Un groupe de politiques qui choisit un autre membre — de lui-même (URL Test, Fallback, SSID) ou par sélection manuelle. Les connexions qui utilisaient le membre qu'il a quitté sont fermées. Un groupe Load Balance répartit les connexions entre ses membres et ne compte jamais comme un changement.
- Un changement de la politique sélectionnée pour le mode global, que suit la politique intégrée
PROXY: les connexions que le mode global envoyait à l'ancienne politique, et celles qui l'atteignaient viaPROXY, sont fermées. - Le passage du mode de sortie entre Règle, Global et Direct : toutes les connexions sont fermées.
- Un rechargement qui modifie les serveurs DNS,
[Host], les politiques, les groupes de politiques ou les fournisseurs de proxy, ou les règles ou les jeux de règles : toutes les connexions sont fermées.
Cela vaut pour chaque groupe de politiques que traverse une connexion : le groupe nommé par sa règle, un groupe imbriqué dans celui-ci, le groupe amont d'une politique chaînée (underlying-proxy) et les groupes membres d'un groupe de relais.
Après un changement de membre d'un groupe ou de la politique du mode global, chaque connexion concernée est fermée proprement avec un délai de 3 secondes avant une fermeture forcée ; un changement de mode ou un rechargement les ferme immédiatement. Un flux UDP ordinaire n'est fermé par aucun de ces changements. Les règles ajoutées via /api/rules/user ne dépendent pas de cette option : par défaut, elles ferment les connexions qu'elles routent ailleurs, que l'option soit activée ou non.
Par défaut :
false. Il s'agit d'un réglage global — il affecte tous les groupes de politiques.
Network Framework (macOS / iOS / tvOS)
network-framework = true
Active Network.framework d'Apple pour les connexions sortantes. Network.framework peut offrir de meilleures performances et une intégration moderne de la pile TLS sur les plateformes prises en charge.
Par défaut :
truesur macOS,falsesur iOS et tvOS.
Exclure les noms d'hôte simples
exclude-simple-hostnames = true
Lorsque cette option est activée, les requêtes vers des noms d'hôte simples (noms à étiquette unique sans point, par ex. localhost) contournent les règles de proxy et sont résolues localement. Cela évite des résolutions DNS inutiles pour les noms du réseau local. Il s'agit du réglage « Exclure les noms d'hôte simples » du proxy système de macOS lui-même : Chute Mac l'écrit dans la configuration du proxy système, il ne s'applique donc qu'aux applications qui suivent le proxy système — ni au mode amélioré ni au trafic TUN. Sous iOS et tvOS, il est écrit de la même façon dans les réglages de proxy du tunnel : un nom d'hôte simple est alors traité par le TUN de Chute plutôt que par le proxy de Chute, comme un nom d'hôte de skip-proxy. Chute Android ne l'utilise pas.
Sur Chute Mac, une migration ponctuelle active cette option par défaut au premier lancement ; un réglage explicitement désactivé par l'utilisateur est respecté.
Par défaut :
false.
Désactiver l'enregistrement en base de données
disable-db-record = true
Lorsque cette option est activée, Chute cesse d'écrire les enregistrements de trafic dans la base de données locale. Cela peut améliorer les performances et réduire l'usage du stockage, mais l'historique de trafic ne sera pas disponible dans Chute Dashboard.
Par défaut :
false.
Affichage de la vitesse dans la barre des menus (Mac uniquement)
menu-bar-show-speed = true
Lorsque cette option est activée, Chute Mac affiche les vitesses d'envoi et de réception actuelles dans la barre des menus.
Analysée mais sans effet dans le moteur actuel — rien dans Chute Mac ne lit cette clé. La vitesse dans la barre des menus se bascule depuis l'entrée de menu Afficher la vitesse de connexion, stockée dans les réglages propres à l'app. La clé est tout de même réécrite à l'enregistrement de la configuration.
Détourner les autres serveurs DNS
hijack-dns = 8.8.8.8:53
Par défaut, Chute ne renvoie de fausses adresses IP que pour les requêtes DNS envoyées à l'adresse DNS de Chute (198.18.0.2). Les requêtes envoyées à un DNS standard sont simplement transmises.
Certains appareils ou logiciels utilisent toujours un serveur DNS codé en dur. (Par exemple, les enceintes Google utilisent toujours 8.8.8.8). Vous pouvez utiliser cette option pour détourner la requête et obtenir une fausse adresse.
Vous pouvez utiliser hijack-dns = *:53 pour détourner toutes les requêtes DNS.
Une entrée sans port signifie le port 53 : hijack-dns = 8.8.8.8 équivaut à 8.8.8.8:53. Une entrée illisible est ignorée avec un avis ; le reste de la ligne s'applique toujours.
La fausse IP est aussi disponible sur Apple TV (tvOS 17 et ultérieur). Elle y était désactivée ; la vérification sur un appareil est encore en cours.
Routes exclues
tun-excluded-routes = 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12
Chute VIF ne peut traiter que les protocoles TCP et UDP. Utilisez cette option pour contourner des plages d'IP précises afin de laisser passer tout le trafic.
Remarque : cette option s'applique aux tunnels de paquets iOS et tvOS, où les plages deviennent des routes exclues des réglages IP du tunnel, ainsi qu'à Chute Android sous Android 13 et ultérieur, où elles deviennent des routes exclues du VPN — Android 11 et 12 n'offrent pas d'API pour les routes exclues, les plages y sont donc ignorées. Les requêtes traitées par le serveur proxy de Chute ne sont pas concernées. Combinez « skip-proxy » et « tun-excluded-routes » pour vous assurer que certains flux HTTP contournent bien Chute.
Sous macOS, elle s'applique aux deux types de mode amélioré, et ce qui reste hors du tunnel est la même liste que celle que tiennent à l'écart les tunnels iOS et tvOS : les plages de cette option, celles de
bypass-tunet les entrées d'adresse IP et de CIDR deskip-proxy— les entrées de nom d'hôte ne sont pas des routes et n'y jouent aucun rôle. Avec le type PacketTunnel, les plages deviennent des routes exclues des réglages IP du tunnel, comme sur iOS. Avec le type Helper utun, l'assistant les laisse en dehors des routes qu'il dirige vers l'utun, si bien que le trafic vers elles suit les routes ordinaires du système ; en IPv6, l'assistant ne dirige vers l'utun que2000::/3, donc seules les plages IPv6 comprises dans2000::/3y changent quelque chose. Les plages IPv6 ne comptent que lorsque le tunnel porte l'IPv6 (ipv6 = true). Une entrée de longueur de préfixe0(0.0.0.0/0,::/0), ou qui chevauche la boucle locale (127.0.0.0/8,::1) ou les sous-réseaux propres au tunnel (198.18.0.0/15,fd12:1:1:1::/64), est ignorée et signalée dans le journal — le127.0.0.1que contient d'ordinaireskip-proxyest donc simplement ignoré. Une entrée detun-included-routesplus spécifique qu'une plage exclue l'emporte toujours, puisque les routes sont choisies d'après la longueur du préfixe. Une liste modifiée prend effet au rechargement de la configuration.Cette option peut provoquer une erreur système ENOMEM (Cannot allocate memory). Il semble s'agir d'un bug du système iOS. Évitez si possible d'utiliser cette option.
Routes incluses
tun-included-routes = 192.168.1.12/32
Par défaut, l'interface Chute VIF se déclare comme route par défaut. Mais comme l'interface Wi-Fi possède une route plus spécifique, une partie du trafic peut ne pas passer par l'interface Chute VIF. Utilisez cette option pour ajouter une route plus spécifique.
Pourquoi une route par défaut ne suffit pas : le système choisit une route d'après la longueur du préfixe, et non d'après l'ordre. Le sous-réseau directement connecté de l'interface physique elle-même — 192.168.1.0/24, par exemple — est plus spécifique que le 0.0.0.0/0 du tunnel, si bien que ce trafic n'atteint jamais Chute. Une entrée ajoutée ici installe une route encore plus spécifique et l'emporte. Ces routes s'ajoutent à la route par défaut et ne restreignent jamais ce que le tunnel capture.
Remarque : évitez d'énumérer en bloc les plages privées (
10.0.0.0/8,172.16.0.0/12,192.168.0.0/16). C'est normalement inutile et cela peut perturber le routage propre au système ; Chute respecte une telle entrée mais consigne un avertissement — sauf sous la variante Network Extension du mode amélioré sur macOS, qui la respecte sans avertissement. La raison habituelle de recourir à cette option est de joindre une plage que possède le tunnel d'une autre application VPN.Remarque : une entrée qui scierait la branche sur laquelle Chute est assis est refusée, motif à l'appui dans le journal : la boucle locale, les sous-réseaux propres au VIF (
198.18.0.0/15etfd12:1:1:1::/64), le link-local, le multicast, le broadcast et une longueur de préfixe de0. La variante Helper utun du mode amélioré sur macOS refuse en outre une entrée qui couvre la passerelle par défaut actuelle. Sous la variante Network Extension, le motif va dans le journal système plutôt que dans celui de Chute.Remarque : sur iPhone, le système décide séparément de la capture du réseau local. Un sous-réseau local listé ici n'est honoré que si Inclure les réseaux locaux est également activé dans les réglages de l'application — un interrupteur qu'on ne peut activer que lorsque Inclure tous les réseaux est activé ; une plage que possède le tunnel d'une autre application n'a besoin d'aucun interrupteur de ce genre. Chute tvOS affiche les mêmes interrupteurs mais ne les applique pas au tunnel. Sous macOS, les routes sont installées directement et aucune condition de ce type ne s'applique.
Remarque : sous macOS, la variante Helper utun du mode amélioré installe ces routes au moment où l'interface est attachée, si bien qu'une liste modifiée rattache l'interface au rechargement. Cette option exige la version 0.8.6 ou ultérieure de l'assistant — après une mise à jour de Chute, approuvez une fois l'invite de réinstallation de l'assistant, faute de quoi la variante Helper utun signale que l'assistant n'est pas en cours d'exécution.
Détection de protocole
sniffing-enabled = true
sniffing-timeout = 100
Chute peut détecter le protocole réel d'une connexion en inspectant les premiers octets. Cela permet à des règles comme PROTOCOL,TLS,Proxy de fonctionner correctement même pour des connexions entrantes non HTTP.
sniffing-enabled (par défaut : false)
sniffing-enabled = true
Active la détection de protocole pour les connexions TCP. En mode amélioré, le même interrupteur permet de traiter par nom un flux HTTP/3 (QUIC) vers une adresse IP nue : Chute lit le nom du serveur dans le ClientHello QUIC, les règles de type DOMAIN voient ce nom plutôt que l'adresse, et chaque paquet suivant du flux suit le verdict du premier. Un ClientHello trop grand pour un seul paquet — courant avec l'échange de clés post-quantique — est réassemblé par flux à partir des paquets Initial qui le transportent, dans la limite d'un hello réassemblé de 16 Kio, de sorte que son nom est lu lui aussi. Tant que le reste du hello n'est pas arrivé, les datagrammes du flux sont retenus au lieu d'être envoyés avec leur adresse nue, et repartent ensemble selon la politique du nom une fois celui-ci lu — le premier fragment d'un hello découpé ne prend donc plus une route différente du reste. Les garde-fous sont une attente d'une seconde, huit datagrammes ou 16 Kio retenus par flux, et 64 flux en cours de réassemblage à la fois ; un flux au-delà de l'un d'eux, ou dont les paquets Initial ne complètent jamais le ClientHello, est traité par adresse comme auparavant.
Pour une connexion vers une adresse réelle, les règles voient le nom que le client annonce lui-même — le SNI TLS ou l'en-tête HTTP Host —, même si le cache DNS de Chute connaît déjà un nom pour cette adresse : le cache ne garde qu'un nom par adresse, le dernier à s'y être résolu, et derrière une adresse partagée ce peut être celui d'un autre site. Le nom du cache est utilisé lorsque rien ne peut être lu dans la connexion. Une requête écrite pour un proxy HTTP — CONNECT, ou une requête dont la cible est une URL complète — reste détectée comme HTTP, mais l'hôte qu'elle nomme est la prochaine destination de ce proxy, pas le nom de cette connexion ; la connexion garde le nom du cache ou l'adresse. Un protocole où le serveur parle le premier ne donne aucun nom à lire : les connexions vers les ports 21, 22, 23, 25, 110, 119, 143, 587, 2222, 2525, 3306 et 5900 ne passent pas par la détection et sont établies immédiatement ; sur tout autre port, un tel protocole attend l'expiration de sniffing-timeout avant d'être connecté.
sniffing-timeout (par défaut : 100 ms)
sniffing-timeout = 200
Temps maximal, en millisecondes, d'attente des données initiales pour déterminer le protocole. Augmentez cette valeur si la détection de protocole échoue sur des connexions lentes.
Bloquer QUIC
block-quic = auto
Contrôle si Chute rejette le trafic QUIC détecté, y compris HTTP/3. QUIC fonctionne sur UDP et ne peut pas être déchiffré par le MitM HTTP de Chute. Rejeter QUIC peut inciter les clients compatibles à réessayer en TCP, ce qui permet un traitement par proxy sur TCP et, si elle est configurée, l'application du déchiffrement HTTPS.
| Valeur | Comportement |
|---|---|
off |
N'applique aucun blocage global de QUIC (par défaut). Le trafic QUIC détecté suit les règles de routage normales. |
on |
Rejette chaque flux QUIC détecté, y compris le trafic acheminé vers DIRECT. |
auto |
Ne rejette le QUIC détecté que lorsque la politique de sortie finale est un proxy. Le trafic acheminé vers DIRECT est autorisé ; celui acheminé vers REJECT reste rejeté par cette règle. |
all |
Graphie Surge de on. |
all-proxy, per-policy |
Graphies Surge, toutes deux lues comme auto — Chute n'a pas de blocage QUIC par politique, si bien que per-policy bloque le QUIC sur tout flux passant par un proxy. Le mot que vous avez écrit est conservé à l'enregistrement du profil. |
Pour le trafic entrant par le TUN, Chute répond à un flux QUIC rejeté par un message ICMP/ICMPv6 Port Unreachable, afin que les clients compatibles puissent se rabattre sans attendre l'expiration d'un délai QUIC.
Un flux QUIC rejeté est enregistré avec
REJECTcomme politique, quelle que soit la politique choisie par la règle.La détection QUIC pour
block-quicest automatique et ne nécessite passniffing-enabled;sniffing-enabledcontrôle la détection de protocole — TLS sur TCP, et le nom de serveur d'un flux QUIC. Utilisez une règlePROTOCOL,QUIC,...lorsque vous avez besoin d'un traitement par règles de flux QUIC individuels.
Répondre à l'ICMP dans le tunnel
icmp-auto-reply = false
Une requête d'écho ICMP qui entre dans le tunnel — IPv4 comme IPv6 — reçoit une réponse de Chute lui-même : la réponse est fabriquée localement et rien n'est envoyé à la cible. Toute destination répond donc, y compris une adresse qu'une règle enverrait vers REJECT ou un hôte hors service, si bien qu'un ping qui réussit dans le tunnel ne dit rien de l'accessibilité de la cible. Mettez false pour cesser de répondre : la requête est alors relayée hors de l'appareil, mais sa réponse ne revient jamais par le tunnel, et le ping reste sans réponse.
Par défaut :
true. S'applique au trafic arrivant par le TUN ; l'ICMP n'est jamais relayé par un proxy.
Contourner le TUN
bypass-tun = 192.168.0.0/16, 10.0.0.0/8
Similaire à skip-proxy, mais opère au niveau du routage TUN/VIF. Les connexions vers ces plages d'IP contournent entièrement l'interface TUN et passent directement par la pile réseau du système.
Remarque : cette option s'applique aux tunnels de paquets iOS et tvOS, où ses plages rejoignent
tun-excluded-routescomme routes exclues du tunnel, et de la même manière à Chute Android sous Android 13 et ultérieur (Android 11 et 12 l'ignorent). Sous macOS, ses plages rejoignenttun-excluded-routesdans les deux types de mode amélioré — voir Routes exclues.
Afficher une page d'erreur en cas de rejet
show-error-page-for-reject = true
Lorsque cette option est activée, Chute renvoie une page d'erreur lisible pour les requêtes rejetées. Cela ne vaut que pour une requête arrivée par l'entrée proxy HTTP ; l'option désactivée, une telle requête reçoit HTTP/1.1 503 Service Unavailable à la place. Une requête rejetée venant de toute autre entrée est abandonnée dans les deux cas.
Par défaut :
false.
DNS optimiste
optimistic-dns = false
Lorsque cette option est activée, un enregistrement en cache dont le TTL est expiré est tout de même renvoyé immédiatement, pendant qu'il est redemandé en arrière-plan. Cela réduit la latence de connexion, au prix d'un éventuel renvoi d'enregistrements DNS obsolètes. Un enregistrement expiré n'est renvoyé ainsi que pendant un temps limité : une durée égale à son propre TTL, et au moins cinq minutes ; au-delà, la requête attend la réponse de l'amont. Lorsqu'elle est désactivée, un enregistrement dont le TTL est expiré n'est pas servi et la requête part vers l'amont ; cette réponse remplit de nouveau le cache, de sorte que la recherche suivante est servie par le cache. Lors du passage à un autre réseau, ou lorsque la liste des serveurs DNS change, tous les enregistrements en cache sont considérés comme expirés. Elle détermine aussi, sur toutes les plateformes, si le tunnel se connecte à plusieurs adresses d'un même nom à la fois.
Par défaut :
true. Définissezoptimistic-dns = falsepour désactiver.
Autoriser l'accès Wi-Fi PRO
allow-wifi-access = true
Permet aux autres appareils du même réseau d'atteindre les ports proxy HTTP et SOCKS5 de Chute, en élargissant l'adresse d'écoute des deux écouteurs à 0.0.0.0. Les configurations de style Surge — ainsi que la correspondance allow-lan de l'importateur sing-box — ne portent que ce drapeau et laissent interface à sa valeur par défaut 127.0.0.1 ; c'est pourquoi le drapeau doit élargir lui-même l'adresse d'écoute. C'est une fonctionnalité de Chute Pro : sans elle, le drapeau et un interface joker sont ignorés, les deux écouteurs restent sur 127.0.0.1, et sur iOS et tvOS ils ne démarrent donc pas.
Les apps ont aussi un interrupteur pour cela, Autoriser les connexions du réseau local : sur Chute Mac dans le menu de la barre des menus (Connexions du réseau local dans le panneau de la barre des menus), et dans le panneau de configuration sur Chute iOS et Chute Android ; Chute tvOS n'en a pas. Il démarre dans l'état que demande la configuration, et place les deux écouteurs sur toutes les interfaces ou les ramène sur 127.0.0.1 pour l'exécution en cours seulement ; sur iOS, où les écouteurs ne tournent que sur toutes les interfaces, il les démarre et les arrête aussi. Rien n'est écrit dans la configuration : le prochain démarrage, ou un rechargement accepté, revient à ce que dit la configuration. L'activer exige Chute Pro ; le désactiver, non.
Le drapeau et un
interfacejoker explicite sont deux écritures de la même intention, et Chute en prend l'union : une configuration qui écrit déjà0.0.0.0se comporte exactement comme avant. Modifier le drapeau relie les deux écouteurs, donc retirer l'accès prend effet au rechargement plutôt qu'au prochain démarrage.Ce sont les ports du proxy, et ils n'ont aucune authentification tant que
http-authn'est pas défini. Sur un réseau que vous ne contrôlez pas, définissez aussi des identifiants.
Configuration gérée
#!MANAGED-CONFIG https://example.com/config.conf interval=86400 strict=false
Une configuration dont la première ligne est un en-tête #!MANAGED-CONFIG est retéléchargée automatiquement depuis l'URL. Les paramètres de cet en-tête et le comportement de mise à jour sont documentés dans Configuration gérée.
Replica / enregistrement du trafic PRO
replica = true
La clé replica de [General] (replica = true) active l'enregistrement du trafic ; la section [Replica] filtre ce que Chute Dashboard affiche — ses clés sont documentées dans Réplique.
Une licence Chute Pro active est en outre nécessaire sur toutes les plateformes : sans elle,
replica = truene capture rien, et les corps laissés par une exécution sous licence ne peuvent pas être relus.
Accès au contrôleur externe (Chute Dashboard)
external-controller-access = password@0.0.0.0:6155
Démarre le serveur de contrôle distant utilisé par Chute Dashboard. La valeur s'écrit password@host:port ; un nom d'utilisateur peut éventuellement précéder le mot de passe (user:password@host:port). Sur iOS et tvOS, un canal USB complémentaire est ouvert sur port + 1 (pas sur macOS). La connexion est décrite sur la page Chute Dashboard.
API de contrôle HTTP et console web
Ce contenu se trouve sur sa propre page : API de contrôle HTTP et console web.
URL de test du proxy
[General]
proxy-test-url = http://cp.cloudflare.com/generate_204
test-timeout = 3
proxy-test-url est l'URL de test de chaque groupe url-test, fallback et load-balance qui ne définit pas son propre url, et test-timeout (secondes) le délai de chaque groupe de ce type sans timeout. Les groupes continuent de suivre ces clés après l'enregistrement de la configuration ; seul un url ou un timeout écrit sur la ligne du groupe les remplace. Une proxy-test-url invalide est une erreur de configuration. internet-test-url est utilisé par le test Internet direct de la console web et est récupéré sans proxy ; s'il est absent, le moteur utilise son URL de réussite intégrée.
UDP via une politique sans UDP
udp-policy-not-supported-behaviour = DIRECT
Ce qu'il advient d'un datagramme UDP dont la politique ne peut pas relayer l'UDP, comme un simple proxy HTTP : REJECT (par défaut) l'abandonne ; DIRECT l'envoie directement à la place. block-quic est tranché avant, sur la politique choisie par la règle : avec block-quic = auto, le QUIC destiné à un proxy qui ne peut pas relayer l'UDP est rejeté au lieu d'être envoyé directement. Le reste de l'UDP se rabat toujours sur DIRECT. L'UDP d'une politique chaînée qui ne peut pas passer par son amont est traité de la même façon, tout comme un serveur DoQ ou DoH3 qui suit le mode de sortie vers une politique sans UDP : REJECT ignore ce serveur, DIRECT l'interroge directement.
Proxy frontal
[General]
global-underlying-proxy = Airport
Fait passer chaque politique de proxy sans underlying-proxy propre par la politique ou le groupe nommé — ce que Shadowrocket appelle proxy frontal (前置代理) et ne règle que dans son app. Les politiques des fournisseurs de proxy sont incluses. Restent inchangés : toute politique qu'une connexion par la politique frontale elle-même peut traverser — ses membres, leurs amonts et les sauts d'un relais parmi eux —, afin que la politique frontale ne passe jamais par elle-même ; une politique qui écrit underlying-proxy=DIRECT, ce qui l'exclut ; les groupes de politiques, dont les membres décident ; et DIRECT, REJECT et TAILSCALE. Omettez la clé, ou écrivez DIRECT, pour la désactiver. Un nom non défini refuse toutes les politiques qu'il couvrirait au lieu de les laisser se connecter directement.
close-if-proxy-chain-missing (Shadowrocket) est lu et réécrit à l'enregistrement du profil. Chute se comporte toujours comme avec true : une politique chaînée dont l'amont manque est refusée. false — la valeur par défaut de Shadowrocket, qui saute le saut manquant et connecte le nœud directement — n'est pas suivi, et un avis le signale une fois.
Empreinte du client
global-client-fingerprint = chrome
Définit l'empreinte du client TLS pour toute politique qui n'a pas la sienne (fingerprint), y compris les politiques que fournit un fournisseur de proxy. La valeur propre à une politique l'emporte toujours ; il s'agit donc d'une valeur par défaut, et non d'un remplacement.
Les valeurs prises en charge sont chrome, firefox, safari et ios, ainsi que edge, 360,
qq, android et random, toutes traitées comme Chrome, ainsi que les autres noms cités
sous fingerprint. Une valeur non reconnue
est ignorée avec l'avertissement Ignoring unsupported global-client-fingerprint '<value>',
et la pile TLS de la plateforme est utilisée.
Par défaut : vide, ce qui signifie la pile TLS de la plateforme. Les politiques ShadowTLS et AnyTLS la lisent toujours ; les politiques Trojan, VMess et VLESS la lisent si elles définissent
tls=trueoureality=true, et les politiques Shadowsocks si elles définissent à la foisws=trueettls=true, ou si elles définissentshadow-tls-password; une politique sur le transport gRPC sans REALITY doit elle aussi écriretls=true. Les politiques ShadowsocksR ne la lisent jamais.
Cette page est une traduction de la version anglaise. En cas de divergence, la version anglaise fait foi.