Terminal Proxy-workflow for udviklere

FreeGuard CLI gør din terminal til et sikkert udviklingsmiljø ved at dirigere trafik gennem krypterede VPN-tunneler. Uanset om du kloner repositories fra begrænsede netværk, fejlsøger API’er på tværs af regioner eller implementerer containere gennem sikre kanaler, integrerer CLI’en sig i de værktøjer, du allerede bruger — git, ssh, curl, docker og mere.

Hvorfor udviklere har brug for en Terminal Proxy

Mange udviklingsopgaver involverer netværksadgang, som drager fordel af VPN-beskyttelse:

• Adgang til interne API’er fra caféer eller lufthavne
• Test af geo-begrænsede tjenester under udvikling
• Push af kode over netværk, der throttler eller inspicerer git-trafik
• Oprettelse af forbindelse til fjernservere gennem restriktive firewalls
• Sikring af, at CI/CD-legitimationsoplysninger er krypteret under transport

FreeGuard CLI håndterer alt dette uden at forlade din terminal.

Git Over VPN

Problemet

Virksomhedsnetværk, offentlig Wi-Fi og nogle ISP’er throttler eller blokerer git-operationer. SSH-baserede git-forbindelser kan blive markeret af deep packet inspection. HTTPS-clones kan blive opfanget af transparente proxies.

Løsningen

Opret forbindelse til FreeGuard, før du udfører dine git-operationer:

freeguard connect --server us-east

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

freeguard disconnect

For en mere automatiseret tilgang kan du pakke det ind i et 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

trap sikrer, at VPN afbrydes, selv hvis scriptet fejler midtvejs.

Proxy-aware Git

FreeGuard CLI kan også eksponere en lokal SOCKS5- eller HTTP-proxy. Konfigurer git til at bruge den:

# 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

Fjern proxy-konfigurationen, når du er færdig:

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

SSH Tunneling med VPN

Adgang til fjernservere

Når du har brug for at SSH’e ind på servere fra upålidelige netværk, tilføjer VPN et krypteringslag, før din SSH-trafik overhovedet forlader din maskine:

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

ProxyJump gennem VPN

Kombinér FreeGuard med SSH ProxyJump for multi-hop-adgang:

# Connect to VPN first
freeguard connect

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

Port forwarding

Videresend fjerne porte gennem VPN-tunnelen:

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

API-udvikling

Test med curl

Diriger dine API-anmodninger gennem VPN for at teste fra forskellige regioner:

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"

Brug af httpie

httpie fungerer på samme måde. FreeGuard CLI fungerer på systemniveau, så alle HTTP-klienter drager fordel af det:

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

Proxy-tilstand til selektiv routing

Hvis du kun vil have bestemte anmodninger gennem VPN, skal du bruge den lokale proxy:

# 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

Docker Containere + VPN

Containernetværk gennem VPN

Diriger Docker-containertrafik gennem 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

Integration med Docker Compose

Tilføj VPN-forbindelse til din udviklingsstack:

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

Bygning af images bag restriktive netværk

Når docker build skal downloade pakker fra registries, som er blokerede eller langsomme:

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

CI/CD-integration

GitHub Actions

Brug FreeGuard CLI i din CI-pipeline til at få adgang til geo-begrænsede ressourcer under 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

Scriptvenligt output

Alle FreeGuard CLI-kommandoer understøtter --json til maskinlæsbar output og --no-color til rene logfiler:

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

CLI’en bruger standard exit-koder, som scripts kan kontrollere:

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

Tips til daglig brug

1. Shell-alias — Tilføj alias vpn="freeguard connect" og alias vpnoff="freeguard disconnect" til din shell-profil.
2. Auto-connect — Tilføj freeguard connect til din .zshrc eller .bashrc, hvis du altid vil have VPN slået til.
3. Serverbogmærker — Brug freeguard config set default-server us-east for at springe --server-flaget over.
4. Status i prompt — Parse freeguard status --json for at vise VPN-status i din shell-prompt.

Næste skridt

• FreeGuard CLI — installation og fuld kommando-reference
• CLI command documentation — detaljeret reference for hver kommando og hvert flag
• Deploy on headless servers — kør FreeGuard CLI som en systemtjeneste
• Pricing — udviklervenlige planer

Sidst opdateret: March 2026