Instalacja i konfiguracja Happ w dystrybucjach Linux
Klient desktopowy Happ na Linux działa na jądrze Xray i udostępnia lokalne proxy dla systemu oraz aplikacji. Poniżej znajdziesz instalację przez AppImage lub pakiet, podłączenie linku subskrypcji z bota Telegram oraz konfigurację autostartu.
Jak połączyć Happ VPN — Linux
Zainstaluj aplikację
Pobierz Happ dla Linuksa z oficjalnego źródła dla swojej dystrybucji.
Uzyskaj klucz
Otwórz bota Telegram i aktywuj dostęp.
Dodaj klucz
Zaimportuj link subskrypcji do aplikacji.
Włącz połączenie
Wybierz serwer i włącz VPN.
Instalacja Happ na Linux: AppImage i .deb
Wersja desktopowa Happ jest udostępniana w sekcji Releases repozytorium Happ-proxy na GitHub. Dla większości dystrybucji wygodniejszy jest uniwersalny format AppImage — nie wymaga instalacji i uruchamia się z dowolnego folderu. Dla rodziny Debian i Ubuntu dostępny jest osobny pakiet .deb.
Pobierz najnowszy plik pod swoją architekturę (zwykle x86_64) i nadaj AppImage uprawnienia wykonywalne, a następnie uruchom: `chmod +x Happ-x86_64.AppImage` oraz `./Happ-x86_64.AppImage`. Dla .deb użyj `sudo apt install ./happ_amd64.deb` — menedżer pakietów sam pobierze zależności.
Jeśli AppImage nie startuje, najczęściej brakuje biblioteki FUSE. Zainstaluj ją komendą `sudo apt install libfuse2` (Debian/Ubuntu) lub odpowiednikiem dla Twojej dystrybucji. Jako obejście AppImage można rozpakować i uruchomić bezpośrednio: `./Happ-x86_64.AppImage --appimage-extract`, a następnie `./squashfs-root/AppRun`.
Import subskrypcji i konfiguracji
Dostęp do serwerów przydziela bot Telegram serwisu: tam aktywujesz klucz próbny, opłacony lub oficjalny i otrzymujesz link subskrypcji w postaci https://…/sub/…. Ten link zawiera aktualną listę serwerów oraz parametry Xray — nie trzeba wprowadzać konfiguracji ręcznie.
W aplikacji otwórz dodawanie konfiguracji, wklej link subskrypcji i zapisz. Happ pobierze wszystkie dostępne serwery jako jedną listę i w przyszłości będzie je aktualizować przez ten sam link. Jeśli serwery się zmieniają lub dochodzą nowe lokalizacje, wystarczy odświeżyć subskrypcję — ponowna instalacja nie jest potrzebna.
W razie potrzeby można dodać też pojedynczą konfigurację: skopiuj ciąg vless:// lub ss:// z bota i wklej go poprzez import ze schowka. Ten sam klucz działa na wszystkich urządzeniach, dlatego subskrypcja dla Linux, Windows i klientów mobilnych jest identyczna.
Uruchomienie trybu proxy na jądrze Xray
Po imporcie wybierz serwer z listy i włącz połączenie. Happ uruchamia lokalne proxy (SOCKS i HTTP) na jądrze Xray i przez nie kieruje ruch. W trybie systemowym klient wpisuje proxy do ustawień środowiska pracy, dzięki czemu przeglądarki i większość aplikacji zaczynają działać przez tunel bez dodatkowej konfiguracji.
Lokalny port proxy można wskazać ręcznie w ustawieniach aplikacji — jest to wygodne, gdy chcesz skierować do Happ tylko konkretny program. Wpisz adres 127.0.0.1 i wybrany port w ustawieniach proxy przeglądarki lub w zmiennych środowiskowych (na przykład `export https_proxy=http://127.0.0.1:PORT`), a pozostały ruch pozostaw bezpośrednio.
Do precyzyjnego rozdzielenia ruchu Happ oferuje routing według list oraz split tunneling — które domeny i aplikacje idą przez proxy, a które z pominięciem. Szczegółowe omówienie reguł i utility wydzielono do osobnych sekcji serwisu, aby nie mieszać podstawowej instalacji z zaawansowaną konfiguracją tras.
Autostart Happ przy uruchamianiu systemu
Aby proxy uruchamiało się automatycznie, dodaj klienta do autostartu środowiska pracy. Utwórz plik `~/.config/autostart/happ.desktop` z liniami `[Desktop Entry]`, `Type=Application`, `Exec=/pełna/ścieżka/Happ-x86_64.AppImage` oraz `X-GNOME-Autostart-enabled=true`. GNOME, KDE i większość środowisk podchwyci go przy następnym logowaniu.
W przypadku instalacji z .deb skrót autostartu można włączyć bezpośrednio w ustawieniach aplikacji albo przez menu autostartu Twojego środowiska — ścieżka do pliku wykonywalnego podstawi się automatycznie. Po zalogowaniu Happ zwinie się do zasobnika systemowego i będzie dostępny z ikony obok zegara.
Jeśli uruchamiasz Linux bez powłoki graficznej, skonfiguruj uruchamianie jako usługę użytkownika systemd: umieść unit w `~/.config/systemd/user/`, wskaż ścieżkę do AppImage w `ExecStart` i aktywuj autostart komendą `systemctl --user enable --now happ.service`.
Sprawdzenie połączenia i diagnostyka
Po połączeniu sprawdź, czy ruch idzie przez serwer: otwórz dowolny serwis wykrywania IP — adres i kraj powinny odpowiadać wybranej lokalizacji. Jeśli IP pozostało bez zmian, upewnij się, że proxy systemowe jest włączone, a aplikacja czyta właściwy lokalny port.
Przy zrywaniu połączenia lub niskiej prędkości zmień serwer na liście subskrypcji — sąsiednie lokalizacje często dają bardziej stabilną trasę. Następnie odśwież subskrypcję, aby pobrać aktualne parametry Xray, i uruchom połączenie ponownie. Czasem przeszkadza lokalny firewall: zezwól Happ na połączenia wychodzące w ufw lub firewalld.
Jeśli po aktualizacji klienta lista serwerów się nie ładuje, sprawdź termin ważności klucza w bocie Telegram oraz poprawność linku subskrypcji. Logi połączenia są dostępne w samej aplikacji i pomagają odróżnić problem z kluczem od blokady sieciowej.
Gotowy, by się połączyć?
Uzyskaj klucz Happ VPN w bocie Telegram: 3 dni za darmo, bez karty.
Uzyskaj kluczNajczęstsze pytania
Jak zainstalować Happ na Linux?
Pobierz najnowszą wersję z sekcji Releases repozytorium Happ-proxy na GitHub: AppImage dla dowolnej dystrybucji lub .deb dla Debian i Ubuntu. AppImage nadaj uprawnienia wykonywalne komendą chmod +x i uruchom, a .deb zainstaluj przez sudo apt install ./plik.deb. Następnie dodaj link subskrypcji z bota Telegram.
Skąd wziąć klucz i subskrypcję dla Linux?
Klucz i link subskrypcji przydziela bot Telegram serwisu — tam aktywuje się dostęp próbny, opłacony lub oficjalny. Link zawiera listę serwerów i parametry Xray, wystarczy raz wkleić go w aplikacji. Klucz jest wspólny dla wszystkich urządzeń, dlatego subskrypcja dla Linux jest taka sama jak dla Windows i klientów mobilnych.
AppImage się nie uruchamia — co robić?
Najczęściej brakuje biblioteki FUSE: zainstaluj ją komendą sudo apt install libfuse2 lub odpowiednikiem dla Twojej dystrybucji. Jako obejście rozpakuj obraz przez ./Happ-x86_64.AppImage --appimage-extract i uruchom ./squashfs-root/AppRun. Upewnij się też, że plikowi nadano flagę wykonywalności przez chmod +x.
Jak skonfigurować autostart Happ na Linux?
Utwórz plik ~/.config/autostart/happ.desktop z wpisem Desktop Entry i ścieżką do AppImage w linii Exec — GNOME i KDE podchwycą go przy logowaniu. Dla serwerów bez grafiki skonfiguruj usługę użytkownika systemd w ~/.config/systemd/user/ i włącz ją komendą systemctl --user enable --now happ.service.
Jak skierować przez Happ tylko jedną przeglądarkę?
Włącz lokalne proxy w ustawieniach aplikacji i zapamiętaj adres 127.0.0.1 z wybranym portem. Wpisz to proxy w ustawieniach konkretnej przeglądarki lub w zmiennej środowiskowej https_proxy — wtedy przez tunel pójdzie tylko ona, a pozostały ruch pozostanie bezpośredni. Do routingu według domen użyj split tunneling.
Połączenie jest, ale IP się nie zmienia — dlaczego?
Sprawdź, czy proxy systemowe jest włączone, a aplikacja nasłuchuje na właściwym lokalnym porcie. Zmień serwer na liście subskrypcji i odśwież ją, aby pobrać aktualne parametry. Jeśli przeszkadza lokalny firewall, zezwól Happ na połączenia wychodzące w ufw lub firewalld, a następnie uruchom połączenie ponownie.