Solução de Problemas do FreeGuard CLI
Está com problemas com o FreeGuard CLI? Este guia cobre os problemas mais comuns e suas soluções. Para cada problema, tente executar freeguard doctor primeiro — ele detecta automaticamente a maioria dos problemas de configuração e ambiente.
Problemas de Instalação
Permissão negada durante a instalação
Sintoma: O script de instalação falha com Permission denied ou EACCES.
Solução: No macOS/Linux, o instalador precisa de acesso de escrita em /usr/local/bin. Execute com privilégios elevados:
curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sudo sh
No Windows, certifique-se de abrir o PowerShell como Administrador antes de executar o comando de instalação.
Comando não encontrado após a instalação
Sintoma: Executar freeguard retorna command not found ou not recognized.
Saída do Doctor:
✗ CLI binary: Not in PATH
Solução: O binário pode não estar no PATH do seu shell. Adicione-o manualmente:
# macOS/Linux — add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="$HOME/.freeguard/bin:$PATH"
# Then reload your shell
source ~/.zshrc # or ~/.bashrc
No Windows, adicione %USERPROFILE%\.freeguard\bin à variável de ambiente PATH do sistema e reinicie o terminal.
curl falha ou download expira
Sintoma: O script de instalação não consegue baixar o binário.
Solução: Se você está atrás de um firewall corporativo ou em uma rede restrita, baixe o binário manualmente da página de Releases do GitHub e coloque-o em ~/.freeguard/bin/. Em seguida, torne-o executável:
chmod +x ~/.freeguard/bin/freeguard
Problemas de Login
Código de verificação não recebido
Sintoma: Após executar freeguard login --email [email protected] --send-code, nenhum e-mail chega.
Solução:
- Verifique sua pasta de spam/lixo eletrônico — e-mails de verificação às vezes são filtrados.
- Aguarde 2 minutos antes de solicitar novamente. Há um limite de taxa no envio de códigos.
- Verifique se o endereço de e-mail está correto:
freeguard login --email [email protected] --send-code
- Tente um provedor de e-mail diferente se o problema persistir.
Token expirado
Sintoma: Comandos falham com Authentication expired ou Token invalid.
Saída do Doctor:
✗ Credentials: Token expired (last refresh: 2026-03-01)
Solução: Faça login novamente para atualizar suas credenciais:
freeguard logout
freeguard login --email [email protected] --send-code
E-mail errado — assinatura não encontrada
Sintoma: O login é bem-sucedido, mas freeguard connect diz No active subscription.
Saída do Doctor:
✓ Credentials: Logged in (email: u***@example.com)
✗ Subscription: No active subscription found
Solução: Certifique-se de que está fazendo login com o mesmo e-mail usado para comprar sua assinatura. Se usou um e-mail diferente:
freeguard logout
freeguard login --email [email protected] --send-code
Problemas de Conexão
Tempo limite de conexão
Sintoma: freeguard connect trava ou retorna Connection timed out.
Saída do Doctor:
✗ Network: Internet not reachable
Solução:
- Verifique sua conexão de internet base (desconecte a VPN primeiro):
freeguard disconnect
ping 8.8.8.8
- Tente um nó ou país diferente:
freeguard connect --country SG
- Tente um protocolo diferente que pode funcionar melhor na sua rede:
freeguard connect --protocol hysteria2
Porta 7890 já em uso
Sintoma: freeguard connect falha com Port 7890 is already in use.
Saída do Doctor:
✗ Port 7890: In use by another process (PID: 12345)
Solução: Outro aplicativo proxy está usando a porta padrão. Pare o outro aplicativo ou altere a porta proxy do FreeGuard:
freeguard config set proxy.port 8080
freeguard connect
Vazamento de DNS detectado
Sintoma: Consultas DNS contornam o túnel VPN.
Solução: Mude para uma configuração DNS segura:
freeguard config set dns.provider secure
freeguard disconnect
freeguard connect
Você pode verificar se o DNS está sendo roteado pela VPN:
freeguard doctor
Procure a verificação de DNS na saída para confirmar que está funcionando corretamente.
Problemas de Permissão
Modo TUN requer sudo
Sintoma: freeguard connect --tun falha com Permission denied: TUN device.
Saída do Doctor:
✗ TUN permission: Not available (run with sudo for TUN mode)
Solução: O modo TUN cria uma interface de rede virtual, que requer privilégios elevados:
# macOS/Linux
sudo freeguard connect --tun
# Windows — run PowerShell as Administrator
freeguard connect --tun
Se você não precisa de cobertura VPN em todo o sistema, use o modo proxy do sistema padrão (sem necessidade de sudo):
freeguard connect
Porta abaixo de 1024 requer privilégios elevados
Sintoma: Definir uma porta proxy abaixo de 1024 falha com Permission denied.
Solução: Portas abaixo de 1024 são restritas na maioria dos sistemas operacionais. Use uma porta acima de 1024:
freeguard config set proxy.port 7890
Ou execute com privilégios elevados se precisar especificamente de uma porta baixa:
sudo freeguard connect
Ainda preso?
Se freeguard doctor e as soluções acima não resolverem seu problema, deixe a IA diagnosticá-lo automaticamente.
Visite a página do FreeGuard CLI Agent e descreva seu problema. O agente pode ler a saída do freeguard doctor --json e guiá-lo passo a passo para uma solução.
Você também pode executar o assistente interativo de solução de problemas:
freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat
Perguntas Frequentes
Por que o FreeGuard CLI diz “connection refused”?
Isso geralmente significa que o servidor VPN está temporariamente indisponível. Tente freeguard connect --server auto para selecionar automaticamente o melhor servidor disponível, ou verifique as configurações do seu firewall.
Como verifico se minha conexão VPN está funcionando?
Execute freeguard status para ver o estado da conexão, servidor atual e protocolo. Você também pode executar curl ifconfig.me para verificar se seu endereço IP mudou.
O FreeGuard CLI não inicia após uma atualização do sistema. O que devo fazer?
Execute freeguard update para obter a versão mais recente. Se falhar, reinstale com o script de instalação: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.
Como reporto um bug ou obtenho ajuda?
Execute freeguard debug para coletar informações de diagnóstico e entre em contato com o suporte pelo site ou e-mail. Inclua a saída de debug para uma resolução mais rápida.
Última atualização: março de 2026