Installation und Einrichtung von Happ in Linux-Distributionen

Happ unter Linux installieren: AppImage und .deb

Die Desktop-Version von Happ wird im Bereich Releases des Happ-proxy-Repositorys auf GitHub verteilt. Für die meisten Distributionen ist das universelle Format AppImage praktischer – es erfordert keine Installation und startet aus jedem beliebigen Ordner. Für die Debian- und Ubuntu-Familie gibt es ein separates .deb-Paket.

Laden Sie die aktuelle Datei für Ihre Architektur herunter (in der Regel x86_64), machen Sie das AppImage ausführbar und starten Sie es anschließend: `chmod +x Happ-x86_64.AppImage` und `./Happ-x86_64.AppImage`. Für .deb verwenden Sie `sudo apt install ./happ_amd64.deb` – der Paketmanager löst die Abhängigkeiten selbst auf.

Wenn das AppImage nicht startet, fehlt meistens die FUSE-Bibliothek. Installieren Sie sie mit dem Befehl `sudo apt install libfuse2` (Debian/Ubuntu) oder dem entsprechenden Befehl für Ihre Distribution. Als Ausweichlösung lässt sich das AppImage entpacken und direkt ausführen: `./Happ-x86_64.AppImage --appimage-extract` und danach `./squashfs-root/AppRun`.

Abo und Konfiguration importieren

Den Zugang zu den Servern vergibt der Telegram-Bot des Dienstes: Dort aktivieren Sie einen Test-, Bezahl- oder offiziellen Schlüssel und erhalten einen Abo-Link der Form https://…/sub/…. Dieser Link enthält die aktuelle Serverliste und die Xray-Parameter – Konfigurationen müssen Sie nicht manuell eingeben.

Öffnen Sie in der Anwendung das Hinzufügen einer Konfiguration, fügen Sie den Abo-Link ein und speichern Sie ihn. Happ lädt alle verfügbaren Server als eine Liste und aktualisiert sie künftig über denselben Link. Wenn sich Server ändern oder neue Standorte hinzukommen, genügt ein Klick auf die Abo-Aktualisierung – eine Neuinstallation ist nicht nötig.

Bei Bedarf lässt sich auch eine einzelne Konfiguration hinzufügen: Kopieren Sie die Zeile vless:// oder ss:// aus dem Bot und fügen Sie sie über den Import aus der Zwischenablage ein. Derselbe Schlüssel funktioniert auf allen Geräten, daher stimmt das Abo für Linux, Windows und die mobilen Clients überein.

Proxy-Modus auf dem Xray-Kern starten

Wählen Sie nach dem Import einen Server aus der Liste und aktivieren Sie die Verbindung. Happ startet einen lokalen Proxy (SOCKS und HTTP) auf dem Xray-Kern und leitet den Datenverkehr darüber. Im Systemmodus trägt der Client den Proxy in die Einstellungen der Arbeitsumgebung ein, sodass Browser und die meisten Anwendungen ohne zusätzliche Einrichtung über den Tunnel laufen.

Der lokale Proxy-Port lässt sich in den Einstellungen der Anwendung manuell festlegen – das ist praktisch, wenn nur ein bestimmtes Programm über Happ geleitet werden soll. Tragen Sie die Adresse 127.0.0.1 und den gewählten Port in die Proxy-Einstellungen des Browsers oder in die Umgebungsvariablen ein (zum Beispiel `export https_proxy=http://127.0.0.1:PORT`) und lassen Sie den übrigen Datenverkehr direkt laufen.

Für eine gezielte Aufteilung des Datenverkehrs bietet Happ eine Routenführung nach Listen sowie split tunneling – welche Domains und Anwendungen über den Proxy und welche daran vorbei laufen. Eine ausführliche Erläuterung der Regeln und der utility ist in eigene Bereiche der Website ausgelagert, damit die grundlegende Installation nicht mit der Feineinstellung der Routen vermischt wird.

Autostart von Happ beim Systemstart

Damit der Proxy automatisch startet, fügen Sie den Client zum Autostart der Arbeitsumgebung hinzu. Erstellen Sie die Datei `~/.config/autostart/happ.desktop` mit den Zeilen `[Desktop Entry]`, `Type=Application`, `Exec=/vollständiger/pfad/Happ-x86_64.AppImage` und `X-GNOME-Autostart-enabled=true`. GNOME, KDE und die meisten Umgebungen übernehmen sie beim nächsten Anmelden.

Bei einer .deb-Installation lässt sich die Autostart-Verknüpfung direkt in den Einstellungen der Anwendung aktivieren oder über das Autostart-Menü Ihrer Umgebung – der Pfad zur ausführbaren Datei wird automatisch eingesetzt. Nach dem Anmelden minimiert sich Happ in den System-Tray und ist über das Symbol neben der Uhr erreichbar.

Wenn Sie Linux ohne grafische Oberfläche betreiben, richten Sie den Start als systemd-Benutzerdienst ein: Legen Sie die Unit in `~/.config/systemd/user/` ab, geben Sie den Pfad zum AppImage in `ExecStart` an und aktivieren Sie den Autostart mit dem Befehl `systemctl --user enable --now happ.service`.

Verbindung prüfen und Diagnose

Prüfen Sie nach dem Verbinden, ob der Datenverkehr über den Server läuft: Öffnen Sie einen beliebigen Dienst zur IP-Ermittlung – Adresse und Land sollten dem gewählten Standort entsprechen. Ist die IP unverändert geblieben, stellen Sie sicher, dass der System-Proxy aktiviert ist und die Anwendung den richtigen lokalen Port ausliest.

Bei Abbrüchen oder langsamer Geschwindigkeit wechseln Sie den Server in der Abo-Liste – benachbarte Standorte liefern oft eine stabilere Route. Aktualisieren Sie anschließend das Abo, um die aktuellen Xray-Parameter zu erhalten, und starten Sie die Verbindung neu. Manchmal stört eine lokale Firewall: Erlauben Sie Happ ausgehende Verbindungen in ufw oder firewalld.

Wenn nach einem Update des Clients die Serverliste nicht geladen wird, prüfen Sie die Gültigkeit des Schlüssels im Telegram-Bot und die Korrektheit des Abo-Links. Die Verbindungsprotokolle sind in der Anwendung selbst verfügbar und helfen dabei, ein Problem mit dem Schlüssel von einer Netzwerksperre zu unterscheiden.