Terminal-Proxy-Workflow für Entwickler
FreeGuard CLI verwandelt Ihr Terminal in eine sichere Entwicklungsumgebung, indem der Traffic über verschlüsselte VPN-Tunnel geleitet wird. Ob Sie Repositories aus eingeschränkten Netzwerken klonen, APIs über Regionen hinweg debuggen oder Container über sichere Kanäle bereitstellen — die CLI integriert sich in die Tools, die Sie bereits verwenden — git, ssh, curl, docker und mehr.

Terminal-Proxy-Workflow für Entwickler

FreeGuard CLI verwandelt Ihr Terminal in eine sichere Entwicklungsumgebung, indem der Traffic über verschlüsselte VPN-Tunnel geleitet wird. Ob Sie Repositories aus eingeschränkten Netzwerken klonen, APIs über Regionen hinweg debuggen oder Container über sichere Kanäle bereitstellen — die CLI integriert sich in die Tools, die Sie bereits verwenden — git, ssh, curl, docker und mehr.

Warum Entwickler einen Terminal-Proxy benötigen

Viele Entwicklungsaufgaben umfassen Netzwerkzugriff, der von VPN-Schutz profitiert:

  • Zugriff auf interne APIs von Cafés oder Flughäfen aus
  • Testen von geo-beschränkten Diensten während der Entwicklung
  • Code über Netzwerke pushen, die git-Traffic drosseln oder inspizieren
  • Verbindung zu Remote-Servern über restriktive Firewalls
  • CI/CD-Zugangsdaten während der Übertragung verschlüsselt halten

FreeGuard CLI erledigt all das, ohne Ihr Terminal zu verlassen.


Git über VPN

Das Problem

Firmennetze, öffentliches Wi-Fi und einige ISPs drosseln oder blockieren git-Operationen. SSH-basierte git-Verbindungen können von Deep Packet Inspection markiert werden. HTTPS-Clones können von transparenten Proxys abgefangen werden.

Die Lösung

Verbinden Sie sich vor Ihren git-Operationen mit FreeGuard:

freeguard connect --server us-east

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

freeguard disconnect

Für einen stärker automatisierten Ansatz können Sie dies in ein Skript einbetten:

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

Das trap stellt sicher, dass die VPN-Verbindung auch dann getrennt wird, wenn das Skript zwischendurch fehlschlägt.

Proxy-fähiges Git

FreeGuard CLI kann außerdem einen lokalen SOCKS5- oder HTTP-Proxy bereitstellen. Konfigurieren Sie git entsprechend:

# Proxy für git global setzen
git config --global http.proxy socks5://127.0.0.1:1080
git config --global https.proxy socks5://127.0.0.1:1080

# Oder pro Repository
git config http.proxy socks5://127.0.0.1:1080

Entfernen Sie die Proxy-Konfiguration, wenn Sie fertig sind:

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

SSH-Tunneling mit VPN

Zugriff auf Remote-Server

Wenn Sie sich von nicht vertrauenswürdigen Netzwerken aus per SSH mit Servern verbinden müssen, fügt VPN eine Verschlüsselungsebene hinzu, bevor Ihr SSH-Traffic überhaupt Ihr Gerät verlässt:

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

ProxyJump über VPN

Kombinieren Sie FreeGuard mit SSH ProxyJump für Multi-Hop-Zugriff:

# Zuerst mit VPN verbinden
freeguard connect

# Dann über einen Bastion Host springen
ssh -J [email protected] [email protected]

Portweiterleitung

Leiten Sie entfernte Ports durch den VPN-Tunnel weiter:

freeguard connect --server eu-west
ssh -L 5432:db.internal:5432 [email protected]
# Jetzt mit localhost:5432 verbinden, um die entfernte Datenbank zu erreichen

API-Entwicklung

Testen mit curl

Leiten Sie Ihre API-Anfragen über VPN, um sie aus verschiedenen Regionen zu testen:

freeguard connect --server jp-tokyo

# Geo-spezifische API-Antworten testen
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"

Verwendung von httpie

httpie funktioniert genauso. FreeGuard CLI arbeitet auf Systemebene, sodass alle HTTP-Clients profitieren:

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

Proxy-Modus für selektives Routing

Wenn nur bestimmte Anfragen über VPN laufen sollen, verwenden Sie den lokalen Proxy:

# FreeGuard mit lokalem Proxy starten
freeguard connect

# Bestimmte Anfragen über den Proxy routen
curl --proxy socks5://127.0.0.1:1080 https://api.example.com/endpoint

# Direkte Anfragen umgehen VPN
curl https://internal.company.com/api

Docker-Container + VPN

Container-Netzwerk über VPN

Leiten Sie den Traffic von Docker-Containern über FreeGuard:

# Host mit VPN verbinden
freeguard connect --server us-east

# Container, die das Host-Netzwerk verwenden, werden über VPN geroutet
docker run --network host my-app:latest

Docker-Compose-Integration

Fügen Sie Ihrer Entwicklungsumgebung VPN-Konnektivität hinzu:

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

Images hinter restriktiven Netzwerken bauen

Wenn docker build Pakete aus Registries herunterladen muss, die blockiert oder langsam sind:

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

CI/CD-Integration

GitHub Actions

Verwenden Sie FreeGuard CLI in Ihrer CI-Pipeline, um während Builds auf geo-beschränkte Ressourcen zuzugreifen:

- 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

Skriptfreundliche Ausgabe

Jeder FreeGuard CLI-Befehl unterstützt --json für maschinenlesbare Ausgabe und --no-color für saubere Protokolldateien:

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

# Server als JSON für programmatische Auswahl auflisten
freeguard servers --json --region us | jq '.[0].id'

Exit Codes

Die CLI verwendet Standard-Exit-Codes, die Skripte prüfen können:

Exit Code Bedeutung
0 Erfolg
1 Allgemeiner Fehler
2 Authentifizierung erforderlich
3 Verbindung fehlgeschlagen
4 Server nicht gefunden
freeguard connect --server us-east
if [ $? -eq 0 ]; then
  echo "VPN verbunden, Deployment wird gestartet..."
  ./deploy.sh
fi

Tipps für den täglichen Einsatz

  1. Shell-Alias — Fügen Sie alias vpn="freeguard connect" und alias vpnoff="freeguard disconnect" Ihrem Shell-Profil hinzu.
  2. Automatische Verbindung — Fügen Sie freeguard connect zu Ihrer .zshrc oder .bashrc hinzu, wenn VPN immer aktiv sein soll.
  3. Server-Lesezeichen — Verwenden Sie freeguard config set default-server us-east, um das --server-Flag zu überspringen.
  4. Status in der Eingabeaufforderung — Parsen Sie freeguard status --json, um den VPN-Status in Ihrer Shell-Eingabeaufforderung anzuzeigen.

Nächste Schritte

Zuletzt aktualisiert: März 2026