FreeGuard CLI: VPN en tu terminal
FreeGuard CLI es un cliente VPN de línea de comandos, gratuito y de código abierto, que te permite conectarte a servidores VPN, administrar tu suscripción y automatizar la seguridad de tu red, todo desde la terminal. Tanto si eres desarrollador, sysadmin o un usuario avanzado, la CLI te ofrece la forma más rápida y más apta para scripts de proteger tu conexión a Internet.

FreeGuard CLI: VPN en tu terminal

FreeGuard CLI es un cliente VPN de línea de comandos, gratuito y de código abierto, que te permite conectarte a servidores VPN, administrar tu suscripción y automatizar la seguridad de tu red, todo desde la terminal. Tanto si eres desarrollador, sysadmin o un usuario avanzado, la CLI te ofrece la forma más rápida y más apta para scripts de proteger tu conexión a Internet.

¿Por qué usar un cliente VPN CLI?

Las aplicaciones VPN gráficas están bien para un uso ocasional, pero se quedan cortas cuando necesitas velocidad, control y automatización. Aquí tienes por qué el enfoque CLI gana para los usuarios técnicos:

Velocidad bruta

La FreeGuard CLI se conecta en segundos. No hay ninguna GUI que cargar, ninguna pantalla de bienvenida que esperar y ningún proceso en segundo plano innecesario. Abre tu terminal, escribe un comando y ya estás conectado.

freeguard connect

Eso es todo. Tu tráfico ahora está cifrado y se enruta a través del servidor más rápido disponible.

Listo para la automatización

¿Necesitas conectarte a un VPN antes de ejecutar un script de despliegue? ¿Quieres rotar servidores cada hora? La CLI se integra directamente en scripts de shell, tareas cron y canalizaciones CI/CD.

#!/bin/bash
freeguard connect --server us-west
./deploy.sh
freeguard disconnect

Compatibilidad con servidores sin interfaz

¿Estás ejecutando una instancia en la nube sin entorno de escritorio? La CLI funciona perfectamente en servidores sin interfaz. Sin X11, sin Wayland, sin problema. Instala, autentica, conecta.

Integración con agentes de IA

Esto es lo que realmente distingue a FreeGuard CLI. Está diseñada desde cero para funcionar con asistentes de codificación con IA como Claude Code, Cursor y OpenClaw. Los agentes de IA pueden instalar, configurar y administrar tu conexión VPN mediante una conversación natural. No se requieren pasos manuales.


Instalación rápida

Empezar tarda menos de un minuto en cualquier plataforma.

macOS

brew install freeguard/tap/freeguard

Linux (Ubuntu / Debian)

curl -fsSL https://cli.freeguard.com/install.sh | bash

Linux (otras distribuciones)

curl -fsSL https://cli.freeguard.com/install.sh | bash

El instalador detecta tu distribución e instala el paquete apropiado.

Windows

winget install FreeGuard.CLI

Verificar la instalación

freeguard --version

Deberías ver el número de versión impreso en stdout.


Tu primera conexión

Paso 1: Inicia sesión

freeguard login

Esto abre tu navegador para autenticarte. En servidores sin interfaz, usa el inicio de sesión por correo electrónico:

freeguard login --method email

Paso 2: Conéctate

freeguard connect

FreeGuard selecciona automáticamente el servidor más rápido según tu ubicación. Para elegir una región específica:

freeguard connect --server jp-tokyo

Paso 3: Verifica

freeguard status

Esto muestra el estado de tu conexión, el servidor actual, el protocolo y el tiempo de actividad.

Paso 4: Desconéctate

freeguard disconnect

Qué hace diferente a FreeGuard CLI

Configuración con un solo comando

Otras CLIs de VPN requieren descargar archivos de configuración, editar YAML y administrar certificados manualmente. FreeGuard CLI se encarga de todo:

freeguard login && freeguard connect

Dos comandos. Cero archivos de configuración.

Diseñada para agentes de IA

FreeGuard CLI es el primer cliente VPN diseñado para ser operado por asistentes de IA. Cada comando admite salida --json y modo --no-color para análisis por máquinas. Los agentes de IA en plataformas como Claude Code pueden instalar y administrar FreeGuard sin ninguna intervención humana.

Protocolos modernos

FreeGuard CLI admite de forma nativa los protocolos Trojan, Hysteria2 y AnyTLS. El cliente selecciona automáticamente el mejor protocolo para las condiciones de tu red, o puedes especificar uno manualmente:

freeguard connect --protocol hysteria2

Paridad multiplataforma

Los mismos comandos funcionan igual en macOS, Linux y Windows. Los scripts que escribes en tu Mac se ejecutarán sin cambios en tus servidores de producción.

Código abierto

El cliente CLI es completamente de código abierto. Puedes auditar el código, contribuir con funciones o hacer un fork para tu propio uso.


Comandos comunes de un vistazo

Command Description
freeguard login Autentica tu cuenta
freeguard connect Conéctate al servidor más rápido
freeguard connect --server <id> Conéctate a un servidor específico
freeguard disconnect Desconéctate del VPN
freeguard status Muestra el estado de la conexión
freeguard servers Lista los servidores disponibles
freeguard config Ver o actualizar la configuración
freeguard logout Cerrar sesión

Próximos pasos

Última actualización: March 2026