Работен процес на 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
Съвети за ежедневна употреба
- Shell alias — Добавете
alias vpn="freeguard connect"иalias vpnoff="freeguard disconnect"към вашия shell profile. - Автоматично свързване — Добавете
freeguard connectкъм вашия.zshrcили.bashrc, ако винаги искате VPN да е включен. - Сървърни отметки — Използвайте
freeguard config set default-server us-east, за да пропуснете флага--server. - Статус в prompt-а — Парсвайте
freeguard status --json, за да показвате VPN статуса във вашия shell prompt.
Следващи стъпки
- FreeGuard CLI — инсталация и пълна справка за командите
- CLI command documentation — подробна справка за всяка команда и флаг
- Deploy on headless servers — изпълнявайте FreeGuard CLI като системна услуга
- Pricing — планове, подходящи за разработчици
Последна актуализация: March 2026