FreeGuard CLI Quick Start

FreeGuard CLI adalah klien VPN baris perintah yang terhubung dengan satu perintah. Instal di macOS, Linux, atau Windows, login dengan email Anda, dan jalankan freeguard connect untuk mengamankan internet Anda dalam waktu kurang dari 5 menit.

Installation

macOS and Linux

Instal dengan satu perintah:

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

Atau gunakan Homebrew di macOS:

brew install freeguardvpn/tap/freeguard

Setelah instalasi, verifikasi bahwa semuanya berhasil:

freeguard version

Expected output:

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

Windows

Buka PowerShell sebagai Administrator dan jalankan:

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

Setelah instalasi, restart terminal Anda dan jalankan freeguard version untuk mengonfirmasi.

Login

FreeGuard CLI menggunakan verifikasi berbasis email — tidak perlu registrasi akun.

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

Anda akan menerima kode verifikasi 6 digit di email Anda. Masukkan kode tersebut:

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

Contoh output:

✓ Logged in successfully!
✓ Found 1 active subscription (Pro Plan, expires 2026-12-01)
✓ Configuration generated: ~/.freeguard/profiles/default.yaml

Jika Anda memiliki akun FreeGuard, Anda juga bisa login melalui browser:

freeguard login --account

Ini akan membuka browser Anda untuk autentikasi OAuth dan mengembalikan token secara otomatis.

Connect

Terhubung ke server tercepat yang tersedia dengan satu perintah:

freeguard connect

Contoh output:

✓ Connected to United States - New York (us-new-01)
  Protocol: anytls | Latency: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

Untuk terhubung ke negara tertentu:

freeguard connect --country JP

Untuk terhubung ke node tertentu:

freeguard connect jp-tok-01

Verify

Periksa bahwa koneksi Anda aktif:

freeguard status

Contoh output:

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)

Untuk mendapatkan output yang dapat dibaca mesin (berguna untuk scripting atau agen AI):

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}
}

Next Steps

• CLI Commands Reference — Daftar lengkap semua perintah, flag, dan format output.
• CLI Troubleshooting — Solusi untuk masalah umum instalasi, login, dan koneksi.
• FreeGuard CLI Agent — Biarkan AI mendiagnosis dan memperbaiki masalah untuk Anda secara otomatis.
• Jalankan freeguard --help untuk menjelajahi semua perintah yang tersedia dari terminal Anda.

Frequently Asked Questions

How do I install FreeGuard CLI on my system?

Jalankan curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh di macOS atau Linux. Di macOS, Anda juga bisa menggunakan brew install freeguard. Installer akan mendeteksi OS dan arsitektur Anda secara otomatis.

Can I use FreeGuard CLI without a GUI?

Ya. FreeGuard CLI sepenuhnya headless — berjalan sepenuhnya di terminal tanpa memerlukan antarmuka grafis. Ini menjadikannya ideal untuk server, container, dan sesi SSH jarak jauh.

How do I switch VPN protocols with the CLI?

Gunakan freeguard connect --protocol <name>. Protokol yang didukung mencakup Hysteria2, Anytls, dan Trojan. CLI secara default akan memilih protokol tercepat yang tersedia untuk jaringan Anda.

Does FreeGuard CLI work on ARM devices like Raspberry Pi?

Ya. CLI mendukung arsitektur arm64 dan armv7. Skrip instalasi akan mendeteksi platform Anda secara otomatis dan mengunduh binary yang sesuai.

Last updated: March 2026