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 trois voies : Lien d'abonnement pour une URL fournie par un prestataire, Scanner un QR code, 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-CONFIG du profil. Un abonnement Clash ou sing-box 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.
• Importer depuis un fichier local — importe un fichier Chute (.conf), sing-box (.json) ou Clash/mihomo (.yaml) ; 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.

Sans licence, 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

Chute Mac réside dans la barre des menus (il n'y a pas d'icône dans le Dock par défaut). Cliquez sur l'icône de la barre des menus :

1. 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://, ... ; des quatre apps, seul Chute Mac importe les liens de partage). Assistant de configuration... en crée une pas à pas à la place. Les deux entrées de menu n'apparaissent que tant que le proxy est arrêté. 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.
2. La sélectionner — Sélectionner le fichier de configuration, ou Changer de configuration pendant que le proxy tourne. Au premier démarrage du moteur, Chute installe l'assistant privilégié qui règle le proxy système et crée l'interface du mode amélioré : il explique pourquoi (Chute a besoin d'un assistant), puis macOS vous demande de l'autoriser. Sous macOS 13 et ultérieur, l'assistant peut aussi devoir être autorisé dans Réglages Système > Général > Ouverture et extensions ; Chute le signale par Approbation requise ou Autoriser Chute dans les ouvertures de session.
3. L'activer — deux interrupteurs indépendants répondent à des besoins différents :
   • Proxy système — 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é (⌘E) — 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.
4. Vérifier — 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.

Remarque : ces étapes décrivent la nouvelle fenêtre principale. Chute Mac ne l'active de lui-même que pour une installation qui n'a encore aucune configuration ; une installation qui avait déjà des configurations garde l'ancienne interface : son menu propose Préférences... à la place de Ouvrir le tableau de bord..., et cette fenêtre n'a pas d'onglet Trafic ni Journal. Cochez Utiliser la nouvelle interface principale dans le menu — l'entrée est listée pendant que le proxy tourne — pour basculer.

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.