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
- Shell-Alias — Fügen Sie
alias vpn="freeguard connect"undalias vpnoff="freeguard disconnect"Ihrem Shell-Profil hinzu. - Automatische Verbindung — Fügen Sie
freeguard connectzu Ihrer.zshrcoder.bashrchinzu, wenn VPN immer aktiv sein soll. - Server-Lesezeichen — Verwenden Sie
freeguard config set default-server us-east, um das--server-Flag zu überspringen. - Status in der Eingabeaufforderung — Parsen Sie
freeguard status --json, um den VPN-Status in Ihrer Shell-Eingabeaufforderung anzuzeigen.
Nächste Schritte
- FreeGuard CLI — Installation und vollständige Befehlsreferenz
- CLI-Befehlsdokumentation — ausführliche Referenz für jeden Befehl und Schalter
- Bereitstellung auf Headless-Servern — FreeGuard CLI als Systemdienst ausführen
- Preise — tarife für Entwickler
Zuletzt aktualisiert: März 2026