FreeGuard VPN
HomeVPN 節點「定價」
FreeGuard CLI 快速入門
FreeGuard CLI 是一個命令列 VPN 用戶端，只需一條命令即可連線。將其安裝在 macOS、Linux 或 Windows 上，使用您的電子郵件登入，並執行 `freeguard connect`，即可在不到 5 分鐘內保護您的網路。
Table of Contents

FreeGuard CLI 快速入門

FreeGuard CLI 是一個命令列 VPN 用戶端，只需一條命令即可連線。將其安裝在 macOS、Linux 或 Windows 上，使用您的電子郵件登入，並執行 freeguard connect，即可在不到 5 分鐘內保護您的網路。

安裝

macOS 和 Linux

使用單一命令安裝：

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

或者在 macOS 上使用 Homebrew：

brew install freeguardvpn/tap/freeguard

安裝完成後，確認是否成功：

freeguard version

預期輸出：

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

Windows

以系統管理員身分開啟 PowerShell，並執行：

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

安裝完成後，重新啟動您的終端機，並執行 freeguard version 以確認。

登入

FreeGuard CLI 使用基於電子郵件的驗證 — 無需註冊帳戶。

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

您將會在電子郵件中收到一組 6 位數驗證碼。輸入它：

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

範例輸出：

✓ 成功登入！
✓ 找到 1 個有效訂閱（Pro Plan，於 2026-12-01 到期）
✓ 已產生設定：~/.freeguard/profiles/default.yaml

如果您有 FreeGuard 帳戶，也可以透過瀏覽器登入：

freeguard login --account

這會開啟您的瀏覽器進行 OAuth 驗證，並自動回傳權杖。

連線

使用一條命令連線到最快可用的伺服器：

freeguard connect

範例輸出：

✓ 已連線至 United States - New York (us-new-01)
  Protocol: anytls | 延遲: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

若要連線到特定國家：

freeguard connect --country JP

若要連線到特定節點：

freeguard connect jp-tok-01

驗證

檢查您的連線是否已啟用：

freeguard status

範例輸出：

FreeGuard VPN 狀態
────────────────────
Status:     ● 已連線
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)

若要取得可供機器讀取的輸出（適合用於腳本或 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}
}

後續步驟

  • CLI 指令參考 — 所有指令、旗標與輸出格式的完整清單。
  • CLI 疑難排解 — 常見安裝、登入與連線問題的解決方案。
  • FreeGuard CLI Agent — 讓 AI 自動為您診斷並修正問題。
  • 執行 freeguard --help，從您的終端機探索所有可用指令。

常見問題

如何在我的系統上安裝 FreeGuard CLI？

在 macOS 或 Linux 上執行 curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh。在 macOS 上，您也可以使用 brew install freeguard。安裝程式會自動偵測您的作業系統與架構。

我可以在沒有 GUI 的情況下使用 FreeGuard CLI 嗎？

可以。FreeGuard CLI 是完全無頭模式 — 它完全在終端機中執行，不需要圖形介面。這使它非常適合伺服器、容器與遠端 SSH 工作階段。

如何使用 CLI 切換 VPN 協定？

使用 freeguard connect --protocol <name>。支援的協定包括 Hysteria2、Anytls 和 Trojan。CLI 預設會使用您網路上最快可用的協定。

FreeGuard CLI 是否可在 Raspberry Pi 之類的 ARM 裝置上運作？

可以。CLI 支援 arm64 與 armv7 架構。安裝指令碼會自動偵測您的平台並下載正確的二進位檔。

最後更新：2026 年 3 月