Instalação e configuração do Happ em distribuições Linux
O cliente desktop Happ no Linux funciona sobre o núcleo Xray e disponibiliza um proxy local para o sistema e os aplicativos. A seguir: instalação via AppImage ou pacote, conexão do link de assinatura obtido no bot do Telegram e configuração do autostart.
Como conectar o Happ VPN — Linux
Instale a app
Baixe o Happ para Linux de uma fonte oficial para a sua distribuição.
Obtenha uma chave
Abra o bot do Telegram e ative o acesso.
Adicione a chave
Importe o link de subscrição na app.
Ative a ligação
Escolha um servidor e ative a VPN.
Instalação do Happ no Linux: AppImage e .deb
A versão desktop do Happ é distribuída na seção Releases do repositório Happ-proxy no GitHub. Para a maioria das distribuições, o formato universal AppImage é mais prático — ele não exige instalação e roda a partir de qualquer pasta. Para a família Debian e Ubuntu há um pacote .deb separado.
Baixe o arquivo mais recente para a sua arquitetura (normalmente x86_64), torne o AppImage executável e execute-o: `chmod +x Happ-x86_64.AppImage` e `./Happ-x86_64.AppImage`. Para o .deb use `sudo apt install ./happ_amd64.deb` — o gerenciador de pacotes resolve as dependências automaticamente.
Se o AppImage não iniciar, na maioria das vezes falta a biblioteca FUSE. Instale-a com o comando `sudo apt install libfuse2` (Debian/Ubuntu) ou o equivalente da sua distribuição. Como alternativa, o AppImage pode ser extraído e executado diretamente: `./Happ-x86_64.AppImage --appimage-extract` e depois `./squashfs-root/AppRun`.
Importação da assinatura e da configuração
O acesso aos servidores é fornecido pelo bot do Telegram do serviço: nele você ativa uma chave de teste, paga ou oficial e recebe um link de assinatura no formato https://…/sub/…. Esse link contém a lista atualizada de servidores e os parâmetros do Xray — não é preciso inserir configurações manualmente.
No aplicativo, abra a opção de adicionar configuração, cole o link de assinatura e salve. O Happ carregará todos os servidores disponíveis em uma única lista e depois os atualizará por esse mesmo link. Se os servidores mudarem ou novas localizações forem adicionadas, basta tocar em atualizar assinatura — não é necessário reinstalar.
Se preciso, também é possível adicionar uma configuração única: copie a linha vless:// ou ss:// do bot e cole-a via importação da área de transferência. A mesma chave funciona em todos os dispositivos, portanto a assinatura para Linux, Windows e clientes móveis é idêntica.
Ativação do modo proxy sobre o núcleo Xray
Após a importação, escolha um servidor na lista e ative a conexão. O Happ levanta um proxy local (SOCKS e HTTP) sobre o núcleo Xray e roteia o tráfego por ele. No modo de sistema, o cliente registra o proxy nas configurações do ambiente de trabalho, então navegadores e a maioria dos aplicativos passam a funcionar através do túnel sem ajustes adicionais.
A porta local do proxy pode ser definida manualmente nas configurações do aplicativo — o que é útil quando você quer direcionar apenas um programa específico para o Happ. Indique o endereço 127.0.0.1 e a porta definida nas configurações de proxy do navegador ou nas variáveis de ambiente (por exemplo, `export https_proxy=http://127.0.0.1:PORT`), deixando o restante do tráfego direto.
Para uma separação pontual do tráfego, o Happ oferece roteamento por listas e split tunneling — quais domínios e aplicativos passam pelo proxy e quais o contornam. A análise detalhada das regras e da utility está em seções separadas do site, para não misturar a instalação básica com o ajuste fino das rotas.
Autostart do Happ na inicialização do sistema
Para que o proxy suba automaticamente, adicione o cliente à inicialização do ambiente de trabalho. Crie o arquivo `~/.config/autostart/happ.desktop` com as linhas `[Desktop Entry]`, `Type=Application`, `Exec=/caminho/completo/Happ-x86_64.AppImage` e `X-GNOME-Autostart-enabled=true`. GNOME, KDE e a maioria dos ambientes o reconhecerão no próximo login.
Para a instalação via .deb, o atalho de autostart pode ser ativado diretamente nas configurações do aplicativo ou pelo menu de inicialização do seu ambiente — o caminho do executável é preenchido automaticamente. Após o login, o Happ é minimizado para a bandeja do sistema e fica acessível pelo ícone próximo ao relógio.
Se você usa Linux sem interface gráfica, configure a execução como um serviço de usuário do systemd: coloque o unit em `~/.config/systemd/user/`, indique o caminho do AppImage em `ExecStart` e ative o autostart com o comando `systemctl --user enable --now happ.service`.
Verificação da conexão e diagnóstico
Depois de conectar, verifique se o tráfego está passando pelo servidor: abra qualquer serviço de identificação de IP — o endereço e o país devem corresponder à localização escolhida. Se o IP permaneceu o mesmo, confirme que o proxy de sistema está ativado e que o aplicativo está lendo a porta local correta.
Em caso de quedas ou lentidão, troque de servidor na lista de assinatura — localizações vizinhas costumam oferecer uma rota mais estável. Em seguida, atualize a assinatura para obter os parâmetros atuais do Xray e reinicie a conexão. Às vezes o firewall local atrapalha: permita conexões de saída do Happ no ufw ou no firewalld.
Se, após atualizar o cliente, a lista de servidores não carregar, verifique a validade da chave no bot do Telegram e se o link de assinatura está correto. Os logs de conexão estão disponíveis no próprio aplicativo e ajudam a distinguir um problema com a chave de um bloqueio de rede.
Pronto para se conectar?
Obtenha a sua chave Happ VPN no bot do Telegram: 3 dias grátis, sem cartão.
Obter chavePerguntas frequentes
Como instalar o Happ no Linux?
Baixe a versão mais recente na seção Releases do repositório Happ-proxy no GitHub: AppImage para qualquer distribuição ou .deb para Debian e Ubuntu. Torne o AppImage executável com o comando chmod +x e execute-o; instale o .deb com sudo apt install ./arquivo.deb. Depois, adicione o link de assinatura obtido no bot do Telegram.
Onde obter a chave e a assinatura para Linux?
A chave e o link de assinatura são fornecidos pelo bot do Telegram do serviço — nele se ativa o acesso de teste, pago ou oficial. O link contém a lista de servidores e os parâmetros do Xray, e precisa ser colado uma vez no aplicativo. A chave é única para todos os dispositivos, então a assinatura para Linux é a mesma do Windows e dos clientes móveis.
O AppImage não inicia — o que fazer?
Na maioria das vezes falta a biblioteca FUSE: instale-a com sudo apt install libfuse2 ou o equivalente da sua distribuição. Como alternativa, extraia a imagem com ./Happ-x86_64.AppImage --appimage-extract e execute ./squashfs-root/AppRun. Verifique também se o arquivo recebeu a permissão de execução com chmod +x.
Como configurar o autostart do Happ no Linux?
Crie o arquivo ~/.config/autostart/happ.desktop com uma entrada Desktop Entry e o caminho do AppImage na linha Exec — GNOME e KDE o reconhecerão no login. Para servidores sem interface gráfica, configure um serviço de usuário do systemd em ~/.config/systemd/user/ e ative-o com o comando systemctl --user enable --now happ.service.
Como direcionar apenas um navegador pelo Happ?
Ative o proxy local nas configurações do aplicativo e anote o endereço 127.0.0.1 com a porta definida. Configure esse proxy nas opções de um navegador específico ou na variável de ambiente https_proxy — assim apenas ele passará pelo túnel, enquanto o restante do tráfego permanece direto. Para roteamento por domínios, use o split tunneling.
A conexão existe, mas o IP não muda — por quê?
Verifique se o proxy de sistema está ativado e se o aplicativo está escutando a porta local correta. Troque de servidor na lista de assinatura e atualize-a para obter os parâmetros atuais. Se o firewall local estiver atrapalhando, permita as conexões de saída do Happ no ufw ou no firewalld e reinicie a conexão.