WindGatorRise37/Gemini-Config-Checker-

项目介绍

Gemini Config Checker 用来验证代理配置是否真的能进入 Google AI Studio 和 Gemini，而不仅仅是“能连上 Google”。原因是 Google 会按已登录账号在页面加载后判断地区可用性，普通 HTTP 探针会让所有存活配置都显示健康，但页面仍可能显示地区限制。工具因此用独立浏览器配置文件打开 AI Studio 和 Gemini，读取 Google 实际给出的结果：AI Studio 会跳转到 available-regions 页面，Gemini 会提示当前国家/地区不受支持（为什么需要登录浏览器）。

工具有两种模式。Simple 直接测试你提供的每个配置；Advanced 先使用一个可用的基础配置作为第一跳，把免费配置串在后面，以获得 Google 接受的不同出口 IP。可选的 Anti-DPI 配置会对离开本机的链路做 TLS 分片（Anti-DPI 配置）。

快速使用

构建产物在 Releases 页面 发布。以 Windows 为例：解压对应 amd64/arm64 的桌面包，运行 GeminiConfigChecker.exe。Windows 10/11 自带 WebView2；构建未签名，SmartScreen 可能要求确认。

1. 在 Scan 标签粘贴代理链接（vless://、vmess://、trojan://、ss://）、订阅 URL 或 base64 文本，每项一行/一条；也可以留空，选择内置的免费列表（用户指南）。
2. 选择 Simple 或 Advanced。Advanced 需要粘贴一个你确认可用、且 AI Studio 没有地区拦截的基础配置。
3. 如果普通配置在你的网络里连不上，保持 Anti-DPI 开启。
4. 点一次 Sign in with Google：会打开使用独立配置文件的浏览器窗口登录 Google，之后扫描会记住该登录状态。没有浏览器时，可把检查类型改为仅连通性，跳过地区验证。
5. 开始扫描，在 Results 查看结果；再用 Export 或复制按钮取得链接或 Xray JSON 配置。

没有桌面环境时，可运行 Web 服务器构建并打开 http://localhost:8787（下载选项）。

使用约束

• 地区检查依赖 Chrome、Edge 或 Brave；没有浏览器只能做连通性测试。Android 仅支持连通性模式，因为应用无法驱动已登录的 Chromium。
• README 说明目前只有 Windows 构建被完整跑过，macOS、Linux、Android 构建来自 CI，尚未在真实设备上验证。
• 地区检查每个配置约需 20–40 秒，每个并发浏览器检查约占 200 MB 内存；默认最多测试 60 个配置。
• 结果是采样而非保证：Cloudflare Worker 出口可能在不同连接间变化，依赖前应重新测试（结果说明）。
• 免费配置由未知第三方运营，不要通过它们传输敏感流量；本地 Web 服务器无鉴权，应只留在 localhost（隐私与安全）。
• 桌面构建未签名；Android APK 在未配置仓库密钥时可能使用一次性密钥签名，后续版本无法覆盖安装。README 标注 MIT，但内置的 Xray-core 保留 MPL-2.0（许可证）。

需要注意

README 顶部有一个 “Download Gemeni app” 按钮，指向 Dropbox 上的 .rar 文件（下载按钮），与正文要求从 GitHub Releases 获取构建的说明矛盾。应把它视为与文档分发无关的外部压缩包，改用 Release 产物和 SHA256SUMS.txt 校验。

HotRepo 点评

该项目于 2026-11-15 出现在 HotRepo 新项目榜，首个观察窗口记录到 278 个 Star，Fork 为 0，尚无 GitHub 全语言日榜记录。这样的数据形态更像一次新发布带来的短期关注，而不是持续采用的证据。项目聚焦“按账号判断 Google AI Studio 和 Gemini 地区可用性”这一具体问题，用户指南和源码构建路径写得较细；但 macOS/Linux/Android 未在真实设备验证，加上顶部冲突的下载按钮，是在依赖它之前最需要权衡的地方。