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 : le fichier est enregistré comme configuration gérée et retéléchargé toutes les 24 heures.
• 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.

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 Dashboard 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… pour un fichier sur disque, ou Assistant de configuration… pour en créer une pas à pas. L'onglet Profils de la fenêtre principale permet en outre d'importer depuis une URL d'abonnement ou un lien de partage (ss://, vmess://, …). 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.
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. Le premier démarrage demande d'approuver l'extension réseau ou 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.

Chute tvOS

Chute pour Apple TV se configure depuis un iPhone ou un iPad : la vue d'importation de configuration distante de Chute iOS — accessible via le schéma d'URL chute://tv — transmet une configuration au téléviseur.

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 Politique de 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.