Gemini Config Checker 是一个用来筛选代理配置的工具。它不靠简单的连通性探测下结论,而是在已登录 Google 账号的浏览器里打开 AI Studio 和 Gemini,看 Google 实际返回什么页面,从而判断某条代理配置能否真正进入这两个服务。
项目当前版本为 0.1.0,属于早期预发布。按 README 说明,它目前只在 Windows 上完成端到端验证;macOS、Linux 和 Android 构建来自 CI 流水线,尚未在真实设备上充分测试。
为什么需要“登录态浏览器”
Google 对区域可用性的判断是绑定已登录账号的,并且发生在页面加载之后。普通的 HTTP 请求——即使是以假密钥调用 Gemini API——从任何国家看起来都可能“正常”,这会让连通性探测把每条活着的代理都标记成健康。
项目在开发时观察到:出口定位到美国、香港和新加坡的配置也可能被拦截,而且同一个出口的状态会随时间变化。因此这个工具选择读取 Google 向已登录用户展示的结果:
- AI Studio 被拦截时,页面会跳转到
/docs/available-regions。 - Gemini 被拦截时,会显示“Gemini isn’t currently supported in your country”。
两种模式:Simple 与 Advanced
界面顶部的 Simple / Advanced 开关决定测试的对象和路由结构,标题下方的路由示意图也会随之变化。
| Simple | Advanced | |
|---|---|---|
| 回答的问题 | 我手上的哪些配置能用? | 哪些免费配置能通过我的配置走出去? |
| 路由 | 你 → 配置 → AI Studio / Gemini | 你 → 基础配置 → 免费配置 → AI Studio / Gemini |
| 需要提供 | 自己的配置(链接、订阅地址或 base64),或选择现成的免费列表 | 一条可用的基础配置,以及免费列表或粘贴的配置 |
| Anti-DPI 应用对象 | 每条被测配置(各自从本机连接) | 基础配置的第一跳(免费配置在其隧道内运行) |
| 典型用途 | 批量检查已有配置;在依赖某条配置前先验证它 | Cloudflare 配置本身能连,但需要一个 Google 能接受的出口 |
| 导出 | 链接、base64、单条配置的完整 Xray 配置 | 链接、base64、链式 Xray 配置(基础 → 免费) |
主要功能与使用方式
输入与扫描
在 Simple 模式下,可以把 vless://、vmess://、trojan://、ss:// 配置逐行粘贴到输入框,也支持订阅 URL 或 base64 文本;留空则测试内置的现成免费列表。Advanced 模式需要先提供一条能正常工作、且不会在 AI Studio 触发区域墙的基础配置,支持分享链接、完整 xray JSON,甚至多跳链。扫描前工具会先测试基础配置,如果它本身无法到达 Google,会给出明确提示并停止。
结果页会实时列出每条配置的状态,包括健康/已连接、区域被拦截、错误等,并显示 AI Studio 与 Gemini 两列的独立结果、Ping 延迟。可以按状态筛选、按名称或地址搜索、按延迟或名称排序,并多选后批量复制。
Anti-DPI 配置
工具内置了一套针对过滤网络的 Anti-DPI 配置,默认值来自 patterniha / PattN 的方案,包括 Finalmask 分片、TLS 指纹、ALPN、密码套件和 Clean IP 等字段。每个值都可以编辑,点击“Suggested values”可恢复默认。
由于标准 xray-core 只支持每个 fragment mask 一个 length/delay,而该方案使用按段设置的 lengths/delays(PattN fork 的特性),工具在连接前运行一个小型本地转发器来复现相同的分片算法。目前只支持 fragment 类型的 mask,其他类型会被拒绝并给出提示。README 也提醒:在非过滤网络中应关闭该配置,否则只会增加延迟。
导出与客户端兼容
结果可以复制为分享链接,用于 v2rayN、Hiddify、PattN 等客户端,或粘贴到 BPB 的 Chain Proxy 字段。也可以导出为可直接导入的 Xray 配置,导出时可选择目标客户端:PattN / PattNG 会保留 finalmask 字段;标准 Xray / v2rayN 则会移除该字段,因为标准核心无法解析 fork 的 schema。导出的文件使用经典的 vnext / servers 布局,混合入站端口为 10808 和 10809,并包含固定 DNS 和 UDP/443 阻断。
运行环境与安装
项目提供桌面应用、Web 服务器和 Android APK 三种形态。桌面应用基于 Wails 构建,Web 服务器在 http://localhost:8787 提供同一套界面。
| 平台 | 桌面应用 | Web 服务器 | 区域检查 |
|---|---|---|---|
| Windows | amd64、arm64 | amd64、arm64 | 需要 Chrome / Edge / Brave |
| macOS | universal(Intel + Apple Silicon) | amd64、arm64 | 需要 Chrome / Edge / Brave |
| Linux | amd64(GTK 3 + WebKitGTK 4.1) | amd64、arm64、armv7 | 需要 Chrome / Chromium / Edge / Brave |
| Android 8+ | APK(arm64-v8a) | 需从源码为 Termux 构建 | 仅连通性模式 |
Windows 用户下载 zip 解压后运行 GeminiConfigChecker.exe 即可,WebView2 已内置于 Windows 10/11。macOS 首次启动需右键打开;Linux 需要预先安装 GTK 3 和 WebKitGTK 4.1 运行库。Android APK 运行的是仅连通性模式,因为 Android 不允许应用驱动已登录的 Chromium,无法在该平台验证区域。
Web 服务器版本可通过 -addr、-no-open、-version 等参数控制。README 特别提醒:该界面没有身份认证,应只监听本地或通过 SSH 隧道访问,不要直接暴露到公网。
设置项与结果解读
检查类型有两种:区域检查会打开 AI Studio 和 Gemini 读取 Google 的判断,每条配置约需 20–40 秒;仅连通性模式只证明路由能到达 Google 并测量延迟,速度快但不会检查区域。其他设置包括“健康”的定义(同时要求 AI Studio 和 Gemini、仅其一)、最大测试配置数、并发浏览器检查数、并发连通性测试数、连通性超时等。
需要强调的是,README 明确说明:一次判定只是样本,不是保证。Cloudflare Worker 的出口可能在两次连接之间变化,同一条路由可能现在通过、一分钟后就失败。打算长期使用的配置应重新测试。
适用人群与注意事项
这个工具适合已经有一批代理配置、想快速筛出能进入 Google AI Studio 和 Gemini 的人;也适合 Cloudflare 配置本身可用、但需要换一个 Google 能接受的出口的场景。它依赖真实浏览器完成区域判定,因此对桌面环境有要求,服务器上需要图形会话或改用连通性模式。
项目目前是早期版本,跨平台构建尚未充分实机验证;Android 只能做连通性检查;Web 界面无认证;Anti-DPI 配置在非过滤网络中反而增加延迟。这些都是在使用前需要了解的限制。
项目主页
https://github.com/YellowLaborerMarket/Gemini-Config-Checker-
相关推荐
Gemini Config Checker:用「登录态浏览器」验证代理配置能否真正进入 Gemini 和 AI Studio
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、桌面和手机应用。





