TurtleReside/Gemini-Config-Checker-

项目介绍

Gemini Config Checker 用来测试一批代理配置（vless://、vmess://、trojan://、ss:// 分享链接、订阅 URL 或 base64 文本），判断哪些配置能让已登录的 Google 账号真正打开 AI Studio 和 Gemini。出发点是普通 HTTP 探测在哪个国家都返回「正常」，所以工具会驱动一个独立的 Chrome/Edge/Brave 配置文件，以你的账号登录，然后读取 Google 自己的判定：AI Studio 跳转到 /docs/available-regions，或 Gemini 显示「当前国家/地区不支持」（为什么需要登录浏览器）。

工具分两种模式。Simple 直接检测你提供的配置；Advanced 把免费配置串在一个可用的基础配置之后，让 Google 看到不同的出口。两种模式都可选用反 DPI 配置（TLS ClientHello 分片、fingerprint、ALPN 和加密套件，取值来自 PattN 方案），由本地转发器实现（反 DPI 配置）。结果可复制为分享链接、base64 订阅或完整的 Xray JSON 配置；导出给 PattN/PattNG 时保留 finalmask 字段，给原版 Xray/v2rayN 时自动去掉。

快速使用

从 Releases 页面下载对应平台的构建，并用同页的 SHA256SUMS.txt 校验（下载与安装）。Windows 上解压 windows_amd64（或 arm64）压缩包，运行 GeminiConfigChecker.exe；构建未签名，SmartScreen 提示时选「更多信息 → 仍要运行」。Linux 需先安装 libgtk-3-0 和 libwebkit2gtk-4.1-0；web server 构建执行 ./gemini-config-checker，在 http://localhost:8787 打开界面。Android 提供 arm64-v8a APK。

在应用内：

1. 在顶部切换 Simple 或 Advanced。
2. 每行粘贴一个分享链接、订阅 URL 或 base64 文本；留空则测试内置的免费列表。
3. 只有在网络受限环境里才保持 Anti-DPI 开启。
4. 点击 Sign in with Google：会打开一个独立的浏览器配置文件，正常登录，检测到登录后窗口自动关闭。
5. 按 Start scan，在 Results 页查看结果；区域检测模式下每个配置约需 20–40 秒。

使用约束

• 区域检测需要本机装有 Chrome、Edge、Brave、Chromium 或 Vivaldi，或通过 GCC_BROWSER / CHROME_BIN 指定路径；Flatpak 版浏览器无法驱动。
• Android 和「仅连通性」模式只能证明能连到 Google 并测延迟，不验证地区，因为 Android 应用无法驱动已登录的 Chromium。
• 每个并发浏览器检测约占 200 MB 内存；默认最多测 60 个配置、4 个浏览器并发。
• 判定只是一次采样：Cloudflare Worker 出口可能在连接之间变化，保留前应重新测试。
• Web server 无身份认证且绑定 127.0.0.1，不要直接暴露到公网，需要远程访问时用 SSH 隧道。
• 按 README，v0.1.0 时 macOS、Linux 和 Android 构建来自 CI，尚未在真实设备上验证。
• 免费配置由未知第三方运营，README 本身也提醒不要通过它们传输敏感流量。
• README 声明的许可证是 MIT，仓库元数据为 Apache-2.0；内置的 Xray-core 保持 MPL-2.0（许可证）。

HotRepo 点评

该项目在 2026-11-15 进入新项目榜，首个记录小时内新增 192 Star，对一个 v0.1.0 预发布版本来说启动速度很快。文档写得比这个阶段通常的详细程度高：分平台的安装路径、CI 与发布规则，以及「只有 Windows 在真机上跑过」的明确说明。安装前有两处值得留意：README 顶部横幅指向一个 Dropbox .rar，而不是正文描述的 Releases 产物；仓库元数据里的许可证也和 README 不一致。这两点都不构成直接否定——Releases 是文档给出的正规路径，也提供 SHA256 校验——但读者应通过 Releases 页面下载并核对校验和，而不是点横幅链接。