Premiers pas
Cette page décrit le premier lancement : introduire une configuration dans Chute, la sélectionner, démarrer le proxy et vérifier que le trafic circule. Tout le reste de ce manuel repose sur une installation fonctionnelle.
Chute iOS
1. Obtenir une configuration
Au premier lancement, sans aucune configuration, Chute ouvre un guide de configuration (« Bienvenue dans Chute ») proposant quatre voies : Lien d'abonnement pour une URL fournie par un prestataire ou un lien de partage (ss://, vmess://, …), Scanner un QR code, Importer un fichier de profil pour un profil Clash / mihomo, sing-box, Surge ou Shadowrocket ou un .conf Chute, et Configuration manuelle, qui demande les informations de votre serveur, les sites à faire transiter par le proxy et un choix de DNS, puis crée une configuration nommée « Default » et se connecte.
Pour ajouter une configuration par la suite, touchez la barre Config en haut de l'écran principal, puis Ajouter une configuration depuis... :
- Configuration vierge — ouvre l'éditeur intégré avec une configuration vide (voir l'exemple minimal ci-dessous pour savoir quoi y mettre).
- Ajouter un abonnement — télécharge depuis une URL d'abonnement et la maintient à jour : un profil natif est enregistré comme configuration gérée et retéléchargé toutes les 24 heures, ou à l'intervalle que fixe la propre ligne
#!MANAGED-CONFIGdu profil. Un abonnement Clash ou sing-box, ou un abonnement qui sert une liste de liens de partage, est converti au passage et enregistré comme instantané statique, sans en-tête de mise à jour : il ne se rafraîchit donc jamais de lui-même — réimportez-le pour le mettre à jour. Un lien de partage isolé saisi ici est converti une seule fois et ouvert dans l'éditeur. - Importer depuis le presse-papiers — une adresse d'abonnement ou un lien de partage présent dans le presse-papiers est récupéré comme le fait Ajouter un abonnement ; tout autre texte est lu comme un profil et ouvert dans l'éditeur.
- Importer depuis un fichier local — importe un fichier Chute (
.conf), Surge, Shadowrocket, sing-box (.json) ou Clash/mihomo (.yaml) ; c'est le contenu qui détermine le format, et les formats non natifs sont convertis automatiquement. - Synchroniser depuis iCloud, Télécharger depuis une URL, Envoyer un fichier via Wi-Fi, Télécharger depuis un QR code — d'autres moyens d'arriver au même résultat.
Un fichier .conf, .yaml ou .json peut aussi être ouvert dans Chute depuis Fichiers, Safari ou une autre app, et le bouton d'import en un geste d'un fournisseur peut transmettre une adresse à Chute via chute://install-config ; dans les deux cas, l'import se fait comme ci-dessus.
Sans Chute Pro, un iPhone ou un iPad ne conserve qu'une configuration. Dès qu'il y en a une, chacun des canaux ci-dessus déclenche l'alerte d'achat, tout comme le fait de sélectionner une autre configuration — voir Licence et activation.
2. La sélectionner
Dans la liste des configurations, touchez une configuration pour qu'une coche apparaisse, puis touchez Terminé. Chute exécute toujours la configuration sélectionnée — si aucune ne l'est, l'interrupteur principal refuse de démarrer (« Veuillez d'abord sélectionner une configuration »).
3. Démarrer et autoriser
Touchez l'interrupteur rond de l'écran principal. Au tout premier démarrage, iOS demande à ajouter une configuration VPN — approuvez-la et confirmez avec Face ID / Touch ID / code. Si vous avez refusé l'invite, basculez simplement à nouveau l'interrupteur ; si le profil VPN venait à se bloquer, Réinitialiser la configuration VPN dans les réglages de l'app le supprime pour que le démarrage suivant le recrée.
4. Vérifier
Une fois l'interrupteur activé, laissez le mode de sortie sur Basé sur les règles (les modes Direct / Global contournent ou imposent le proxy en bloc), puis ouvrez un site web. Le bouton Tableau de bord affiche le trafic en direct et le détail par connexion — le moyen le plus rapide de confirmer que la configuration se comporte comme prévu.
Chute Mac
Le premier lancement ouvre Configurer Chute, une carte pour chaque chose que macOS doit autoriser avant que Chute puisse acheminer le trafic : Placer dans le dossier Applications (Placer dans Applications y copie Chute et le rouvre), Autoriser Chute en arrière-plan pour l'assistant privilégié qui règle le proxy système et crée l'interface du mode amélioré (Autoriser…, puis activez Chute là où les Réglages Système le listent ; sous macOS 12, Installer l'assistant… et un mot de passe administrateur), et Vérifier le service en arrière-plan, qui s'assure que l'assistant répond. Lorsque le type du mode amélioré est réglé sur PacketTunnel (recommandé), une carte supplémentaire, Extension réseau du mode amélioré, demande à macOS l'extension réseau et la configuration VPN via Configurer…. La fenêtre revient à chaque lancement tant que les étapes ne sont pas terminées ; Ignorer propose Me le rappeler la prochaine fois ou Ne plus me le rappeler, et dans les deux cas Terminer la configuration de Chute… dans la barre des menus et une bannière Poursuivre la configuration… dans la fenêtre principale la rouvrent. Ensuite, tant qu'il n'y a aucune configuration, l'assistant de configuration s'ouvre, et quand il se ferme, une bulle sur l'icône de la barre des menus, Chute se trouve dans la barre des menus, montre où Chute reste.
Chute Mac réside dans la barre des menus (il n'y a pas d'icône dans le Dock par défaut). Un clic sur l'icône de la barre des menus ouvre un panneau : en haut, la configuration utilisée ; pendant que Chute tourne, les tuiles Proxy système et Mode amélioré, les tuiles plus petites Capture du trafic, MitM et Connexions du réseau local et le mode de sortie ; et en bas Fenêtre principale, Dashboard (qui télécharge Chute Dashboard s'il n'est pas installé) et, pendant que Chute tourne, un bouton de rechargement, ainsi que ⋯ pour le reste. Un clic droit ou un Contrôle-clic sur l'icône ouvre plutôt le menu, qui affiche aussi les raccourcis clavier ; désactiver Ouvrir un panneau au clic gauche (le menu reste au clic droit) sous Icône de la barre des menus dans l'onglet Divers de la fenêtre principale fait qu'un clic ouvre le menu. Les étapes ci-dessous indiquent sur quoi cliquer :
- Importer une configuration — Importer une configuration... ouvre l'onglet Profils de la fenêtre principale, qui propose Importer depuis un fichier… pour un fichier sur disque et Importer depuis une URL ou un lien de partage… pour une URL d'abonnement ou un lien de partage (
ss://,vmess://, ... ; Chute iOS et Chute Android importent aussi les liens de partage, Chute tvOS non). Assistant de configuration... en crée une pas à pas à la place. Les deux sont proposés tant que le proxy est arrêté ; le panneau propose aussi Importer une configuration... sous le nom de la configuration, tout en haut. Les profils d'abonnement et convertis sont stockés sous~/Library/Application Support/<bundle id>/Profiles/; les fichiers importés depuis le disque sont référencés sur place. - La sélectionner — Sélectionner le fichier de configuration, ou choisissez un autre profil sous le nom de la configuration en haut du panneau (Changer de configuration dans le menu pendant que le proxy tourne). Sans Chute Pro, un Mac ne conserve qu'un profil, et l'essai aussi : en ajouter un autre, ou quitter celui qui est sélectionné, affiche Plusieurs profils nécessitent Chute Pro, dont le bouton Obtenir Chute Pro ouvre la fenêtre Chute Pro (Pas maintenant la ferme), et l'édition gratuite continue d'exécuter le profil qu'elle a. Si Configurer Chute a été ignoré, activer Proxy système ou Mode amélioré le rouvre, puisque les deux ont besoin de l'assistant privilégié.
- L'activer — deux interrupteurs indépendants répondent à des besoins différents :
- Proxy système — la première tuile du panneau, ou l'interrupteur en haut du menu. Enregistre Chute comme proxy HTTP/SOCKS du système ; les apps qui respectent le proxy système passent par Chute.
- Mode amélioré (la tuile voisine ; ⌘E dans le menu) — capture tout le trafic au niveau réseau, y compris celui des apps qui ignorent le proxy système. Son type par défaut, Helper utun (ancien), affiche un avis avant de s'activer et ne demande aucune autre approbation ; seul le type PacketTunnel (recommandé) demande d'approuver l'extension réseau et la configuration VPN de Chute. Consultez Mode amélioré pour le choix du type et le déroulement de l'approbation.
- Vérifier — la tuile Proxy système du panneau affiche l'adresse du proxy (l'en-tête du menu affiche « Proxy système : actif »), et les onglets Trafic et Journal de la fenêtre principale montrent ce qui circule et pourquoi.
La fenêtre principale s'ouvre par Fenêtre principale en bas du panneau, ou par Ouvrir la fenêtre principale... (⌘,) dans le menu.
Chute tvOS
Chute tvOS ajoute une configuration par lui-même. Dans la liste des configurations, Ajouter une configuration depuis... propose Configuration vierge, Envoyer un fichier via Wi-Fi ou Chute iOS et Télécharger depuis une URL. L'envoi Wi-Fi place une simple page HTTP à l'adresse du téléviseur, à laquelle tout navigateur du même réseau peut envoyer un fichier ; ouverte depuis un iPhone, cette page passe la main à Chute iOS via le schéma d'URL chute://tv, et c'est là qu'intervient la vue d'importation de configuration distante. La limite d'une seule configuration est la même que sur iOS.
Chute Android
Le premier lancement sur Android — ajout d'une configuration, consentement VPN, modes de service et par application, et où vérifier — a sa propre page : Premiers pas sur Android. La configuration minimale ci-dessous y fonctionne telle quelle.
Une configuration minimale
Une configuration complète et fonctionnelle pour un serveur Shadowsocks — achemine en direct le trafic du réseau local et le trafic chinois, et tout le reste par le proxy :
[General]
loglevel = notify
dns-server = 1.1.1.1, 8.8.8.8
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
[Proxy]
MyProxy = ss, example.com, 8388, aes-256-gcm, "password"
[Proxy Group]
MainGroup = select, MyProxy, DIRECT
[Rule]
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR,10.0.0.0/8,DIRECT
IP-CIDR,172.16.0.0/12,DIRECT
IP-CIDR,127.0.0.0/8,DIRECT
GEOIP,CN,DIRECT
FINAL,MainGroup
Remplacez la ligne [Proxy] par le protocole et les paramètres de votre serveur — tous les protocoles pris en charge sont documentés dans Serveur proxy. À partir d'ici :
- Configuration — le format de fichier et chaque section.
- Règle — comment les règles sont évaluées et le catalogue complet des types de règles.
- Groupe de politiques — sélection automatique (url-test, fallback, load-balance).
- Dépannage — quand quelque chose ne fonctionne pas.
Cette page est une traduction de la version anglaise. En cas de divergence, la version anglaise fait foi.