Gemini-Config-Checker - 用已登录浏览器验证代理配置能否访问 Google AI Studio 与 Gemini
Gemini-Config-Checker 是一个桌面与网页端工具,通过已登录的浏览器逐条测试代理配置,判断哪些配置能真正打开 Google AI Studio 和 Gemini。项目由 YellowLaborerMarket 维护,采用 Apache-2.0 许可,目前处于 0.1.0 早期预发布阶段,尚无正式 release。
Gemini-Config-Checker 是一个用来筛选代理配置的工具:它把每条配置放进真实浏览器里、以已登录 Google 账号的身份去访问 Google AI Studio 和 Gemini,看这条线路究竟能不能用。它要解决的问题是,普通的连通性探测几乎总会给出「正常」的结论——据项目说明,即使是一个随便填的密钥去请求 Gemini API,从任何国家都会返回「没问题」,于是大量实际被区域限制的配置被误判为健康。这个项目适合手里攒了一堆 vless / vmess / trojan / ss 配置、想知道哪些真能用的用户,也适合在 Cloudflare 配置本身能连、但出口被 Google 拒绝时,想借免费配置换一个出口的人。
维护者与状态
项目由 YellowLaborerMarket 维护,仓库创建于 2026-11-15,最后一次提交也在 2026-11-15。截至 2026-11-16,仓库星标数为 473。项目尚无正式 release,README 中自述当前版本为 0.1.0,属于早期预发布,并称端到端流程只在 Windows 上跑通过;macOS、Linux 与 Android 的构建来自 CI 流水线,尚未在真实设备上验证。
主要能力
以下能力均据项目自述整理:
- 两种测试模式,一个开关切换。Simple 模式回答「我这些配置里哪些能用」,链路是「你 → 配置 → AI Studio / Gemini」;Advanced 模式回答「哪些免费配置能穿过我这条配置」,链路是「你 → 基础配置 → 免费配置 → AI Studio / Gemini」。标题下方的线路示意图会随模式变化。
- 以登录态判断区域可用性。项目说明称 Google 是按已登录账号、在页面加载之后决定区域可用性的,因此工具读取的是登录用户看到的页面:AI Studio 被拦表现为跳转到
/docs/available-regions,Gemini 被拦表现为提示所在国家暂不支持。 - 反 DPI 配置。Simple 模式下反 DPI 作用于每一条被测配置;Advanced 模式下作用于基础配置的第一跳,免费配置在该隧道内运行。README 称其分片转发器复现了 patterniha 的 Xray-core 分支中 fragment
finalmask的语义。 - 多种输入方式。可以直接粘贴分享链接(
vless://、vmess://、trojan://、ss://),也可以给订阅 URL 或 base64 文本;留空则测试内置的现成免费列表。 - 导出。Simple 模式可导出链接、base64 或单条配置的完整 Xray 配置;Advanced 模式可导出链接、base64 或
base → free的链式 Xray 配置,布局沿用 v2rayN 的「Copy with chain」。 - 先验基础配置。Advanced 模式在测试免费配置之前会先测基础配置,如果基础配置本身到不了 Google,会直接停下并给出提示。
- 结果与界面。窗口分 Scan、Results、Export 三个标签页,Results 提供实时列表、筛选与复制按钮,界面支持浅色 / 深色主题。
使用入口
仓库地址:Gemini-Config-Checker。据项目说明,各平台构建需从 Releases 页面获取,每个 release 附带 SHA256SUMS.txt。
Windows:解压后直接运行 GeminiConfigChecker.exe,WebView2 已内置于 Windows 10/11;构建未签名,SmartScreen 可能提示。macOS:解压后把 .app 拖入「应用程序」,首次启动右键选择「打开」。Linux:先安装 libgtk-3-0 与 libwebkit2gtk-4.1-0,再运行解压出的可执行文件。Android 8+ 提供 arm64-v8a 的 APK,扫描引擎以前台服务方式运行,需要 Chrome / Edge / Brave 才能做区域检查,而 Android 上只能使用连通性模式。
没有桌面环境时可用 Web 服务器构建:
./gemini-config-checker
随后在浏览器打开 http://localhost:8787。可用参数包括 -addr 127.0.0.1:8787、-no-open、-version。README 明确提醒该界面没有身份验证,应只监听本机,或通过 SSH 隧道访问,不要直接暴露到公网。
许可与限制
项目采用 Apache-2.0 许可证。
据项目说明,已知限制包括:版本仍为 0.1.0 早期预发布,仅在 Windows 上完成端到端验证;macOS、Linux、Android 构建未经真机测试。区域检查依赖本机安装 Chrome / Edge / Brave,登录会在一个独立浏览器配置文件中进行,应用本身看不到密码;项目建议使用次要账号,因为请求来自大量 IP,Google 可能提示可疑登录。Android 无法驱动已登录的 Chromium,因此只能做连通性检查。Web 服务器构建无鉴权。APK 在未配置仓库密钥时使用一次性密钥签名,后续构建无法原地升级,需先卸载。此外,Advanced 模式要求用户先拥有一条本身可用、且不会在 AI Studio 触发区域墙的基础配置。