FreeGuard CLI:終端中的 VPN
FreeGuard CLI 是一款免費、開源的命令列 VPN 用戶端,讓您可以直接從終端連接到 VPN 伺服器、管理訂閱,並自動化您的網路安全——全部都能在終端完成。無論您是開發者、系統管理員,還是進階使用者,CLI 都能提供最快、最適合腳本化的方式來保護您的網路連線。

FreeGuard CLI:終端中的 VPN

FreeGuard CLI 是一款免費、開源的命令列 VPN 用戶端,讓您可以直接從終端連接到 VPN 伺服器、管理訂閱,並自動化您的網路安全——全部都能在終端完成。無論您是開發者、系統管理員,還是進階使用者,CLI 都能提供最快、最適合腳本化的方式來保護您的網路連線。

為什麼要使用 CLI VPN 用戶端?

圖形化 VPN 應用程式適合日常使用,但當您需要速度、控制與自動化時,它們就顯得不足。以下是 CLI 方式對技術使用者更有優勢的原因:

極速表現

FreeGuard CLI 可在數秒內連線。沒有 GUI 需要載入,沒有啟動畫面需要等待,也沒有多餘的背景程序。打開終端、輸入一個指令,您就已連線。

freeguard connect

就這麼簡單。您的流量現在已經加密,並透過最快可用的伺服器路由。

可直接用於自動化

需要在執行部署腳本前先連上 VPN?想要每小時輪換伺服器?CLI 可以直接整合到 shell 腳本、cron jobs 和 CI/CD 管線中。

#!/bin/bash
freeguard connect --server us-west
./deploy.sh
freeguard disconnect

支援無頭伺服器

正在執行沒有桌面環境的雲端主機?CLI 在無頭伺服器上也能完美運作。沒有 X11,沒有 Wayland,也沒問題。安裝、驗證、連線。

AI Agent 整合

這正是 FreeGuard CLI 真正與眾不同之處。它從一開始就為了與 Claude Code、Cursor 和 OpenClaw 等 AI 程式設計助理協作而設計。AI agents 可以透過自然對話安裝、設定並管理您的 VPN 連線,無需任何手動步驟。


快速安裝

在任何平台上開始使用都不到一分鐘。

macOS

brew install freeguard/tap/freeguard

Linux (Ubuntu / Debian)

curl -fsSL https://cli.freeguard.com/install.sh | bash

Linux (Other Distributions)

curl -fsSL https://cli.freeguard.com/install.sh | bash

安裝程式會偵測您的發行版,並安裝適當的套件。

Windows

winget install FreeGuard.CLI

驗證安裝

freeguard --version

您應該會在 stdout 中看到版本號。


您的第一次連線

步驟 1:登入

freeguard login

這會開啟您的瀏覽器進行驗證。在無頭伺服器上,請使用以電子郵件為基礎的登入方式:

freeguard login --method email

步驟 2:連線

freeguard connect

FreeGuard 會根據您的位置自動選擇最快的伺服器。若要選擇特定區域:

freeguard connect --server jp-tokyo

步驟 3:驗證

freeguard status

這會顯示您的連線狀態、目前伺服器、協定以及上線時間。

步驟 4:中斷連線

freeguard disconnect

FreeGuard CLI 的不同之處

一條指令完成設定

其他 VPN CLI 需要手動下載設定檔、編輯 YAML,以及管理憑證。FreeGuard CLI 會處理所有事情:

freeguard login && freeguard connect

兩個指令。零設定檔。

為 AI Agents 而生

FreeGuard CLI 是第一個專為 AI 助手操作而設計的 VPN 用戶端。每個指令都支援 --json 輸出與 --no-color 模式,方便機器解析。像 Claude Code 這類平台上的 AI agents 可以在完全沒有人工介入的情況下安裝並管理 FreeGuard。

現代化協定

FreeGuard CLI 開箱即支援 Trojan、Hysteria2 和 AnyTLS 協定。用戶端會根據您的網路狀況自動選擇最佳協定,您也可以手動指定:

freeguard connect --protocol hysteria2

跨平台一致性

相同指令在 macOS、Linux 和 Windows 上都能以相同方式運作。您在 Mac 上撰寫的腳本,可以原封不動地在正式環境伺服器上執行。

開源

此 CLI 用戶端完全開源。您可以審查程式碼、貢獻功能,或分支出來供自己使用。


常用指令一覽

Command Description
freeguard login 驗證您的帳戶
freeguard connect 連線到最快的伺服器
freeguard connect --server <id> 連線到特定伺服器
freeguard disconnect 從 VPN 中斷連線
freeguard status 顯示連線狀態
freeguard servers 列出可用伺服器
freeguard config 檢視或更新設定
freeguard logout 登出

下一步

Last updated: March 2026