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 |
退出登录 |
下一步
- FreeGuard CLI overview — 完整功能列表和文档
- AI Agent Setup — 让你的 AI 助手为你管理 VPN
- Pricing — 选择适合你使用情况的套餐
- CLI vs GUI — 不确定该使用哪个客户端?我们会并排对比它们
最后更新:2026 年 3 月