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
- Vzdevek v lupini — V svoj profil lupine dodajte
alias vpn="freeguard connect"inalias vpnoff="freeguard disconnect". - Samodejna povezava — Če želite, da je VPN vedno vklopljen, dodajte
freeguard connectv svojo.zshrcali.bashrc. - Zaznamki strežnikov — Uporabite
freeguard config set default-server us-east, da preskočite zastavico--server. - Stanje v pozivu — Razčlenite
freeguard status --json, da prikažete stanje VPN v pozivu vaše lupine.
Naslednji koraki
- FreeGuard CLI — namestitev in popolna referenca ukazov
- CLI command documentation — podrobna referenca za vsak ukaz in zastavico
- Deploy on headless servers — zaženite FreeGuard CLI kot sistemsko storitev
- Pricing — paketi, prijazni za razvijalce
Zadnja posodobitev: marec 2026