Installation et configuration de Happ sur les distributions Linux

Installer Happ sur Linux : AppImage et .deb

La version de bureau de Happ est distribuée dans la section Releases du dépôt Happ-proxy sur GitHub. Pour la plupart des distributions, le format universel AppImage est plus pratique : il ne nécessite aucune installation et se lance depuis n'importe quel dossier. Pour la famille Debian et Ubuntu, il existe un paquet .deb distinct.

Téléchargez le dernier fichier correspondant à votre architecture (généralement x86_64) et rendez l'AppImage exécutable, puis lancez-le : `chmod +x Happ-x86_64.AppImage` et `./Happ-x86_64.AppImage`. Pour le .deb, utilisez `sudo apt install ./happ_amd64.deb` — le gestionnaire de paquets récupérera lui-même les dépendances.

Si l'AppImage ne démarre pas, c'est le plus souvent la bibliothèque FUSE qui manque. Installez-la avec la commande `sudo apt install libfuse2` (Debian/Ubuntu) ou son équivalent pour votre distribution. En guise de solution de contournement, l'AppImage peut être décompressée et lancée directement : `./Happ-x86_64.AppImage --appimage-extract` puis `./squashfs-root/AppRun`.

Import de l'abonnement et de la configuration

L'accès aux serveurs est délivré par le bot Telegram du service : vous y activez une clé d'essai, payante ou officielle et vous recevez un lien d'abonnement du type https://…/sub/…. Ce lien contient la liste à jour des serveurs et les paramètres Xray — inutile de saisir les configurations manuellement.

Dans l'application, ouvrez l'ajout de configuration, collez le lien d'abonnement et enregistrez. Happ chargera tous les serveurs disponibles en une seule liste et les mettra ensuite à jour via ce même lien. Si les serveurs changent ou que de nouvelles localisations sont ajoutées, il suffit d'appuyer sur la mise à jour de l'abonnement — aucune réinstallation n'est nécessaire.

Si besoin, vous pouvez aussi ajouter une configuration unique : copiez la ligne vless:// ou ss:// depuis le bot et collez-la via l'import depuis le presse-papiers. Une même clé fonctionne sur tous les appareils, l'abonnement pour Linux, Windows et les clients mobiles est donc identique.

Lancer le mode proxy sur le cœur Xray

Après l'import, sélectionnez un serveur dans la liste et activez la connexion. Happ met en place un proxy local (SOCKS et HTTP) sur le cœur Xray et y achemine le trafic. En mode système, le client inscrit le proxy dans les paramètres de l'environnement de bureau, si bien que les navigateurs et la plupart des applications commencent à fonctionner via le tunnel sans configuration supplémentaire.

Le port local du proxy peut être défini manuellement dans les paramètres de l'application — c'est pratique lorsqu'on veut diriger seulement un programme précis vers Happ. Renseignez l'adresse 127.0.0.1 et le port choisi dans les paramètres du proxy du navigateur ou dans les variables d'environnement (par exemple `export https_proxy=http://127.0.0.1:PORT`), et laissez le reste du trafic passer directement.

Pour une répartition ciblée du trafic, Happ dispose d'un routage par listes et du split tunneling — quels domaines et applications passent par le proxy et lesquels le contournent. L'analyse détaillée des règles et des utility est présentée dans des sections dédiées du site, afin de ne pas mélanger l'installation de base avec le réglage fin des routes.

Démarrage automatique de Happ au lancement du système

Pour que le proxy se lance automatiquement, ajoutez le client au démarrage automatique de l'environnement de bureau. Créez le fichier `~/.config/autostart/happ.desktop` avec les lignes `[Desktop Entry]`, `Type=Application`, `Exec=/chemin/complet/Happ-x86_64.AppImage` et `X-GNOME-Autostart-enabled=true`. GNOME, KDE et la plupart des environnements le prendront en compte à la prochaine connexion.

Pour une installation .deb, le raccourci de démarrage automatique peut être activé directement dans les paramètres de l'application ou via le menu de démarrage de votre environnement — le chemin vers le fichier exécutable sera renseigné automatiquement. Après la connexion, Happ se réduit dans la zone de notification système et reste accessible depuis l'icône près de l'horloge.

Si vous lancez Linux sans interface graphique, configurez le lancement comme un service utilisateur systemd : placez l'unit dans `~/.config/systemd/user/`, indiquez le chemin de l'AppImage dans `ExecStart` et activez le démarrage automatique avec la commande `systemctl --user enable --now happ.service`.

Vérification de la connexion et diagnostic

Une fois connecté, vérifiez que le trafic passe bien par le serveur : ouvrez n'importe quel service de détection d'IP — l'adresse et le pays doivent correspondre à la localisation choisie. Si l'IP est restée la même, assurez-vous que le proxy système est activé et que l'application lit le bon port local.

En cas de coupures ou de lenteur, changez de serveur dans la liste d'abonnement — les localisations voisines offrent souvent une route plus stable. Mettez ensuite l'abonnement à jour pour obtenir les paramètres Xray actuels, et relancez la connexion. Parfois, c'est le pare-feu local qui gêne : autorisez les connexions sortantes de Happ dans ufw ou firewalld.

Si après une mise à jour du client la liste des serveurs ne se charge pas, vérifiez la validité de la clé dans le bot Telegram et l'exactitude du lien d'abonnement. Les journaux de connexion sont disponibles dans l'application elle-même et aident à distinguer un problème de clé d'un blocage réseau.