跳到正文

Gemini 怎么配置代理(网页版和 API)

Gemini 是否可用由 Google 决定;其条款只允许在可用地区内使用,代理不会改变这一点。本文只讲网络设置:怎么给 Gemini 网页版、Google AI Studio 和 Gemini API 配代理,以及常见报错怎么排查。

代理改变不了什么

本文讲的是网络设置,不是 Gemini 对你开不开放。Gemini API 附加条款写明:只能在可用地区内访问服务(或向用户提供 API 客户端)。Google 会根据请求的 IP 地址和其他数据(例如账号设置)判断地区。Gemini 网页版、Google AI Studio 和 Gemini API 这三个服务的支持列表可能不同,所以一个能用,另一个不一定能用。各服务支持哪些国家,见支持国家指南。

在浏览器中为 Gemini 网页版配置代理

对于 gemini.google.com 网站上的 Gemini 网页版,只需在操作系统层面配置代理,或使用浏览器扩展即可。系统级代理配置下,浏览器会自动将其用于所有请求,包括访问 Gemini。另一种方案是使用代理管理扩展,例如 SwitchyOmega,它可以在不更改系统设置的情况下快速切换多个代理。

如果你使用的是需要身份验证的代理,请确保在扩展或系统设置中填写了账号和密码(即 USERNAME 和 PASSWORD)。配置完成后,检查浏览器是否真的在使用代理:打开 IP 查询服务,确认显示的地址与所选地区一致。如何检查代理出口国家,详见代理 IP 地址检查指南。

为 Google AI Studio 配置代理

Google AI Studio 位于 aistudio.google.com,用于创建 API 密钥、管理项目和测试模型。与 Gemini 网页版一样,AI Studio 也根据出口 IP 地址判定访问权限。

静态 ISP IP 用起来很方便:租期内不会变,地址不会在操作中途「跳变」,出错时也更好查原因。AI Studio 的支持国家可能和网页版不一样,所以连接正常也不代表 AI Studio 对你可用。

Proxy302 每小时检测一次 Gemini。2026 年 10 月 23 日 15:47 UTC 的一次样本:美国出口在丹佛(AS7922),德国出口在科隆(AS8422)。每国只测一次,不是平均值,下次结果会不同。

通过代码为 Gemini API 配置代理

可以通过官方 Python SDK 或 HTTP 请求(例如 cURL)从代码调用 Gemini API。这两种情况下,代理都通过环境变量或客户端参数来配置。

环境变量

在运行脚本或命令前设置环境变量。走 HTTP 代理时,请使用 HTTPS_PROXY:

用 HTTPS_PROXY 设置代理

export HTTPS_PROXY='http://username:password@proxy-host:port'

仅为示例:请把占位内容换成你自己的值。

密码特殊字符和 NO_PROXY

如果密码中包含特殊字符(例如 @ 或 :),请进行百分号编码:将 p@ss 改为 p%40ss。未编码的 @ 符号会破坏代理地址的解析。将 localhost 和 127.0.0.1 添加到 NO_PROXY 变量中,使本地服务不尝试通过代理:

用 NO_PROXY 设置例外

export NO_PROXY=localhost,127.0.0.1

仅为示例:请把占位内容换成你自己的值。

Python SDK

在官方 Python Gen AI SDK 中,要使用 SOCKS5 代理,需要额外安装 httpx[socks] 包,然后在创建客户端时通过 HttpOptions 传递代理参数。对于 HTTP 代理,仅环境变量 HTTPS_PROXY 就足够了。

cURL 和命令行

通过 cURL 调用 Gemini API 时,使用 -x 标志指定代理,或在环境中设置 HTTPS_PROXY。要验证配置是否生效,可以执行 models.list 请求——如果收到状态码 200 和模型列表的响应,说明代理配置正确。

HTTP 和 SOCKS5 支持情况

所有访问 Gemini 的方式(浏览器、Python SDK、cURL 和命令行)都支持 HTTP 代理。SOCKS5 的支持较有限:在官方 Python Gen AI SDK 中,它通过 httpx[socks] 库工作;在命令行工具中,SOCKS5 的支持取决于版本。如果 SOCKS5 出现连接中断,请改用 HTTP 代理。

地区错误(「你所在的国家/地区不受支持」)

出现这个提示,说明 Google 不在它认定的你所在地区提供该服务。Gemini 网页版、AI Studio 和 API 的支持列表可能不同,代理也不会改变 Google 的条款。想知道 Google 收到的是哪个地址,请检查:

是否真的在用这个地址:确保其他 VPN 或代理已关闭,流量只走你选的代理

超时

通常是代理连不上、地址或端口填错、租期到了,或者网络拥堵。检查要点:

代理的地址、端口和凭据是否正确

代理在网络上的可用性(ping、测试请求)

代理租期还有没有到期

代理身份验证错误(状态码 407)

由账号或密码错误引起。常见原因是密码里的特殊字符没有编码。请核对密码的百分号编码是否正确,账号和密码是否与「我的资产」里显示的一致。

用 Proxy302 怎么做

静态 ISP 代理很适合这种用法:整个租期内 IP 固定、不会轮换,一个地址可以一直固定给一个账号或一个工具使用。现成的预设和完整设置见 Gemini 代理页,产品介绍见静态 ISP 代理页面。

下表是我们最近一次每小时检测的结果:从 7 个国家的出口访问 Gemini。这项检测走的是动态住宅出口,不是静态 ISP IP:它只说明从这些国家能不能连上服务,不代表某个租用 IP 的质量;响应时间是从我们在亚洲的探测器测的。

实测出口:Gemini 从 7 个国家的连通

实测出口:Gemini 从 7 个国家的连通
项目运营商网络ASN响应时间(毫秒)
美国Comcast Cable Communications, LLCAS7922314
英国PlusnetAS6871345
德国NetCologne Gesellschaft fur Telekommunikation mbHAS84226441
日本NTT DOCOMO BUSINESS,Inc.AS4713331
新加坡Whiz Communications Pte LtdAS135600459
巴西KMM TELECOM LTDA-MEAS264542734
印度尼西亚PT Telekomunikasi IndonesiaAS7713367

Proxy302 探测器每小时检测一次,本次检测时间:2026 年 10 月 23 日 15:47 UTC。每个国家通过一个动态住宅出口、经公开的 Proxy302 入口向 Gemini 发一次请求。IP 只公开前三段。每国一个样本,不是平均值,之后的检测结果会不同。

用 Proxy302 怎么做:步骤

  1. 第 1 步

    打开「静态 ISP 代理」页面,选择「地区」「租期」和「数量」,再选「协议」HTTP 或 SOCKS5。协议在购买时确定,之后每个 IP 都固定不变。

  2. 第 2 步

    生成 IP 后,打开「我的资产」,逐一复制各 IP 的 HOST(地址)、PORT(端口)、USERNAME(账号)和 PASSWORD(密码)。「连接工具」页(控制台里教你把代理接到各种软件的页面)里有填好你自己连接信息的现成示例。

  3. 第 3 步

    把这些信息填入要用这个 IP 的浏览器配置文件、软件或手机。

  4. 第 4 步

    通过代理访问 https://ipinfo.io/json,核对返回结果中的 country 字段是否与你选择的地区一致。

  5. 第 5 步

    在中国大陆,先在「连接工具」页打开辅助工具,使用代理期间保持开着。

价格与限制

静态 ISP IP 一天 US$0.50、30 天 US$7.99,约合每天 US$0.27,各国价格相同。库存每天都会变化,以下单页面为准。没有免费试用,最小购买量是 1 个 IP、1 天。换 IP 不能解除限制、撤销封号或提高限额。

常见问题

如何检查代理是否正常工作并返回所需国家?

通过代理向 IP 查询服务发送请求(例如,HTTP 代理使用 curl -x http://user:pass@host:port https://ipinfo.io/json,SOCKS5 使用 curl -x socks5h://user:pass@host:port https://ipinfo.io/json)。在响应中找到 country 字段,并将其与预期地区比较。检查 IP 地址的详细说明见检查指南。

为什么 Gemini 可以用,但 Google AI Studio 不行?

这些服务的支持国家列表可能不同,所以一个能用、另一个不一定能用,代理改变不了这一点。支持地区信息可在支持国家参考中查阅。

长期使用 Google 账号应该选择哪种代理?

静态 ISP IP 在整个租用期间不会改变,而动态住宅代理适用于不需要同一地址的短期检查。

是否需要对每个工具单独配置代理?

浏览器不需要:Chrome 和 Edge 使用系统代理。curl 和大多数命令行工具不读取系统设置,稳妥的做法是在同一终端会话中先设置 HTTPS_PROXY(和 NO_PROXY),Python SDK 也一样。

如果使用 SOCKS5 时出现连接错误该怎么办?

请尝试改用 HTTP 代理:大多数工具都支持它。如果确实需要 SOCKS5,请确保为 Python SDK 安装了 httpx[socks] 包。

参考资料

3
  1. Gemini API 附加服务条款

    官方文档 · 确认日期:

    2026 年 10 月 24 日读取:只能在可用地区内访问服务(或向用户提供 API 客户端)。

  2. Proxy302 产品事实与价格表

    产品观察 · 确认日期:

    站点的产品事实表(数值已于 2026 年 10 月 18-19 日对照控制台、后端和价格表核对):产品、美元价格(1 PTC = 1 美元)、租期、协议与端口、国家数、数量上限、没有免费试用。

  3. Proxy302 每小时连通检测

    产品观察 · 确认日期:

    探测器的公开 JSON proxy302.com/live/connectivity/gemini.json,读取于 2026 年 10 月 23 日 15:47 UTC:每个出口国家一次请求,经动态住宅出口;出口城市、ASN、网络和响应时间。

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。