AI工具指南Gemini 使用指南

Gemini 使用与网络指南:网页端、AI Studio、API 与 Gemini CLI

Gemini 的网络问题大多与「地区」有关,其次是 Google 服务使用的 QUIC 协议。本文按入口整理配置要点。

作者:机场博客编辑部发布:更新:约 1 分钟阅读

Gemini 使用指南

核心结论

  • 出口地区必须在对应 Gemini 产品的可用地区列表内。
  • 地区问题可能与账号相关因素有关,不一定能通过网络解决。
  • 页面加载慢可以尝试在规则中拒绝 UDP 443,让浏览器使用 TCP。
  • API 与 Gemini CLI 需要终端走代理。

第一件事:确认出口地区

Gemini 相关产品都有公开的可用地区列表。使用前:

  1. 在代理客户端中查看当前节点的落地地区;
  2. 对照官方列表确认该地区可用;
  3. 为 Google / Gemini 相关域名固定使用这个地区的节点。

如果出口地区正确、浏览器流量也确实经过代理,但仍然提示不可用,问题可能与账号的关联国家/地区等因素有关,这部分以 Google 官方说明为准。

网页端与 AI Studio

分流规则

Google 服务域名很多。多数订阅自带的规则会把 Google 相关域名整体指向代理,一般不需要手动添加。如果你自定义了规则,至少要覆盖 google.com、googleapis.com、gstatic.com 等域名。

加载缓慢与 QUIC

Google 服务支持基于 UDP 的 QUIC 协议。在 TUN 模式下,如果节点不支持 UDP,浏览器会先尝试 QUIC,超时后才改用 TCP,表现为页面每次都要卡几秒。处理方法:

  • 在 mihomo 规则中拒绝 UDP 443(示例见 Gemini 稳定机场);
  • 或者换用支持 UDP 的节点。

Gemini API

用程序调用 Gemini API 时,需要确认程序的请求经过代理:

export HTTPS_PROXY=http://127.0.0.1:7897
python your_script.py

如果 API 返回 User location is not supported for the API use,说明请求出口不在支持范围内,或者程序根本没有走代理。

Gemini CLI

Gemini CLI 是 Google 提供的开源命令行工具,可以通过 npm 安装:

npm install -g @google/gemini-cli
gemini

与其他终端 AI 工具一样,它需要通过环境变量或 TUN 模式走代理,配置方法见 为终端 AI 工具配置代理。登录方式(Google 账号、API Key 等)以官方文档为准。

遇到问题

报错排查见 Gemini 请求失败排查;网络服务选择见 Gemini 稳定机场。

常见问题

Gemini 和 Google AI Studio 是一回事吗?

不是。Gemini 应用面向普通用户;Google AI Studio 是面向开发者的调试与 API Key 管理工具。两者都使用 Gemini 模型,但入口和可用地区规则可能不同。

Gemini CLI 怎么设置代理?

可以在启动前设置 HTTPS_PROXY 环境变量,或者开启代理客户端的 TUN 模式。具体选项以 Gemini CLI 官方文档为准。

资料来源与数据性质

返回上级专题Gemini 稳定机场选择指南Gemini 对访问地区较为敏感。本专题解释 Gemini 网页端、AI Studio、API 与 Gemini CLI 的网络需求,分析地区不受支持、请求失败、页面加载缓慢等问题,并给出选择建议。