Geliştiriciler için Terminal Proxy İş Akışı

FreeGuard CLI, trafiği şifrelenmiş VPN tünelleri üzerinden yönlendirerek terminalinizi güvenli bir geliştirme ortamına dönüştürür. İster kısıtlı ağlardan depoları klonluyor, ister bölgeler arası API’lerde hata ayıklıyor, ister kapsayıcıları güvenli kanallar üzerinden dağıtıyor olun, CLI zaten kullandığınız araçlara entegre olur — git, ssh, curl, docker ve daha fazlası.

Geliştiricilerin Neden Terminal Proxy’ye İhtiyacı Var

Birçok geliştirme görevi, VPN korumasından fayda sağlayan ağ erişimi içerir:

Kafelerde veya havaalanlarında dahili API’lere erişmek
Geliştirme sırasında coğrafi olarak kısıtlanmış hizmetleri test etmek
git trafiğini yavaşlatan veya inceleyen ağlar üzerinden kod göndermek
Kısıtlayıcı güvenlik duvarları üzerinden uzak sunuculara bağlanmak
CI/CD kimlik bilgilerini aktarım sırasında şifreli tutmak

FreeGuard CLI, bunların hepsini terminalinizden ayrılmadan halleder.

VPN Üzerinden Git

Sorun

Kurumsal ağlar, genel Wi‑Fi ve bazı ISP’ler git işlemlerini yavaşlatır veya engeller. SSH tabanlı git bağlantıları derin paket incelemesi tarafından işaretlenebilir. HTTPS klonları şeffaf proxy’ler tarafından ele geçirilebilir.

Çözüm

git işlemlerinizden önce FreeGuard’a bağlanın:

freeguard connect --server us-east

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

freeguard disconnect

Daha otomatik bir yaklaşım için bunu bir betiğe sarın:

#!/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, betik yarıda başarısız olsa bile VPN bağlantısının kesilmesini sağlar.

Proxy Farkındalıklı Git

FreeGuard CLI ayrıca yerel bir SOCKS5 veya HTTP proxy sunabilir. git’i bunu kullanacak şekilde yapılandırın:

# 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

İşiniz bittiğinde proxy yapılandırmasını kaldırın:

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

VPN ile SSH Tünelleme

Uzak Sunucu Erişimi

Güvenilmeyen ağlardan sunuculara SSH ile bağlanmanız gerektiğinde, VPN SSH trafiğiniz makinenizden çıkmadan önce bir şifreleme katmanı ekler:

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

VPN Üzerinden ProxyJump

Çok atlamalı erişim için FreeGuard’ı SSH ProxyJump ile birleştirin:

# Connect to VPN first
freeguard connect

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

Port Yönlendirme

Uzak portları VPN tüneli üzerinden yönlendirin:

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

API Geliştirme

curl ile Test Etme

Farklı bölgelerden test etmek için API isteklerinizi VPN üzerinden yönlendirin:

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"

httpie Kullanma

httpie de aynı şekilde çalışır. FreeGuard CLI sistem düzeyinde çalışır, bu yüzden tüm HTTP istemcileri fayda sağlar:

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

Seçici Yönlendirme için Proxy Modu

Yalnızca belirli isteklerin VPN üzerinden geçmesini istiyorsanız, yerel proxy’yi kullanın:

# 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 Kapsayıcıları + VPN

Kapsayıcı Ağını VPN Üzerinden Geçirme

Docker kapsayıcı trafiğini FreeGuard üzerinden yönlendirin:

# Connect host to VPN
freeguard connect --server us-east

# Containers using host network will route through VPN
docker run --network host my-app:latest

Docker Compose Entegrasyonu

Geliştirme yığınınıza VPN bağlantısı ekleyin:

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

Kısıtlayıcı Ağların Ardında İmaj Oluşturma

docker build, engellenmiş veya yavaş kayıt depolarından paket indirmesi gerektiğinde:

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

CI/CD Entegrasyonu

GitHub Actions

Derlemeler sırasında coğrafi olarak kısıtlanmış kaynaklara erişmek için CI hattınızda FreeGuard CLI kullanın:

- 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

Betik Dostu Çıktı

Her FreeGuard CLI komutu, makine tarafından okunabilir çıktı için --json ve temiz günlük dosyaları için --no-color destekler:

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

Çıkış Kodları

CLI, betiklerin kontrol edebileceği standart çıkış kodlarını kullanır:

Exit Code	Anlamı
0	Başarı
1	Genel hata
2	Kimlik doğrulama gerekli
3	Bağlantı başarısız
4	Sunucu bulunamadı

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

Günlük Kullanım İçin İpuçları

Shell alias — Shell profilinize alias vpn="freeguard connect" ve alias vpnoff="freeguard disconnect" ekleyin.
Auto-connect — VPN’in her zaman açık olmasını istiyorsanız .zshrc veya .bashrc dosyanıza freeguard connect ekleyin.
Server bookmarks — --server bayrağını atlamak için freeguard config set default-server us-east kullanın.
Prompt’ta durum — Shell prompt’unuzda VPN durumunu göstermek için freeguard status --json çıktısını ayrıştırın.

Sonraki Adımlar

FreeGuard CLI — kurulum ve tam komut başvurusu
CLI command documentation — her komut ve bayrak için ayrıntılı başvuru
Deploy on headless servers — FreeGuard CLI’yi sistem hizmeti olarak çalıştırın
Pricing — geliştirici dostu planlar

Son güncelleme: March 2026