FreeGuard CLI クイックスタート

FreeGuard CLI は、1 コマンドで接続できるコマンドライン VPN クライアントです。macOS、Linux、または Windows にインストールし、メールアドレスでログインして、freeguard connect を実行すれば、5 分以内にインターネットを保護できます。

インストール

macOS と Linux

1 つのコマンドでインストールします。

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

または、macOS では Homebrew を使用します。

brew install freeguardvpn/tap/freeguard

インストール後、正常に動作したことを確認します。

freeguard version

期待される出力:

FreeGuard CLI v1.0.0
Core: mihomo v1.19.21
OS: darwin/arm64

Windows

PowerShell を管理者として開き、次を実行します。

irm https://downloadcli.freeguardvpn.com/cli/install.ps1 | iex

インストール後、ターミナルを再起動して freeguard version を実行し、確認します。

接続

1 コマンドで、利用可能な最速のサーバーに接続します。

freeguard connect

出力例:

✓ United States - New York (us-new-01) に接続しました
  Protocol: anytls | Latency: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

特定の国に接続するには:

freeguard connect --country JP

特定のノードに接続するには:

freeguard connect jp-tok-01

確認

接続が有効であることを確認します。

freeguard status

出力例:

FreeGuard VPN Status
────────────────────
Status:     ● Connected
Node:       United States - New York (us-new-01)
Protocol:   anytls
Latency:    42ms
Upload:     1.2 MB/s
Download:   15.8 MB/s
Duration:   2h 15m
Mode:       System Proxy (HTTP/SOCKS5)

機械可読な出力を取得するには（スクリプトや AI エージェントに便利です）:

freeguard status --json

{
  "connected": true,
  "node": {"id": "us-new-01", "name": "United States - New York", "country": "US"},
  "protocol": "anytls",
  "latency_ms": 42,
  "traffic": {"upload_bps": 1258291, "download_bps": 16569754},
  "duration_seconds": 8100,
  "mode": "system_proxy",
  "proxy_port": {"mixed": 7890}
}

次のステップ

CLI Commands Reference — すべてのコマンド、フラグ、出力形式の完全な一覧。
CLI Troubleshooting — インストール、ログイン、接続に関する一般的な問題の解決策。
FreeGuard CLI Agent — AI に問題を自動的に診断・修復させます。
ターミナルで freeguard --help を実行して、利用可能なすべてのコマンドを確認します。

よくある質問

自分のシステムに FreeGuard CLI をインストールするにはどうすればよいですか?

macOS または Linux では curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh を実行します。macOS では brew install freeguard も使用できます。インストーラーは OS とアーキテクチャを自動検出します。

GUI なしで FreeGuard CLI を使用できますか?

はい。FreeGuard CLI は完全な headless で動作し、グラフィカルインターフェースは不要です。サーバー、コンテナ、リモート SSH セッションに最適です。

CLI で VPN プロトコルを切り替えるにはどうすればよいですか?

freeguard connect --protocol <name> を使用します。対応しているプロトコルには Hysteria2、Anytls、Trojan があります。CLI はネットワークに最適な最速のプロトコルをデフォルトで使用します。

FreeGuard CLI は Raspberry Pi のような ARM デバイスで動作しますか?

はい。CLI は arm64 と armv7 アーキテクチャをサポートしています。インストールスクリプトはプラットフォームを自動検出し、正しいバイナリをダウンロードします。

最終更新: 2026 年 3 月