很多代理配置检测工具都会告诉你「连接成功」,但这并不等于你能真正打开 Google AI Studio 或 Gemini。Google 对这两个产品的地区限制,是在用户登录后、页面加载完成时才判定的,普通 HTTP 探测(哪怕请求的是 Gemini API)几乎都会返回「正常」。Gemini Config Checker 试图解决的就是这个问题:它把每条代理配置放进一个已经登录 Google 的浏览器里,按真实使用路径打开 AI Studio 和 Gemini,读取 Google 实际给出的「可用」或「地区受限」结果。
项目是什么
Gemini Config Checker 是一个开源桌面应用兼 Web 服务,用来自动扫描一批代理配置,找出真正能让你进入 Google AI Studio 和 Gemini 的那几条。项目当前版本为 0.1.0,属于早期预发布阶段,作者明确说明目前只在 Windows 上完整跑通过;macOS、Linux 和 Android 的构建来自 CI 流水线,尚未在真实设备上验证。
根据 README,一个普通 HTTP 请求无法可靠判断地区可用性:探测时标记为「健康」的出口,实际可能在美国、香港、新加坡等地区被 Google 拦截,而且同一个出口的判定还可能随时间变化。因此项目选择读取登录用户看到的页面结果:AI Studio 被拦截时会跳转到 /docs/available-regions,Gemini 则显示「Gemini isn’t currently supported in your country」。
两种工作模式
界面顶部的 Simple / Advanced 开关决定检测的内容和链路结构,标题下方的路线示意图会同步变化。
- Simple 模式:回答「我手上的这些配置哪些能用」。路径是 你 → 被测配置 → AI Studio / Gemini。你可以粘贴分享链接、订阅地址、base64 文本,或直接选择一个现成的免费配置列表。Anti-DPI 配置作用于每一条被测配置。
- Advanced 模式:回答「哪些免费配置能通过我的基础配置工作」。路径是 你 → 基础配置 → 免费配置 → AI Studio / Gemini。你需要提供一条已经可用的基础配置,再选择或粘贴免费配置列表;Anti-DPI 只作用于基础配置的第一跳。适合「Cloudflare 配置本身能连,但出口被 Google 拒绝」的情况。
两种模式随时可以切换,结果会保留产生它的扫描模式,导出和复制操作也跟随该模式。
真实存在的功能特点
- 登录态地区检测:点击「Sign in with Google」会打开一个仅由本应用使用的 Chrome / Edge / Brave 独立配置文件,用户正常登录;应用本身看不到密码。登录被识别后窗口自动关闭,下次启动会记住登录状态。
- 仅连通性检测:在 Settings 中把检测类型切为 connectivity only,就不需要浏览器和登录,只验证路由能否到达 Google 并测量延迟,但不会验证地区。Android 版本只能使用这一模式。
- Anti-DPI 配置:内置一套面向受限网络的默认参数,包括 Finalmask 分片、fingerprint、ALPN、cipher suites 和 Clean IP,每一项都可编辑,并提供「Suggested values」恢复默认值。可以从粘贴的配置中读取已有的相关参数。
- 两阶段检测:先用并发的连通性测试快速淘汰死配置,再进入浏览器阶段做地区判定。
- 结果与导出:结果页可按状态筛选、按名称或地址搜索、按延迟或名称排序,并支持多选批量复制。导出页可输出分享链接、base64 订阅或完整的 Xray 配置,Advanced 模式下还能生成 base → free 的链式 Xray 配置。
- 本地记忆:勾选 remember 后,输入的配置和设置只保存在本设备的本地存储中。
使用方式与运行环境
项目提供各平台的发布包,每个 release 都附带 SHA256SUMS.txt。桌面版和 Web 服务版的可用情况如下:
- Windows:amd64、arm64 桌面版,需要 Chrome / Edge / Brave 做地区检测;WebView2 已内置于 Windows 10/11。
- macOS:universal 桌面版(Intel + Apple Silicon),另提供 amd64 / arm64 Web 服务版。
- Linux:amd64 桌面版,依赖 GTK 3 与 WebKitGTK 4.1;Web 服务版覆盖 amd64、arm64、armv7。没有桌面环境时可直接运行 Web 服务版,在浏览器中打开
http://localhost:8787。 - Android 8+:提供 arm64-v8a APK,仅支持连通性模式。扫描引擎以前台服务方式运行,屏幕关闭时仍可继续扫描。
Web 服务版支持 -addr、-no-open、-version 参数。README 特别提醒其 UI 没有身份认证,应只监听 localhost,或通过 SSH 隧道访问,不要直接暴露到公网。
基本流程是:选择模式、填入配置或选择免费列表、按需配置 Anti-DPI、完成 Google 登录或选择仅连通性检测,然后开始扫描。Advanced 模式会先测试基础配置,若基础配置本身无法到达 Google,会停止并给出明确提示。
适用人群
这个工具适合已经持有一批代理配置、想确认哪几条能实际打开 AI Studio 和 Gemini 的用户;也适合基础配置可用、但需要换一个 Google 能接受的出口的用户。它不负责提供代理服务,也不替代代理客户端,扫描结果需要粘贴回 v2rayN、Hiddify、PattN 等客户端使用。
注意事项
- 结果是采样,不是保证。Cloudflare Worker 的出口可能在两次连接之间变化,同一条路由可能此刻通过、稍后失败,打算长期使用的配置应重新测试。
- 地区检测每条配置大约需要 20–40 秒;默认同时进行 4 个浏览器检查,每个约占用 200 MB 内存,小内存机器应调低。
- 项目默认只支持
fragment类型的 mask,其他类型会被明确拒绝。标准 xray-core 只支持单个 length/delay,而配方使用分段 lengths/delays,因此应用在连接前用一个本地转发器复现相同的分片算法。 - Anti-DPI 配置在非受限网络中只会增加延迟,应关闭。
- Windows 构建未签名,SmartScreen 可能提示;macOS 首次启动需右键打开或移除 quarantine 属性。
- 导出 Xray 配置时需选择目标客户端:PattN / PattNG 版本保留
finalmask,标准 Xray / v2rayN 版本会移除它,因为原版核心无法解析该字段。 - Android 发布 APK 在未配置仓库密钥时使用临时密钥签名,后续构建无法原地升级,需要先卸载旧版。
项目数据与许可
该项目在 GitHub 上获得 473 个 Star,Fork 数为 0。主要语言标注为 Makefile,许可证为 Apache-2.0。README 中列出了多个参考项目与工具,包括 Free-v2ray-Configs 的免费配置列表、patterniha 的 PattN / PattNG 与 Anti-DPI 配方、BPB-Worker-Panel、SenPaiScanner、XTLS/Xray-core、v2rayN、Wails 以及界面所用字体。
项目主页:https://github.com/VortexHostFeel/Gemini-Config-Checker-
相关推荐
Gemini Config Checker:用已登录浏览器筛选能进入 Google AI Studio 与 Gemini 的代理配置
Gemini Config Checker:用登录态浏览器实测代理配置能否进入 Google AI Studio 与 Gemini
STE80 Humanizer:两步改写,让 AI 文本读起来像人写的
smolmaxxing:在电视盒子、旧iPad和手机上跑起16B到80B大模型
Freebie Radar:835 Star 的福利聚合雷达,57 个源定时采集并用 AI 过滤假福利
Muse4AI:让 AI Agent 直接调用本机 Muse 会话生成图片和视频
muse.ai 注册与邀请码兑换协议分析:纯 HTTP Python 实现的协议细节项目
Blender AI 助手 mcp-for-blender-pro:用对话和智能体操作场景
最近更新
Gemini Config Checker:用「登录态浏览器」验证代理配置能否真正进入 Gemini 和 AI Studio
Gemini Config Checker 是一个开源工具,通过在已登录 Google 的浏览器中实际打开 AI Studio 和 Gemini,判断代理配置是否真的能绕过地区限制。支持 Simple / Advanced 两种检测模式、Anti-DPI 参数和 Xray 配置导出,当前为 0.1.0 早期版本。
Gemini Config Checker:用已登录浏览器筛选能进入 Google AI Studio 与 Gemini 的代理配置
Gemini Config Checker 是一个早期预发布工具,通过在已登录 Google 账号的浏览器中打开 AI Studio 和 Gemini,筛选真正能进入这两项服务的代理配置,支持 Simple/Advanced 两种模式和 Anti-DPI 配置。
Gemini Config Checker:用登录态浏览器实测代理配置能否进入 Google AI Studio 与 Gemini
Gemini Config Checker 是一个通过已登录 Google 账号的真实浏览器来筛选代理配置的工具,判断配置能否真正进入 Google AI Studio 和 Gemini,支持 Simple 与 Advanced 两种链式测试模式。
STE80 Humanizer:两步改写,让 AI 文本读起来像人写的
STE80 Humanizer 是一个面向 AI Agent 的写作技能,先用 26 条规则清理 AI 写作痕迹,再把句子结构向 ASD-STE100 简化技术英语靠拢到约 80%。本文介绍它的两步方法、三种模式、安装方式、检查脚本和适用边界。
smolmaxxing:在电视盒子、旧iPad和手机上跑起16B到80B大模型
smolmaxxing 是基于 llama.cpp 的端侧推理项目,已在电视盒子、旧 iPad 和 OnePlus 手机上实测运行 2B 到 80B 模型,通过定制内核、内存裁剪、专家按需从闪存读取等技术,让模型大小超出可用内存的设备也能完成推理。
Freebie Radar:835 Star 的福利聚合雷达,57 个源定时采集并用 AI 过滤假福利
Freebie Radar 是一个自托管的福利与多兴趣信息聚合雷达,用 57 个源定时采集、AI 语义审核过滤假福利,并按获取方式分级和多路由推送到 Telegram。项目基于 TypeScript 与 SQLite,支持 Docker Compose 快速启动,GitHub 上已有 835 Star。
Muse4AI:让 AI Agent 直接调用本机 Muse 会话生成图片和视频
Muse4AI 是一个运行在 Windows 本机的桥接工具,通过 REST、MCP 和 OAuth 把用户的 Muse 会话开放给 ChatGPT、Claude、Cursor、Codex、n8n 等 AI Agent,用于生成图片视频、继续对话、延长或按描述编辑视频。项目不经过自有云端中转,结果和密钥保存在本机,采用 MIT 许可证。
muse.ai 注册与邀请码兑换协议分析:纯 HTTP Python 实现的协议细节项目
一个用 Python 纯 HTTP 实现 muse.ai 注册与邀请码兑换流程的研究项目,整理了抓包比对得出的协议细节,包括 OTP 确认、会话引导、动态披露文案、vm/wake 调用和邀请码兑换失败原因等。项目不采用 MIT 等开源许可证,仅供个人非商业学习研究使用。
Blender AI 助手 mcp-for-blender-pro:用对话和智能体操作场景
mcp-for-blender-pro 是一个面向 Blender 的 AI 助手插件,内置 MCP 服务器,支持 OpenAI、Claude、Gemini、Ollama 等模型,可通过对话检查场景、创建物体、编辑材质和搜索资产,并提供单助手与多智能体团队链工作流。
agentes.chat:让团队和 AI 智能体在同一个聊天空间协作的自托管 Slack 替代方案
agentes.chat 是一个开源、可自托管的 Slack 替代方案,让 AI 智能体作为正式成员加入频道和私信,支持 Claude、ChatGPT/Codex、Gemini、Grok 等模型,配备 MCP 工具、独立计算机与浏览器、例行任务、记忆和审批机制,并提供 Web、桌面和手机应用。




