WinnerSpecialist/Gemini-Config-Checker-

项目介绍

Gemini Config Checker 检查代理配置时，不走简单的 HTTP 连通性探测，而是在一个已登录 Google 账号的浏览器配置里打开 AI Studio 和 Gemini，读取 Google 实际显示的地区判定。README 的解释是：普通 HTTP 请求从任何国家都会返回「正常」，因此连通性探测会把所有活着的配置都标成健康。支持的配置形式包括 vless://、vmess://、trojan://、ss:// 链接、订阅 URL、base64 文本以及完整的 Xray JSON。

工具有两种模式。Simple 直接检测一批配置；Advanced 把免费配置串联在一个可用的基础配置之后，适合 Cloudflare Worker 线路能连上、但 Google 封锁其出口的情况。可选的 anti-DPI 配置会对第一跳做 TLS ClientHello 分片等处理，参数来自 PattN 的方案。

快速使用

1. 从 GitHub Releases 下载对应平台的构建，每个 release 都附带 SHA256SUMS.txt。
2. Windows 上解压后运行 GeminiConfigChecker.exe。Windows 10/11 自带 WebView2；SmartScreen 提示时选择 More info → Run anyway。
3. 打开 Scan 标签，每行粘贴一个配置；也可以留空，改为测试内置的免费列表。
4. 点 Sign in with Google，会打开一个独立的 Chrome/Edge/Brave 配置，在那里登录，检测到登录后窗口自动关闭。只有在 Plain 配置连不通的网络里才需要开启 Anti-DPI。
5. 点 Start scan，在 Results 标签查看结果：Healthy、Region blocked 或 Error。用 Export 可以复制链接、base64 订阅，或给 PattN、v2rayN 等客户端导入的 Xray 配置。

没有受支持的浏览器，或在 Android 上使用时，可在设置里把检测类型改为 connectivity only：这样不需要登录，但也不再验证地区。

使用约束

• 地区检测需要 Chrome、Edge、Brave 或 Chromium，Flatpak 版浏览器无法被驱动。Linux 还需要图形会话（DISPLAY 或 WAYLAND_DISPLAY）。
• 地区检测每个配置使用一个浏览器实例，约 200 MB 内存；默认同时检测 4 个浏览器、每次最多 60 个配置。
• Android 版只能做连通性检测，因为 Android 不允许应用驱动已登录的 Chromium。
• Web server 构建在 http://localhost:8787 上提供界面且没有身份验证，应只留在本机，或通过 SSH 隧道访问。
• 二进制未签名；Android release 在配置了仓库密钥时用该密钥签名，否则使用一次性密钥，会导致后续版本无法原地升级。
• 检测结论只是采样：Cloudflare Worker 的出口可能在不同连接间变化，打算长期使用的配置需要复测。
• README 说明 0.1.0 是早期预发布版，只在 Windows 上完整跑通过；macOS、Linux 和 Android 构建来自 CI，尚未在真机上验证。
• 仓库标注 Apache-2.0 许可证，README 则指向 MIT；Xray-core（MPL-2.0）和字体各自保留原许可证。

HotRepo 点评

HotRepo 只记录到该项目出现在 2026-11-15 的新项目榜：约 1.5 小时的统计窗口内新增 286 Star、0 Fork，没有 GitHub 日榜名次。Star 短时冲高但还没有 Fork，加上它仍是只在 Windows 上跑通过一遍的早期预发布版，目前看不到成熟用户群，也看不到二进制与源码对应的证据。比较有价值的是它的检测思路：读取登录状态下的 Google 地区判定，而不是依赖 HTTP 探测；但这套方法的价值，取决于你有多信任它发布的二进制程序。