Quy trình Terminal Proxy cho Nhà phát triển

FreeGuard CLI biến terminal của bạn thành một môi trường phát triển an toàn bằng cách định tuyến lưu lượng qua các tunnel VPN được mã hóa. Dù bạn đang clone repository từ các mạng bị hạn chế, gỡ lỗi API xuyên khu vực, hay triển khai container qua các kênh an toàn, CLI tích hợp vào những công cụ bạn đã dùng — git, ssh, curl, docker, và nhiều hơn nữa.

Vì sao Nhà phát triển Cần Terminal Proxy

Nhiều tác vụ phát triển liên quan đến truy cập mạng và được hưởng lợi từ bảo vệ VPN:

Truy cập các API nội bộ từ quán cà phê hoặc sân bay
Kiểm thử các dịch vụ bị giới hạn theo khu vực trong quá trình phát triển
Push code qua các mạng giới hạn hoặc kiểm tra lưu lượng git
Kết nối tới máy chủ từ xa qua các firewall hạn chế
Giữ mã hóa thông tin xác thực CI/CD trong quá trình truyền

FreeGuard CLI xử lý tất cả những việc này mà không cần rời khỏi terminal của bạn.

Git Qua VPN

Vấn đề

Các mạng doanh nghiệp, Wi-Fi công cộng và một số ISP sẽ giới hạn hoặc chặn các thao tác git. Các kết nối git dựa trên SSH có thể bị đánh dấu bởi deep packet inspection. Các bản clone HTTPS có thể bị chặn bởi transparent proxies.

Giải pháp

Kết nối với FreeGuard trước khi thực hiện các thao tác 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

Để tự động hóa hơn, hãy bọc nó trong một script:

#!/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 đảm bảo VPN sẽ ngắt kết nối ngay cả khi script thất bại giữa chừng.

Git Nhận biết Proxy

FreeGuard CLI cũng có thể hiển thị một local SOCKS5 hoặc HTTP proxy. Cấu hình git để sử dụng nó:

# 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

Xóa cấu hình proxy khi xong:

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

SSH Tunneling với VPN

Truy cập Máy chủ Từ xa

Khi bạn cần SSH vào máy chủ từ các mạng không đáng tin cậy, VPN sẽ thêm một lớp mã hóa trước khi lưu lượng SSH của bạn rời khỏi máy:

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

ProxyJump Qua VPN

Kết hợp FreeGuard với SSH ProxyJump để truy cập nhiều bước:

# Connect to VPN first
freeguard connect

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

Chuyển tiếp Cổng

Chuyển tiếp các cổng từ xa qua tunnel VPN:

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

Phát triển API

Kiểm thử với curl

Định tuyến các yêu cầu API của bạn qua VPN để kiểm thử từ các khu vực khác nhau:

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"

Sử dụng httpie

httpie hoạt động theo cùng một cách. FreeGuard CLI hoạt động ở cấp hệ thống, vì vậy tất cả HTTP clients đều được hưởng lợi:

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

Chế độ Proxy cho Định tuyến Có chọn lọc

Nếu bạn chỉ muốn một số yêu cầu nhất định đi qua VPN, hãy dùng local 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 Containers + VPN

Lưu lượng Mạng của Container qua VPN

Định tuyến lưu lượng Docker container qua 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

Tích hợp Docker Compose

Thêm khả năng kết nối VPN vào stack phát triển của bạn:

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

Xây dựng Image sau các Mạng Hạn chế

Khi docker build cần tải package từ các registry bị chặn hoặc chậm:

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

Tích hợp CI/CD

GitHub Actions

Sử dụng FreeGuard CLI trong pipeline CI của bạn để truy cập các tài nguyên bị giới hạn theo khu vực trong quá trình 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

Đầu ra Thân thiện với Script

Mọi lệnh FreeGuard CLI đều hỗ trợ --json để có đầu ra đọc được bởi máy và --no-color cho các file log gọn gàng:

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

Mã Thoát

CLI sử dụng các exit code tiêu chuẩn mà script có thể kiểm tra:

Exit Code	Ý nghĩa
0	Thành công
1	Lỗi chung
2	Cần xác thực
3	Kết nối thất bại
4	Không tìm thấy máy chủ

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

Mẹo cho Việc Sử dụng Hằng ngày

Shell alias — Thêm alias vpn="freeguard connect" và alias vpnoff="freeguard disconnect" vào shell profile của bạn.
Tự động kết nối — Thêm freeguard connect vào .zshrc hoặc .bashrc nếu bạn luôn muốn bật VPN.
Dấu trang máy chủ — Dùng freeguard config set default-server us-east để bỏ qua cờ --server.
Trạng thái trong prompt — Phân tích freeguard status --json để hiển thị trạng thái VPN trong shell prompt của bạn.

Các Bước Tiếp theo

FreeGuard CLI — cài đặt và tài liệu tham khảo đầy đủ các lệnh
CLI command documentation — tài liệu tham khảo chi tiết cho mọi lệnh và cờ
Deploy on headless servers — chạy FreeGuard CLI như một system service
Pricing — các gói thân thiện với nhà phát triển

Cập nhật lần cuối: March 2026