FreeGuard CLI Khởi động nhanh

FreeGuard CLI là một VPN client dòng lệnh kết nối chỉ với một lệnh. Cài đặt trên macOS, Linux, hoặc Windows, đăng nhập bằng email của bạn, và chạy freeguard connect để bảo vệ internet của bạn trong chưa đầy 5 phút.

Cài đặt

macOS và Linux

Cài đặt bằng một lệnh duy nhất:

curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh

Hoặc dùng Homebrew trên macOS:

brew install freeguardvpn/tap/freeguard

Sau khi cài đặt, xác minh rằng nó hoạt động:

freeguard version

Kết quả mong đợi:

FreeGuard CLI v1.0.0
Core: mihomo v1.19.21
OS: darwin/arm64

Windows

Mở PowerShell với quyền Administrator và chạy:

irm https://downloadcli.freeguardvpn.com/cli/install.ps1 | iex

Sau khi cài đặt, khởi động lại terminal của bạn và chạy freeguard version để xác nhận.

Đăng nhập

FreeGuard CLI sử dụng xác minh qua email — không cần đăng ký tài khoản.

freeguard login --email [email protected] --send-code

Bạn sẽ nhận được mã xác minh 6 chữ số qua email. Nhập mã đó:

freeguard login --email [email protected] --code 123456

Ví dụ đầu ra:

✓ Đăng nhập thành công!
✓ Tìm thấy 1 gói đăng ký đang hoạt động (Pro Plan, hết hạn 2026-12-01)
✓ Cấu hình đã được tạo: ~/.freeguard/profiles/default.yaml

Nếu bạn có tài khoản FreeGuard, bạn cũng có thể đăng nhập qua trình duyệt:

freeguard login --account

Thao tác này sẽ mở trình duyệt của bạn để xác thực OAuth và tự động trả về một token.

Kết nối

Kết nối đến server nhanh nhất hiện có chỉ với một lệnh:

freeguard connect

Ví dụ đầu ra:

✓ Đã kết nối tới United States - New York (us-new-01)
  Protocol: anytls | Latency: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

Để kết nối đến một quốc gia cụ thể:

freeguard connect --country JP

Để kết nối đến một node cụ thể:

freeguard connect jp-tok-01

Xác minh

Kiểm tra rằng kết nối của bạn đang hoạt động:

freeguard status

Ví dụ đầu ra:

FreeGuard VPN Status
────────────────────
Status:     ● Connected
Node:       United States - New York (us-new-01)
Protocol:   anytls
Latency:    42ms
Upload:     1.2 MB/s
Download:   15.8 MB/s
Duration:   2h 15m
Mode:       System Proxy (HTTP/SOCKS5)

Để lấy đầu ra có thể đọc bằng máy (hữu ích cho scripting hoặc AI agents):

freeguard status --json

{
  "connected": true,
  "node": {"id": "us-new-01", "name": "United States - New York", "country": "US"},
  "protocol": "anytls",
  "latency_ms": 42,
  "traffic": {"upload_bps": 1258291, "download_bps": 16569754},
  "duration_seconds": 8100,
  "mode": "system_proxy",
  "proxy_port": {"mixed": 7890}
}

Bước tiếp theo

CLI Commands Reference — Danh sách đầy đủ tất cả lệnh, cờ, và định dạng đầu ra.
CLI Troubleshooting — Giải pháp cho các vấn đề thường gặp về cài đặt, đăng nhập, và kết nối.
FreeGuard CLI Agent — Để AI tự động chẩn đoán và sửa lỗi cho bạn.
Chạy freeguard --help để khám phá tất cả các lệnh có sẵn từ terminal của bạn.

Câu hỏi thường gặp

Làm sao để cài đặt FreeGuard CLI trên hệ thống của tôi?

Chạy curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh trên macOS hoặc Linux. Trên macOS, bạn cũng có thể dùng brew install freeguard. Trình cài đặt sẽ tự động nhận diện OS và kiến trúc của bạn.

Tôi có thể dùng FreeGuard CLI mà không cần GUI không?

Có. FreeGuard CLI hoàn toàn headless — nó chạy hoàn toàn trong terminal mà không cần giao diện đồ họa. Điều này làm cho nó lý tưởng cho server, container, và các phiên SSH từ xa.

Làm sao để chuyển đổi VPN protocols bằng CLI?

Dùng freeguard connect --protocol <name>. Các protocols được hỗ trợ bao gồm Hysteria2, Anytls, và Trojan. CLI mặc định sẽ dùng protocol nhanh nhất hiện có cho mạng của bạn.

FreeGuard CLI có hoạt động trên các thiết bị ARM như Raspberry Pi không?

Có. CLI hỗ trợ kiến trúc arm64 và armv7. Script cài đặt sẽ tự động nhận diện nền tảng của bạn và tải xuống binary phù hợp.

Lần cập nhật cuối: March 2026