FreeGuard VPN
首页VPN 节点价格
FreeGuard CLI 快速开始
FreeGuard CLI 是一个命令行 VPN 客户端，只需一条命令即可连接。将其安装到 macOS、Linux 或 Windows 上，使用你的电子邮件登录，然后运行 `freeguard connect`，即可在 5 分钟内保护你的网络连接。
目录

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

示例输出：

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

如果你有 FreeGuard 账户，也可以通过浏览器登录：

freeguard login --account

这会打开浏览器进行 OAuth 身份验证，并自动返回一个令牌。

连接

只需一条命令即可连接到当前最快的可用服务器：

freeguard connect

示例输出：

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

连接到指定国家：

freeguard connect --country JP

连接到指定节点：

freeguard connect jp-tok-01

验证

检查你的连接是否处于活动状态：

freeguard status

示例输出：

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)

要获取机器可读的输出（适用于脚本或 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}
}

下一步

  • 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 月