メインコンテンツへ移動
AIチュートリアル

Gemini Config CheckerでGeminiとGoogle AI Studioのプロキシ設定をテストする方法

Gemini Config Checkerのインストール方法、シンプルまたは詳細モードでのプロキシ設定のスキャン方法、Google AI StudioとGeminiへのアクセス確認方法、アンチDPI設定の適用方法、結果の解釈方法、Xray対応クライアント向けの動作するルートのエクスポート方法を解説します。

約21分で読了
Gemini Config CheckerでGeminiとGoogle AI Studioのプロキシ設定をテストする方法

Gemini Config Checkerの機能

Gemini Config Checkerはプロキシ設定をテストし、Google AI StudioおよびGeminiに接続できるかどうかを判定します。基本的なHTTPプローブとは異なり、地域チェックモードでは、ログイン済みのChromiumベースブラウザーで各サービスを開き、Googleがアカウントに表示する判定結果を読み取ります。

この違いが重要なのは、Googleがログイン済みのページの読み込み後に地域での利用可否を判断するためです。Googleには正常に接続できても、AI Studio、Gemini、またはその両方へのアクセスがブロックされる場合があります。同じプロキシの出口でも、時間によって結果が異なることがあります。

バージョン0.1.0は初期のプレリリースです。完全なワークフローはWindowsでテスト済みです。macOS、Linux、Android向けパッケージはCIで生成されますが、READMEには実機でまだ検証されていないと記載されています。

主な機能

  • ログイン済みの地域検証: Google AI StudioとGeminiに表示されるメッセージおよびリダイレクトを確認します。
  • 接続のみのテスト: ブラウザーへのログインなしで、経路がGoogleに到達できることを確認し、遅延を測定します。
  • シンプルモード: デバイスからプロキシ設定を直接テストします。
  • アドバンストモード: 動作するベース設定の背後に無料設定を連結し、別の出口を探します。
  • 複数の入力形式: 対応する共有リンク、サブスクリプションURL、Base64サブスクリプション、さらに該当する場合は完全なXray JSON設定を受け付けます。
  • Anti-DPIプロファイル: 編集可能なフラグメンテーション、フィンガープリント、ALPN、暗号スイート、クリーンIP設定を適用します。
  • 結果のフィルタリングとエクスポート: リンクをコピーし、Base64サブスクリプションを生成し、Xray設定を作成します。
  • クロスプラットフォームパッケージ: リリースにはデスクトップ、Webサーバー、Android版が含まれますが、プラットフォーム固有の制限があります。

シンプルモードとアドバンストモードを理解する

シンプルモード

設定をすでに複数持っていて、どれが動作するかを特定したい場合は、シンプルモードを使用します。テストされる経路は次のとおりです。

あなた -> 設定 -> AI StudioまたはGemini

vless://、vmess://、trojan://、ss://リンク、サブスクリプションURL、またはBase64サブスクリプションテキストを指定できます。入力を空のままにして、用意された無料リストを選択することもできます。

アドバンストモード

正常に接続できるベース設定があり、Googleが受け入れる別の出口が必要な場合は、アドバンストモードを使用します。経路は次のようになります。

あなた -> ベース設定 -> 無料設定 -> AI StudioまたはGemini

ベースには共有リンク、完全なXray JSON設定、またはマルチホップチェーンを指定できます。候補をスキャンする前に、アプリケーションがベース経路をテストし、Googleに到達できない場合は停止します。

このモードでは、Anti-DPI設定がベース設定の最初のホップに適用されます。エクスポートされたXray設定では、ベース -> 無料のチェーンが保持されます。

インストールとセットアップ

リリースのダウンロードと検証

  1. プロジェクトのリリースページを開きます。
  2. オペレーティングシステムとアーキテクチャに合ったパッケージをダウンロードします。
  3. 可能な場合は、付属のSHA256SUMS.txtファイルを使用してダウンロードを検証します。

Windows

  1. amd64またはarm64向けのWindowsデスクトップZIPをダウンロードします。
  2. 任意のディレクトリに展開します。
  3. GeminiConfigChecker.exeを実行します。
  4. 署名のないビルドについてSmartScreenの警告が表示された場合、ダウンロードしたリリースを信頼できるなら、詳細情報を選択してから実行を選択します。

地域チェックにはChrome、Edge、またはBraveが必要です。WebView2はWindows 10およびWindows 11に含まれています。

macOS

  1. ユニバーサルmacOSアーカイブをダウンロードして展開します。
  2. アプリケーションをアプリケーションに移動します。
  3. 初回起動時は、アプリケーションを右クリックして開くを選択します。

macOSが引き続きアプリケーションをブロックする場合、READMEには次のコマンドが記載されています。

xattr -dr com.apple.quarantine "/Applications/GeminiConfigChecker.app"

Linux

DebianまたはUbuntuでは、デスクトップランタイムライブラリをインストールします。

sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0

アーカイブを展開し、デスクトップアプリケーションを起動します。

tar -xzf gemini-config-checker-desktop_<version>_linux_amd64.tar.gz
./GeminiConfigChecker

デスクトップ環境のないマシンでは、Webサーバービルドを使用します。

./gemini-config-checker

次にhttp://localhost:8787を開きます。Linuxでの地域チェックにはChrome、Chromium、Edge、またはBraveと、グラフィカルセッションが必要です。

Android

  1. Android 8以降のデバイスで、arm64-v8a APKをダウンロードします。
  2. APKを開く際に使用したブラウザーまたはファイルマネージャーからのインストールを許可します。
  3. アプリケーションをインストールして起動します。

Androidが対応するのは接続のみのスキャンであり、ログイン済みの地域チェックには対応していません。永続通知により、画面がオフになってもスキャンエンジンが動作し続けます。エンジンを停止するには、通知の停止操作を使用します。

後のAPKで異なる署名キーが使用されている場合、既存のインストールをそのまま更新することはできません。新しいものをインストールする前に、以前のビルドをアンインストールしてください。

Webサーバーの安全性

Webサーバーは次のようなオプションを受け付けます。

./gemini-config-checker -addr 127.0.0.1:8787
./gemini-config-checker -no-open
./gemini-config-checker -version

インターフェースに認証はありません。localhostにバインドしたままにしてください。リモートからアクセスする場合は、公開せずにトンネルを使用してください。

ssh -L 8787:localhost:8787 your-server

地域チェック用のGoogleアカウントを接続する

アプリケーションにはスキャン、結果、エクスポートのタブがあります。正確な地域チェックを実行する前に、Googleアカウントを接続してください。

  1. Googleでサインインを選択します。
  2. アプリケーション専用の別プロファイルでChrome、Edge、またはBraveが開くまで待ちます。
  3. 通常どおりサインインします。アプリケーションがパスワードを受け取ることはありません。
  4. ブラウザーが自動的に閉じ、Googleアカウントが接続されたことが画面に表示されるまで待ちます。

リクエストが多数のIPアドレスから送信される可能性があり、不審なサインイン警告が表示されることがあるため、サブアカウントの使用を推奨します。アプリからアカウントを削除を選択すると、アプリケーションの分離されたプロファイルが削除されますが、通常のブラウザープロファイルは変更されません。

対応ブラウザーを利用できない場合は、チェックの種類を接続性のみに変更してください。サインインは不要ですが、Googleが出口リージョンを許可しているかどうかは判断できません。

基本操作：シンプルモードで設定をスキャンする

  1. ヘッダーの切り替えをシンプルに設定します。
  2. 対応するプロキシリンクを1行に1つ貼り付けます。サブスクリプションURLまたはbase64サブスクリプションを貼り付けることもできます。
  3. 組み込みの無料リストをスキャンする場合は、入力欄を空のままにして利用可能なリストから1つ選択します。
  4. ネットワーク上で通常のCloudflareベースの設定が接続できない場合は、Anti-DPIを有効にします。
  5. 利用可能性を判定するにはサインイン済みブラウザーでリージョンを確認を、より高速な到達性テストには接続性のみを選択します。
  6. スキャンを開始を選択するか、CtrlとEnterを押します。
  7. 結果タブを開き、エントリが表示される様子を確認します。

基本的な入力は次のようになります。

vless://...
vmess://...
trojan://...
ss://...

スキャナーはまず、接続性テストで到達できない設定を除外します。リージョンモードでは、残った経路に対してAI StudioとGeminiへのブラウザーチェックを実行します。

基本操作：アドバンストモードでチェーンを構築する

  1. アドバンストに切り替えます。
  2. 動作するベース設定を貼り付けます。共有リンク、完全なXray JSON、または既存のマルチホップチェーンを使用できます。
  3. マシンから出る最初の接続で必要な場合は、Anti-DPIを有効にします。
  4. 無料設定のソースを選択します。READMEではverifiedリストが推奨されており、customではサブスクリプションURLを指定できます。
  5. または、候補となる無料設定を自分で貼り付けます。
  6. チェックの種類とブラウザーのサインイン設定を確認します。
  7. スキャンを開始します。

アプリケーションは、背後にある無料経路をテストする前にベース設定を検証します。そのベース設定でGoogleに到達できない場合は、続行する前に修正してください。

Anti-DPIプロファイルを設定する

Anti-DPIプロファイルは、通常のCloudflare設定が機能しないフィルタリング済みネットワーク向けに設計されています。推奨デフォルトには、2つのフラグメントマスク、unsafeフィンガープリント、http/1.1 ALPN、あらかじめ定義された13個の暗号スイート一覧、オプションのクリーンIPが含まれます。

  • Finalmask：レシピのフラグメントマスクを使用してTLS ClientHelloを分割します。
  • Fingerprint：デフォルトはunsafeです。ネイティブGo TLSを使用するため、設定した暗号スイート一覧が適用されます。
  • ALPN：デフォルトはhttp/1.1です。
  • Cipher suites：参照先のAnti-DPIレシピで定義された一覧を使用します。
  • Clean IP：接続先アドレスを置き換えますが、SNIとHostには元のドメインを保持します。

設定から読み込むを選択すると、finalmask、cipherSuites、alpnなどのJSONフィールド、またはfm、ciphers、alpn、fpなどのリンクパラメーターから互換性のある値を読み込めます。推奨値を選択すると、デフォルトに戻ります。

アプリケーションのローカルフォワーダーは、PattN Xrayフォークで使用されるセグメントごとのlengthsおよびdelaysの動作を再現します。対応しているのはfragmentマスクのみです。遅延が増加するため、フィルタリングされていないネットワークではプロファイルを無効にしてください。

実用的なスキャン設定を選択する

  • チェックの種類：リージョンモードは正確ですが、設定ごとにおよそ20〜40秒かかります。接続性モードは高速ですが、リージョンアクセスは検証しません。
  • 正常の条件：両方の製品、AI Studioのみ、またはGeminiのみを必須にします。
  • 最大設定数：デフォルトは60で、テスト前に候補リストがシャッフルされます。
  • 同時ブラウザーチェック数：デフォルトは4です。ブラウザーチェック1件につき約200 MBのメモリを使用するため、容量の小さいシステムでは減らしてください。
  • 同時接続性テスト数：デフォルトは20です。
  • 接続タイムアウト：デフォルトは10秒です。経路が遅い場合は増やせます。
  • 記憶する：設定と構成をデバイスのローカルストレージに保存します。共有コンピューターでは無効にしてください。

結果を解釈する

  • 正常：リージョンモードで、経路が選択した製品ルールに合格しました。
  • 接続済み：接続性モードで、経路はGoogleに到達しましたが、リージョンは検証されていません。
  • リージョンでブロック：必須に指定した製品のうち少なくとも1つが、リージョンによる制限を表示しました。
  • エラー：設定に到達できなかった、タイムアウトした、またはブラウザーの問題が発生しました。ラベルにカーソルを合わせると報告された理由を確認できます。
  • Ping：完全な経路を通じた1回のリクエストを測定します。

AI Studio列とGemini列に別々の結果が表示されるのは、製品ごとに異なる地域ルールが適用される場合があるためです。ステータスで絞り込み、名前やアドレスで検索し、pingまたは名前で並べ替え、複数の項目を選択して一括コピーできます。

合格結果はサンプルであり、永続的な保証ではありません。Cloudflare Workerの終了先は接続ごとに変わる可能性があるため、維持する予定のルートを再テストしてください。

動作する設定をエクスポートする

Copyを使うと、共有リンクをクリップボードにコピーできます。v2rayN、Hiddify、PattNなどのクライアントや、BPBのChain Proxyフィールドに貼り付けられます。

Simpleモードでは、Copy full configによって選択したルートのXray設定が作成されます。Advancedモードでは、Copy with chainによってベースからフリー出口までの完全なチェーンが作成されます。Exportタブでは、1行1リンク形式の出力、base64サブスクリプション、または保存済みJSONファイルも作成できます。

エクスポート先は慎重に選択してください。

  • PattNまたはPattNG: finalmaskを含むオプションを選択します。
  • 標準のXrayまたはv2rayN: 標準オプションを選択します。標準コアはフォーク固有のスキーマを解析できないため、finalmaskが削除されます。

生成されたファイルでは、ポート10808と10809に異なるinbound、固定DNS、およびUDPポート443のブロックが使用されます。v2rayNでは、Servers、続いてAdd custom configuration serverを使用します。生成したファイルを直接テストすることもできます。

xray run -c file.json

高度なヒントとトラブルシューティング

適切な正常判定ルールを使う

AI Studioは動作するのにGeminiがブロックされる、またはその逆の場合は、実際に必要な製品に合わせてHealthy meansを変更してください。2つのサービスでは地域判定の結果が異なる場合があります。

メモリ使用量を減らす

メモリが限られたマシンでは、同時に実行するブラウザチェックの数を減らしてください。接続チェックは負荷が低いため、ネットワークが過負荷でない限り、より多くを同時実行できます。

ブラウザ検出を修正する

対応ブラウザが見つからない場合は、Chrome、Edge、Brave、または対応するChromium系ブラウザをインストールしてください。標準とは異なる場所にあるブラウザを使用する場合は、実行ファイルをGCC_BROWSERまたはCHROME_BINに設定します。Flatpak版ブラウザはアプリケーションから操作できません。

広範囲のタイムアウトに対処する

すべてのルートがタイムアウトする場合は、通常のプロキシクライアントで設定を確認してください。Advancedモードでは、ベース設定が動作することを確認します。フィルタリングされたネットワークでは、anti-DPIプロファイルを有効にして、クリーンなIPを試してください。

期限切れのセッションから復旧する

アプリケーションにGoogleセッションの期限切れが報告された場合は、もう一度ログインしてください。変化するIPアドレスから繰り返しリクエストを送ると、Googleから再度セキュリティ確認を求められることがあります。

アプリケーションをリセットする

まずアプリケーションからアカウントを削除し、必要に応じてローカルデータを削除します。

  • Windows: %AppData%\GeminiConfigChecker
  • macOS: ~/Library/Application Support/GeminiConfigChecker
  • Linux: ~/.config/GeminiConfigChecker

ソースからビルドする

ビルドにはgo.modで指定されたGoバージョンが必要です。デスクトップ版のビルドには、Wails v2とプラットフォーム用WebViewの依存関係も必要です。Android版のビルドには、Android SDK、JDK 17以降、Gradle 8.10が必要です。

make test
make web
make desktop
make android
make dist VERSION=0.1.0

make testはvetと単体テストを実行します。その他のコマンドは、Webサーバー、ネイティブデスクトップアプリケーション、Android APK、またはクロスコンパイルされた配布用バイナリをビルドします。

プライバシーとセキュリティに関する考慮事項

  • Googleへのサインインは、アプリケーション内ではなく、専用のブラウザプロファイルで行われます。
  • アプリケーションがGoogleのパスワードを受け取ることはありません。
  • 設定と各種オプションはローカルストレージに保持され、Rememberが有効な場合にのみ保存されます。
  • Googleへの通信はエンドツーエンドTLSで保護されますが、無料プロキシの運営者は接続先を確認できる場合があります。
  • 身元の不明な運営者が提供する無料設定を使って、機密性の高い通信を送信しないでください。
  • 認証されていないWebインターフェースをパブリックネットワークに公開しないでください。

まとめ

Gemini Config Checkerは、単純な接続性と、Google AI StudioおよびGeminiが実際に利用可能かどうかを地域ごとに区別する実用的な手段を提供します。直接テストする場合はSimpleモードから始め、信頼できるベースルートの背後で別の出口が必要な場合はAdvancedモードを使い、成功した結果をクライアントが対応する形式でエクスポートしてください。ルートや地域判定は変化する可能性があるため、設定を信頼して使用する前に必ず再テストしてください。