Работен процес на Terminal Proxy за разработчици
FreeGuard CLI превръща вашия терминал в защитена среда за разработка, като насочва трафика през шифровани VPN тунели. Независимо дали клонирате хранилища от ограничени мрежи, дебъгвате API-та между региони или внедрявате контейнери през защитени канали, CLI се интегрира в инструментите, които вече използвате — git, ssh, curl, docker и още.

Работен процес на Terminal Proxy за разработчици

FreeGuard CLI превръща вашия терминал в защитена среда за разработка, като насочва трафика през шифровани VPN тунели. Независимо дали клонирате хранилища от ограничени мрежи, дебъгвате API-та между региони или внедрявате контейнери през защитени канали, CLI се интегрира в инструментите, които вече използвате — git, ssh, curl, docker и още.

Защо разработчиците се нуждаят от Terminal Proxy

Много задачи по разработка включват мрежов достъп, който се възползва от VPN защита:

  • Достъп до вътрешни API-та от кафенета или летища
  • Тестване на услуги с географски ограничения по време на разработка
  • Изпращане на код през мрежи, които ограничават или инспектират git трафика
  • Свързване с отдалечени сървъри през ограничителни защитни стени
  • Запазване на 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 да го използва:

# 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

Премахнете конфигурацията на 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 за достъп през множество хопове:

# Connect to VPN first
freeguard connect

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

Пренасочване на портове

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

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

Разработка на API

Тестване с curl

Насочвайте вашите API заявки през VPN, за да тествате от различни региони:

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

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

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

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

Ако искате само определени заявки да минават през VPN, използвайте локалния 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 контейнери + VPN

Мрежа на контейнера през VPN

Насочвайте трафика на Docker контейнерите през 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

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

Добавете VPN свързаност към вашия development stack:

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

Изграждане на образи зад ограничителни мрежи

Когато docker build трябва да изтегли пакети от registries, които са блокирани или бавни:

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 за чисти лог файлове:

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

Exit кодове

CLI използва стандартни exit кодове, които скриптовете могат да проверяват:

Exit Code Meaning
0 Успех
1 Обща грешка
2 Изисква се удостоверяване
3 Неуспешна връзка
4 Сървърът не е намерен
freeguard connect --server us-east
if [ $? -eq 0 ]; then
  echo "VPN connected, starting deployment..."
  ./deploy.sh
fi

Съвети за ежедневна употреба

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

Следващи стъпки

  • FreeGuard CLI — инсталация и пълна справка за командите
  • CLI command documentation — подробна справка за всяка команда и флаг
  • Deploy on headless servers — изпълнявайте FreeGuard CLI като системна услуга
  • Pricing — планове, подходящи за разработчици

Последна актуализация: March 2026