Inicio rápido de FreeGuard CLI

FreeGuard CLI es un cliente VPN de línea de comandos que se conecta con un solo comando. Instálalo en macOS, Linux o Windows, inicia sesión con tu correo electrónico y ejecuta freeguard connect para proteger tu Internet en menos de 5 minutos.

Instalación

macOS y Linux

Instala con un solo comando:

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

O usa Homebrew en macOS:

brew install freeguardvpn/tap/freeguard

Después de la instalación, verifica que funcionó:

freeguard version

Salida esperada:

FreeGuard CLI v1.0.0
Core: mihomo v1.19.21
OS: darwin/arm64

Windows

Abre PowerShell como Administrador y ejecuta:

irm https://downloadcli.freeguardvpn.com/cli/install.ps1 | iex

Después de la instalación, reinicia tu terminal y ejecuta freeguard version para confirmar.

Inicio de sesión

FreeGuard CLI usa verificación basada en correo electrónico — no se requiere registro de cuenta.

freeguard login --email [email protected] --send-code

Recibirás un código de verificación de 6 dígitos en tu correo electrónico. Ingrésalo:

freeguard login --email [email protected] --code 123456

Ejemplo de salida:

✓ Logged in successfully!
✓ Found 1 active subscription (Pro Plan, expires 2026-12-01)
✓ Configuration generated: ~/.freeguard/profiles/default.yaml

Si tienes una cuenta de FreeGuard, también puedes iniciar sesión mediante el navegador:

freeguard login --account

Esto abre tu navegador para la autenticación OAuth y devuelve un token automáticamente.

Conectar

Conéctate al servidor más rápido disponible con un solo comando:

freeguard connect

Ejemplo de salida:

✓ Connected to United States - New York (us-new-01)
  Protocol: anytls | Latency: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

Para conectarte a un país específico:

freeguard connect --country JP

Para conectarte a un nodo específico:

freeguard connect jp-tok-01

Verificar

Comprueba que tu conexión esté activa:

freeguard status

Ejemplo de salida:

FreeGuard VPN Status
────────────────────
Status:     ● Connected
Node:       United States - New York (us-new-01)
Protocol:   anytls
Latency:    42ms
Upload:     1.2 MB/s
Download:   15.8 MB/s
Duration:   2h 15m
Mode:       System Proxy (HTTP/SOCKS5)

Para obtener salida legible por máquina (útil para scripting o agentes de IA):

freeguard status --json

{
  "connected": true,
  "node": {"id": "us-new-01", "name": "United States - New York", "country": "US"},
  "protocol": "anytls",
  "latency_ms": 42,
  "traffic": {"upload_bps": 1258291, "download_bps": 16569754},
  "duration_seconds": 8100,
  "mode": "system_proxy",
  "proxy_port": {"mixed": 7890}
}

Próximos pasos

Referencia de comandos de CLI — Lista completa de todos los comandos, flags y formatos de salida.
Solución de problemas de CLI — Soluciones para problemas comunes de instalación, inicio de sesión y conexión.
Agente de FreeGuard CLI — Deja que la IA diagnostique y resuelva problemas por ti automáticamente.
Ejecuta freeguard --help para explorar todos los comandos disponibles desde tu terminal.

Preguntas frecuentes

¿Cómo instalo FreeGuard CLI en mi sistema?

Ejecuta curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh en macOS o Linux. En macOS, también puedes usar brew install freeguard. El instalador detecta automáticamente tu sistema operativo y arquitectura.

¿Puedo usar FreeGuard CLI sin una GUI?

Sí. FreeGuard CLI es completamente sin interfaz gráfica — funciona totalmente en la terminal sin requerir una interfaz gráfica. Esto lo hace ideal para servidores, contenedores y sesiones remotas SSH.

¿Cómo cambio los protocolos VPN con la CLI?

Usa freeguard connect --protocol <name>. Los protocolos compatibles incluyen Hysteria2, Anytls y Trojan. La CLI usa por defecto el protocolo más rápido disponible para tu red.

¿FreeGuard CLI funciona en dispositivos ARM como Raspberry Pi?

Sí. La CLI es compatible con las arquitecturas arm64 y armv7. El script de instalación detecta automáticamente tu plataforma y descarga el binario correcto.

Última actualización: marzo de 2026