Flux de lucru Terminal Proxy pentru dezvoltatori

FreeGuard CLI transformă terminalul într-un mediu de dezvoltare sigur, direcționând traficul prin tuneluri VPN criptate. Fie că clonezi repository-uri din rețele restricționate, depanezi API-uri între regiuni sau desfășori containere prin canale securizate, CLI se integrează în instrumentele pe care le folosești deja — git, ssh, curl, docker și altele.

De ce au nevoie dezvoltatorii de un Terminal Proxy

Multe sarcini de dezvoltare implică acces la rețea care beneficiază de protecția VPN:

Accesarea API-urilor interne din cafenele sau aeroporturi
Testarea serviciilor restricționate geografic în timpul dezvoltării
Trimiterea codului prin rețele care limitează sau inspectează traficul git
Conectarea la servere la distanță prin firewall-uri restrictive
Menținerea credențialelor CI/CD criptate în tranzit

FreeGuard CLI gestionează toate acestea fără să părăsești terminalul.

Git prin VPN

Problema

Rețelele corporative, Wi-Fi-ul public și unii furnizori de internet limitează sau blochează operațiunile git. Conexiunile git bazate pe SSH pot fi marcate de deep packet inspection. Clone-urile HTTPS pot fi interceptate de proxy-uri transparente.

Soluția

Conectează-te la FreeGuard înainte de operațiunile git:

freeguard connect --server us-east

git clone [email protected]:your-org/private-repo.git
git fetch --all
git push origin feature-branch

freeguard disconnect

Pentru o abordare mai automatizată, include-l într-un script:

#!/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 se asigură că VPN se deconectează chiar dacă scriptul eșuează la jumătate.

Git compatibil cu Proxy

FreeGuard CLI poate expune și un proxy local SOCKS5 sau HTTP. Configurează git să-l folosească:

# Set proxy pentru git global
git config --global http.proxy socks5://127.0.0.1:1080
git config --global https.proxy socks5://127.0.0.1:1080

# Sau per repository
git config http.proxy socks5://127.0.0.1:1080

Elimină configurația proxy când ai terminat:

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

Tunelare SSH cu VPN

Acces la servere la distanță

Când trebuie să te conectezi prin SSH la servere din rețele nesigure, VPN adaugă un strat de criptare înainte ca traficul SSH să părăsească dispozitivul tău:

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

ProxyJump prin VPN

Combină FreeGuard cu SSH ProxyJump pentru acces multi-hop:

# Conectează-te mai întâi la VPN
freeguard connect

# Apoi treci printr-un bastion host
ssh -J [email protected] [email protected]

Redirecționare de porturi

Redirecționează porturi remote prin tunelul VPN:

freeguard connect --server eu-west
ssh -L 5432:db.internal:5432 [email protected]
# Acum conectează-te la localhost:5432 pentru a accesa baza de date remote

Dezvoltare API

Testare cu curl

Direcționează cererile API prin VPN pentru a testa din regiuni diferite:

freeguard connect --server jp-tokyo

# Testează răspunsurile API specifice regiunii
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"

Folosind httpie

httpie funcționează la fel. FreeGuard CLI operează la nivel de sistem, astfel încât toți clienții HTTP beneficiază:

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

Mod Proxy pentru rutare selectivă

Dacă vrei ca doar anumite cereri să treacă prin VPN, folosește proxy-ul local:

# Pornește FreeGuard cu proxy local
freeguard connect

# Direcționează cereri specifice prin proxy
curl --proxy socks5://127.0.0.1:1080 https://api.example.com/endpoint

# Cererile directe ocolesc VPN
curl https://internal.company.com/api

Containere Docker + VPN

Traficul containerului prin VPN

Direcționează traficul containerelor Docker prin FreeGuard:

# Conectează host-ul la VPN
freeguard connect --server us-east

# Containerele care folosesc network-ul host vor fi rutate prin VPN
docker run --network host my-app:latest

Integrare Docker Compose

Adaugă conectivitate VPN la stack-ul tău de dezvoltare:

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

Construirea imaginilor în spatele unor rețele restrictive

Când docker build trebuie să descarce pachete din registries blocate sau lente:

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

Integrare CI/CD

GitHub Actions

Folosește FreeGuard CLI în pipeline-ul tău CI pentru a accesa resurse restricționate geografic în timpul build-urilor:

- 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

Output prietenos pentru scripturi

Fiecare comandă FreeGuard CLI suportă --json pentru output lizibil de mașini și --no-color pentru fișiere de log curate:

# Obține statusul conexiunii ca JSON
freeguard status --json
# {"connected": true, "server": "us-east-1", "protocol": "hysteria2", "uptime": 3600}

# Listează serverele ca JSON pentru selecție programatică
freeguard servers --json --region us | jq '.[0].id'

Coduri de ieșire

CLI folosește coduri de ieșire standard pe care scripturile le pot verifica:

Exit Code	Înțeles
0	Succes
1	Eroare generală
2	Autentificare necesară
3	Conexiune eșuată
4	Server negăsit

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

Sfaturi pentru utilizarea zilnică

Alias shell — Adaugă alias vpn="freeguard connect" și alias vpnoff="freeguard disconnect" în profilul shell-ului tău.
Conectare automată — Adaugă freeguard connect în .zshrc sau .bashrc dacă vrei mereu VPN activ.
Bookmark-uri pentru servere — Folosește freeguard config set default-server us-east pentru a sări peste flag-ul --server.
Status în prompt — Parsează freeguard status --json pentru a afișa statusul VPN în promptul shell-ului tău.

Următorii pași

FreeGuard CLI — instalare și referință completă a comenzilor
CLI command documentation — referință detaliată pentru fiecare comandă și flag
Deploy on headless servers — rulează FreeGuard CLI ca serviciu de sistem
Pricing — planuri prietenoase pentru dezvoltatori

Ultima actualizare: March 2026