FreeGuard for Linux: Command-Line VPN with Rules and GeoIP Routing

FreeGuard Linux 版是专为服务器和开发者打造的命令行客户端：用自定义规则或 GeoIP 按地区分流，用 JSON 输出编写脚本，还能作为 systemd 用户服务运行。在 x86_64 或 arm64 上一条命令即可安装。

Linux 版 FreeGuard 是命令行客户端

单个 Go 程序，会自动为你配置好 mihomo 核心。如需图形界面，请使用 FreeGuard Windows 版或 Mac 版。

freeguard 命令行工具可以在终端里完成登录、选服务器和连接，并管理路由规则和开机自启。它是适用于 x86_64 和 arm64 Linux 的单个 Go 程序，会自动为你配置好 mihomo 核心，服务器、容器、精简系统和开发者的笔记本电脑都能用。

Linux 上没有桌面应用。如果需要图形界面，请使用 FreeGuard 的 Windows 或 Mac 应用。

按你的方式分流：规则分流和 GeoIP 区域分流

自己编写路由规则，或让某个地区的流量直连，连接后还能查看路由摘要。

• 默认规则模式： 由路由规则决定哪些流量走 VPN、哪些直连，freeguard connect 会用通俗的语言输出路由摘要
• 自定义规则： freeguard rule add DOMAIN example.com DIRECT 添加一条规则；rule list、rule remove 和 rule import（从网址或文件导入）用来管理其余规则
• GeoIP 区域分流： freeguard config set geoip_region CN 让某个地区（例如 CN 或 JP）的流量直连，其余流量继续走 VPN
• TUN 模式： freeguard connect --tun 接管整台机器的流量；不开启时，FreeGuard 会提供一个本地代理供应用使用

在 Linux 上安装 FreeGuard

支持三种安装方式：安装脚本、Homebrew 或 GitHub Releases。没有官方的 apt、dnf 或 pacman 软件源。

安装脚本（推荐）：

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

通过 Homebrew 安装：

brew install planetlinkinc/tap/freeguardvpn

直接下载二进制文件： 从 GitHub Releases 下载与你的架构对应的版本。

我们不会通过发行版软件源发布 .deb、.rpm 或 Arch 软件包，因此没有 apt install freeguard、dnf install freeguard 或 pacman -S freeguard。

更多命令行功能

• 协议： anytls、hysteria2 和 trojan，每次连接都可以指定，例如 freeguard connect la2 anytls
• 选择服务器： 用别名连接，如 freeguard connect la2 或 hk1；用 freeguard connect US 连接最佳的美国服务器；或者直接运行 freeguard connect，沿用上次的服务器或自动选择最佳服务器
• 开机自启： freeguard autostart enable 会在 ~/.config/systemd/user/freeguard.service 安装一个 systemd 用户服务（无需以 root 身份运行守护进程）
• 诊断： freeguard doctor 检查你的运行环境
• 状态与监控： freeguard status 和 freeguard monitor 显示实时连接信息
• 脚本化： 给命令加上 --json，即可输出方便脚本和 AI 智能体读取的结果

如何开始使用

1. 步骤 1： 运行 curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh
2. 步骤 2： 运行 freeguard init，用你的 FreeGuard 账户登录
3. 步骤 3： 运行 freeguard connect（或运行 freeguard connect la2 连接指定服务器）

常见问题

FreeGuard 有 Linux 图形界面应用吗？

没有。FreeGuard Linux 版就是 freeguard 命令行客户端。如果需要图形界面，请使用 Windows 或 Mac 应用。

在 Linux 上怎样只让部分流量走 VPN？

使用路由规则或 GeoIP 区域分流。freeguard rule add 可以让指定的域名或 IP 段直连或走 VPN，freeguard config set geoip_region CN 可以让某个地区的流量直连，其余流量继续走 VPN。

Linux 命令行版免费吗？

安装是免费的。连接时使用你的 FreeGuard 订阅；运行 freeguard subscribe list 可以查看套餐。

可以通过发行版的包管理器安装 FreeGuard 吗？

不能通过官方发行版软件源安装。请使用我们的安装脚本（install.sh）、Homebrew，或从 GitHub Releases 下载二进制文件。我们不会发布到 apt、dnf、pacman 或 AUR。

命令行版能在无头服务器和 Docker 中运行吗？

可以。命令行版是一个没有图形界面依赖的 Go 单文件程序，可以在 SSH 会话、容器内以及精简的基础镜像中运行，只要容器具备创建 TUN 设备所需的网络权限即可。

可以开机自动启动 FreeGuard 吗？

可以。freeguard autostart enable 会在 ~/.config/systemd/user/freeguard.service 安装一个 systemd 用户服务。它以你的用户身份运行，而不是作为 root 守护进程。

支持哪些架构和发行版？

支持 x86_64 和 arm64 Linux。命令行版是单个 Go 程序，会自动为你配置好 mihomo 核心，因此较新内核的现代发行版一般都能运行；我们主要在 Ubuntu 和 Debian 上测试。

Linux 命令行版和桌面应用使用相同的协议吗？

是的。anytls、hysteria2 和 trojan 都可以在命令行版中使用，所用的 mihomo 核心与 Windows 和 Mac 应用相同。

如何卸载命令行版？

如果是用安装脚本安装的，请从 /usr/local/bin（或 ~/.local/bin）删除 freeguard 二进制文件，并删除 ~/.freeguard。如果用 Homebrew 安装，请运行 brew uninstall freeguardvpn。如果开启过开机自启，请先运行 freeguard autostart disable。