Configurare Happ su Mac: dall'installazione al routing del traffico

Installazione di Happ su macOS

Happ è un client basato sul core Xray che su Mac funziona sia come normale applicazione con proxy di sistema, sia come tunnel di rete completo. Scarica la versione per macOS, sposta l'applicazione nella cartella «Applicazioni» e avviala. Al primo avvio macOS potrebbe mostrare un avviso di Gatekeeper che segnala che il programma è stato scaricato da internet: apri «Impostazioni di Sistema → Privacy e sicurezza» e conferma l'avvio con il pulsante «Apri comunque».

Per un funzionamento stabile si consiglia macOS 12 Monterey o versioni successive: sulle versioni precedenti parte delle API di rete che Happ utilizza per la modalità TUN non è disponibile. Il client funziona correttamente sia su Mac con processori Apple Silicon (M1–M4) sia sui modelli con chip Intel; non è necessario cercare una build separata per ciascuna architettura, la versione universal seleziona da sola il codice adatto.

Dopo l'installazione conviene subito consentire ad Happ l'avvio automatico all'accesso al sistema e la visualizzazione dell'icona nella barra dei menu. È comodo: connessione, cambio di server e cambio di modalità restano a portata di mano, senza dover aprire ogni volta la finestra dell'applicazione.

Chiave e abbonamento: come connettersi

L'accesso ai server viene fornito dal bot Telegram del servizio. Ottieni una chiave di prova, ufficiale o a pagamento nel bot: in risposta riceverai o una stringa di abbonamento (un link nel formato happ:// o https://), oppure una configurazione di server separata. Non è necessario copiare manualmente lunghe configurazioni sul Mac: l'abbonamento recupererà da solo l'elenco aggiornato dei server e lo aggiornerà quando ci saranno modifiche lato servizio.

Il modo più rapido per aggiungere la chiave è copiare il link dell'abbonamento e in Happ premere «Aggiungi dagli appunti»: l'applicazione riconosce il contenuto degli appunti e importa il profilo automaticamente. Se apri il link happ:// direttamente in macOS, il sistema proporrà di passarlo a Happ tramite deep-link, e il profilo verrà aggiunto con un solo clic.

Dopo l'importazione l'elenco dei server comparirà nella finestra principale. Scegli il nodo con il ping più basso, premi «Connetti» e attendi che l'indicatore diventi attivo. È sufficiente aggiungere l'abbonamento una sola volta: al rinnovo della chiave nel bot non occorre reinstallare nulla, il client recupererà gli aggiornamenti da solo.

Modalità proxy e modalità TUN: quale scegliere

Su macOS Happ offre due modi radicalmente diversi di instradare il traffico. La modalità proxy avvia un proxy SOCKS/HTTP locale e lo imposta nelle impostazioni di rete del sistema. Attraverso di esso passano le richieste delle applicazioni che rispettano il proxy di sistema, in primo luogo i browser. È una modalità leggera: non richiede privilegi di amministratore e non interessa il traffico dei programmi che funzionano aggirando il proxy.

La modalità TUN (chiamata anche modalità tunnel di sistema) crea un'interfaccia di rete virtuale utun e intercetta il traffico a livello dell'intero sistema. In questo caso attraverso il tunnel passano non solo i browser, ma anche i messenger, i client desktop, il terminale e i servizi in background. Per attivare il TUN, Happ chiederà una volta di installare un helper privilegiato e di confermare l'operazione con la password di amministratore: è il comportamento standard di macOS per le applicazioni che gestiscono lo stack di rete.

Regola pratica: se serve che «voli tutto» nell'intera applicazione, attiva il TUN. Se il compito è puntuale — aprire l'accesso solo nel browser, senza toccare il resto del sistema — è sufficiente la modalità proxy. Puoi passare da una modalità all'altra al volo, senza eliminare l'abbonamento e senza cambiare il server selezionato.

Routing e split tunneling

Il core Xray all'interno di Happ supporta un routing flessibile: puoi impostare regole su quale traffico passa attraverso il server e quale invece direttamente. Su Mac questo viene usato più spesso per il tunneling separato (split tunneling): ad esempio, i siti bancari e locali vengono fatti passare aggirando il tunnel, mentre tutto il resto attraverso il server selezionato. Le regole si costruiscono per domini, sottoreti IP e geozone.

Le liste di routing (routing lists) preconfezionate evitano di elencare a mano centinaia di domini. Collegando una lista di questo tipo, ottieni set di regole preimpostati — ad esempio «risorse locali in diretta» o «bloccare i domini pubblicitari e di tracciamento». Le liste si aggiornano, quindi le regole restano attuali senza il tuo intervento.

Su macOS è inoltre utile l'opzione di bypass del traffico della rete locale: le connessioni a stampanti, NAS e altri dispositivi della rete domestica devono passare direttamente, altrimenti smetteranno di essere rilevati. Nelle impostazioni di routing lascia gli intervalli privati (10.0.0.0/8, 192.168.0.0/16 e simili) fuori dal tunnel: è una pratica standard e sicura.

Ottimizzazione e problemi tipici su Mac

Se dopo aver attivato il TUN internet è scomparso in tutte le applicazioni, come prima cosa verifica che l'helper privilegiato sia stato installato e che Happ abbia il permesso di modificare la configurazione di rete in «Privacy e sicurezza». La revoca di questo permesso è la causa più frequente del fatto che il tunnel si attiva ma il traffico non passa. La reinstallazione dell'helper dalle impostazioni dell'applicazione di solito risolve il problema.

In caso di velocità ridotta, prova a cambiare server con uno geograficamente più vicino e fai attenzione al trasporto della connessione. I nodi con protocolli di mascheramento moderni sul core Xray di solito danno un risultato stabile su canali instabili, mentre un nodo pubblico sovraccarico cala in velocità nelle ore di punta. Il ping e il carico del server sono visibili direttamente nell'elenco.

Se il browser ignora la connessione in modalità proxy, verifica che al suo interno non sia impostato un proxy proprio o un'estensione che intercetta la rete: essa sovrascrive l'impostazione di sistema. E perché Happ non si disconnetta quando il Mac va in sospensione, attiva la connessione automatica all'avvio e il mantenimento del tunnel; così, dopo il risveglio del portatile, la connessione si ripristinerà da sola.