Gemini 怎么配置代理（网页版和 API）

代理改变不了什么

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

• 支持国家指南

• 来源：
• Gemini API 附加服务条款

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

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

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

Gemini CLI

Gemini CLI 从环境变量里读取代理。按它的源代码，会依次取 HTTPS_PROXY、https_proxy、HTTP_PROXY、http_proxy 里第一个已设置的。启动 gemini 之前，把其中一个设成你的代理的 HTTP 地址即可。

Gemini CLI 的文档没有说明支持 SOCKS，所以请用代理的 HTTP 入口（Proxy302 的 HTTP 端口是 2222）。

登录方式：Google 关于 Gemini Code Assist 个人版的公告写明，自 2026 年 6 月 18 日起，Gemini Code Assist 个人版、Google AI Pro 和 Google AI Ultra 的用户，不能再用“使用 Google 账号登录”访问 IDE 扩展或 Gemini CLI。Gemini Code Assist Standard 和 Enterprise 订阅适用另外的时间表。规划登录方式前，请先看这份公告。

• Google 公告

• 来源：
• Gemini CLI source code (google-gemini/gemini-cli): proxy setting
• Google: Gemini Code Assist for individuals deprecation notice

Gemini CLI: macOS, Linux

# macOS, Linux, WSL
export HTTPS_PROXY='http://username:password@proxy-host:port'
gemini

macOS、Linux、WSL。仅为示例：把占位的值换成你自己的。

• 来源：
• Gemini CLI source code (google-gemini/gemini-cli): proxy setting

Gemini CLI: Windows PowerShell

# Windows PowerShell
$env:HTTPS_PROXY = "http://username:password@proxy-host:port"
gemini

Windows PowerShell，只对当前窗口有效。仅为示例：把占位的值换成你自己的。

• 来源：
• Gemini CLI source code (google-gemini/gemini-cli): proxy setting

用 MCP 给 Gemini CLI 加一个代理工具

MCP 可以给 Gemini CLI 增加工具。装上 proxy302-mcp 后，Gemini CLI 能获取 Proxy302 代理，并通过它打开网页。把下面这段加进 ~/.gemini/settings.json；只想在某个项目里用，就加进该项目的 .gemini/settings.json。

proxy302-mcp 是 Proxy302 官方的 MCP 服务，在 GitHub 开源，由 Proxy302 团队维护。Proxy302 也在 https://proxy302.com/v1/mcp 托管了一份：Claude Code、Cursor、VS Code 这类能带 Authorization 请求头的客户端，填 API 密钥就能连，不用安装。

这和上面的代理变量是两套互不相干的设置：变量决定 Gemini CLI 自己怎么联网，MCP 服务器提供的工具另有各自的设置。工具清单、其他客户端和使用限制见 Proxy302 MCP 服务器指南。

• Proxy302 MCP 服务器指南

• 来源：
• Gemini CLI docs: MCP servers
• proxy302-mcp 的 README（Proxy302 官方 MCP 服务）

用 MCP 给 Gemini CLI 加一个代理工具: settings.json

{
  "mcpServers": {
    "proxy302": {
      "command": "npx",
      "args": [
        "-y",
        "github:proxy302/proxy302-mcp"
      ],
      "env": {
        "PROXY302_API_KEY": "<key id>:<secret>"
      }
    }
  }
}

文件 ~/.gemini/settings.json。把 <key id>:<secret> 换成你的 Proxy302 API 密钥。

• 来源：
• Gemini CLI docs: MCP servers

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

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

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

• 来源：
• Gemini API 附加服务条款

超时

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

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

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

代理租期还有没有到期

代理身份验证错误（状态码 407）

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

用 Proxy302 怎么做

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

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

• Gemini 代理页
• 静态 ISP 代理页面

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

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

• 来源：
• Proxy302 每小时连通检测

用 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 步

   在中国大陆，先在「工具与检测」页打开Proxy302 极速连接工具，使用代理期间保持开着。

   • 极速连接工具指南

价格与限制

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

• 预算有限？可选普通静态住宅 IP

• 来源：
• Proxy302 产品事实与价格表

Proxy302 一览

价格按 PTC 从钱包扣，1 PTC = 1 美元。没有免费试用：最小一单是 1 GB 动态住宅流量，或一个 IP 用 1 天。核对于 2026-11-04。

• 来源：
• Proxy302 产品事实与价格表
• Proxy302 ISP for AI subscriptions: public catalog

常见问题

延伸阅读

Gemini 代理

Gemini 代理即 Gemini 专用 ISP：独享原生 IP，30 天 8 PTC，选在 Gemini 网页版和 AI Studio 两份名单都有的国家。

查看配置与价格

ChatGPT、Claude、Gemini 支持的国家和地区

对照 OpenAI、Anthropic、Google 四份官方名单：中国大陆、香港、澳门、台湾能否使用，报错是什么意思，附 7 个国家每小时实测。

代理 IP 怎么查：IP 地址、国家、运营商

30 秒查清代理的 IP、国家和运营商；为什么不同查询网站城市对不上、纯净度分数看什么。附我们对三家查询服务的实测。

静态住宅 IP（ISP 代理）

静态 ISP 代理：一条固定的住宅级 IP，整个租期内保持不变。适合社媒账号、店铺和 AI 工具。支持 HTTP / SOCKS5。

查看配置与价格

代理 MCP 服务器

讲清楚代理 MCP 服务器是什么、本地和远程 MCP 服务器有什么区别、怎么装进 Claude Code、Codex CLI 和 Cursor，以及 MCP 服务器自己的网络请求怎么走代理。