为什么要把 Gemini / AI Studio / API 从「一锅炖」里拆出来

不少用户的配置里只有一个「代理」或「自动选择」,所有非中国大陆流量共用同一策略组。对普通网页这常常够用,但 Google 的生成式产品链路更长:AI Studio 会拉取多段脚本与控制台资源;Gemini 网页依赖搜索与账户体系相关域名;而官方 SDK 与 REST 调用默认指向 generativelanguage.googleapis.com。若这些请求与视频、社交、下载等大流量混在同一组,一旦你为省流量切到较慢节点,AI 侧会连带变慢或间歇性超时;若规则顺序不当,还可能出现部分子域直连、部分走代理,表现正是社区里常见的「网页能开、API 或 SDK 报错」。

为 Google AI 相关流量单独建一个策略组(例如命名为「Google AI」),并在 rules 里用 DOMAIN-SUFFIX 提前指向该组,有三点直接收益:你可以为 AI 固定选用延迟更低或更稳定的出口,而不必动其他海外站点;排查时能快速判断「是否只有 Google AI 域名异常」;日后若还要叠加 Vertex AI、Colab 等,可以按同一范式扩展,而不必重写整份配置。这与本站已发的 OpenAI、Anthropic、xAI 专篇并列互补,各自覆盖不同厂商的域名习惯与端点命名。

和「规则大全」的分工 本文不展开所有内核字段,只锁定 Google 系 AI 与 generativelanguage.googleapis.com 一类端点。通用规则顺序、GEOIP、Rule Providers 仍以YAML 分流指南为准。

Gemini、Google AI Studio 与 API 会命中哪些域名

Google 产品线迭代快,具体子域可能随时间增减,但 2026 年前后仍可抓住几条稳定主线。面向终端用户的 Gemini 网页与相关体验,常见后缀包括 google.com 体系下与 Gemini 品牌相关的路径与静态资源域;Google AI Studio(含文档与试用控制台)大量使用 ai.google.devaistudio.google.com 等;若你仍遇到旧书签或重定向,可能还会看到历史上与 MakerSuite 相关的 google 子域,建议以浏览器开发者工具「网络」面板里实际请求的 Host 为准做核对。

对开发者而言,Generative Language API 的 HTTPS 主机名通常是 generativelanguage.googleapis.com。这是本文希望你在规则里显式覆盖的核心之一:它不属于「普通浏览器地址栏里看得见」的域名,却恰恰是 SDK、curl 与后端服务报错时日志里反复出现的主机名。若你只给 google.com 写了宽泛后缀,而未覆盖 googleapis.com 下的这一条,连接可能仍落入默认 MATCH 规则,表现为直连超时或被错误节点拖累。

登录与 OAuth 流程往往还涉及 accounts.google.comoauth2.googleapis.com 等。是否把它们并入「Google AI」组或沿用你已有的「Google 账户」组,取决于你是否已有一套稳定的 Google 服务分流;关键是同一浏览器会话内各跳转会话不要拆成互相矛盾的出口,否则容易出现登录态异常或控制台空白。若你使用 Vertex AI 等企业端点,主机名会落在 googleapis.com 的其他服务前缀下,需单独核对官方文档中的 endpoint,不宜与消费级 Gemini API 混为一谈。

网页正常、API 超时的第一层含义

浏览器走系统代理或 TUN,而你在终端执行 Python、Node 或 Go 调用时,进程未必自动继承同一代理。Clash 的 Google 域名分流只决定「已进入内核的连接发往哪个策略组」;若请求根本没进 Clash,规则再完美也无济于事。因此遇到「网页能开、API 超时」时,应优先核对:是否启用了 TUN、终端是否设置了 HTTPS_PROXY、Docker 或 WSL 内的 localhost 是否指向了错误宿主机地址。本站WSL2 与 Windows Clash 代理一文对子系统与宿主回环有专门说明,可与本文对照阅读。

策略组设计:为 Google AI 单独建 proxy-group

proxy-groups 中新增类型为 selecturl-test 的组即可,名称建议简短且可检索(如下例「Google AI」)。候选节点可与主「代理」组复用,也可以只放入对 Google 路由更友好、丢包更低的线路——以你订阅实测为准,而非迷信某一地区标签。

若使用 url-test,测速 URL 尽量选接近真实访问的 HTTPS 端点,并合理设置 interval,避免过于频繁的探测本身制造延迟抖动。若你更希望在出问题时手动切换节点,select 在日志对照与 A/B 对比上往往更直观。

proxy-groups:
  - name: "Google AI"
    type: select
    proxies:
      - "自动选择"
      - "节点-US-低延迟"
      - "节点-EU-备用"
  # ... other groups ...

请确保 rules 中引用的组名与这里完全一致。若使用中文命名,注意 YAML 引号与编辑器编码,与分流指南中的建议保持一致。

分流规则示例:把 Google AI 域名放在 MATCH 之前

规则自上而下匹配,首条命中即停止。与 Gemini、AI Studio 及 Generative Language API 相关的条目应位于过于宽泛的 MATCH 或「全局代理」之前,否则永远不会生效。下面是一段示意(请结合你当前浏览器与 SDK 实际请求核对,勿盲目整段粘贴):

rules:
  - DOMAIN-SUFFIX,generativelanguage.googleapis.com,Google AI
  - DOMAIN-SUFFIX,ai.google.dev,Google AI
  - DOMAIN-SUFFIX,aistudio.google.com,Google AI
  - DOMAIN-SUFFIX,makersuite.google.com,Google AI
  - DOMAIN-SUFFIX,gemini.google.com,Google AI
  # Optional: align sign-in hops with your existing Google rules
  - DOMAIN-SUFFIX,accounts.google.com,Google AI
  # ... GEOIP CN DIRECT, RULE-SETs, then MATCH ...

其中 generativelanguage.googleapis.com 建议单独成行,而不是仅写一条巨大的 googleapis.com 指向代理:后者会把大量无关 Google API 流量一并绑死,排错时难以区分「是 AI 配额问题还是别的服务在拖慢」。若你确认需要整站 Google API 同出口,再考虑更宽后缀,并配合连接日志分批验证。

与社区规则集的关系 若订阅的规则集已包含部分 Google 条目,注意其指向的策略组是否与你期望一致,并避免重复规则导致顺序混乱。优先级仍以你手写段落在文件中的位置为准。

开发者场景:让 API 与 SDK 稳定命中同一策略组

调用 Gemini 官方 API 时,客户端库通常直连 generativelanguage.googleapis.com。在已启用 Clash 系统代理或 TUN 的环境中,多数语言运行时仍会默认不走代理,除非你显式配置环境变量或运行时选项。常见做法是设置 HTTPS_PROXY 指向 Clash 的 mixed 或 HTTP 端口,与本文规则共同生效:规则负责选路,环境变量负责把流量送进内核。

长耗时生成场景下,中间设备或节点的空闲超时可能导致连接被提前掐断,表现为 SDK 侧「read timeout」而不仅是 TCP 失败。此时除更换节点外,可适当调大客户端超时、确认未叠加第二层代理,并观察 Clash 日志中该主机名是否稳定命中「Google AI」组。若你使用 gRPC 或流式接口,还需留意 HTTP/2 与部分老旧内核的兼容性;需要升级内核时可参考《Clash Meta 内核升级完整教程》

在容器或远程开发环境中,代理地址应指向容器或远程机可达的 Clash 监听地址,而不是写死容器内的 127.0.0.1,除非 Clash 与进程同网络命名空间。此类「环境错位」在日志里常呈现为连接超时,容易被误判为 Google 侧故障。

连接失败与超时:按现象缩小范围

配置表面正确却仍失败时,建议先区分「HTTP 层错误」与「连接层错误」。前者可能是配额、鉴权或区域策略;后者多与路由、DNS、TLS 或进程未走代理有关。下表便于快速对照,细节需结合客户端与 Clash 日志。

现象 可能原因 建议
仅 API/SDK 超时,浏览器正常 终端未走 Clash;或 generativelanguage.googleapis.com 未命中规则 设置 HTTPS_PROXY 或启用 TUN;在规则中显式加入该主机后缀并检查顺序
AI Studio 白屏或资源 4xx ai.google.dev 等子域未代理;或登录跳转出口不一致 补齐 DOMAIN-SUFFIX;统一账户相关域名策略组
返回 403 / PERMISSION_DENIED API Key 项目权限、区域或条款限制 核对 Cloud 控制台与 API 启用状态;非纯代理问题
返回 429 / RESOURCE_EXHAUSTED 配额或并发超限 降并发、退避重试;检查计费与配额页
TLS 握手失败 / 证书异常 HTTPS 解密、错误协议或系统时间偏差 暂时关闭中间人安全软件测试;校准系统时间
间歇性慢与断流 节点质量、缓冲区或 HTTP/2 兼容 更换节点;升级 Meta 内核;观察日志是否频繁重连

DNS 与 fake-ip 场景下,域名规则依赖解析与匹配路径一致;若发现连接日志中的目标与预期不符,应回到YAML 指南中的 DNS 章节做对照,而不是仅在策略组里反复换节点。

合规与条款 使用代理访问受地区或账户策略限制的服务可能违反服务条款或当地法规。本文仅作技术配置说明,请自行评估合法合规性。

移动端与 Clash for Android

在 Android 上使用 Gemini 应用或 Chrome 访问 AI Studio 时,除规则外还需注意分应用代理、省电与后台限制是否导致进程间歇性直连。若仅移动网络异常,可按《Clash for Android 订阅与 DNS 排查》逐步排除本机因素,再回到本文的 Google AI 域名是否命中。

写在最后:补齐 AI 矩阵中的 Google 侧

2026 年,生成式工具会继续分散在不同云厂商与域名习惯之下。把 Clash 配稳,本质仍是策略组、规则顺序、DNS 与现实线路的综合题;针对 GeminiGoogle AI Studiogenerativelanguage.googleapis.com 做一层清晰分流,能显著减少「网页与 API 表现不一致」带来的困惑,也与 ChatGPT、Claude、Grok 专篇在长尾词上自然错开。相比堆砌规则,更可取的是锁定场景、可复制、可对照日志——这三点决定了你日后维护配置的成本。

若你希望少在 YAML 缩进上耗神,可以优先选择图形化完善的客户端,把精力留给节点质量与策略组命名;底层仍是同一套内核逻辑。全平台安装包可从本站下载中心获取。与泛泛的「全局规则大全」相比,用好独立「Google AI」策略组与本文域名集合,往往比多订阅几条大而全的规则集更能稳住 API 与控制台体验。

立即免费下载 Clash,开启流畅上网新体验;为 Google AI 单独建组并配上文域名规则后,Gemini 与 AI Studio 的网页、API 链路更容易保持一致。

系统学习策略组与 Rule Providers 请阅读《Clash YAML 规则分流完全指南》;更多文章见技术专栏