Configurer Happ sur Mac : de l'installation au routage du trafic

Installation de Happ sur macOS

Happ est un client basé sur le noyau Xray qui, sur Mac, fonctionne à la fois comme une application ordinaire avec proxy système et comme un tunnel réseau complet. Téléchargez la version pour macOS, déplacez l'application dans le dossier « Applications » et lancez-la. Au premier démarrage, macOS peut afficher un avertissement Gatekeeper indiquant que le programme a été téléchargé depuis Internet — ouvrez « Réglages Système → Confidentialité et sécurité » et confirmez le lancement avec le bouton « Ouvrir quand même ».

Pour un fonctionnement stable, macOS 12 Monterey ou une version plus récente est recommandé — sur les versions antérieures, une partie des API réseau que Happ utilise pour le mode TUN n'est pas disponible. Le client fonctionne aussi correctement sur les Mac équipés de processeurs Apple Silicon (M1–M4) que sur les modèles à puces Intel ; il n'est pas nécessaire de chercher une build distincte pour chaque architecture, la version universelle sélectionne elle-même le code adapté.

Après l'installation, il est judicieux d'autoriser tout de suite le lancement automatique de Happ à l'ouverture de session ainsi que l'affichage de l'icône dans la barre de menus. C'est pratique : la connexion, le changement de serveur et le basculement de mode restent à portée de main, sans avoir à ouvrir la fenêtre de l'application à chaque fois.

Clé et abonnement : comment se connecter

L'accès aux serveurs est délivré par le bot Telegram du service. Souscrivez une clé d'essai, officielle ou payante dans le bot — en réponse, vous recevrez soit une chaîne d'abonnement (un lien au format happ:// ou https://), soit une configuration de serveur distincte. Il n'est pas nécessaire de copier manuellement de longues configurations sur Mac : l'abonnement récupère lui-même la liste actuelle des serveurs et la met à jour lorsque des changements surviennent du côté du service.

Le moyen le plus rapide d'ajouter une clé est de copier le lien d'abonnement et, dans Happ, d'appuyer sur « Ajouter depuis le presse-papiers » : l'application reconnaît le contenu du presse-papiers et importe le profil automatiquement. Si vous ouvrez un lien happ:// directement sous macOS, le système proposera de le transmettre à Happ via deep-link, et le profil sera ajouté en un clic.

Après l'import, la liste des serveurs apparaît dans la fenêtre principale. Choisissez le nœud au ping le plus faible, appuyez sur « Connecter » et attendez que l'indicateur devienne actif. Il suffit d'ajouter l'abonnement une seule fois — lors du renouvellement de la clé dans le bot, il n'est rien nécessaire de réinstaller, le client récupère les mises à jour de lui-même.

Mode proxy et mode TUN : que choisir

Sur macOS, Happ propose deux façons fondamentalement différentes de faire transiter le trafic. Le mode proxy met en place un proxy SOCKS/HTTP local et l'inscrit dans les réglages réseau du système. Les requêtes des applications qui respectent le proxy système passent par ce canal — les navigateurs avant tout. C'est un mode léger : il ne nécessite pas de droits d'administrateur et n'affecte pas le trafic des programmes qui fonctionnent en contournant le proxy.

Le mode TUN (également appelé mode tunnel système) crée une interface réseau virtuelle utun et intercepte le trafic au niveau de l'ensemble du système. Dans ce cas, le tunnel achemine non seulement les navigateurs, mais aussi les messageries, les clients de bureau, le terminal et les services en arrière-plan. Pour activer le TUN, Happ demandera une fois d'installer un helper privilégié et de confirmer l'action avec le mot de passe administrateur — c'est le comportement normal de macOS pour les applications qui gèrent la pile réseau.

Règle pratique : si vous voulez que « tout passe » pour l'application entière, activez le TUN. Si le besoin est ponctuel — ouvrir l'accès uniquement dans le navigateur sans toucher au reste du système — le mode proxy suffit. On peut basculer entre les modes à la volée, sans supprimer l'abonnement ni changer le serveur sélectionné.

Routage et split tunneling

Le noyau Xray au sein de Happ prend en charge un routage flexible : on peut définir des règles indiquant quel trafic passe par le serveur et lequel passe en direct. Sur Mac, cela sert le plus souvent au tunnelage séparé (split tunneling) : par exemple, les sites bancaires et locaux contournent le tunnel, tandis que tout le reste passe par le serveur sélectionné. Les règles se construisent par domaines, sous-réseaux IP et géozones.

Les listes de routage prêtes à l'emploi (routing lists) évitent d'énumérer manuellement des centaines de domaines. En connectant une telle liste, vous obtenez des ensembles de règles préconfigurés — par exemple, « ressources locales en direct » ou « bloquer les domaines publicitaires et de traçage ». Les listes se mettent à jour, de sorte que les règles restent pertinentes sans votre intervention.

Sur macOS, l'option de contournement du trafic du réseau local est particulièrement utile : les accès aux imprimantes, aux NAS et à d'autres appareils du réseau domestique doivent passer en direct, sinon ils cesseront d'être détectés. Dans les réglages de routage, laissez les plages privées (10.0.0.0/8, 192.168.0.0/16 et similaires) hors du tunnel — c'est une pratique standard et sûre.

Optimisation et problèmes courants sur Mac

Si Internet a disparu dans toutes les applications après l'activation du TUN, vérifiez d'abord que le helper privilégié est bien installé et que Happ a l'autorisation de modifier la configuration réseau dans « Confidentialité et sécurité ». Le retrait de cette autorisation est la cause la plus fréquente du fait que le tunnel se met en place mais que le trafic ne passe pas. Réinstaller le helper depuis les réglages de l'application résout généralement le problème.

En cas de vitesse lente, essayez de changer de serveur pour un serveur géographiquement plus proche et prêtez attention au transport de la connexion. Les nœuds dotés de protocoles de masquage modernes sur le noyau Xray donnent en général un résultat stable sur les canaux instables, tandis qu'un nœud public surchargé perd en vitesse aux heures de pointe. Le ping et la charge du serveur se voient directement dans la liste.

Si le navigateur ignore la connexion en mode proxy, vérifiez qu'aucun proxy propre ni extension interceptant le réseau n'y est configuré — cela écrase le réglage système. Et pour que Happ ne se déconnecte pas lors de la mise en veille du Mac, activez la connexion automatique au démarrage et le maintien du tunnel ; ainsi, après le réveil de l'ordinateur portable, la connexion se rétablira d'elle-même.