跳到主要内容
AI教程

如何使用 Gemini Config Checker 测试 Gemini 和 Google AI Studio 代理配置

了解如何安装 Gemini Config Checker，在简单或高级模式下扫描代理配置，验证 Google AI Studio 和 Gemini 访问权限，应用抗 DPI 设置，解读结果，并为兼容 Xray 的客户端导出可用路由。

AI我搜编辑部阅读约 14 分钟
如何使用 Gemini Config Checker 测试 Gemini 和 Google AI Studio 代理配置

Gemini 配置检查器的作用

Gemini 配置检查器会测试代理配置，以确定其是否能够访问 Google AI Studio 和 Gemini。与基本的 HTTP 探测不同，其区域检查模式会在已登录的 Chromium 内核浏览器中打开这些服务，并读取 Google 针对该账户显示的判定结果。

这一点很重要，因为 Google 会在登录页面加载后判定区域可用性。某条线路可能能够成功访问 Google，但仍会被阻止访问 AI Studio、Gemini，或两者都无法访问。同一个代理出口在不同时间也可能得到不同结果。

0.1.0 版本是早期预发布版本。完整工作流已在 Windows 上完成测试。macOS、Linux 和 Android 软件包由 CI 构建，但 README 说明这些版本尚未在真实设备上运行验证。

主要功能

  • 登录状态下的区域验证：检查 Google AI Studio 和 Gemini 显示的消息与重定向结果。
  • 仅连接性测试：确认线路能够访问 Google 并测量延迟，无需登录浏览器。
  • 简单模式：直接从设备测试代理配置。
  • 高级模式：在可用的基础配置后串联免费配置，以寻找其他出口。
  • 多种输入格式：支持分享链接、订阅 URL、base64 订阅，以及在适用情况下完整的 Xray JSON 配置。
  • 抗 DPI 配置：应用可编辑的分片、指纹、ALPN、密码套件和干净 IP 设置。
  • 结果筛选与导出：复制链接、生成 base64 订阅并创建 Xray 配置。
  • 跨平台软件包：发行版包含桌面端、Web 服务器和 Android 版本，但受各平台特定限制影响。

了解简单模式和高级模式

简单模式

当你已有一组配置并想找出可用配置时，请使用简单模式。测试线路如下：

你 -> 配置 -> AI Studio 或 Gemini

你可以提供 vless://、vmess://、trojan:// 或 ss:// 链接、订阅 URL，或 base64 订阅文本。也可以留空输入并选择现成的免费列表。

高级模式

当你有一个能够成功连接、但需要不同且能被 Google 接受的出口时，请使用高级模式。线路变为：

你 -> 基础配置 -> 免费配置 -> AI Studio 或 Gemini

基础配置可以是分享链接、完整的 Xray JSON 配置或多跳链路。扫描候选配置前，应用会测试基础线路；如果无法访问 Google，扫描将停止。

在此模式下，抗 DPI 设置会作用于基础配置的第一跳。导出的 Xray 配置会保留 基础配置 -> 免费配置 链路。

安装与设置

下载并验证发行版

  1. 打开项目的 Releases 页面。
  2. 下载与你的操作系统和架构匹配的软件包。
  3. 如有可能，使用随附的 SHA256SUMS.txt 文件验证下载内容。

Windows

  1. 下载适用于 amd64 或 arm64 的 Windows 桌面版 ZIP。
  2. 将其解压到任意目录。
  3. 运行 GeminiConfigChecker.exe。
  4. 如果 SmartScreen 警告这是未签名版本，并且你信任下载的发行版，请选择 更多信息，然后选择 仍要运行。

区域检查需要 Chrome、Edge 或 Brave。Windows 10 和 Windows 11 已包含 WebView2。

macOS

  1. 下载并解压通用 macOS 压缩包。
  2. 将应用程序移至 Applications。
  3. 首次启动时，右键点击应用程序并选择 打开。

如果 macOS 仍然阻止应用程序运行，README 提供了以下命令：

xattr -dr com.apple.quarantine "/Applications/GeminiConfigChecker.app"

Linux

在 Debian 或 Ubuntu 上，安装桌面运行时库：

sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0

解压压缩包并启动桌面应用程序：

tar -xzf gemini-config-checker-desktop_<version>_linux_amd64.tar.gz
./GeminiConfigChecker

在没有桌面环境的计算机上使用 Web 服务器版本：

./gemini-config-checker

然后打开 http://localhost:8787。Linux 上的区域检查需要 Chrome、Chromium、Edge 或 Brave，以及图形会话。

Android

  1. 在 Android 8 或更高版本的设备上下载 arm64-v8a APK。
  2. 允许用于打开 APK 的浏览器或文件管理器安装应用。
  3. 安装并启动应用程序。

Android 支持仅连接性扫描，不支持登录状态下的区域检查。其常驻通知可在屏幕熄灭时保持扫描引擎运行。使用通知中的停止操作关闭引擎。

如果后续 APK 使用不同的签名密钥，则无法直接更新现有安装。请先卸载旧版本，再安装新版本。

Web 服务器安全

Web 服务器接受以下选项：

./gemini-config-checker -addr 127.0.0.1:8787
./gemini-config-checker -no-open
./gemini-config-checker -version

该界面没有身份验证。请将其绑定到 localhost。若要远程访问，请使用隧道，而不要将其公开暴露：

ssh -L 8787:localhost:8787 your-server

连接 Google 账号以进行区域检查

应用包含 扫描、结果 和 导出 标签页。在运行准确的区域检查前，请连接一个 Google 账号：

  1. 选择 使用 Google 登录。
  2. 等待 Chrome、Edge 或 Brave 打开一个供应用使用的独立配置文件。
  3. 正常登录。应用不会获取您的密码。
  4. 等待浏览器自动关闭，并确认界面显示 Google 账号已连接。

建议使用备用账号，因为请求可能来自多个 IP 地址，这可能触发可疑登录警告。选择 从应用中移除账号 会删除应用的隔离配置文件，但不会更改您的常用浏览器配置文件。

如果没有可用的受支持浏览器，请将检查类型更改为 仅连接性。此模式无需登录，但无法告知您 Google 是否允许该出口区域。

基本用法：在简单模式下扫描配置

  1. 将顶部切换开关设置为 简单。
  2. 每行粘贴一个受支持的代理链接。也可以粘贴订阅 URL 或 base64 订阅。
  3. 如果要扫描内置免费列表，请将输入留空，然后选择一个可用列表。
  4. 如果普通的基于 Cloudflare 的配置无法在您的网络上连接，请启用 Anti-DPI。
  5. 选择 使用已登录浏览器检查区域 以获取可用性判定，或选择 仅连接性 以进行更快的可达性测试。
  6. 选择 开始扫描，或按下 Ctrl 和 Enter。
  7. 打开 结果 标签页查看条目出现。

基本输入可能如下所示：

vless://...
vmess://...
trojan://...
ss://...

扫描器会先在连接性测试期间剔除无法连接的配置。在区域模式下，保留下来的路由会继续通过浏览器检查 AI Studio 和 Gemini。

基本用法：在高级模式下构建链

  1. 切换到 高级。
  2. 粘贴一个可用的基础配置。可以是分享链接、完整的 Xray JSON，或现有的多跳链。
  3. 如果离开您设备的第一个连接需要防 DPI，请启用 Anti-DPI。
  4. 选择免费配置来源。README 推荐使用 verified 列表，而 custom 接受订阅 URL。
  5. 也可以自行粘贴候选免费配置。
  6. 确认检查类型和浏览器登录设置。
  7. 开始扫描。

应用会先验证基础配置，然后通过该配置测试后续的免费路由。如果基础配置无法访问 Google，请先修正后再继续。

配置 Anti-DPI 配置文件

Anti-DPI 配置文件适用于普通 Cloudflare 配置失败的受限网络。其建议默认值包括两个分片掩码、unsafe 指纹、http/1.1 ALPN、预定义的 13 套加密套件列表，以及可选的干净 IP。

  • Finalmask：使用配方中的分片掩码拆分 TLS ClientHello。
  • Fingerprint：默认为 unsafe，使用原生 Go TLS，因此会应用配置的加密套件列表。
  • ALPN：默认为 http/1.1。
  • Cipher suites：使用引用的 Anti-DPI 配方中定义的列表。
  • Clean IP：替换连接地址，同时保留原始域名用于 SNI 和 Host。

选择 从配置读取，可从 finalmask、cipherSuites 和 alpn 等 JSON 字段，或 fm、ciphers、alpn 和 fp 等链接参数中导入兼容值。选择 建议值 可恢复默认值。

应用的本地转发器复现了 PattN Xray 分支所使用的每段 lengths 和 delays 行为。仅支持 fragment 掩码。在受限网络之外请禁用此配置文件，因为它会增加延迟。

选择实用的扫描设置

  • 检查类型：区域模式更准确，但每个配置大约需要 20 到 40 秒。连接性模式更快，但不会验证区域访问权限。
  • 健康标准：要求两个产品均可用、仅 AI Studio 可用，或仅 Gemini 可用。
  • 最大配置数：默认为 60，测试前会先将候选列表随机打乱。
  • 同时进行的浏览器检查：默认为 4。每次浏览器检查约使用 200 MB 内存，因此在配置较低的系统上请减少此数值。
  • 同时进行的连接性测试：默认为 20。
  • 连接超时：默认为 10 秒，较慢的路由可适当增加。
  • 记住：将配置和设置存储在设备的本地存储中。在共享电脑上请禁用此选项。

解读结果

  • 健康：在区域模式下，该路由通过了所选产品规则。
  • 已连接：在连接性模式下，该路由已连接到 Google，但其区域未经验证。
  • 区域受阻：至少一个必需产品显示了区域限制。
  • 错误：配置无法访问、请求超时或遇到浏览器问题。将鼠标悬停在标签上可查看报告的原因。
  • Ping：测量通过完整路由发出的一次请求。

AI Studio 和 Gemini 栏显示的结果可能不同，因为这两个产品可能采用不同的区域规则。你可以按状态筛选，按名称或地址搜索，按延迟或名称排序，还可以选择多个条目进行批量复制。

通过检测结果只是一个样本，并非永久保证。Cloudflare Worker 的退出节点可能在不同连接之间发生变化，因此请重新测试你打算长期使用的线路。

导出可用配置

使用复制将分享链接放入剪贴板。你可以将其粘贴到 v2rayN、Hiddify 或 PattN 等客户端中，也可以粘贴到 BPB 的 Chain Proxy 字段。

在简单模式下，复制完整配置会为选定线路创建 Xray 配置。在高级模式下，复制并串联会创建完整的基础节点到免费节点链。导出选项卡还可以生成每行一个链接的输出、base64 订阅或保存为 JSON 文件。

请谨慎选择导出目标：

  • PattN 或 PattNG：选择包含 finalmask 的选项。
  • 原版 Xray 或 v2rayN：选择标准选项。该选项会移除 finalmask，因为原版核心无法解析分支特有的架构。

生成的文件使用端口 10808 和 10809 上的混合入站、固定 DNS，以及 UDP 443 端口规则。在 v2rayN 中，选择服务器，然后选择添加自定义配置服务器。你也可以直接测试生成的文件：

xray run -c file.json

高级技巧与故障排除

使用正确的健康判定规则

如果 AI Studio 可以使用但 Gemini 被阻止，或反过来，请更改健康状态表示，使其匹配你实际需要的产品。这两项服务可能返回不同的区域判定结果。

减少内存使用

在内存有限的设备上，减少同时进行的浏览器检测数量。连接性检测所需资源较少，通常可以保持更高的并发数，除非网络负载过高。

修复浏览器检测

如果找不到受支持的浏览器，请安装 Chrome、Edge、Brave 或受支持的 Chromium 变体。对于位于非标准位置的浏览器，将其可执行文件路径设置为 GCC_BROWSER 或 CHROME_BIN。应用程序无法驱动 Flatpak 浏览器。

处理大范围超时

如果所有线路都超时，请在常用代理客户端中验证配置。在高级模式下，确认基础配置可以正常使用。在受过滤的网络中，启用反 DPI 配置并尝试使用干净 IP。

恢复过期会话

如果应用程序提示 Google 会话已过期，请重新登录。来自不同 IP 地址的重复请求可能会导致 Google 要求再次进行安全验证。

重置应用程序

先从应用程序中移除账号，然后在必要时删除其本地数据：

  • Windows： %AppData%\GeminiConfigChecker
  • macOS： ~/Library/Application Support/GeminiConfigChecker
  • Linux： ~/.config/GeminiConfigChecker

从源代码构建

构建需要使用 go.mod 指定的 Go 版本。桌面版构建还需要 Wails v2 和对应平台的 WebView 依赖。Android 构建需要 Android SDK、JDK 17 或更高版本，以及 Gradle 8.10。

make test
make web
make desktop
make android
make dist VERSION=0.1.0

make test 会运行 vet 和单元测试。其他命令分别用于构建 Web 服务器、原生桌面应用、Android APK 或交叉编译的发行版二进制文件。

隐私与安全注意事项

  • Google 登录会在独立的浏览器配置文件中进行，而不是在应用程序内部进行。
  • 应用程序不会接收你的 Google 密码。
  • 配置和设置保存在本地存储中，并且仅在启用记住后才会保存。
  • 与 Google 的通信仍受端到端 TLS 保护，但免费代理运营者仍可能看到访问目标。
  • 不要通过未知方运营的免费配置传输敏感流量。
  • 不要将未经过身份验证的 Web 界面暴露在公共网络中。

结论

Gemini Config Checker 提供了一种实用方式，用于区分普通连接性与 Google AI Studio 和 Gemini 的实际区域可用性。直接测试时从简单模式开始；当你需要在可靠的基础线路后使用备用出口时，使用高级模式；然后以客户端支持的格式导出成功结果。由于线路和区域判定可能发生变化，请务必在依赖某个配置前重新测试。