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 |
登出 |
下一步
- FreeGuard CLI overview — 完整功能列表與文件
- AI Agent Setup — 讓您的 AI 助手代您管理 VPN
- Pricing — 選擇最符合您使用情境的方案
- CLI vs GUI — 不確定該使用哪個用戶端?我們並排比較給您看
Last updated: March 2026