Installazione e configurazione di Happ nelle distribuzioni Linux
Il client desktop Happ su Linux funziona sul core Xray e mette a disposizione un proxy locale per il sistema e le applicazioni. Di seguito: installazione tramite AppImage o pacchetto, connessione del link di abbonamento dal bot Telegram e configurazione dell'avvio automatico.
Come connettere Happ VPN — Linux
Installa l'app
Scarica Happ per Linux da una fonte ufficiale per la tua distribuzione.
Ottieni una chiave
Apri il bot Telegram e attiva l'accesso.
Aggiungi la chiave
Importa il link di abbonamento nell'app.
Attiva la connessione
Scegli un server e attiva la VPN.
Installare Happ su Linux: AppImage e .deb
La build desktop di Happ è distribuita nella sezione Releases del repository Happ-proxy su GitHub. Per la maggior parte delle distribuzioni è più comodo il formato universale AppImage: non richiede installazione e si avvia da qualsiasi cartella. Per la famiglia Debian e Ubuntu è disponibile un pacchetto .deb separato.
Scarica il file più recente per la tua architettura (di solito x86_64) e rendi l'AppImage eseguibile, poi avvialo: `chmod +x Happ-x86_64.AppImage` e `./Happ-x86_64.AppImage`. Per il .deb usa `sudo apt install ./happ_amd64.deb` — il gestore dei pacchetti recupererà automaticamente le dipendenze.
Se l'AppImage non si avvia, molto spesso manca la libreria FUSE. Installala con il comando `sudo apt install libfuse2` (Debian/Ubuntu) o con l'equivalente per la tua distribuzione. Come soluzione alternativa, l'AppImage può essere estratto e avviato direttamente: `./Happ-x86_64.AppImage --appimage-extract` e poi `./squashfs-root/AppRun`.
Importare l'abbonamento e la configurazione
L'accesso ai server viene fornito dal bot Telegram del servizio: lì attivi una chiave di prova, a pagamento o ufficiale e ricevi un link di abbonamento del tipo https://…/sub/…. Questo link contiene l'elenco aggiornato dei server e i parametri Xray — non è necessario inserire le configurazioni manualmente.
Nell'applicazione apri l'aggiunta della configurazione, incolla il link di abbonamento e salva. Happ caricherà tutti i server disponibili in un unico elenco e in seguito li aggiornerà tramite lo stesso link. Se i server cambiano o vengono aggiunte nuove località, basta premere l'aggiornamento dell'abbonamento — non serve reinstallare.
Se necessario, puoi aggiungere anche una singola configurazione: copia la stringa vless:// o ss:// dal bot e incollala tramite l'importazione dagli appunti. La stessa chiave funziona su tutti i dispositivi, quindi l'abbonamento per Linux, Windows e i client mobili coincide.
Avviare la modalità proxy sul core Xray
Dopo l'importazione seleziona un server dall'elenco e attiva la connessione. Happ avvia un proxy locale (SOCKS e HTTP) sul core Xray e instrada il traffico attraverso di esso. In modalità di sistema il client imposta il proxy nelle impostazioni dell'ambiente di lavoro, quindi i browser e la maggior parte delle applicazioni iniziano a funzionare attraverso il tunnel senza configurazioni aggiuntive.
La porta del proxy locale può essere specificata manualmente nelle impostazioni dell'applicazione — comodo quando serve indirizzare verso Happ solo un programma specifico. Imposta l'indirizzo 127.0.0.1 e la porta scelta nelle impostazioni proxy del browser o nelle variabili d'ambiente (ad esempio `export https_proxy=http://127.0.0.1:PORT`), lasciando il resto del traffico diretto.
Per una suddivisione mirata del traffico, Happ dispone di instradamento tramite liste e split tunneling — quali domini e applicazioni passano attraverso il proxy e quali lo aggirano. L'analisi dettagliata delle regole e della utility è collocata in sezioni separate del sito, per non mescolare l'installazione di base con la configurazione fine degli instradamenti.
Avvio automatico di Happ all'accensione del sistema
Affinché il proxy si avvii automaticamente, aggiungi il client all'avvio automatico dell'ambiente di lavoro. Crea il file `~/.config/autostart/happ.desktop` con le righe `[Desktop Entry]`, `Type=Application`, `Exec=/percorso/completo/Happ-x86_64.AppImage` e `X-GNOME-Autostart-enabled=true`. GNOME, KDE e la maggior parte degli ambienti lo riconosceranno al successivo accesso.
Per l'installazione tramite .deb, il collegamento di avvio automatico può essere attivato direttamente nelle impostazioni dell'applicazione oppure tramite il menu di avvio automatico del tuo ambiente — il percorso del file eseguibile verrà inserito automaticamente. Dopo l'accesso Happ si ridurrà nel system tray e sarà accessibile dall'icona vicino all'orologio.
Se avvii Linux senza interfaccia grafica, imposta l'avvio come servizio utente systemd: colloca la unit in `~/.config/systemd/user/`, indica il percorso all'AppImage in `ExecStart` e attiva l'avvio automatico con il comando `systemctl --user enable --now happ.service`.
Verifica della connessione e diagnostica
Dopo la connessione verifica che il traffico passi attraverso il server: apri un qualsiasi servizio di rilevamento IP — l'indirizzo e il paese devono corrispondere alla località selezionata. Se l'IP è rimasto invariato, assicurati che il proxy di sistema sia attivo e che l'applicazione legga la porta locale corretta.
In caso di interruzioni o velocità ridotta, cambia server nell'elenco dell'abbonamento — le località vicine spesso offrono un instradamento più stabile. Poi aggiorna l'abbonamento per ottenere i parametri Xray aggiornati e riavvia la connessione. A volte il problema è il firewall locale: consenti a Happ le connessioni in uscita in ufw o firewalld.
Se dopo l'aggiornamento del client l'elenco dei server non si carica, verifica la validità della chiave nel bot Telegram e la correttezza del link di abbonamento. I log della connessione sono disponibili nell'applicazione stessa e aiutano a distinguere un problema con la chiave da un blocco di rete.
Pronto a connetterti?
Ottieni la tua chiave Happ VPN nel bot Telegram: 3 giorni gratis, senza carta.
Ottieni una chiaveDomande frequenti
Come installare Happ su Linux?
Scarica la build più recente dalla sezione Releases del repository Happ-proxy su GitHub: AppImage per qualsiasi distribuzione o .deb per Debian e Ubuntu. Rendi l'AppImage eseguibile con il comando chmod +x e avvialo, il .deb installalo tramite sudo apt install ./file.deb. Poi aggiungi il link di abbonamento dal bot Telegram.
Dove ottenere la chiave e l'abbonamento per Linux?
La chiave e il link di abbonamento vengono forniti dal bot Telegram del servizio — lì si attiva l'accesso di prova, a pagamento o ufficiale. Il link contiene l'elenco dei server e i parametri Xray e va inserito una sola volta nell'applicazione. La chiave è unica per tutti i dispositivi, quindi l'abbonamento per Linux coincide con quello di Windows e dei client mobili.
L'AppImage non si avvia — cosa fare?
Molto spesso manca la libreria FUSE: installala con il comando sudo apt install libfuse2 o con l'equivalente per la tua distribuzione. Come soluzione alternativa estrai l'immagine con ./Happ-x86_64.AppImage --appimage-extract e avvia ./squashfs-root/AppRun. Assicurati inoltre che al file sia stato assegnato il flag di esecuzione tramite chmod +x.
Come configurare l'avvio automatico di Happ su Linux?
Crea il file ~/.config/autostart/happ.desktop con una voce Desktop Entry e il percorso all'AppImage nella riga Exec — GNOME e KDE lo riconosceranno all'accesso. Per i server senza interfaccia grafica imposta un servizio utente systemd in ~/.config/systemd/user/ e attivalo con il comando systemctl --user enable --now happ.service.
Come indirizzare tramite Happ solo un browser?
Attiva il proxy locale nelle impostazioni dell'applicazione e memorizza l'indirizzo 127.0.0.1 con la porta scelta. Imposta questo proxy nelle impostazioni di un browser specifico o nella variabile d'ambiente https_proxy — così attraverso il tunnel passerà solo quello, mentre il resto del traffico resterà diretto. Per l'instradamento per domini usa lo split tunneling.
La connessione c'è, ma l'IP non cambia — perché?
Verifica che il proxy di sistema sia attivo e che l'applicazione sia in ascolto sulla porta locale corretta. Cambia server nell'elenco dell'abbonamento e aggiornalo per ottenere i parametri aggiornati. Se il problema è il firewall locale, consenti a Happ le connessioni in uscita in ufw o firewalld, poi riavvia la connessione.