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 для Linux — клиент командной строки, созданный для серверов и разработчиков: направляйте трафик по собственным правилам или по регионам с помощью GeoIP, используйте его в сценариях с выводом JSON и запускайте как пользовательскую службу systemd. Установите его одной командой на x86_64 или arm64.

FreeGuard в Linux — клиент командной строки

Один исполняемый файл Go, который самостоятельно настраивает ядро mihomo. Для графического приложения используйте FreeGuard для Windows или Mac.

CLI freeguard позволяет входить в аккаунт, выбирать сервер, подключаться, настраивать правила маршрутизации и автозапуск из терминала. Это единый бинарный файл Go для Linux на x86_64 и arm64, который самостоятельно настраивает ядро mihomo. Он подходит для серверов, контейнеров и минимальных установок, а также для ноутбуков разработчиков.

Приложения FreeGuard для 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 предоставляет локальный прокси, которым могут пользоваться ваши приложения

Установка FreeGuard в Linux

Три поддерживаемых способа установки: наш установочный скрипт, 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 устанавливает службу systemd пользователя в ~/.config/systemd/user/freeguard.service (демон root не требуется)
  • Диагностика: freeguard doctor проверяет вашу среду
  • Состояние и мониторинг: freeguard status и freeguard monitor показывают актуальную информацию о подключении
  • Скрипты: добавьте --json к команде, чтобы получить вывод, читаемый скриптами и ИИ-агентами

Как начать работу

  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.

Как направить через VPN только часть трафика в Linux?

Используйте правила маршрутизации или маршрутизацию по региону GeoIP. freeguard rule add направляет трафик определенных доменов или диапазонов IP напрямую или через VPN, а freeguard config set geoip_region CN направляет трафик одного региона напрямую, оставляя остальной трафик в VPN.

Бесплатен ли CLI для Linux?

Установка бесплатна. Для подключения используется ваша подписка FreeGuard; выполните freeguard subscribe list, чтобы посмотреть тарифы.

Можно ли установить FreeGuard с помощью менеджера пакетов моего дистрибутива?

Не из официальных репозиториев дистрибутива. Используйте наш установочный скрипт (install.sh), Homebrew или бинарный файл из GitHub Releases. Мы не публикуем пакеты в apt, dnf, pacman или AUR.

Работает ли CLI на серверах без графического интерфейса и в Docker?

Да. CLI — это отдельный бинарный файл на Go без зависимостей от графического интерфейса. Он работает через SSH, внутри контейнеров и на минимальных базовых образах, если у контейнера есть необходимые сетевые возможности для создания устройства TUN.

Можно ли запускать FreeGuard автоматически при загрузке?

Да. freeguard autostart enable устанавливает пользовательскую службу systemd по адресу ~/.config/systemd/user/freeguard.service. Она запускается от имени вашего пользователя, а не как демон root.

Какие архитектуры и дистрибутивы поддерживаются?

Linux с архитектурами x86_64 и arm64. CLI — это один бинарный файл Go, который самостоятельно настраивает ядро mihomo, поэтому должна подойти любая современная дистрибуция с актуальной версией ядра; мы в основном тестируем Ubuntu и Debian.

Использует ли CLI для Linux те же протоколы, что и настольные приложения?

Да. anytls, hysteria2 и trojan работают в CLI на том же ядре mihomo, которое используют приложения для Windows и Mac.

Как удалить CLI?

Если вы использовали скрипт установки, удалите бинарный файл freeguard из /usr/local/bin (или ~/.local/bin) и удалите ~/.freeguard. Если вы использовали Homebrew, выполните команду brew uninstall freeguardvpn. Если вы включили автозапуск, сначала выполните команду freeguard autostart disable.

Последняя проверка: 2026-05-22