Terminálový Proxy pracovný postup pre vývojárov

FreeGuard CLI mení váš terminál na bezpečné vývojové prostredie tým, že smeruje prevádzku cez šifrované VPN tunely. Či už klonujete repozitáre z obmedzených sietí, debuggujete API naprieč regiónmi, alebo nasadzujete kontajnery cez zabezpečené kanály, CLI sa integruje do nástrojov, ktoré už používate — git, ssh, curl, docker a ďalšie.

Prečo vývojári potrebujú Terminálový Proxy

Mnohé vývojové úlohy zahŕňajú prístup k sieti, z ktorého profituje ochrana VPN:

• Prístup k interným API z kaviarní alebo letísk
• Testovanie služieb s geografickým obmedzením počas vývoja
• Odosielanie kódu cez siete, ktoré obmedzujú alebo kontrolujú git prevádzku
• Pripojenie k vzdialeným serverom cez reštriktívne firewally
• Udržiavanie CI/CD poverení šifrovaných počas prenosu

FreeGuard CLI toto všetko zvládne bez toho, aby ste opustili terminál.

Git cez VPN

Problém

Podnikové siete, verejné Wi-Fi a niektorí ISP obmedzujú alebo blokujú git operácie. SSH-based git pripojenia môžu byť označené pomocou hlbokej kontroly paketov. HTTPS klony môžu byť zachytené transparentnými proxymi.

Riešenie

Pred git operáciami sa pripojte 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

Pre automatizovanejší prístup to zabaľte 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 zabezpečí, že sa VPN odpojí aj vtedy, ak skript zlyhá uprostred.

Git s vedomím Proxy

FreeGuard CLI môže tiež sprístupniť lokálny SOCKS5 alebo HTTP proxy. Nakonfigurujte git, aby ho používal:

# 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

Keď skončíte, odstráňte konfiguráciu proxy:

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

SSH tunelovanie s VPN

Prístup k vzdialenému serveru

Keď sa potrebujete pripojiť cez SSH na servery z nedôveryhodných sietí, VPN pridá šifrovaciu vrstvu ešte predtým, než SSH prevádzka opustí vaše zariadenie:

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

ProxyJump cez VPN

Skombinujte FreeGuard so SSH ProxyJump pre viacnásobný hop prístup:

# Connect to VPN first
freeguard connect

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

Presmerovanie portov

Presmerujte vzdialené porty cez VPN tunel:

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

Vývoj API

Testovanie s curl

Smerujte svoje API požiadavky cez VPN, aby ste testovali z rôznych regiónov:

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"

Použitie httpie

httpie funguje rovnako. FreeGuard CLI pracuje na systémovej úrovni, takže všetci HTTP klienti z toho profitujú:

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

Režim Proxy pre selektívne smerovanie

Ak chcete, aby cez VPN išli len niektoré požiadavky, použite lokálny 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 kontajnery + VPN

Sieť kontajnera cez VPN

Smerujte sieťovú prevádzku Docker kontajnerov cez 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

Integrácia s Docker Compose

Pridajte konektivitu VPN do vášho vývojového stacku:

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

Build image za reštriktívnych sietí

Keď docker build potrebuje stiahnuť balíky z registrov, ktoré sú blokované alebo pomalé:

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

Integrácia CI/CD

GitHub Actions

Použite FreeGuard CLI vo vašom CI pipeline na prístup k zdrojom s geografickým obmedzením počas buildov:

- 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ý pre skripty

Každý príkaz FreeGuard CLI podporuje --json pre strojovo čitateľný výstup a --no-color pre čisté log súbory:

# 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 kódy

CLI používa štandardné exit kódy, ktoré môžu skripty kontrolovať:

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

Tipy na každodenné používanie

1. Shell alias — Pridajte alias vpn="freeguard connect" a alias vpnoff="freeguard disconnect" do vášho shell profilu.
2. Automatické pripojenie — Pridajte freeguard connect do vášho .zshrc alebo .bashrc, ak chcete mať VPN vždy zapnutú.
3. Záložky serverov — Použite freeguard config set default-server us-east na preskočenie prepínača --server.
4. Stav v prompt-e — Parsujte freeguard status --json a zobrazujte stav VPN vo vašom shell prompt-e.

Ďalšie kroky

• FreeGuard CLI — inštalácia a kompletná referencia príkazov
• CLI command documentation — podrobná referencia pre každý príkaz a prepínač
• Deploy on headless servers — spustenie FreeGuard CLI ako systémovej služby
• Pricing — plány vhodné pre vývojárov

Last updated: March 2026