Работен тек на Terminal Proxy за развивачи

FreeGuard CLI го претвора вашиот терминал во безбедна развојна средина со насочување на сообраќајот низ шифрирани VPN тунели. Без разлика дали клонирате складишта од ограничени мрежи, дебагирате API-и низ региони или распоредувате контејнери преку безбедни канали, CLI се интегрира со алатките што веќе ги користите — git, ssh, curl, docker и други.

Зошто на развивачите им треба Terminal Proxy

Многу развојни задачи вклучуваат мрежен пристап што има корист од VPN заштита:

• Пристап до внатрешни API-и од кафулиња или аеродроми
• Тестирање на услуги со гео-ограничување за време на развој
• Испраќање код преку мрежи што го ограничуваат или инспектираат git сообраќајот
• Поврзување со оддалечени сервери преку рестриктивни firewalls
• Чување на CI/CD акредитиви шифрирани при пренос

FreeGuard CLI се справува со сето ова без да го напуштите терминалот.

Git преку VPN

Проблемот

Корпоративни мрежи, јавен Wi‑Fi и некои ISP-ови го ограничуваат или блокираат git работењето. SSH-базирани git врски може да бидат означени од deep packet inspection. HTTPS клонирања може да бидат пресретнати од транспарентни Proxy.

Решението

Поврзете се со FreeGuard пред вашите git операции:

freeguard connect --server us-east

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

freeguard disconnect

За поавтоматизиран пристап, завиткајте го во скрипта:

#!/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 осигурува VPN да се исклучи дури и ако скриптата не успее на половина пат.

Git свесен за Proxy

FreeGuard CLI може да изложи и локален SOCKS5 или HTTP Proxy. Конфигурирајте git да го користи:

# Постави Proxy за git глобално
git config --global http.proxy socks5://127.0.0.1:1080
git config --global https.proxy socks5://127.0.0.1:1080

# Или по складиште
git config http.proxy socks5://127.0.0.1:1080

Отстранете ја Proxy конфигурацијата кога ќе завршите:

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

SSH тунелирање со VPN

Пристап до оддалечен сервер

Кога треба да SSH-увате во сервери од непоуздани мрежи, VPN додава слој на шифрирање пред вашиот SSH сообраќај воопшто да ја напушти вашата машина:

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

ProxyJump преку VPN

Комбинирајте FreeGuard со SSH ProxyJump за повеќескоковски пристап:

# Прво поврзете се со VPN
freeguard connect

# Потоа скокнете преку bastion host
ssh -J [email protected] [email protected]

Пренасочување порти

Пренасочувајте оддалечени порти низ VPN тунелот:

freeguard connect --server eu-west
ssh -L 5432:db.internal:5432 [email protected]
# Сега поврзете се на localhost:5432 за да стигнете до оддалечената база на податоци

Развој на API

Тестирање со curl

Насочете ги вашите API барања преку VPN за тестирање од различни региони:

freeguard connect --server jp-tokyo

# Тестирај гео-специфични API одговори
curl -s https://api.example.com/v1/content | jq '.region'
# Излез: "ap-northeast-1"

freeguard connect --server de-frankfurt
curl -s https://api.example.com/v1/content | jq '.region'
# Излез: "eu-central-1"

Користење на httpie

httpie работи на ист начин. FreeGuard CLI работи на системско ниво, па сите HTTP клиенти имаат корист:

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

Proxy режим за селективно насочување

Ако сакате само одредени барања да одат преку VPN, користете го локалниот Proxy:

# Стартувај FreeGuard со локален Proxy
freeguard connect

# Насочи специфични барања преку Proxy
curl --proxy socks5://127.0.0.1:1080 https://api.example.com/endpoint

# Директните барања го заобиколуваат VPN
curl https://internal.company.com/api

Docker контејнери + VPN

Мрежа на контејнер преку VPN

Насочете го сообраќајот на Docker контејнерите преку FreeGuard:

# Поврзи го host-от со VPN
freeguard connect --server us-east

# Контејнерите што користат host network ќе се насочуваат преку VPN
docker run --network host my-app:latest

Интеграција со Docker Compose

Додајте VPN поврзување во вашиот развоен стек:

#!/bin/bash
# dev-start.sh
freeguard connect --server us-east --json | jq -r '.status'
docker compose up -d
echo "Развојниот стек работи преку VPN"

Градење слики зад рестриктивни мрежи

Кога docker build треба да преземе пакети од registry-ја што се блокирани или бавни:

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

CI/CD интеграција

GitHub Actions

Користете FreeGuard CLI во вашиот CI pipeline за пристап до гео-ограничени ресурси за време на 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

Излез погоден за скрипти

Секоја FreeGuard CLI команда поддржува --json за машински читлив излез и --no-color за чисти log-датотеки:

# Добиј статус на поврзување како JSON
freeguard status --json
# {"connected": true, "server": "us-east-1", "protocol": "hysteria2", "uptime": 3600}

# Листа на сервери како JSON за програмски избор
freeguard servers --json --region us | jq '.[0].id'

Излезни кодови

CLI користи стандардни exit codes што скриптите може да ги проверуваат:

freeguard connect --server us-east
if [ $? -eq 0 ]; then
  echo "VPN поврзан, почнува распоредувањето..."
  ./deploy.sh
fi

Совети за секојдневна употреба

1. Shell alias — Додајте alias vpn="freeguard connect" и alias vpnoff="freeguard disconnect" во вашиот shell профил.
2. Автоматско поврзување — Додајте freeguard connect во вашите .zshrc или .bashrc ако секогаш сакате VPN да биде вклучен.
3. Обележувачи на сервери — Користете freeguard config set default-server us-east за да го прескокнете --server flag-от.
4. Статус во prompt-от — Парсирајте freeguard status --json за да го прикажете VPN статусот во вашиот shell prompt.

Следни чекори

• FreeGuard CLI — инсталација и целосна референца на команди
• CLI command documentation — детална референца за секоја команда и flag
• Deploy on headless servers — стартувајте FreeGuard CLI како системска услуга
• Pricing — планови погодни за развивачи

Last updated: March 2026