Gemini-Config-Checker- — Gemini等の地域制限をブラウザ実挙動で判定するプロキシ検査ツール
YellowLaborerMarket/Gemini-Config-Checker-
★ 474 ・ Makefile ・ Apache-2.0
概要
「Gemini-Config-Checker-」は、Google AI Studio や Google Gemini へのアクセスが実際に行えるかどうかを検証するためのプロキシ設定チェッカーです。
一般的なプロキシ検証ツールでは、単純な HTTP リクエストや ping による疎通確認のみを行うことが多く見られます。しかし、Google の AI サービスはアクセス元の IP アドレスだけでなく、サインインしたアカウントや Web ページの読み込み完了後に利用可能地域(リージョン)の判定を実施します。そのため、単純なリクエストでは正常応答を返していても、実際にブラウザから開くと利用不可画面へリダイレクトされてしまうケースが少なくありません。
本ツールは、Chrome や Edge などのブラウザを独立したプロファイルで起動し、サインイン状態での実挙動を確認することで、対象のプロキシ設定が Gemini や AI Studio で本当に利用できるかを判別します。地域制限のあるネットワーク環境から Gemini などの生成 AI サービスを利用したいユーザーや、手持ちのプロキシ設定を正確に検証したい開発者に向けて開発されています。
主な特徴
-
サインイン済みブラウザによる地域判定
HTTP レベルの死活監視にとどまらず、実際のブラウザを自動制御して Google へのサインイン状態をシミュレートし、AI Studio のリダイレクトや Gemini の地域制限メッセージを検知します。 -
Simple と Advanced の2つのモード
単一のプロキシ設定を評価する「Simple」モードと、手元のベースプロキシ経由で無料の公開プロキシに多段接続(チェーン)させて出口 IP を変更する「Advanced」モードを切り替えて利用できます。 -
Anti-DPI プロファイルの搭載
パケット断片化(fragment)や特定の TLS フィンガープリント、暗号スイートの調整など、ディープパケットインスペクション(DPI)を回避するための設定があらかじめ組み込まれています。 -
デスクトップ UI と Web サーバーモードの提供
ネイティブウィンドウで操作できるデスクトップアプリケーション(Wails ベース)に加え、ヘッドレスサーバーや Termux 環境でブラウザからアクセスできる Web サーバー形式のバイナリも用意されています。 -
多様なプロトコルとエクスポート機能
vless://、vmess://、trojan://、ss://形式のリンク、サブスクリプション URL、Base64 文字列の読み込みに対応しており、検証結果はリンク一覧や Xray 向けの設定ファイルとして出力できます。
使い方
GitHub の Releases ページから各プラットフォーム向けのビルドが配布されています。
デスクトップ環境での起動
Windows
gemini-config-checker-desktop__windows_amd64.zip(またはarm64)をダウンロードして展開します。- 展開先にある
GeminiConfigChecker.exeを実行します(未署名のため SmartScreen の警告が出た場合は「詳細情報」→「実行」を選択します)。
macOS
..._macos_universal.zipをダウンロードして展開し、.appファイルを「アプリケーション」フォルダに移動します。- 初回起動時は右クリックから「開く」を選択します。実行が拒否される場合は、ターミナルで
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 サーバーモードでの起動
GUI デスクトップ環境がない Linux サーバーや Termux 環境では、Web サーバー版を利用してブラウザから UI にアクセスします。
# サーバーを起動(ローカルホストの 8787 番ポートで待機)
./gemini-config-checker
起動後、ブラウザで http://localhost:8787 を開きます。起動オプションとして -addr、-no-open、-version などが用意されています。
Android 環境での利用
- 配布されている APK ファイル(
..._android_arm64.apk)を端末にダウンロードしてインストールします。 - アプリを起動すると、長時間のスキャンでも処理が中断されないようにフォアグラウンドサービスとして常駐します。
※ Android 環境ではブラウザの自動制御が行えないため、後述の「疎通確認のみ」のモードで動作します。
スキャンと検証の流れ
- Google サインイン(地域チェックを行う場合)
デスクトップ版で「Sign in with Google」をクリックすると、アプリ専用の独立プロファイルでブラウザ(Chrome / Edge / Brave)が起動します。ここで Google アカウントにログインするとプロファイルが保存され、以降の判定に利用されます。 - モード選択と設定の入力
「Simple」または「Advanced」を選択し、プロキシ URL(vless://やサブスクリプション URL など)を貼り付けます。設定を入力せずに内蔵の無料リストを選択してスキャンすることも可能です。 - スキャンの実行と結果の確認
スキャンを実行すると「Results」タブにリアルタイムでステータスが表示され、AI Studio / Gemini への到達性が確認できた設定をクリップボードへのコピーやファイル形式でエクスポートできます。
技術的なポイント
README から確認できる本ツールの設計・実装上の特徴は以下の通りです。
-
Wails によるクロスプラットフォーム UI
Go 言語と Web 技術を組み合わせて軽量なデスクトップアプリを構築するフレームワーク「Wails」を採用しています。Linux 環境では GTK 3 と WebKitGTK 4.1、Windows では WebView2 を利用して描画を行います。 -
Xray-core の内包とフォワード機能
プロキシエンジンのコアとしてXTLS/Xray-coreを組み込んでいます。設定のテスト時には、自身がフォワーダーとしてパケットの断片化処理(Anti-DPI レシピに基づくfinalmaskの適用など)を行いながら通信を中継します。 -
ブラウザプロファイルの分離
Google アカウントによる地域判定を行う際、ユーザーが普段利用しているブラウザの日常プロファイルには干渉せず、本ツール専用の独立したプロファイルディレクトリを作成してブラウザプロセスを立ち上げる設計になっています。 -
チェーン接続(多段プロキシ)の自動構成
Advanced モードでは、手元のベースプロキシ(Cloudflare Workers 経由など)を第1ホップとし、そのトンネル内部を通して公開プロキシに接続するルーティング(base → free)を動的に構成し、設定ファイルを出力する機能を備えています。
注意点
-
開発フェーズ
本ツールはバージョン 0.1.0 の早期プレリリース段階にあります。README によると、エンドツーエンドの動作確認が十分に行われているのは Windows 環境のみであり、macOS、Linux、Android のビルドは CI パイプライン経由で生成されたもので実機検証が完了していないと明記されています。 -
Google アカウントの利用について
検証処理では短時間のうちに多数の異なる IP アドレスを経由して Google へのアクセスが試行されます。そのため、Google 側から不審なログインとして検知されるリスクがあります。普段利用しているメインアカウントではなく、検証用の予備アカウントを使用することが推奨されています。 -
Web サーバーモードのセキュリティ
Web サーバー版の UI には認証機能が含まれていません。外部に直接公開せず、127.0.0.1でのみリッスンさせるか、リモートサーバーで実行する場合は SSH ポートフォワーディング(ssh -L)などを併用してアクセスする必要があります。 -
プラットフォームごとの制約
ブラウザをドライブして地域判定を行う機能は、デスクトップ環境(Chrome、Chromium、Edge、Brave のいずれかが導入されている環境)でのみ動作します。Android 環境ではプラットフォーム側の制約によりブラウザの外部制御ができないため、疎通確認モード(Connectivity-only)のみの対応となります。 -
ライセンス
本プロジェクトは Apache License 2.0 のもとで公開されています。また、フォントや参照元の外部ツールなどにも個別のオープンソースライセンスが適用されています。
まとめ
Gemini-Config-Checker- は、Google AI Studio や Gemini 特有の地域判定ロジックに対応したプロキシ設定検証ツールです。サインイン済みブラウザによる実挙動の確認や Anti-DPI、多段プロキシ構成のサポートなど、制限環境下での実用性に焦点を当てた機能が盛り込まれています。初期リリース段階のため動作検証の進捗には留意が必要ですが、設定の可否を確実に判断したい場合に役立つツールです。





