Potek terminalnega Proxyja za razvijalce
FreeGuard CLI spremeni vaš terminal v varno razvojno okolje tako, da promet usmerja skozi šifrirane VPN predore. Ne glede na to, ali klonirate repozitorije iz omejenih omrežij, odpravljate napake v API-jih med regijami ali uvajate vsebnike prek varnih kanalov, se CLI vključi v orodja, ki jih že uporabljate — git, ssh, curl, docker in druga.

Potek terminalnega Proxyja za razvijalce

FreeGuard CLI spremeni vaš terminal v varno razvojno okolje tako, da promet usmerja skozi šifrirane VPN predore. Ne glede na to, ali klonirate repozitorije iz omejenih omrežij, odpravljate napake v API-jih med regijami ali uvajate vsebnike prek varnih kanalov, se CLI vključi v orodja, ki jih že uporabljate — git, ssh, curl, docker in druga.

Zakaj razvijalci potrebujejo terminalni Proxy

Številne razvojne naloge vključujejo omrežni dostop, ki ima koristi od zaščite VPN:

  • Dostop do notranjih API-jev iz kavarn ali letališč
  • Testiranje storitev z geografsko omejitvijo med razvojem
  • Potiskanje kode prek omrežij, ki omejujejo ali pregledujejo promet git
  • Povezovanje z oddaljenimi strežniki prek restriktivnih požarnih zidov
  • Ohranjanje poverilnic CI/CD šifriranih med prenosom

FreeGuard CLI poskrbi za vse to, ne da bi zapustili terminal.


Git prek VPN

Težava

Korporativna omrežja, javni Wi‑Fi in nekateri ponudniki interneta upočasnjujejo ali blokirajo operacije git. Povezave git, ki temeljijo na SSH, lahko zazna poglobljeni pregled paketov. Kloniranja prek HTTPS lahko prestrežejo transparentni Proxyji.

Rešitev

Pred operacijami git se povežite s 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

Za bolj avtomatiziran pristop to zavijte v skripto:

#!/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 zagotovi odklop VPN tudi, če skripta na sredini odpove.

Git, ki upošteva Proxy

FreeGuard CLI lahko izpostavi tudi lokalni SOCKS5 ali HTTP Proxy. Konfigurirajte git za njegovo uporabo:

# Nastavi Proxy za git globalno
git config --global http.proxy socks5://127.0.0.1:1080
git config --global https.proxy socks5://127.0.0.1:1080

# Ali za posamezen repozitorij
git config http.proxy socks5://127.0.0.1:1080

Ko končate, odstranite konfiguracijo Proxyja:

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

SSH tuneliranje z VPN

Dostop do oddaljenega strežnika

Ko se morate iz nezaupanja vrednih omrežij povezati prek SSH na strežnike, VPN doda plast šifriranja, še preden vaš SSH promet zapusti napravo:

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

ProxyJump prek VPN

Združite FreeGuard z SSH ProxyJump za dostop z več skoki:

# Najprej se povežite z VPN
freeguard connect

# Nato skočite prek bastion gostitelja
ssh -J [email protected] [email protected]

Posredovanje vrat

Oddaljena vrata posredujte skozi VPN predor:

freeguard connect --server eu-west
ssh -L 5432:db.internal:5432 [email protected]
# Zdaj se povežite z localhost:5432 za dostop do oddaljene zbirke podatkov

Razvoj API-jev

Testiranje s curl

Vaše zahteve API usmerite skozi VPN za testiranje iz različnih regij:

freeguard connect --server jp-tokyo

# Preizkus odzivov API glede na geo lokacijo
curl -s https://api.example.com/v1/content | jq '.region'
# Izhod: "ap-northeast-1"

freeguard connect --server de-frankfurt
curl -s https://api.example.com/v1/content | jq '.region'
# Izhod: "eu-central-1"

Uporaba httpie

httpie deluje enako. FreeGuard CLI deluje na sistemski ravni, zato imajo koristi vsi odjemalci HTTP:

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

Proxy način za selektivno usmerjanje

Če želite samo določene zahteve usmeriti skozi VPN, uporabite lokalni Proxy:

# Zaženi FreeGuard z lokalnim Proxyjem
freeguard connect

# Posamezne zahteve usmeri skozi Proxy
curl --proxy socks5://127.0.0.1:1080 https://api.example.com/endpoint

# Neposredne zahteve obidejo VPN
curl https://internal.company.com/api

Docker vsebniki + VPN

Omrežje vsebnika skozi VPN

Promet Docker vsebnikov usmerite skozi FreeGuard:

# Poveži gostitelja z VPN
freeguard connect --server us-east

# Vsebniki, ki uporabljajo omrežje gostitelja, bodo usmerjeni skozi VPN
docker run --network host my-app:latest

Integracija Docker Compose

V svoji razvojni sklad dodajte povezljivost VPN:

#!/bin/bash
# dev-start.sh
freeguard connect --server us-east --json | jq -r '.status'
docker compose up -d
echo "Razvojni sklad deluje skozi VPN"

Gradnja slik za restriktivnimi omrežji

Ko mora docker build prenesti pakete iz registrov, ki so blokirani ali počasni:

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

Integracija CI/CD

GitHub Actions

Uporabite FreeGuard CLI v svoji CI-pipeline za dostop do geografsko omejenih virov med gradnjo:

- 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

Izhod, primeren za skripte

Vsak ukaz FreeGuard CLI podpira --json za strojno berljiv izhod in --no-color za čiste dnevniške datoteke:

# Pridobi stanje povezave kot JSON
freeguard status --json
# {"connected": true, "server": "us-east-1", "protocol": "hysteria2", "uptime": 3600}

# Seznam strežnikov kot JSON za programsko izbiro
freeguard servers --json --region us | jq '.[0].id'

Izhodne kode

CLI uporablja standardne izhodne kode, ki jih lahko skripte preverijo:

Exit Code Pomen
0 Uspeh
1 Splošna napaka
2 Zahtevana je avtentikacija
3 Povezava ni uspela
4 Strežnik ni bil najden
freeguard connect --server us-east
if [ $? -eq 0 ]; then
  echo "VPN povezan, začenjam uvajanje..."
  ./deploy.sh
fi

Nasveti za vsakodnevno uporabo

  1. Vzdevek v lupini — V svoj profil lupine dodajte alias vpn="freeguard connect" in alias vpnoff="freeguard disconnect".
  2. Samodejna povezava — Če želite, da je VPN vedno vklopljen, dodajte freeguard connect v svojo .zshrc ali .bashrc.
  3. Zaznamki strežnikov — Uporabite freeguard config set default-server us-east, da preskočite zastavico --server.
  4. Stanje v pozivu — Razčlenite freeguard status --json, da prikažete stanje VPN v pozivu vaše lupine.

Naslednji koraki

Zadnja posodobitev: marec 2026