Fluxo de Trabalho de Proxy no Terminal para Desenvolvedores

O FreeGuard CLI transforma seu terminal em um ambiente de desenvolvimento seguro, roteando o tráfego por túneis VPN criptografados. Seja clonando repositórios de redes restritas, depurando APIs entre regiões ou implantando contêineres por canais seguros, o CLI se integra às ferramentas que você já usa — git, ssh, curl, docker e muito mais.

Por que Desenvolvedores Precisam de um Proxy no Terminal

Muitas tarefas de desenvolvimento envolvem acesso à rede que se beneficia da proteção VPN:

• Acessar APIs internas de cafeterias ou aeroportos
• Testar serviços com restrição geográfica durante o desenvolvimento
• Enviar código por redes que limitam ou inspecionam o tráfego git
• Conectar-se a servidores remotos por firewalls restritivos
• Manter credenciais de CI/CD criptografadas em trânsito

O FreeGuard CLI lida com tudo isso sem sair do seu terminal.

Git via VPN

O Problema

Redes corporativas, Wi-Fi público e alguns ISPs limitam ou bloqueiam operações git. Conexões git baseadas em SSH podem ser sinalizadas por inspeção profunda de pacotes. Clones via HTTPS podem ser interceptados por proxies transparentes.

A Solução

Conecte-se ao FreeGuard antes das suas operações git:

freeguard connect --server us-east

git clone [email protected]:your-org/private-repo.git
git fetch --all
git push origin feature-branch

freeguard disconnect

Para uma abordagem mais automatizada, envolva isso em um script:

#!/bin/bash
freeguard connect --server us-east --json | jq -r '.status'
trap "freeguard disconnect" EXIT

git pull origin main
npm run build
git push origin main

O trap garante que a desconexão da VPN aconteça mesmo se o script falhar no meio do processo.

Git Compatível com Proxy

O FreeGuard CLI também pode expor um proxy local SOCKS5 ou HTTP. Configure o git para usá-lo:

# Set proxy for git globally
git config --global http.proxy socks5://127.0.0.1:1080
git config --global https.proxy socks5://127.0.0.1:1080

# Or per-repository
git config http.proxy socks5://127.0.0.1:1080

Remova a configuração do proxy quando terminar:

git config --global --unset http.proxy
git config --global --unset https.proxy

Tunelamento SSH com VPN

Acesso a Servidor Remoto

Quando você precisa fazer SSH em servidores a partir de redes não confiáveis, a VPN adiciona uma camada de criptografia antes mesmo que seu tráfego SSH saia da sua máquina:

freeguard connect --server us-west
ssh [email protected]

ProxyJump Através da VPN

Combine o FreeGuard com SSH ProxyJump para acesso em múltiplos saltos:

# Connect to VPN first
freeguard connect

# Then jump through a bastion host
ssh -J [email protected] [email protected]

Encaminhamento de Porta

Encaminhe portas remotas pelo túnel VPN:

freeguard connect --server eu-west
ssh -L 5432:db.internal:5432 [email protected]
# Now connect to localhost:5432 to reach the remote database

Desenvolvimento de API

Testando com curl

Roteie suas requisições de API pela VPN para testar a partir de diferentes regiões:

freeguard connect --server jp-tokyo

# Test geo-specific API responses
curl -s https://api.example.com/v1/content | jq '.region'
# Output: "ap-northeast-1"

freeguard connect --server de-frankfurt
curl -s https://api.example.com/v1/content | jq '.region'
# Output: "eu-central-1"

Usando httpie

O httpie funciona da mesma forma. O FreeGuard CLI opera no nível do sistema, então todos os clientes HTTP se beneficiam:

freeguard connect --server uk-london
http GET https://api.example.com/v1/pricing Accept:application/json

Modo Proxy para Roteamento Seletivo

Se você quiser apenas que certas requisições passem pela VPN, use o proxy local:

# Start FreeGuard with local proxy
freeguard connect

# Route specific requests through the proxy
curl --proxy socks5://127.0.0.1:1080 https://api.example.com/endpoint

# Direct requests bypass VPN
curl https://internal.company.com/api

Contêineres Docker + VPN

Tráfego de Rede do Contêiner pela VPN

Roteie o tráfego de contêineres Docker pelo FreeGuard:

# Connect host to VPN
freeguard connect --server us-east

# Containers using host network will route through VPN
docker run --network host my-app:latest

Integração com Docker Compose

Adicione conectividade VPN à sua stack de desenvolvimento:

#!/bin/bash
# dev-start.sh
freeguard connect --server us-east --json | jq -r '.status'
docker compose up -d
echo "Development stack is running through VPN"

Construindo Imagens em Redes Restritivas

Quando docker build precisa baixar pacotes de registries que estão bloqueados ou lentos:

freeguard connect --server us-west
docker build --network host -t my-app:latest .
freeguard disconnect

Integração com CI/CD

GitHub Actions

Use o FreeGuard CLI no seu pipeline de CI para acessar recursos com restrição geográfica durante as builds:

- name: Connect VPN
  run: |
    curl -fsSL https://cli.freeguard.com/install.sh | bash
    freeguard login --method token --token ${{ secrets.FREEGUARD_TOKEN }}
    freeguard connect --server us-east --json

Saída Amigável para Scripts

Todo comando do FreeGuard CLI suporta --json para saída legível por máquina e --no-color para arquivos de log limpos:

# Get connection status as JSON
freeguard status --json
# {"connected": true, "server": "us-east-1", "protocol": "hysteria2", "uptime": 3600}

# List servers as JSON for programmatic selection
freeguard servers --json --region us | jq '.[0].id'

Códigos de Saída

O CLI usa códigos de saída padrão que os scripts podem verificar:

freeguard connect --server us-east
if [ $? -eq 0 ]; then
  echo "VPN connected, starting deployment..."
  ./deploy.sh
fi

Dicas para o Uso Diário

1. Alias de shell — Adicione alias vpn="freeguard connect" e alias vpnoff="freeguard disconnect" ao perfil do seu shell.
2. Conexão automática — Adicione freeguard connect ao seu .zshrc ou .bashrc se você quiser a VPN sempre ativada.
3. Favoritos de servidores — Use freeguard config set default-server us-east para pular a flag --server.
4. Status no prompt — Analise freeguard status --json para mostrar o status da VPN no prompt do seu shell.

Próximos Passos

• FreeGuard CLI — instalação e referência completa de comandos
• CLI command documentation — referência detalhada de cada comando e flag
• Deploy on headless servers — execute o FreeGuard CLI como um serviço de sistema
• Pricing — planos amigáveis para desenvolvedores

Last updated: March 2026