FreeGuard CLI トラブルシューティング

FreeGuard CLI で問題が発生していますか？このガイドでは、最も一般的な問題とその解決方法を説明します。すべての問題に対して、まず freeguard doctor を実行してみてください — ほとんどの設定や環境の問題を自動的に検出します。

インストールの問題

インストール中にアクセス拒否

症状: インストールスクリプトが Permission denied または EACCES で失敗する。

解決策: macOS/Linux では、インストーラーに /usr/local/bin への書き込み権限が必要です。管理者権限で実行してください：

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

Windows では、インストールコマンドを実行する前に PowerShell を管理者として開いてください。

インストール後にコマンドが見つからない

症状: freeguard を実行すると command not found または not recognized が返される。

Doctor の出力:

✗ CLI binary:     Not in PATH

解決策: バイナリがシェルの PATH に含まれていない可能性があります。手動で追加してください：

# macOS/Linux — add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="$HOME/.freeguard/bin:$PATH"

# Then reload your shell
source ~/.zshrc  # or ~/.bashrc

Windows では、システムの PATH 環境変数に %USERPROFILE%\.freeguard\bin を追加し、ターミナルを再起動してください。

curl が失敗またはダウンロードがタイムアウト

症状: インストールスクリプトがバイナリをダウンロードできない。

解決策: 企業のファイアウォールの背後にいる場合や制限されたネットワークにいる場合は、GitHub の Releases ページからバイナリを手動でダウンロードし、~/.freeguard/bin/ に配置してください。その後、実行可能にします：

chmod +x ~/.freeguard/bin/freeguard

ログインの問題

確認コードが届かない

症状: freeguard login --email [email protected] --send-code を実行後、メールが届かない。

解決策:

スパム/迷惑メールフォルダを確認してください — 確認メールがフィルタリングされることがあります。
再度リクエストする前に2分間待ってください。コード送信にはレート制限があります。
メールアドレスが正しいか確認してください：

freeguard login --email [email protected] --send-code

問題が続く場合は、別のメールプロバイダーを試してください。

トークンの期限切れ

症状: コマンドが Authentication expired または Token invalid で失敗する。

Doctor の出力:

✗ Credentials:     Token expired (last refresh: 2026-03-01)

解決策: 再度ログインして認証情報を更新してください：

freeguard logout
freeguard login --email [email protected] --send-code

間違ったメール — サブスクリプションが見つからない

症状: ログインは成功するが、freeguard connect が No active subscription と表示する。

Doctor の出力:

✓ Credentials:     Logged in (email: u***@example.com)
✗ Subscription:    No active subscription found

解決策: サブスクリプションを購入した時と同じメールアドレスでログインしていることを確認してください。別のメールを使用した場合：

freeguard logout
freeguard login --email [email protected] --send-code

接続の問題

接続タイムアウト

症状: freeguard connect がハングするか、Connection timed out を返す。

Doctor の出力:

✗ Network:         Internet not reachable

解決策:

基本的なインターネット接続を確認してください（先に VPN を切断）：

freeguard disconnect
ping 8.8.8.8

別のノードまたは国を試してください：

freeguard connect --country SG

ネットワークでより良く機能する可能性のある別のプロトコルを試してください：

freeguard connect --protocol hysteria2

ポート 7890 がすでに使用中

症状: freeguard connect が Port 7890 is already in use で失敗する。

Doctor の出力:

✗ Port 7890:       In use by another process (PID: 12345)

解決策: 別の proxy アプリケーションがデフォルトポートを使用しています。他のアプリケーションを停止するか、FreeGuard の proxy ポートを変更してください：

freeguard config set proxy.port 8080
freeguard connect

DNS リークが検出された

症状: DNS クエリが VPN トンネルをバイパスしている。

解決策: セキュアな DNS 設定に切り替えてください：

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

DNS が VPN 経由でルーティングされていることを確認できます：

freeguard doctor

出力の DNS チェックを確認して、正しく機能していることを確かめてください。

権限の問題

TUN モードには sudo が必要

症状: freeguard connect --tun が Permission denied: TUN device で失敗する。

Doctor の出力:

✗ TUN permission:  Not available (run with sudo for TUN mode)

解決策: TUN モードは仮想ネットワークインターフェースを作成するため、管理者権限が必要です：

# macOS/Linux
sudo freeguard connect --tun

# Windows — run PowerShell as Administrator
freeguard connect --tun

システム全体の VPN カバレッジが不要な場合は、デフォルトのシステム proxy モードを使用してください（sudo 不要）：

freeguard connect

1024 未満のポートには管理者権限が必要

症状: 1024 未満の proxy ポートを設定すると Permission denied で失敗する。

解決策: 1024 未満のポートはほとんどのオペレーティングシステムで制限されています。1024 以上のポートを使用してください：

freeguard config set proxy.port 7890

または、低いポートが特に必要な場合は管理者権限で実行してください：

sudo freeguard connect

まだ解決しない場合

freeguard doctor と上記の解決策で問題が解決しない場合は、AI に自動診断させましょう。

FreeGuard CLI Agent ページにアクセスし、問題を説明してください。エージェントは freeguard doctor --json の出力を読み取り、ステップバイステップで解決に導きます。

対話型トラブルシューティングウィザードも実行できます：

freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat

よくある質問

FreeGuard CLI が “connection refused” と表示するのはなぜですか？

これは通常、VPN サーバーが一時的に利用できないことを意味します。freeguard connect --server auto で最適なサーバーを自動選択するか、ファイアウォールの設定を確認してください。

VPN 接続が機能しているか確認するにはどうすればよいですか？

freeguard status を実行して、接続状態、現在のサーバー、プロトコルを確認してください。curl ifconfig.me を実行して IP アドレスが変更されたことを確認することもできます。

システムアップデート後に FreeGuard CLI が起動しません。どうすればよいですか？

freeguard update を実行して最新バージョンを取得してください。それが失敗した場合は、インストールスクリプトで再インストールしてください：curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh。

バグを報告したり、サポートを受けるにはどうすればよいですか？

freeguard debug を実行して診断情報を収集し、ウェブサイトまたはメールでサポートに連絡してください。より迅速な解決のためにデバッグ出力を添付してください。

最終更新: 2026年3月