FreeGuard CLI Quick Start

FreeGuard CLI é um cliente VPN de linha de comando que conecta com um único comando. Instale-o no macOS, Linux ou Windows, faça login com seu e-mail e execute freeguard connect para proteger sua internet em menos de 5 minutos.

Installation

macOS and Linux

Instale com um único comando:

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

Ou use o Homebrew no macOS:

brew install freeguardvpn/tap/freeguard

Após a instalação, verifique se funcionou:

freeguard version

Saída esperada:

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

Windows

Abra o PowerShell como Administrador e execute:

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

Após a instalação, reinicie o terminal e execute freeguard version para confirmar.

Login

FreeGuard CLI usa verificação baseada em e-mail — não é necessário registro de conta.

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

Você receberá um código de verificação de 6 dígitos no seu e-mail. Digite-o:

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

Exemplo de saída:

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

Se você tiver uma conta FreeGuard, também pode fazer login via navegador:

freeguard login --account

Isso abre seu navegador para autenticação OAuth e retorna um token automaticamente.

Connect

Conecte-se ao servidor mais rápido disponível com um único comando:

freeguard connect

Exemplo de saída:

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

Para conectar a um país específico:

freeguard connect --country JP

Para conectar a um nó específico:

freeguard connect jp-tok-01

Verify

Verifique se sua conexão está ativa:

freeguard status

Exemplo de saída:

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 obter saída legível por máquina (útil para scripts ou 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}
}

Next Steps

• CLI Commands Reference — Lista completa de todos os comandos, flags e formatos de saída.
• CLI Troubleshooting — Soluções para problemas comuns de instalação, login e conexão.
• FreeGuard CLI Agent — Deixe a IA diagnosticar e corrigir problemas para você automaticamente.
• Execute freeguard --help para explorar todos os comandos disponíveis no seu terminal.

Frequently Asked Questions

How do I install FreeGuard CLI on my system?

Execute curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh no macOS ou Linux. No macOS, você também pode usar brew install freeguard. O instalador detecta automaticamente seu sistema operacional e arquitetura.

Can I use FreeGuard CLI without a GUI?

Sim. FreeGuard CLI é totalmente headless — ele é executado inteiramente no terminal, sem necessidade de interface gráfica. Isso o torna ideal para servidores, contêineres e sessões SSH remotas.

How do I switch VPN protocols with the CLI?

Use freeguard connect --protocol <name>. Os protocolos suportados incluem Hysteria2, Anytls e Trojan. O CLI usa por padrão o protocolo mais rápido disponível para sua rede.

Does FreeGuard CLI work on ARM devices like Raspberry Pi?

Sim. O CLI suporta as arquiteturas arm64 e armv7. O script de instalação detecta automaticamente sua plataforma e baixa o binário correto.

Last updated: March 2026