Flusso di lavoro del Proxy del terminale per sviluppatori

FreeGuard CLI trasforma il tuo terminale in un ambiente di sviluppo sicuro instradando il traffico attraverso tunnel VPN crittografati. Che tu stia clonando repository da reti ristrette, eseguendo il debug di API tra regioni o distribuendo container tramite canali sicuri, la CLI si integra con gli strumenti che già usi — git, ssh, curl, docker e altri.

Perché gli sviluppatori hanno bisogno di un Proxy del terminale

Molte attività di sviluppo coinvolgono l’accesso alla rete che beneficia della protezione VPN:

• Accesso ad API interne da bar o aeroporti
• Test di servizi con restrizioni geografiche durante lo sviluppo
• Invio di codice su reti che limitano o ispezionano il traffico git
• Connessione a server remoti tramite firewall restrittivi
• Protezione delle credenziali CI/CD durante il transito

FreeGuard CLI gestisce tutto questo senza mai lasciare il tuo terminale.

Git su VPN

Il problema

Le reti aziendali, il Wi‑Fi pubblico e alcuni ISP limitano o bloccano le operazioni git. Le connessioni git basate su SSH possono essere segnalate dall’ispezione approfondita dei pacchetti. Le clone HTTPS possono essere intercettate da proxy trasparenti.

La soluzione

Connettiti a FreeGuard prima delle tue operazioni 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

Per un approccio più automatizzato, racchiudilo in uno 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

Il trap garantisce che la VPN si disconnetta anche se lo script fallisce a metà.

Git consapevole del Proxy

FreeGuard CLI può anche esporre un proxy SOCKS5 o HTTP locale. Configura git per usarlo:

# 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

Rimuovi la configurazione del proxy quando hai finito:

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

Tunneling SSH con VPN

Accesso a server remoti

Quando devi accedere via SSH a server da reti non attendibili, la VPN aggiunge un livello di crittografia prima ancora che il traffico SSH lasci il tuo dispositivo:

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

ProxyJump tramite VPN

Combina FreeGuard con SSH ProxyJump per accesso multi-hop:

# Connect to VPN first
freeguard connect

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

Port Forwarding

Instrada le porte remote attraverso il tunnel VPN:

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

Sviluppo API

Test con curl

Instrada le tue richieste API attraverso la VPN per testare da regioni diverse:

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"

Uso di httpie

httpie funziona allo stesso modo. FreeGuard CLI opera a livello di sistema, quindi tutti i client HTTP ne beneficiano:

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

Modalità Proxy per il routing selettivo

Se vuoi che solo alcune richieste passino attraverso la VPN, usa il proxy locale:

# 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

Container Docker + VPN

Traffico di rete dei container attraverso la VPN

Instrada il traffico dei container Docker attraverso 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

Integrazione con Docker Compose

Aggiungi la connettività VPN al tuo stack di sviluppo:

#!/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"

Build di immagini dietro reti restrittive

Quando docker build deve scaricare pacchetti da registry bloccati o lenti:

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

Integrazione CI/CD

GitHub Actions

Usa FreeGuard CLI nella tua pipeline CI per accedere a risorse con restrizioni geografiche durante le build:

- 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

Output adatto agli script

Ogni comando FreeGuard CLI supporta --json per output leggibile dalle macchine e --no-color per file di log puliti:

# 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'

Exit Codes

La CLI usa i codici di uscita standard che gli script possono verificare:

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

Suggerimenti per l’uso quotidiano

1. Alias della shell — Aggiungi alias vpn="freeguard connect" e alias vpnoff="freeguard disconnect" al profilo della tua shell.
2. Connessione automatica — Aggiungi freeguard connect al tuo .zshrc o .bashrc se vuoi che la VPN sia sempre attiva.
3. Segnalibri del server — Usa freeguard config set default-server us-east per saltare il flag --server.
4. Stato nel prompt — Analizza freeguard status --json per mostrare lo stato della VPN nel prompt della shell.

Prossimi passi

• FreeGuard CLI — installazione e riferimento completo dei comandi
• CLI command documentation — riferimento dettagliato per ogni comando e flag
• Deploy on headless servers — esegui FreeGuard CLI come servizio di sistema
• Pricing — piani adatti agli sviluppatori

Ultimo aggiornamento: March 2026