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

FreeGuard for Linux is a command-line client for servers and developers: custom routing rules, GeoIP region routing, JSON output and a systemd user service. Install it with one command on x86_64 or arm64.

FreeGuard for Linux 是專為伺服器和開發人員打造的命令列用戶端:您可以使用自己的規則或透過 GeoIP 按地區路由流量,使用 JSON 輸出編寫指令碼,並將其作為 systemd 使用者服務執行。在 x86_64 或 arm64 上,只需一個命令即可安裝。

Linux 上的 FreeGuard 是命令列用戶端

一個 Go 單一執行檔,可為您設定 mihomo 核心。若要使用圖形介面應用程式,請使用 Windows 或 Mac 版 FreeGuard。

freeguard CLI 可在終端機中處理登入、伺服器選擇、連線、路由規則和自動啟動。它是適用於 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(從 URL 或檔案)可管理其餘規則
  • 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。

更多 CLI 功能

  • 協定: 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 圖形介面應用程式嗎?

沒有。Linux 版 FreeGuard 是 freeguard 命令列用戶端。若想使用圖形介面,請使用 Windows 或 Mac 應用程式。

如何在 Linux 上只將部分流量透過 VPN 路由?

使用路由規則或 GeoIP 區域路由。freeguard rule add 會將特定網域或 IP 範圍設為直接連線或經由 VPN 傳送,而 freeguard config set geoip_region CN 會讓某個區域的流量直接連線,其餘流量則維持透過 VPN 傳送。

Linux CLI 免費嗎?

安裝免費。連線需使用您的 FreeGuard 訂閱;執行 freeguard subscribe list 查看方案。

我可以從發行版的套件管理員安裝 FreeGuard 嗎?

無法從官方發行版套件庫安裝。請使用我們的安裝指令碼 (install.sh)、Homebrew,或 GitHub Releases 上的二進位檔。我們不會發布到 apt、dnf、pacman 或 AUR。

CLI 能在無頭伺服器和 Docker 上執行嗎?

是。CLI 是單一 Go 二進位檔,沒有 GUI 相依項目。只要容器具備建立 TUN 裝置所需的網路能力,CLI 就能透過 SSH、在容器內以及精簡基礎映像中執行。

我可以讓 FreeGuard 在開機時自動啟動嗎?

是。freeguard autostart enable 會在 ~/.config/systemd/user/freeguard.service 安裝 systemd 使用者服務。它會以您的使用者身分執行,而非作為 root 常駐程式執行。

支援哪些架構與發行版?

x86_64 和 arm64 Linux。CLI 是單一 Go 二進位檔,會為您設定 mihomo 核心,因此任何使用近期核心的現代發行版應該都能運作;我們主要在 Ubuntu 和 Debian 上進行測試。

Linux CLI 是否使用與桌面應用程式相同的通訊協定?

是的。anytls、hysteria2 和 trojan 都可在 CLI 中使用,且使用與 Windows 和 Mac 應用程式相同的 mihomo 核心。

如何解除安裝 CLI?

如果您使用安裝指令碼,請從 /usr/local/bin(或 ~/.local/bin)移除 freeguard 二進位檔,並刪除 ~/.freeguard。使用 Homebrew 安裝的話,請執行 brew uninstall freeguardvpn。如果您啟用了自動啟動,請先執行 freeguard autostart disable。

最後驗證:2026-05-22