Instalación y configuración de Happ en distribuciones Linux

Instalar Happ en Linux: AppImage y .deb

La compilación de escritorio de Happ se distribuye en la sección Releases del repositorio Happ-proxy en GitHub. Para la mayoría de las distribuciones resulta más cómodo el formato universal AppImage: no requiere instalación y se ejecuta desde cualquier carpeta. Para la familia Debian y Ubuntu existe un paquete .deb aparte.

Descarga el archivo más reciente para tu arquitectura (normalmente x86_64) y haz el AppImage ejecutable, luego lánzalo: `chmod +x Happ-x86_64.AppImage` y `./Happ-x86_64.AppImage`. Para el .deb usa `sudo apt install ./happ_amd64.deb`: el gestor de paquetes resolverá las dependencias por sí mismo.

Si el AppImage no arranca, lo más habitual es que falte la biblioteca FUSE. Instálala con `sudo apt install libfuse2` (Debian/Ubuntu) o el equivalente de tu distribución. Como alternativa, el AppImage se puede descomprimir y ejecutar directamente: `./Happ-x86_64.AppImage --appimage-extract` y luego `./squashfs-root/AppRun`.

Importar la suscripción y la configuración

El acceso a los servidores lo entrega el bot de Telegram del servicio: allí activas una clave de prueba, de pago u oficial y obtienes un enlace de suscripción del tipo https://…/sub/…. Ese enlace contiene la lista actualizada de servidores y los parámetros de Xray; no hace falta introducir configuraciones manualmente.

En la aplicación abre la opción de añadir configuración, pega el enlace de suscripción y guarda. Happ cargará todos los servidores disponibles en una sola lista y en adelante los actualizará mediante ese mismo enlace. Si los servidores cambian o se añaden nuevas ubicaciones, basta con pulsar actualizar suscripción; no es necesario reinstalar.

Si lo necesitas, también puedes añadir una configuración individual: copia la cadena vless:// o ss:// desde el bot y pégala mediante la importación desde el portapapeles. La misma clave funciona en todos los dispositivos, por lo que la suscripción para Linux, Windows y los clientes móviles coincide.

Iniciar el modo proxy sobre el núcleo Xray

Tras importar, elige un servidor de la lista y activa la conexión. Happ levanta un proxy local (SOCKS y HTTP) sobre el núcleo Xray y enruta el tráfico a través de él. En modo de sistema, el cliente registra el proxy en la configuración del entorno de escritorio, por lo que los navegadores y la mayoría de las aplicaciones empiezan a funcionar a través del túnel sin configuración adicional.

El puerto local del proxy se puede indicar manualmente en los ajustes de la aplicación: resulta cómodo cuando solo quieres dirigir a Happ un programa concreto. Indica la dirección 127.0.0.1 y el puerto asignado en los ajustes de proxy del navegador o en las variables de entorno (por ejemplo, `export https_proxy=http://127.0.0.1:PORT`), dejando el resto del tráfico de forma directa.

Para separar el tráfico de forma selectiva, Happ dispone de enrutamiento por listas y split tunneling: qué dominios y aplicaciones pasan por el proxy y cuáles lo evitan. El análisis detallado de las reglas y de la utility se ha llevado a secciones aparte del sitio, para no mezclar la instalación básica con el ajuste fino de rutas.

Arranque automático de Happ al iniciar el sistema

Para que el proxy se levante automáticamente, añade el cliente al inicio automático del entorno de escritorio. Crea el archivo `~/.config/autostart/happ.desktop` con las líneas `[Desktop Entry]`, `Type=Application`, `Exec=/ruta/completa/Happ-x86_64.AppImage` y `X-GNOME-Autostart-enabled=true`. GNOME, KDE y la mayoría de entornos lo detectarán en el siguiente inicio de sesión.

Para la instalación con .deb, el acceso directo de arranque automático se puede activar directamente en los ajustes de la aplicación o mediante el menú de inicio automático de tu entorno; la ruta al ejecutable se completará automáticamente. Tras iniciar sesión, Happ se minimizará en la bandeja del sistema y estará disponible desde el icono junto al reloj.

Si ejecutas Linux sin entorno gráfico, configura el arranque como un servicio de usuario de systemd: coloca la unit en `~/.config/systemd/user/`, indica la ruta al AppImage en `ExecStart` y activa el arranque automático con el comando `systemctl --user enable --now happ.service`.

Comprobar la conexión y diagnóstico

Tras conectarte, verifica que el tráfico pasa por el servidor: abre cualquier servicio de detección de IP; la dirección y el país deben corresponder a la ubicación elegida. Si la IP sigue siendo la misma, asegúrate de que el proxy del sistema está activado y de que la aplicación lee el puerto local correcto.

Si hay cortes o la velocidad es baja, cambia de servidor en la lista de suscripción: las ubicaciones cercanas suelen ofrecer una ruta más estable. Después actualiza la suscripción para obtener los parámetros de Xray al día y reinicia la conexión. A veces interfiere el cortafuegos local: permite a Happ las conexiones salientes en ufw o firewalld.

Si tras actualizar el cliente la lista de servidores no se carga, comprueba la vigencia de la clave en el bot de Telegram y que el enlace de suscripción sea correcto. Los registros de conexión están disponibles en la propia aplicación y ayudan a distinguir un problema con la clave de un bloqueo de red.