Päätepisteen Proxy-työnkulku kehittäjille

FreeGuard CLI muuttaa terminaalisi turvalliseksi kehitysympäristöksi reitittämällä liikenteen salattujen VPN-tunnelien kautta. Olipa kyse repositorioiden kloonaamisesta rajoitetuista verkoista, API-rajapintojen virheenkorjauksesta eri alueiden välillä tai konttien käyttöönotosta turvallisten kanavien kautta, CLI integroituu jo käyttämiisi työkaluihin — git, ssh, curl, docker ja muihin.

Miksi kehittäjät tarvitsevat päätepisteen Proxyn

Moniin kehitystehtäviin liittyy verkkoyhteys, joka hyötyy VPN-suojauksesta:

• Sisäisten API-rajapintojen käyttäminen kahviloista tai lentokentiltä
• Maantieteellisesti rajoitettujen palveluiden testaaminen kehityksen aikana
• Koodin työntäminen verkkojen yli, jotka rajoittavat tai tarkastavat git-liikennettä
• Yhdistäminen etäpalvelimiin rajoittavien palomuurien kautta
• CI/CD-tunnistetietojen pitäminen salattuina siirron aikana

FreeGuard CLI hoitaa kaiken tämän ilman, että sinun tarvitsee poistua terminaalista.

Git VPN:n kautta

Ongelma

Yritysverkot, julkinen Wi‑Fi ja jotkin ISP:t hidastavat tai estävät git-toimintoja. SSH-pohjaiset git-yhteydet voidaan merkitä syvällä pakettitarkastuksella. HTTPS-kloonauksia voivat siepata läpinäkyvät proxyt.

Ratkaisu

Yhdistä FreeGuardiin ennen git-toimintoja:

freeguard connect --server us-east

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

freeguard disconnect

Automatisoidumpaa lähestymistapaa varten voit kääriä sen skriptiin:

#!/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 varmistaa, että VPN-yhteys katkaistaan, vaikka skripti epäonnistuisi kesken.

Proxy-tietoinen Git

FreeGuard CLI voi myös tarjota paikallisen SOCKS5- tai HTTP-proxy-palvelun. Määritä git käyttämään sitä:

# 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

Poista proxy-määritys, kun olet valmis:

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

SSH-tunnelointi VPN:n kanssa

Etäpalvelimen käyttö

Kun sinun täytyy muodostaa SSH-yhteys palvelimiin epäluotetuista verkoista, VPN lisää salauskerroksen ennen kuin SSH-liikenne edes poistuu koneeltasi:

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

ProxyJump VPN:n kautta

Yhdistä FreeGuard SSH ProxyJumpiin monivaiheista käyttöä varten:

# Connect to VPN first
freeguard connect

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

Porttiohjaus

Ohjaa etäportit VPN-tunnelin kautta:

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

API-kehitys

Testaus curlilla

Reititä API-pyyntösi VPN:n kautta testataksesi eri alueilta:

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"

httpien käyttäminen

httpie toimii samalla tavalla. FreeGuard CLI toimii järjestelmätasolla, joten kaikki HTTP-asiakkaat hyötyvät siitä:

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

Proxy-tila valikoivaan reititykseen

Jos haluat vain tiettyjen pyyntöjen kulkevan VPN:n kautta, käytä paikallista 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-kontit + VPN

Konttiverkko VPN:n kautta

Reititä Docker-konttien liikenne FreeGuardin kautta:

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

Lisää VPN-yhteys kehityskokonaisuuteesi:

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

Kuvien rakentaminen rajoittavien verkkojen takana

Kun docker buildin täytyy ladata paketteja rekistereistä, jotka ovat estettyjä tai hitaita:

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

CI/CD-integraatio

GitHub Actions

Käytä FreeGuard CLI:tä CI-putkessasi päästäksesi rakennusten aikana maantieteellisesti rajoitettuihin resursseihin:

- 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

Skriptiystävällinen tuloste

Jokainen FreeGuard CLI -komento tukee --json-valitsinta koneluettavaan tulosteeseen ja --no-color-valitsinta siisteihin lokitiedostoihin:

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

Poistumiskoodit

CLI käyttää standardeja poistumiskoodeja, joita skriptit voivat tarkistaa:

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

Vinkkejä päivittäiseen käyttöön

1. Shell-alias — Lisää alias vpn="freeguard connect" ja alias vpnoff="freeguard disconnect" shell-profiiliisi.
2. Automaattinen yhdistäminen — Lisää freeguard connect tiedostoon .zshrc tai .bashrc, jos haluat VPN:n aina päälle.
3. Palvelinmerkit — Käytä freeguard config set default-server us-east ohittaaksesi --server-lipun.
4. Tila kehotteessa — Parsii freeguard status --json näyttääksesi VPN-tilan shell-kehotteessasi.

Seuraavat vaiheet

• FreeGuard CLI — asennus ja kaikkien komentojen viite
• CLI-komentojen dokumentaatio — yksityiskohtainen viite jokaiselle komennolle ja valitsimelle
• Deploy on headless servers — aja FreeGuard CLI:tä järjestelmäpalveluna
• Pricing — kehittäjäystävälliset paketit

Last updated: March 2026