VortexHostFeel/Gemini-Config-Checker-

项目介绍

Gemini Config Checker 用来找出哪些代理配置能真正进入 Google AI Studio 和 Gemini。它不发送普通 HTTP 探测请求，而是打开一个独立的浏览器配置，以已登录用户身份访问这两个产品，再读取 Google 给出的结果：AI Studio 重定向到可用地区文档，或 Gemini 提示所在国家不受支持。作者在 为什么需要登录浏览器 中解释，裸请求从任何国家访问都会返回正常。

工具有两种模式：

• Simple：把每条配置（vless/vmess/trojan/ss 链接、订阅 URL、base64，或内置免费列表）当作从本机到 Google 的路由逐条测试。
• Advanced：先放一条可用的 base 配置，再把免费配置链在它后面，适合 Cloudflare 能连但 Google 拒绝该出口的情况。

结果按产品显示健康、被地区封锁或出错，并给出延迟；支持筛选、排序和批量复制。导出可以是分享链接、base64 订阅，或一份 Xray JSON 配置，并可选择是否包含 fork 特有的 finalmask 字段。

引擎基于 Xray-core，桌面外壳用 Wails，原生构建覆盖 Windows、macOS、Linux 和 Android。

快速使用

预编译版本在 Releases 页面 发布，每个版本附带 SHA256SUMS.txt 用于校验。作者说明只有 Windows 桌面版做了完整实测，其他平台由 CI 构建。

1. 下载对应平台的压缩包并解压。Windows 上运行 GeminiConfigChecker.exe；构建未签名，SmartScreen 可能提示，README 的做法是选择 More info → Run anyway。
2. Linux 先装运行库：sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0，然后运行 ./GeminiConfigChecker。没有桌面环境时改用 Web 服务器构建（./gemini-config-checker），打开 http://localhost:8787 Web 服务器说明。
3. 在 Scan 页选择 Simple 或 Advanced。
4. 每行粘贴一条配置，或留空以测试现成的免费列表。
5. 如果网络里普通 Cloudflare 配置连不上，保持 Anti-DPI 开启。
6. 点一次 Sign in with Google，在弹出的独立浏览器配置中正常登录，检测到会话后窗口自动关闭。
7. 按 Start scan（或 Ctrl+Enter），在 Results 页查看结果。
8. 用 Copy / Copy with chain 或 Export 页，把可用配置导入 v2rayN、Hiddify、PattN 或 BPB 的 Chain Proxy 字段。

Advanced 模式会先测试 base 配置；无法到达 Google 时扫描会中止并给出提示。

使用约束

• 地区检测需要本机装有 Chrome、Edge、Brave 或 Chromium；每个并发浏览器检查约占用 200 MB 内存（默认同时 4 个）。
• Android 只能做连通性检测：能证明路由可达 Google，但无法验证地区，因为应用不能驱动已登录的 Chromium。
• 结果是抽样，不是保证。Cloudflare Worker 的出口在连接之间可能变化，测过的配置应再次复测。
• Web 服务器只监听 127.0.0.1，但没有任何认证；应保持在本机或用隧道转发，不要直接暴露。
• Anti-DPI 配置面向受限网络，在其他网络只会增加延迟；只支持 fragment 掩码，分段长度由本地转发器实现，而非原版 Xray-core。
• 免费配置由未知第三方运营，README 提示不要通过它们传输敏感流量。
• 许可证为 MIT，内置的 Xray-core 和字体保留各自许可证。

HotRepo 点评

这是一个很新的项目：HotRepo 在 2026-11-15 记录了首条快照，192 Star 且全部来自同一个一小时的新项目榜统计窗口，Fork 为 0，暂未记录到 GitHub 日榜名次。这说明它是一次较快的初始增长，而不是持续趋势。项目针对一个真实的测量问题——Google 的地区判断只对已登录用户可见——README 也较诚实地说明了未签名构建、CI 平台未实测以及结果只是抽样。需要注意的是来源：README 顶部还突出引导到第三方 Dropbox 的 .rar 压缩包，这与后文基于 Releases 的分发方式并不一致。