Workflow Proxy Terminal untuk Developer

FreeGuard CLI mengubah terminal Anda menjadi lingkungan pengembangan yang aman dengan merutekan traffic melalui tunnel VPN terenkripsi. Baik saat Anda meng-clone repository dari jaringan yang dibatasi, men-debug API lintas region, atau men-deploy container melalui saluran aman, CLI terintegrasi ke alat yang sudah Anda gunakan — git, ssh, curl, docker, dan lainnya.

Mengapa Developer Membutuhkan Proxy Terminal

Banyak tugas pengembangan melibatkan akses jaringan yang mendapatkan manfaat dari perlindungan VPN:

Mengakses API internal dari kedai kopi atau bandara
Menguji layanan yang dibatasi berdasarkan geografis selama pengembangan
Mendorong code melalui jaringan yang membatasi atau memeriksa traffic git
Menghubungkan ke server remote melalui firewall yang ketat
Menjaga kredensial CI/CD tetap terenkripsi saat transit

FreeGuard CLI menangani semua ini tanpa meninggalkan terminal Anda.

Git melalui VPN

Masalahnya

Jaringan perusahaan, Wi-Fi publik, dan beberapa ISP membatasi atau memblokir operasi git. Koneksi git berbasis SSH dapat ditandai oleh deep packet inspection. Clone HTTPS dapat dicegat oleh transparent proxy.

Solusinya

Hubungkan ke FreeGuard sebelum operasi git Anda:

freeguard connect --server us-east

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

freeguard disconnect

Untuk pendekatan yang lebih otomatis, bungkus dalam skrip:

#!/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 memastikan VPN terputus bahkan jika skrip gagal di tengah jalan.

Git yang Sadar Proxy

FreeGuard CLI juga dapat mengekspos proxy SOCKS5 atau HTTP lokal. Konfigurasikan git untuk menggunakannya:

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

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

Hapus konfigurasi proxy saat selesai:

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

Tunneling SSH dengan VPN

Akses Server Remote

Saat Anda perlu SSH ke server dari jaringan yang tidak tepercaya, VPN menambahkan lapisan enkripsi sebelum traffic SSH Anda bahkan meninggalkan mesin Anda:

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

ProxyJump melalui VPN

Gabungkan FreeGuard dengan SSH ProxyJump untuk akses multi-hop:

# Hubungkan ke VPN terlebih dahulu
freeguard connect

# Lalu lompat melalui bastion host
ssh -J [email protected] [email protected]

Port Forwarding

Teruskan port remote melalui tunnel VPN:

freeguard connect --server eu-west
ssh -L 5432:db.internal:5432 [email protected]
# Sekarang hubungkan ke localhost:5432 untuk mencapai database remote

Pengembangan API

Pengujian dengan curl

Rutekan request API Anda melalui VPN untuk menguji dari region yang berbeda:

freeguard connect --server jp-tokyo

# Uji respons API spesifik per region
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"

Menggunakan httpie

httpie bekerja dengan cara yang sama. FreeGuard CLI beroperasi di level sistem, jadi semua HTTP client mendapatkan manfaatnya:

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

Mode Proxy untuk Routing Selektif

Jika Anda hanya ingin request tertentu melalui VPN, gunakan proxy lokal:

# Mulai FreeGuard dengan proxy lokal
freeguard connect

# Rute request tertentu melalui proxy
curl --proxy socks5://127.0.0.1:1080 https://api.example.com/endpoint

# Request langsung melewati VPN
curl https://internal.company.com/api

Container Docker + VPN

Jaringan Container melalui VPN

Rutekan traffic container Docker melalui FreeGuard:

# Hubungkan host ke VPN
freeguard connect --server us-east

# Container yang menggunakan host network akan merutekan melalui VPN
docker run --network host my-app:latest

Integrasi Docker Compose

Tambahkan konektivitas VPN ke stack pengembangan Anda:

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

Membangun Image di Balik Jaringan yang Ketat

Saat docker build perlu mengunduh package dari registry yang diblokir atau lambat:

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

Integrasi CI/CD

GitHub Actions

Gunakan FreeGuard CLI di pipeline CI Anda untuk mengakses resource yang dibatasi berdasarkan geografis selama build:

- 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 yang Ramah Skrip

Setiap perintah FreeGuard CLI mendukung --json untuk output yang dapat dibaca mesin dan --no-color untuk file log yang bersih:

# Dapatkan status koneksi sebagai JSON
freeguard status --json
# {"connected": true, "server": "us-east-1", "protocol": "hysteria2", "uptime": 3600}

# Daftar server sebagai JSON untuk pemilihan terprogram
freeguard servers --json --region us | jq '.[0].id'

Exit Code

CLI menggunakan exit code standar yang dapat diperiksa oleh skrip:

Exit Code	Arti
0	Berhasil
1	Kesalahan umum
2	Autentikasi diperlukan
3	Koneksi gagal
4	Server tidak ditemukan

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

Tips untuk Penggunaan Harian

Alias shell — Tambahkan alias vpn="freeguard connect" dan alias vpnoff="freeguard disconnect" ke profil shell Anda.
Auto-connect — Tambahkan freeguard connect ke .zshrc atau .bashrc jika Anda selalu ingin VPN aktif.
Bookmark server — Gunakan freeguard config set default-server us-east untuk melewati flag --server.
Status di prompt — Parse freeguard status --json untuk menampilkan status VPN di shell prompt Anda.

Langkah Selanjutnya

FreeGuard CLI — instalasi dan referensi lengkap perintah
CLI command documentation — referensi detail untuk setiap perintah dan flag
Deploy on headless servers — jalankan FreeGuard CLI sebagai layanan sistem
Pricing — paket yang ramah developer

Terakhir diperbarui: Maret 2026