Flujo de trabajo de Terminal Proxy para desarrolladores

FreeGuard CLI convierte tu terminal en un entorno de desarrollo seguro al enrutar el tráfico a través de túneles VPN cifrados. Ya sea que estés clonando repositorios desde redes restringidas, depurando APIs entre regiones o desplegando contenedores a través de canales seguros, la CLI se integra con las herramientas que ya usas — git, ssh, curl, docker y más.

Por qué los desarrolladores necesitan un Terminal Proxy

Muchas tareas de desarrollo implican acceso a la red que se beneficia de la protección VPN:

• Acceder a APIs internas desde cafeterías o aeropuertos
• Probar servicios con restricción geográfica durante el desarrollo
• Enviar código a través de redes que limitan o inspeccionan el tráfico de git
• Conectarse a servidores remotos a través de firewalls restrictivos
• Mantener las credenciales de CI/CD cifradas durante la transmisión

FreeGuard CLI se encarga de todo esto sin salir de tu terminal.

Git sobre VPN

El problema

Las redes corporativas, el Wi-Fi público y algunos ISP limitan o bloquean las operaciones de git. Las conexiones git basadas en SSH pueden ser marcadas por la inspección profunda de paquetes. Los clones HTTPS pueden ser interceptados por proxies transparentes.

La solución

Conéctate a FreeGuard antes de tus operaciones de 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 un enfoque más automatizado, envuélvelo en 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

El trap garantiza que las desconexiones VPN también ocurran si el script falla a mitad de camino.

Git compatible con Proxy

FreeGuard CLI también puede exponer un proxy local SOCKS5 o HTTP. Configura git para 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

Elimina la configuración del proxy cuando termines:

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

Túnel SSH con VPN

Acceso a servidores remotos

Cuando necesitas hacer SSH a servidores desde redes no confiables, VPN añade una capa de cifrado antes de que el tráfico SSH siquiera salga de tu máquina:

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

ProxyJump a través de VPN

Combina FreeGuard con SSH ProxyJump para acceso de varios saltos:

# Connect to VPN first
freeguard connect

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

Redirección de puertos

Redirige puertos remotos a través del 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

Desarrollo de API

Probar con curl

Dirige tus solicitudes de API a través de VPN para probar desde diferentes regiones:

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

httpie funciona de la misma manera. FreeGuard CLI opera a nivel de sistema, así que todos los clientes HTTP se benefician:

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

Modo Proxy para enrutamiento selectivo

Si solo quieres que ciertas solicitudes pasen por VPN, usa el 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

Contenedores Docker + VPN

Red del contenedor a través de VPN

Dirige el tráfico de los contenedores Docker a través de 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

Integración con Docker Compose

Añade conectividad VPN a tu pila de desarrollo:

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

Construcción de imágenes detrás de redes restrictivas

Cuando docker build necesita descargar paquetes de registros que están bloqueados o son lentos:

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

Integración CI/CD

GitHub Actions

Usa FreeGuard CLI en tu pipeline de CI para acceder a recursos con restricción geográfica durante las compilaciones:

- 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

Salida apta para scripts

Cada comando de FreeGuard CLI admite --json para salida legible por máquina y --no-color para archivos de registro limpios:

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

La CLI usa códigos de salida estándar que los scripts pueden comprobar:

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

Consejos para el uso diario

1. Alias de shell — Añade alias vpn="freeguard connect" y alias vpnoff="freeguard disconnect" a tu perfil de shell.
2. Auto-conexión — Añade freeguard connect a tu .zshrc o .bashrc si siempre quieres que VPN esté activa.
3. Marcadores de servidor — Usa freeguard config set default-server us-east para omitir la bandera --server.
4. Estado en el prompt — Analiza freeguard status --json para mostrar el estado de VPN en el prompt de tu shell.

Próximos pasos

• FreeGuard CLI — instalación y referencia completa de comandos
• CLI command documentation — referencia detallada de cada comando y bandera
• Deploy on headless servers — ejecuta FreeGuard CLI como servicio del sistema
• Pricing — planes pensados para desarrolladores

Last updated: March 2026