FreeGuard for Linux: Command-Line VPN with Rules and GeoIP Routing

FreeGuard para Linux es un cliente de línea de comandos diseñado para servidores y desarrolladores: enruta el tráfico con tus propias reglas o por región con GeoIP, automatízalo con salida JSON y ejecútalo como servicio de usuario de systemd. Instálalo con un solo comando en x86_64 o arm64.

FreeGuard en Linux es un cliente de línea de comandos

Un único binario de Go que configura el núcleo mihomo por ti. Para una aplicación gráfica, usa FreeGuard para Windows o Mac.

La CLI de freeguard gestiona desde el terminal el inicio de sesión, la selección de servidores, la conexión, las reglas de enrutamiento y el inicio automático. Es un único binario de Go para Linux x86_64 y arm64 que configura el núcleo de mihomo por ti, por lo que es adecuado tanto para servidores, contenedores e instalaciones mínimas como para portátiles de desarrollo.

No hay una aplicación de escritorio para Linux. Si quieres una interfaz gráfica, usa la aplicación de FreeGuard para Windows o Mac.

Dirige el tráfico a tu manera: reglas y enrutamiento por región GeoIP

Escribe tus propias reglas de enrutamiento o envía directamente el tráfico de una región y, después de conectarte, consulta el resumen de enrutamiento.

• Modo de reglas predeterminado: las reglas de enrutamiento deciden qué tráfico pasa por la VPN y cuál va directamente, y freeguard connect muestra un resumen del enrutamiento en lenguaje sencillo
• Reglas personalizadas: freeguard rule add DOMAIN example.com DIRECT añade una regla; rule list, rule remove y rule import (desde una URL o un archivo) administran el resto
• Enrutamiento GeoIP por región: freeguard config set geoip_region CN envía directamente el tráfico de una región, como CN o JP, mientras que todo lo demás permanece en la VPN
• Modo TUN: freeguard connect --tun captura todo el tráfico de la máquina; sin este modo, FreeGuard ofrece un proxy local que pueden usar tus aplicaciones

Instalar FreeGuard en Linux

Tres métodos de instalación compatibles: nuestro script de instalación, Homebrew o GitHub Releases. No hay repositorios oficiales de apt, dnf ni pacman.

Script de instalación (recomendado):

curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh

Instalar con Homebrew:

brew install planetlinkinc/tap/freeguardvpn

Binario directo: descarga la versión para tu arquitectura desde GitHub Releases.

No publicamos paquetes .deb, .rpm ni de Arch en los repositorios de las distribuciones, así que no existe apt install freeguard, dnf install freeguard ni pacman -S freeguard.

Más funciones de la CLI

• Protocolos: anytls, hysteria2 y trojan; elige uno por conexión, por ejemplo freeguard connect la2 anytls
• Selección de servidor: freeguard connect la2 o hk1 por alias, freeguard connect US para el mejor servidor de EE. UU., o simplemente freeguard connect para reutilizar el último servidor o elegir el mejor
• Inicio automático: freeguard autostart enable instala un servicio de systemd de usuario en ~/.config/systemd/user/freeguard.service (no se requiere un daemon de root)
• Diagnóstico: freeguard doctor comprueba tu entorno
• Estado y supervisión: freeguard status y freeguard monitor muestran detalles de la conexión en tiempo real
• Automatización: añade --json a un comando para obtener una salida que puedan leer los scripts y los agentes de IA

Cómo empezar

1. Paso 1: Ejecuta curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh
2. Paso 2: Ejecuta freeguard init e inicia sesión con tu cuenta de FreeGuard
3. Paso 3: Ejecuta freeguard connect (o freeguard connect la2 para un servidor específico)

Preguntas frecuentes

¿FreeGuard tiene una aplicación con interfaz gráfica para Linux?

No. FreeGuard para Linux es el cliente de línea de comandos freeguard. Si quieres una interfaz gráfica, usa la aplicación para Windows o Mac.

¿Cómo dirijo solo parte del tráfico a través de la VPN en Linux?

Usa reglas de enrutamiento o enrutamiento por región GeoIP. freeguard rule add envía dominios específicos o rangos de IP directamente o a través de la VPN, y freeguard config set geoip_region CN envía el tráfico de una región directamente mientras que el resto permanece en la VPN.

¿La CLI de Linux es gratis?

La instalación es gratis. Para conectarte, necesitas una suscripción de FreeGuard; ejecuta freeguard subscribe list para ver los planes.

¿Puedo instalar FreeGuard desde el gestor de paquetes de mi distribución?

No desde los repositorios oficiales de la distribución. Usa nuestro script de instalación (install.sh), Homebrew o un binario de GitHub Releases. No publicamos en apt, dnf, pacman ni AUR.

¿Funciona la CLI en servidores sin interfaz gráfica y en Docker?

Sí. La CLI es un único binario de Go sin dependencias de interfaz gráfica. Se ejecuta por SSH, dentro de contenedores y en imágenes base mínimas, siempre que el contenedor tenga las capacidades de red necesarias para crear un dispositivo TUN.

¿Puedo iniciar FreeGuard automáticamente al arrancar?

Sí. freeguard autostart enable instala un servicio de usuario de systemd en ~/.config/systemd/user/freeguard.service. Se ejecuta como tu usuario, no como un demonio root.

¿Qué arquitecturas y distribuciones son compatibles?

Linux x86_64 y arm64. La CLI es un único binario de Go que configura el núcleo de mihomo por ti, así que debería funcionar en cualquier distribución moderna con un kernel reciente; probamos principalmente en Ubuntu y Debian.

¿La CLI de Linux utiliza los mismos protocolos que las aplicaciones de escritorio?

Sí. anytls, hysteria2 y trojan funcionan en la CLI, con el mismo núcleo mihomo que utilizan las aplicaciones de Windows y Mac.

¿Cómo desinstalo la CLI?

Si usaste el script de instalación, elimina el binario freeguard de /usr/local/bin (o ~/.local/bin) y borra ~/.freeguard. Si usaste Homebrew, ejecuta brew uninstall freeguardvpn. Si activaste el inicio automático, ejecuta primero freeguard autostart disable.