Instalace a nastavení Happ v distribucích Linuxu
Desktopový klient Happ na Linuxu běží na jádru Xray a poskytuje lokální proxy pro systém i aplikace. Níže najdete instalaci přes AppImage nebo balíček, připojení odkazu na odběr z Telegram bota a nastavení automatického spouštění.
Jak připojit Happ VPN — Linux
Nainstalujte aplikaci
Stáhněte Happ pro Linux z oficiálního zdroje pro svou distribuci.
Získejte klíč
Otevřete Telegram bot a aktivujte přístup.
Přidejte klíč
Importujte odkaz předplatného do aplikace.
Zapněte připojení
Vyberte server a zapněte VPN.
Instalace Happ na Linux: AppImage a .deb
Desktopová verze Happ je distribuována v sekci Releases repozitáře Happ-proxy na GitHub. Pro většinu distribucí je pohodlnější univerzální formát AppImage — nevyžaduje instalaci a spouští se z libovolné složky. Pro rodinu Debian a Ubuntu existuje samostatný balíček .deb.
Stáhněte nejnovější soubor pro svou architekturu (obvykle x86_64), nastavte AppImage jako spustitelný a poté jej spusťte: `chmod +x Happ-x86_64.AppImage` a `./Happ-x86_64.AppImage`. Pro .deb použijte `sudo apt install ./happ_amd64.deb` — správce balíčků si sám doplní závislosti.
Pokud se AppImage nespustí, nejčastěji chybí knihovna FUSE. Nainstalujte ji příkazem `sudo apt install libfuse2` (Debian/Ubuntu) nebo obdobou pro vaši distribuci. Jako náhradní řešení lze AppImage rozbalit a spustit přímo: `./Happ-x86_64.AppImage --appimage-extract` a poté `./squashfs-root/AppRun`.
Import odběru a konfigurace
Přístup k serverům poskytuje Telegram bot služby: tam aktivujete zkušební, placený nebo oficiální klíč a získáte odkaz na odběr ve tvaru https://…/sub/…. Tento odkaz obsahuje aktuální seznam serverů a parametry Xray — konfigurace není nutné zadávat ručně.
V aplikaci otevřete přidání konfigurace, vložte odkaz na odběr a uložte jej. Happ načte všechny dostupné servery jako jeden seznam a nadále je bude aktualizovat pomocí stejného odkazu. Pokud se servery mění nebo přibývají nové lokality, stačí stisknout aktualizaci odběru — přeinstalace není potřeba.
V případě potřeby lze přidat i jednotlivou konfiguraci: zkopírujte řádek vless:// nebo ss:// z bota a vložte jej pomocí importu ze schránky. Stejný klíč funguje na všech zařízeních, proto se odběr pro Linux, Windows i mobilní klienty shoduje.
Spuštění režimu proxy na jádru Xray
Po importu vyberte server ze seznamu a zapněte připojení. Happ spustí lokální proxy (SOCKS a HTTP) na jádru Xray a směruje přes něj provoz. V systémovém režimu klient zapíše proxy do nastavení pracovního prostředí, takže prohlížeče a většina aplikací začnou fungovat přes tunel bez další konfigurace.
Lokální port proxy lze zadat ručně v nastavení aplikace — to se hodí, když chcete do Happ směrovat pouze konkrétní program. Zadejte adresu 127.0.0.1 a určený port v nastavení proxy prohlížeče nebo v proměnných prostředí (například `export https_proxy=http://127.0.0.1:PORT`) a zbytek provozu ponechte přímý.
Pro cílené rozdělení provozu má Happ směrování podle seznamů a split tunneling — které domény a aplikace jdou přes proxy a které mimo něj. Podrobný rozbor pravidel a utility je vyčleněn do samostatných sekcí webu, aby se základní instalace nemíchala s jemným nastavením tras.
Automatické spouštění Happ při startu systému
Aby se proxy spouštěla automaticky, přidejte klienta do automatického spouštění pracovního prostředí. Vytvořte soubor `~/.config/autostart/happ.desktop` s řádky `[Desktop Entry]`, `Type=Application`, `Exec=/plná/cesta/Happ-x86_64.AppImage` a `X-GNOME-Autostart-enabled=true`. GNOME, KDE a většina prostředí jej při dalším přihlášení načtou.
Pro instalaci z .deb lze zástupce automatického spouštění zapnout přímo v nastavení aplikace nebo přes nabídku automatického spouštění vašeho prostředí — cesta ke spustitelnému souboru se doplní automaticky. Po přihlášení se Happ minimalizuje do systémové lišty a je dostupný z ikony vedle hodin.
Pokud spouštíte Linux bez grafického prostředí, nastavte spuštění jako uživatelskou službu systemd: umístěte unit do `~/.config/systemd/user/`, uveďte cestu k AppImage v `ExecStart` a aktivujte automatické spouštění příkazem `systemctl --user enable --now happ.service`.
Kontrola připojení a diagnostika
Po připojení ověřte, že provoz jde přes server: otevřete libovolnou službu pro zjištění IP — adresa a země by měly odpovídat vybrané lokalitě. Pokud IP zůstala stejná, ujistěte se, že je systémová proxy zapnutá a aplikace čte správný lokální port.
Při výpadcích nebo pomalé rychlosti změňte server v seznamu odběru — sousední lokality často poskytují stabilnější trasu. Poté aktualizujte odběr, abyste získali aktuální parametry Xray, a restartujte připojení. Někdy překáží lokální firewall: povolte Happ odchozí připojení v ufw nebo firewalld.
Pokud se po aktualizaci klienta seznam serverů nenačítá, zkontrolujte platnost klíče v Telegram botovi a správnost odkazu na odběr. Logy připojení jsou dostupné přímo v aplikaci a pomáhají odlišit problém s klíčem od síťové blokace.
Časté dotazy
Jak nainstalovat Happ na Linux?
Stáhněte nejnovější verzi ze sekce Releases repozitáře Happ-proxy na GitHub: AppImage pro libovolnou distribuci nebo .deb pro Debian a Ubuntu. AppImage nastavte jako spustitelný příkazem chmod +x a spusťte, .deb nainstalujte přes sudo apt install ./soubor.deb. Poté přidejte odkaz na odběr z Telegram bota.
Kde získat klíč a odběr pro Linux?
Klíč a odkaz na odběr poskytuje Telegram bot služby — tam se aktivuje zkušební, placený nebo oficiální přístup. Odkaz obsahuje seznam serverů a parametry Xray, stačí jej jednou vložit do aplikace. Klíč je jednotný pro všechna zařízení, proto se odběr pro Linux shoduje s Windows a mobilními klienty.
AppImage se nespouští — co dělat?
Nejčastěji chybí knihovna FUSE: nainstalujte ji příkazem sudo apt install libfuse2 nebo obdobou pro vaši distribuci. Jako náhradní řešení rozbalte obraz přes ./Happ-x86_64.AppImage --appimage-extract a spusťte ./squashfs-root/AppRun. Také se ujistěte, že má soubor nastavený příznak spuštění přes chmod +x.
Jak nastavit automatické spouštění Happ na Linuxu?
Vytvořte soubor ~/.config/autostart/happ.desktop se záznamem Desktop Entry a cestou k AppImage na řádku Exec — GNOME a KDE jej při přihlášení načtou. Pro servery bez grafiky nastavte uživatelskou službu systemd v ~/.config/systemd/user/ a zapněte ji příkazem systemctl --user enable --now happ.service.
Jak směrovat přes Happ jen jeden prohlížeč?
Zapněte lokální proxy v nastavení aplikace a zapamatujte si adresu 127.0.0.1 s určeným portem. Zadejte tuto proxy v nastavení konkrétního prohlížeče nebo v proměnné prostředí https_proxy — přes tunel pak půjde jen on, zatímco zbytek provozu zůstane přímý. Pro směrování podle domén použijte split tunneling.
Připojení je, ale IP se nemění — proč?
Zkontrolujte, že je zapnutá systémová proxy a aplikace naslouchá na správném lokálním portu. Změňte server v seznamu odběru a aktualizujte jej, abyste získali aktuální parametry. Pokud překáží lokální firewall, povolte Happ odchozí připojení v ufw nebo firewalld a poté restartujte připojení.