FreeGuard CLI: VPN no Seu Terminal
FreeGuard CLI é um cliente VPN de linha de comando gratuito e de código aberto que permite conectar-se a servidores VPN, gerenciar sua assinatura e automatizar sua segurança de rede — tudo a partir do terminal. Seja você desenvolvedor, administrador de sistemas ou usuário avançado, a CLI oferece a forma mais rápida e mais fácil de automatizar por script para proteger sua conexão com a internet.

FreeGuard CLI: VPN no Seu Terminal

FreeGuard CLI é um cliente VPN de linha de comando gratuito e de código aberto que permite conectar-se a servidores VPN, gerenciar sua assinatura e automatizar sua segurança de rede — tudo a partir do terminal. Seja você desenvolvedor, administrador de sistemas ou usuário avançado, a CLI oferece a forma mais rápida e mais fácil de automatizar por script para proteger sua conexão com a internet.

Por que usar um cliente VPN via CLI?

Apps VPN gráficos são bons para uso casual, mas ficam aquém quando você precisa de velocidade, controle e automação. Veja por que a abordagem via CLI vence para usuários técnicos:

Velocidade Bruta

O FreeGuard CLI se conecta em segundos. Não há GUI para carregar, tela de abertura para esperar nem processos em segundo plano desnecessários. Abra seu terminal, digite um comando e você estará conectado.

freeguard connect

É isso. Seu tráfego agora está criptografado e roteado pelo servidor mais rápido disponível.

Pronto para Automação

Precisa conectar a um VPN antes de executar um script de implantação? Quer alternar servidores a cada hora? A CLI se integra diretamente a scripts de shell, jobs cron e pipelines de CI/CD.

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

Suporte a Servidor Sem Interface

Executando uma instância na nuvem sem ambiente de desktop? A CLI funciona perfeitamente em servidores sem interface. Sem X11, sem Wayland, sem problema. Instale, autentique, conecte.

Integração com Agentes de IA

É isso que realmente diferencia o FreeGuard CLI. Ele foi projetado desde o início para funcionar com assistentes de programação de IA como Claude Code, Cursor e OpenClaw. Agentes de IA podem instalar, configurar e gerenciar sua conexão VPN por meio de conversa natural. Nenhuma etapa manual é necessária.


Instalação Rápida

Começar leva menos de um minuto em qualquer plataforma.

macOS

brew install freeguard/tap/freeguard

Linux (Ubuntu / Debian)

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

Linux (Outras Distribuições)

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

O instalador detecta sua distribuição e instala o pacote apropriado.

Windows

winget install FreeGuard.CLI

Verificar a Instalação

freeguard --version

Você deverá ver o número da versão impresso em stdout.


Sua Primeira Conexão

Passo 1: Faça Login

freeguard login

Isso abre seu navegador para autenticação. Em servidores sem interface, use login por e-mail:

freeguard login --method email

Passo 2: Conectar

freeguard connect

O FreeGuard seleciona automaticamente o servidor mais rápido com base na sua localização. Para escolher uma região específica:

freeguard connect --server jp-tokyo

Passo 3: Verificar

freeguard status

Isso exibe o status da sua conexão, o servidor atual, o protocolo e o tempo de atividade.

Passo 4: Desconectar

freeguard disconnect

O que Torna o FreeGuard CLI Diferente

Configuração com Um Comando

Outras CLIs de VPN exigem baixar arquivos de configuração, editar YAML e gerenciar certificados manualmente. O FreeGuard CLI cuida de tudo:

freeguard login && freeguard connect

Dois comandos. Zero arquivos de configuração.

Feito para Agentes de IA

O FreeGuard CLI é o primeiro cliente VPN projetado para ser operado por assistentes de IA. Cada comando oferece saída --json e modo --no-color para análise por máquina. Agentes de IA em plataformas como Claude Code podem instalar e gerenciar o FreeGuard sem qualquer intervenção humana.

Protocolos Modernos

O FreeGuard CLI oferece suporte aos protocolos Trojan, Hysteria2 e AnyTLS pronto para uso. O cliente seleciona automaticamente o melhor protocolo para as condições da sua rede, ou você pode especificar um manualmente:

freeguard connect --protocol hysteria2

Paridade Multiplataforma

Os mesmos comandos funcionam da mesma forma em macOS, Linux e Windows. Os scripts que você escreve no seu Mac vão rodar sem alterações em seus servidores de produção.

Código Aberto

O cliente CLI é totalmente de código aberto. Você pode auditar o código, contribuir com funcionalidades ou fazer um fork para seu próprio uso.


Comandos Comuns em Resumo

Command Description
freeguard login Autenticar sua conta
freeguard connect Conectar ao servidor mais rápido
freeguard connect --server <id> Conectar a um servidor específico
freeguard disconnect Desconectar do VPN
freeguard status Mostrar o status da conexão
freeguard servers Listar servidores disponíveis
freeguard config Ver ou atualizar configurações
freeguard logout Encerrar sessão

Próximos Passos

Última atualização: Março de 2026