Flux de travail du Proxy Terminal pour les développeurs

FreeGuard CLI transforme votre terminal en environnement de développement sécurisé en acheminant le trafic via des tunnels VPN chiffrés. Que vous cloniez des dépôts depuis des réseaux restreints, déboguiez des API entre régions ou déployiez des conteneurs via des canaux sécurisés, le CLI s’intègre aux outils que vous utilisez déjà — git, ssh, curl, docker, et bien plus encore.

Pourquoi les développeurs ont besoin d’un Proxy Terminal

De nombreuses tâches de développement impliquent un accès réseau qui bénéficie de la protection VPN :

• Accéder à des API internes depuis des cafés ou des aéroports
• Tester des services géo-restreints pendant le développement
• Pousser du code sur des réseaux qui limitent ou inspectent le trafic git
• Se connecter à des serveurs distants à travers des pare-feu restrictifs
• Garder les identifiants CI/CD chiffrés en transit

FreeGuard CLI gère tout cela sans quitter votre terminal.

Git via VPN

Le problème

Les réseaux d’entreprise, le Wi‑Fi public et certains FAI limitent ou bloquent les opérations git. Les connexions git basées sur SSH peuvent être signalées par une inspection approfondie des paquets. Les clones HTTPS peuvent être interceptés par des Proxy transparents.

La solution

Connectez-vous à FreeGuard avant vos opérations 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

Pour une approche plus automatisée, encapsulez-la dans un 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

Le trap garantit que les déconnexions VPN se produisent même si le script échoue en cours de route.

Git compatible avec le Proxy

FreeGuard CLI peut également exposer un Proxy SOCKS5 ou HTTP local. Configurez git pour l’utiliser :

# 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

Supprimez la configuration du Proxy une fois terminé :

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

Tunneling SSH avec VPN

Accès à un serveur distant

Lorsque vous devez vous connecter en SSH à des serveurs depuis des réseaux non fiables, le VPN ajoute une couche de chiffrement avant même que votre trafic SSH ne quitte votre machine :

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

ProxyJump via VPN

Combinez FreeGuard avec SSH ProxyJump pour un accès multi-sauts :

# Connect to VPN first
freeguard connect

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

Redirection de ports

Redirigez les ports distants via le 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

Développement d’API

Tests avec curl

Acheminez vos requêtes API via VPN pour tester depuis différentes régions :

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"

Utilisation de httpie

httpie fonctionne de la même manière. FreeGuard CLI fonctionne au niveau système, donc tous les clients HTTP en profitent :

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

Mode Proxy pour le routage sélectif

Si vous souhaitez uniquement que certaines requêtes passent par le VPN, utilisez le 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

Conteneurs Docker + VPN

Trafic réseau des conteneurs via VPN

Acheminez le trafic des conteneurs Docker via 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

Intégration Docker Compose

Ajoutez la connectivité VPN à votre pile de développement :

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

Construction d’images derrière des réseaux restrictifs

Lorsque docker build doit télécharger des paquets depuis des registres bloqués ou lents :

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

Intégration CI/CD

GitHub Actions

Utilisez FreeGuard CLI dans votre pipeline CI pour accéder à des ressources géo-restreintes pendant les 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

Sortie adaptée aux scripts

Chaque commande FreeGuard CLI prend en charge --json pour une sortie lisible par machine et --no-color pour des fichiers de logs propres :

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

Codes de sortie

Le CLI utilise des codes de sortie standard que les scripts peuvent vérifier :

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

Conseils pour l’utilisation quotidienne

1. Alias shell — Ajoutez alias vpn="freeguard connect" et alias vpnoff="freeguard disconnect" à votre profil shell.
2. Connexion automatique — Ajoutez freeguard connect à votre .zshrc ou .bashrc si vous souhaitez toujours activer le VPN.
3. Signets de serveur — Utilisez freeguard config set default-server us-east pour éviter l’option --server.
4. Statut dans l’invite — Analysez freeguard status --json pour afficher l’état du VPN dans votre invite de shell.

Prochaines étapes

• FreeGuard CLI — installation et référence complète des commandes
• CLI command documentation — référence détaillée pour chaque commande et chaque option
• Deploy on headless servers — exécuter FreeGuard CLI en tant que service système
• Pricing — offres adaptées aux développeurs

Dernière mise à jour : March 2026