Radni tijek terminalskog Proxyja za programere
FreeGuard CLI pretvara vaš terminal u sigurno razvojno okruženje usmjeravanjem prometa kroz šifrirane VPN tunele. Bilo da klonirate repozitorije iz ograničenih mreža, otklanjate pogreške u API-jima među regijama ili postavljate kontejnere kroz sigurne kanale, CLI se integrira u alate koje već koristite — git, ssh, curl, docker i druge.

Radni tijek terminalskog Proxyja za programere

FreeGuard CLI pretvara vaš terminal u sigurno razvojno okruženje usmjeravanjem prometa kroz šifrirane VPN tunele. Bilo da klonirate repozitorije iz ograničenih mreža, otklanjate pogreške u API-jima među regijama ili postavljate kontejnere kroz sigurne kanale, CLI se integrira u alate koje već koristite — git, ssh, curl, docker i druge.

Zašto programerima treba terminalski Proxy

Mnogi razvojni zadaci uključuju mrežni pristup koji ima koristi od VPN zaštite:

  • Pristup internim API-jima iz kafića ili zračnih luka
  • Testiranje usluga s geoo-graničenjima tijekom razvoja
  • Slanje koda preko mreža koje ograničavaju ili pregledavaju git promet
  • Povezivanje s udaljenim poslužiteljima kroz restriktivne vatrozide
  • Održavanje CI/CD vjerodajnica šifriranima tijekom prijenosa

FreeGuard CLI obrađuje sve to bez napuštanja vašeg terminala.


Git preko VPN-a

Problem

Korporativne mreže, javni Wi‑Fi i neki ISP-ovi ograničavaju ili blokiraju git operacije. SSH-bazirane git veze mogu biti označene dubinskom inspekcijom paketa. HTTPS kloniranja mogu presresti transparentni proxyji.

Rješenje

Povežite se na FreeGuard prije svojih git operacija:

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 automatiziraniji pristup, omotajte to u 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 osigurava da se VPN isključi čak i ako skripta padne usred izvršavanja.

Git svjestan Proxyja

FreeGuard CLI također može izložiti lokalni SOCKS5 ili HTTP proxy. Konfigurirajte git da ga koristi:

# 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

Uklonite konfiguraciju Proxyja kada završite:

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

SSH tuneliranje s VPN-om

Pristup udaljenom poslužitelju

Kada se trebate SSH-om spojiti na poslužitelje iz nepouzdanih mreža, VPN dodaje sloj enkripcije prije nego što vaš SSH promet uopće napusti uređaj:

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

ProxyJump kroz VPN

Kombinirajte FreeGuard s SSH ProxyJump za višeskočni pristup:

# Connect to VPN first
freeguard connect

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

Prosljeđivanje portova

Proslijedite udaljene portove kroz 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

Razvoj API-ja

Testiranje s curl

Usmjerite svoje API zahtjeve kroz VPN kako biste testirali iz različitih regija:

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"

Korištenje httpie

httpie radi na isti način. FreeGuard CLI djeluje na razini sustava, pa svi HTTP klijenti imaju koristi:

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

Proxy Mode za selektivno usmjeravanje

Ako želite samo određene zahtjeve slati kroz VPN, upotrijebite lokalni 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 kontejneri + VPN

Mreža kontejnera kroz VPN

Usmjerite promet Docker kontejnera kroz 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

Integracija s Docker Compose

Dodajte VPN povezivost u svoj razvojni stack:

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

Izrada slika iza restriktivnih mreža

Kada docker build treba preuzeti pakete iz registryja koji su blokirani ili spori:

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

Integracija CI/CD-a

GitHub Actions

Koristite FreeGuard CLI u CI pipelineu za pristup resursima s geoo-graničenjima tijekom izgradnji:

- 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

Izlaz pogodan za skripte

Svaka FreeGuard CLI naredba podržava --json za izlaz čitljiv stroju i --no-color za čiste datoteke dnevnika:

# 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'

Izlazni kodovi

CLI koristi standardne izlazne kodove koje skripte mogu provjeriti:

Exit Code Meaning
0 Success
1 General error
2 Authentication required
3 Connection failed
4 Server not found
freeguard connect --server us-east
if [ $? -eq 0 ]; then
  echo "VPN connected, starting deployment..."
  ./deploy.sh
fi

Savjeti za svakodnevnu upotrebu

  1. Shell alias — Dodajte alias vpn="freeguard connect" i alias vpnoff="freeguard disconnect" u svoj shell profil.
  2. Automatsko povezivanje — Dodajte freeguard connect u svoj .zshrc ili .bashrc ako uvijek želite da je VPN uključen.
  3. Oznake poslužitelja — Upotrijebite freeguard config set default-server us-east kako biste preskočili zastavicu --server.
  4. Status u promptu — Parsirajte freeguard status --json kako biste prikazali status VPN-a u svom shell promptu.

Sljedeći koraci

Last updated: March 2026