FreeGuard for Linux: Command-Line VPN with Rules and GeoIP Routing

FreeGuard para Linux é um cliente de linha de comando desenvolvido para servidores e desenvolvedores: encaminhe o tráfego com suas próprias regras ou por região com GeoIP, use scripts com saída JSON e execute-o como um serviço de usuário do systemd. Instale-o com um comando em x86_64 ou arm64.

FreeGuard no Linux é um cliente de linha de comando

Um único binário Go que configura o núcleo mihomo para você. Para um aplicativo gráfico, use o FreeGuard para Windows ou Mac.

A CLI freeguard gerencia o login, a seleção de servidores, a conexão, as regras de roteamento e a inicialização automática pelo terminal. É um único binário Go para Linux x86_64 e arm64 que configura o núcleo mihomo para você, sendo adequado para servidores, contêineres e instalações mínimas, bem como para laptops de desenvolvedores.

Não há um aplicativo de desktop para Linux. Se quiser uma interface gráfica, use o aplicativo FreeGuard para Windows ou Mac.

Roteie o tráfego do seu jeito: regras e roteamento por região GeoIP

Crie suas próprias regras de roteamento ou envie o tráfego de uma região diretamente e, depois de se conectar, confira o resumo do roteamento.

• Modo de regras por padrão: as regras de roteamento determinam qual tráfego passa pela VPN e qual segue diretamente, e freeguard connect exibe um resumo do roteamento em linguagem simples
• Regras personalizadas: freeguard rule add DOMAIN example.com DIRECT adiciona uma regra; rule list, rule remove e rule import (de uma URL ou de um arquivo) gerenciam o restante
• Roteamento por região GeoIP: freeguard config set geoip_region CN envia o tráfego de uma região, como CN ou JP, diretamente, enquanto todo o restante permanece na VPN
• Modo TUN: freeguard connect --tun captura todo o tráfego da máquina; sem ele, o FreeGuard fornece um proxy local que seus aplicativos podem usar

Instalar o FreeGuard no Linux

Três métodos de instalação compatíveis: nosso script de instalação, Homebrew ou GitHub Releases. Não há repositórios oficiais de apt, dnf ou pacman.

Script de instalação (recomendado):

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

Instalar com Homebrew:

brew install planetlinkinc/tap/freeguardvpn

Binário direto: baixe a versão para sua arquitetura em GitHub Releases.

Não publicamos pacotes .deb, .rpm ou Arch por meio dos repositórios das distribuições, portanto não há apt install freeguard, dnf install freeguard ou pacman -S freeguard.

Mais recursos da CLI

• Protocolos: anytls, hysteria2 e trojan; escolha um por conexão, por exemplo freeguard connect la2 anytls
• Seleção de servidor: freeguard connect la2 ou hk1 pelo alias, freeguard connect US para escolher o melhor servidor dos EUA, ou freeguard connect sem argumentos para reutilizar seu último servidor ou escolher o melhor
• Inicialização automática: freeguard autostart enable instala um serviço de usuário do systemd em ~/.config/systemd/user/freeguard.service (não é necessário um daemon de root)
• Diagnósticos: freeguard doctor verifica seu ambiente
• Status e monitoramento: freeguard status e freeguard monitor mostram detalhes da conexão em tempo real
• Scripts: adicione --json a um comando para obter uma saída que scripts e agentes de IA possam ler

Como começar

1. Etapa 1: Execute curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh
2. Etapa 2: Execute freeguard init e faça login com sua conta FreeGuard
3. Etapa 3: Execute freeguard connect (ou freeguard connect la2 para um servidor específico)

Perguntas frequentes

O FreeGuard tem um aplicativo de interface gráfica para Linux?

Não. O FreeGuard para Linux é o cliente de linha de comando freeguard. Se quiser uma interface gráfica, use o aplicativo para Windows ou Mac.

Como direciono apenas parte do tráfego pela VPN no Linux?

Use regras de roteamento ou roteamento por região GeoIP. freeguard rule add encaminha domínios específicos ou intervalos de IP diretamente ou pela VPN, e freeguard config set geoip_region CN encaminha o tráfego de uma região diretamente, enquanto o restante permanece na VPN.

A CLI do Linux é gratuita?

A instalação é gratuita. Para se conectar, você precisa de uma assinatura FreeGuard; execute freeguard subscribe list para ver os planos.

Posso instalar o FreeGuard pelo gerenciador de pacotes da minha distribuição?

Não pelos repositórios oficiais da distribuição. Use nosso script de instalação (install.sh), Homebrew ou um binário do GitHub Releases. Não publicamos para apt, dnf, pacman ou AUR.

A CLI funciona em servidores sem interface gráfica e no Docker?

Sim. A CLI é um único binário Go sem dependências de interface gráfica. Ela funciona via SSH, dentro de contêineres e em imagens base mínimas, desde que um contêiner tenha os recursos de rede necessários para criar um dispositivo TUN.

Posso iniciar o FreeGuard automaticamente na inicialização?

Sim. freeguard autostart enable instala um serviço de usuário do systemd em ~/.config/systemd/user/freeguard.service. Ele é executado como seu usuário, não como um daemon de root.

Quais arquiteturas e distribuições são compatíveis?

Linux x86_64 e arm64. A CLI é um único binário Go que configura o núcleo mihomo para você, então qualquer distribuição moderna com um kernel recente deve funcionar; testamos principalmente no Ubuntu e no Debian.

A CLI do Linux usa os mesmos protocolos que os aplicativos para desktop?

Sim. anytls, hysteria2 e trojan funcionam na CLI, usando o mesmo core mihomo dos aplicativos para Windows e Mac.

Como desinstalo a CLI?

Se você usou o script de instalação, remova o binário freeguard de /usr/local/bin (ou ~/.local/bin) e exclua ~/.freeguard. Com o Homebrew, execute brew uninstall freeguardvpn. Se você ativou a inicialização automática, execute freeguard autostart disable primeiro.