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

Linux 向け FreeGuard は、サーバーや開発者向けに構築されたコマンドラインクライアントです。独自のルールまたは GeoIP による地域指定でトラフィックをルーティングし、JSON 出力でスクリプト化して、systemd のユーザーサービスとして実行できます。x86_64 または arm64 では、1 つのコマンドでインストールできます。

Linux版FreeGuardはコマンドラインクライアントです

mihomoコアをセットアップする単一のGoバイナリです。グラフィカルアプリをお使いの場合は、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をインストール

対応しているインストール方法は3つあります。インストールスクリプト、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。接続ごとに1つ選択します。例: 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向けGUIアプリケーションがありますか？

いいえ。Linux版FreeGuardは、freeguardコマンドラインクライアントです。グラフィカルインターフェースを使いたい場合は、Windows版またはMac版のアプリをご利用ください。

Linuxで一部の通信だけをVPN経由にするには？

ルーティングルールまたはGeoIP地域ルーティングを使用します。freeguard rule add は特定のドメインまたはIP範囲を直接、またはVPN経由で送信し、freeguard config set geoip_region CN は1つの地域のトラフィックを直接送信し、残りはVPN経由のままにします。

Linux CLIは無料ですか？

インストールは無料です。接続にはFreeGuardのサブスクリプションを使用します。プランを確認するには freeguard subscribe list を実行してください。

ディストリビューションのパッケージマネージャーから FreeGuard をインストールできますか？

公式のディストリビューションのリポジトリからはインストールできません。当社のインストールスクリプト（install.sh）、Homebrew、または GitHub Releases のバイナリを使用してください。apt、dnf、pacman、または AUR には公開していません。

ヘッドレスサーバーや Docker で CLI は動作しますか？

はい。CLIはGUIへの依存がない単一のGoバイナリです。コンテナにTUNデバイスを作成するために必要なネットワーク機能があれば、SSH経由、コンテナ内、最小構成のベースイメージ上で動作します。

FreeGuardを起動時に自動起動できますか？

はい。freeguard autostart enable は、systemd のユーザーサービスを ~/.config/systemd/user/freeguard.service にインストールします。root デーモンとしてではなく、ユーザーとして実行されます。

対応しているアーキテクチャとディストリビューションは何ですか？

x86_64 および arm64 の Linux に対応しています。CLI は mihomo コアを自動でセットアップする単一の Go バイナリなので、最近のカーネルを搭載した最新のディストリビューションであれば動作するはずです。主に Ubuntu と Debian でテストしています。

Linux CLIはデスクトップアプリと同じプロトコルを使用しますか？

はい。anytls、hysteria2、trojanはすべて、WindowsおよびMacアプリと同じmihomoコアを使うCLIでも動作します。

CLIをアンインストールするには？

インストールスクリプトを使用した場合は、/usr/local/bin（または~/.local/bin）からfreeguardバイナリを削除し、~/.freeguardを削除してください。Homebrewを使用した場合は、brew uninstall freeguardvpnを実行してください。自動起動を有効にしている場合は、まずfreeguard autostart disableを実行してください。