Pracovní postup Terminal Proxy pro vývojáře

FreeGuard CLI promění váš terminál v bezpečné vývojové prostředí tím, že směruje provoz přes šifrované VPN tunely. Ať už klonujete repozitáře z omezených sítí, ladíte API napříč regiony, nebo nasazujete kontejnery přes zabezpečené kanály, CLI se integruje do nástrojů, které už používáte — git, ssh, curl, docker a další.

Proč vývojáři potřebují Terminal Proxy

Mnoho vývojových úloh zahrnuje přístup k síti, který těží z ochrany VPN:

• Přístup k interním API z kaváren nebo letišť
• Testování služeb s geo-omezením během vývoje
• Odesílání kódu přes sítě, které omezují nebo kontrolují provoz git
• Připojování k vzdáleným serverům přes restriktivní firewally
• Zachování šifrování přihlašovacích údajů CI/CD během přenosu

FreeGuard CLI to všechno zvládne, aniž byste opustili terminál.

Git přes VPN

Problém

Firemní sítě, veřejné Wi-Fi a někteří ISP omezují nebo blokují operace git. Připojení git založená na SSH mohou být označena pomocí deep packet inspection. Klony přes HTTPS mohou být zachyceny transparentními proxyny.

Řešení

Před operacemi s git se připojte k 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

Pro více automatizovaný přístup to zabalte do skriptu:

#!/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 zajistí odpojení VPN i v případě, že skript selže uprostřed.

Git kompatibilní s Proxy

FreeGuard CLI může také zpřístupnit lokální SOCKS5 nebo HTTP proxy. Nakonfigurujte git, aby ji používal:

# Nastavení proxy pro git globálně
git config --global http.proxy socks5://127.0.0.1:1080
git config --global https.proxy socks5://127.0.0.1:1080

# Nebo pro konkrétní repozitář
git config http.proxy socks5://127.0.0.1:1080

Po dokončení proxy konfiguraci odeberte:

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

Tunneling SSH s VPN

Přístup ke vzdálenému serveru

Když se potřebujete připojit přes SSH k serverům z nedůvěryhodných sítí, VPN přidává další vrstvu šifrování ještě předtím, než váš provoz SSH opustí zařízení:

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

ProxyJump přes VPN

Kombinujte FreeGuard se SSH ProxyJump pro vícehopový přístup:

# Nejprve se připojte k VPN
freeguard connect

# Poté přeskakujte přes bastion host
ssh -J [email protected] [email protected]

Přesměrování portů

Přesměrujte vzdálené porty přes VPN tunel:

freeguard connect --server eu-west
ssh -L 5432:db.internal:5432 [email protected]
# Nyní se připojte k localhost:5432, abyste dosáhli na vzdálenou databázi

Vývoj API

Testování s curl

Směrujte požadavky na API přes VPN a testujte z různých regionů:

freeguard connect --server jp-tokyo

# Test geověrných odpovědí API
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"

Použití httpie

httpie funguje stejně. FreeGuard CLI pracuje na systémové úrovni, takže z něj těží všichni HTTP klienti:

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

Proxy Mode pro selektivní směrování

Pokud chcete, aby přes VPN šly jen určité požadavky, použijte místní proxy:

# Spuštění FreeGuard s lokální proxy
freeguard connect

# Směrování konkrétních požadavků přes proxy
curl --proxy socks5://127.0.0.1:1080 https://api.example.com/endpoint

# Přímé požadavky VPN obcházejí
curl https://internal.company.com/api

Docker kontejnery + VPN

Síť kontejneru přes VPN

Směrujte provoz Docker kontejnerů přes FreeGuard:

# Připojení hostitele k VPN
freeguard connect --server us-east

# Kontejnery používající host network budou směrovány přes VPN
docker run --network host my-app:latest

Integrace Docker Compose

Přidejte do svého vývojového stacku konektivitu VPN:

#!/bin/bash
# dev-start.sh
freeguard connect --server us-east --json | jq -r '.status'
docker compose up -d
echo "Vývojový stack běží přes VPN"

Sestavování obrazů za restriktivních sítí

Když docker build potřebuje stahovat balíčky z registrů, které jsou blokované nebo pomalé:

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

Integrace CI/CD

GitHub Actions

Použijte FreeGuard CLI ve svém CI pipeline pro přístup ke zdrojům s geo-omezením během buildů:

- 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

Výstup vhodný pro skripty

Každý příkaz FreeGuard CLI podporuje --json pro strojově čitelný výstup a --no-color pro čisté logovací soubory:

# Získání stavu připojení jako JSON
freeguard status --json
# {"connected": true, "server": "us-east-1", "protocol": "hysteria2", "uptime": 3600}

# Výpis serverů jako JSON pro programový výběr
freeguard servers --json --region us | jq '.[0].id'

Exit Codes

CLI používá standardní exit codes, které mohou skripty kontrolovat:

freeguard connect --server us-east
if [ $? -eq 0 ]; then
  echo "VPN připojena, spouštím nasazení..."
  ./deploy.sh
fi

Tipy pro každodenní použití

1. Shell alias — Přidejte alias vpn="freeguard connect" a alias vpnoff="freeguard disconnect" do svého shell profilu.
2. Automatické připojení — Přidejte freeguard connect do svého .zshrc nebo .bashrc, pokud chcete mít VPN vždy zapnutou.
3. Záložky serverů — Použijte freeguard config set default-server us-east a vynechejte příznak --server.
4. Stav v promptu — Parsujte freeguard status --json a zobrazte stav VPN v promptu shellu.

Další kroky

• FreeGuard CLI — instalace a úplná reference příkazů
• Dokumentace příkazů CLI — podrobná reference pro každý příkaz a přepínač
• Nasazení na headless serverech — spuštění FreeGuard CLI jako systémové služby
• Ceny — plány přizpůsobené vývojářům

Poslední aktualizace: March 2026