Aliran Kerja Proxy Terminal untuk Pembangun

FreeGuard CLI menukar terminal anda menjadi persekitaran pembangunan yang selamat dengan menghalakan trafik melalui terowong VPN yang disulitkan. Sama ada anda sedang mengklon repositori dari rangkaian yang dihadkan, menyahpepijat API merentas rantau, atau menyebarkan kontena melalui saluran selamat, CLI berintegrasi dengan alat yang anda sudah gunakan — git, ssh, curl, docker, dan banyak lagi.

Mengapa Pembangun Memerlukan Proxy Terminal

Banyak tugas pembangunan melibatkan akses rangkaian yang mendapat manfaat daripada perlindungan VPN:

Mengakses API dalaman dari kedai kopi atau lapangan terbang
Menguji perkhidmatan yang dihadkan mengikut geolokasi semasa pembangunan
Menolak kod melalui rangkaian yang mengehadkan atau memeriksa trafik git
Menyambung ke pelayan jauh melalui firewall yang ketat
Mengekalkan kelayakan CI/CD yang disulitkan semasa penghantaran

FreeGuard CLI mengendalikan semua ini tanpa meninggalkan terminal anda.

Git Melalui VPN

Masalah

Rangkaian korporat, Wi-Fi awam, dan sesetengah ISP mengehadkan atau menyekat operasi git. Sambungan git berasaskan SSH boleh ditandai oleh deep packet inspection. Klon HTTPS mungkin dipintas oleh proxy telus.

Penyelesaian

Sambung 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 automatik, bungkusnya 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 sambungannya walaupun skrip gagal di tengah jalan.

Git yang Sedar Proxy

FreeGuard CLI juga boleh mendedahkan proxy SOCKS5 atau HTTP tempatan. Konfigurasikan git untuk menggunakannya:

# 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

Buang konfigurasi proxy apabila selesai:

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

Terowong SSH dengan VPN

Akses Pelayan Jauh

Apabila anda perlu SSH ke dalam pelayan dari rangkaian yang tidak dipercayai, VPN menambah lapisan penyulitan sebelum trafik SSH anda meninggalkan mesin anda:

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

ProxyJump Melalui VPN

Gabungkan FreeGuard dengan SSH ProxyJump untuk akses berbilang hop:

# Connect to VPN first
freeguard connect

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

Pengalihan Port

Alihkan port jauh melalui terowong VPN:

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

Pembangunan API

Pengujian dengan curl

Halakan permintaan API anda melalui VPN untuk menguji dari pelbagai rantau:

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"

Menggunakan httpie

httpie berfungsi dengan cara yang sama. FreeGuard CLI beroperasi pada tahap sistem, jadi semua klien HTTP mendapat manfaat:

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

Mod Proxy untuk Penghalaan Terpilih

Jika anda hanya mahu permintaan tertentu melalui VPN, gunakan proxy tempatan:

# 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

Kontena Docker + VPN

Trafik Rangkaian Kontena Melalui VPN

Halakan trafik kontena Docker melalui 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

Integrasi Docker Compose

Tambahkan sambungan VPN ke tindanan pembangunan 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"

Membina Imej di Sebalik Rangkaian yang Ketat

Apabila docker build perlu memuat turun pakej dari registri yang disekat atau perlahan:

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

Integrasi CI/CD

GitHub Actions

Gunakan FreeGuard CLI dalam saluran CI anda untuk mengakses sumber yang dihadkan mengikut geolokasi semasa binaan:

- 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 Mesra Skrip

Setiap arahan FreeGuard CLI menyokong --json untuk output yang boleh dibaca mesin dan --no-color untuk fail log yang bersih:

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

Kod Keluar

CLI menggunakan kod keluar standard yang boleh diperiksa oleh skrip:

Exit Code	Meaning
0	Berjaya
1	Ralat umum
2	Pengesahan diperlukan
3	Sambungan gagal
4	Pelayan tidak ditemui

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

Petua untuk Penggunaan Harian

Alias shell — Tambahkan alias vpn="freeguard connect" dan alias vpnoff="freeguard disconnect" ke profil shell anda.
Sambung automatik — Tambahkan freeguard connect ke .zshrc atau .bashrc anda jika anda mahu VPN sentiasa aktif.
Penanda halaman pelayan — Gunakan freeguard config set default-server us-east untuk melangkau bendera --server.
Status dalam prompt — Parse freeguard status --json untuk memaparkan status VPN dalam prompt shell anda.

Langkah Seterusnya

FreeGuard CLI — pemasangan dan rujukan penuh arahan
CLI command documentation — rujukan terperinci untuk setiap arahan dan bendera
Deploy on headless servers — jalankan FreeGuard CLI sebagai perkhidmatan sistem
Pricing — pelan mesra pembangun

Last updated: March 2026