Terminal Proxy-werkstroom voor ontwikkelaars

FreeGuard CLI maakt van je terminal een veilige ontwikkelomgeving door verkeer via versleutelde VPN-tunnels te routeren. Of je nu repositories kloont vanaf beperkte netwerken, API’s debugt tussen regio’s, of containers uitrolt via veilige kanalen, de CLI integreert met de tools die je al gebruikt — git, ssh, curl, docker, en meer.

Waarom ontwikkelaars een Terminal Proxy nodig hebben

Veel ontwikkeltaken omvatten netwerktoegang die baat heeft bij VPN-beveiliging:

• Toegang tot interne API’s vanuit koffiebars of luchthavens
• Geolocatiebeperkte services testen tijdens ontwikkeling
• Code pushen via netwerken die git-verkeer afremmen of inspecteren
• Verbinding maken met externe servers via restrictieve firewalls
• CI/CD-referenties versleuteld houden tijdens transport

FreeGuard CLI regelt dit allemaal zonder je terminal te verlaten.

Git via VPN

Het probleem

Bedrijfsnetwerken, openbare Wi-Fi en sommige ISP’s remmen of blokkeren git-bewerkingen. SSH-gebaseerde git-verbindingen kunnen worden gemarkeerd door deep packet inspection. HTTPS-clones kunnen worden onderschept door transparante proxies.

De oplossing

Verbind met FreeGuard vóór je git-bewerkingen:

freeguard connect --server us-east

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

freeguard disconnect

Voor een meer geautomatiseerde aanpak kun je dit in een script plaatsen:

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

De trap zorgt ervoor dat VPN ook verbreekt als het script halverwege faalt.

Proxy-bewust Git

FreeGuard CLI kan ook een lokale SOCKS5- of HTTP-proxy beschikbaar maken. Configureer git om deze te gebruiken:

# Stel global proxy in voor git
git config --global http.proxy socks5://127.0.0.1:1080
git config --global https.proxy socks5://127.0.0.1:1080

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

Verwijder de proxyconfiguratie wanneer je klaar bent:

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

SSH-tunneling met VPN

Toegang tot externe servers

Wanneer je via SSH verbinding moet maken met servers vanaf onbetrouwbare netwerken, voegt VPN een versleutelingslaag toe nog voordat je SSH-verkeer je machine verlaat:

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

ProxyJump via VPN

Combineer FreeGuard met SSH ProxyJump voor toegang via meerdere hops:

# Maak eerst verbinding met VPN
freeguard connect

# Spring dan via een bastion host
ssh -J [email protected] [email protected]

Port forwarding

Stuur externe poorten door via de VPN-tunnel:

freeguard connect --server eu-west
ssh -L 5432:db.internal:5432 [email protected]
# Maak nu verbinding met localhost:5432 om de externe database te bereiken

API-ontwikkeling

Testen met curl

Route je API-verzoeken via VPN om vanuit verschillende regio’s te testen:

freeguard connect --server jp-tokyo

# Test regio-specifieke 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"

httpie gebruiken

httpie werkt op dezelfde manier. FreeGuard CLI werkt op systeemniveau, dus alle HTTP-clients profiteren ervan:

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

Proxy-modus voor selectieve routering

Als je alleen wilt dat bepaalde verzoeken via VPN gaan, gebruik dan de lokale proxy:

# Start FreeGuard met lokale proxy
freeguard connect

# Route specifieke verzoeken via de proxy
curl --proxy socks5://127.0.0.1:1080 https://api.example.com/endpoint

# Directe verzoeken omzeilen VPN
curl https://internal.company.com/api

Docker-containers + VPN

Containernetwerk via VPN

Route Docker-containerverkeer via FreeGuard:

# Verbind host met VPN
freeguard connect --server us-east

# Containers die het host-netwerk gebruiken, worden via VPN gerouteerd
docker run --network host my-app:latest

Docker Compose-integratie

Voeg VPN-connectiviteit toe aan je development stack:

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

Images bouwen achter restrictieve netwerken

Wanneer docker build pakketten moet downloaden uit registries die geblokkeerd of traag zijn:

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

CI/CD-integratie

GitHub Actions

Gebruik FreeGuard CLI in je CI-pipeline om tijdens builds toegang te krijgen tot geolocatiebeperkte resources:

- 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

Scriptvriendelijke output

Elke FreeGuard CLI-opdracht ondersteunt --json voor machineleesbare output en --no-color voor schone logbestanden:

# Verbindingsstatus als JSON ophalen
freeguard status --json
# {"connected": true, "server": "us-east-1", "protocol": "hysteria2", "uptime": 3600}

# Servers als JSON weergeven voor programmatische selectie
freeguard servers --json --region us | jq '.[0].id'

Exit-codes

De CLI gebruikt standaard exit-codes die scripts kunnen controleren:

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

Tips voor dagelijks gebruik

1. Shell-alias — Voeg alias vpn="freeguard connect" en alias vpnoff="freeguard disconnect" toe aan je shell-profiel.
2. Automatisch verbinden — Voeg freeguard connect toe aan je .zshrc of .bashrc als je altijd VPN aan wilt hebben.
3. Serverbladwijzers — Gebruik freeguard config set default-server us-east om de --server-vlag over te slaan.
4. Status in prompt — Parse freeguard status --json om VPN-status in je shell-prompt te tonen.

Volgende stappen

• FreeGuard CLI — installatie en volledige opdrachtreferentie
• CLI-opdrachtdocumentatie — gedetailleerde referentie voor elke opdracht en vlag
• Uitrollen op headless servers — voer FreeGuard CLI uit als systeemservice
• Prijzen — ontwikkelaarsvriendelijke abonnementen

Laatst bijgewerkt: March 2026