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 任务和 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 Agent 可以通过自然对话来安装、配置和管理你的 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 Agent 而生

FreeGuard CLI 是首个专为 AI 助手操作而设计的 VPN 客户端。每条命令都支持 --json 输出和 --no-color 模式,便于机器解析。在 Claude Code 等平台上的 AI Agent 可以在无人干预的情况下安装并管理 FreeGuard。

现代协议

FreeGuard CLI 开箱即支持 Trojan、Hysteria2 和 AnyTLS 协议。客户端会根据你的网络条件自动选择最佳协议,或者你也可以手动指定:

freeguard connect --protocol hysteria2

跨平台一致性

在 macOS、Linux 和 Windows 上,相同的命令都能以一致的方式工作。你在 Mac 上编写的脚本,可以原封不动地运行在生产服务器上。

开源

该 CLI 客户端完全开源。你可以审计代码、贡献功能,或基于它 fork 出适合自己使用的版本。


常用命令一览

Command Description
freeguard login 验证你的账户
freeguard connect 连接到最快的服务器
freeguard connect --server <id> 连接到指定服务器
freeguard disconnect 断开 VPN 连接
freeguard status 显示连接状态
freeguard servers 列出可用服务器
freeguard config 查看或更新设置
freeguard logout 退出登录

下一步

最后更新:2026 年 3 月