Gemini 使用与网络指南:网页端、AI Studio、API 与 Gemini CLI
Gemini 的网络问题大多与「地区」有关,其次是 Google 服务使用的 QUIC 协议。本文按入口整理配置要点。
核心结论
- 出口地区必须在对应 Gemini 产品的可用地区列表内。
- 地区问题可能与账号相关因素有关,不一定能通过网络解决。
- 页面加载慢可以尝试在规则中拒绝 UDP 443,让浏览器使用 TCP。
- API 与 Gemini CLI 需要终端走代理。
第一件事:确认出口地区
Gemini 相关产品都有公开的可用地区列表。使用前:
- 在代理客户端中查看当前节点的落地地区;
- 对照官方列表确认该地区可用;
- 为 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 API 可用地区
- 官方资料Gemini CLI 官方仓库