基于 Cloudflare Pages + EdgeTunnel + 8317 聚合网关搭建 Gemini 专线终极实战指南

2026-09-03

前言

调用 Google Gemini 官方 API（或在 CherryStudio / Antigravity / 8317 聚合网关中使用）时，常受制于地区限制（Region Not Supported）、DNS 污染或代理节点不稳定。

传统解决方案往往需要购买境外 VPS、自备已托管的独立域名，费时费力且有持续费用。

本文介绍一套 已实测验证 · 零成本 · 免购买域名 · 零报错 的 Gemini 专线工业级搭建方案：

✅ 免买域名：直接使用 Cloudflare Pages 官方免费分配的 *.pages.dev
✅ 免境外 VPS：利用 Cloudflare 全球边缘计算网络（Anycast 边缘节点）
✅ 本地智能白名单分流：仅 Google / Gemini 流量走加密专线，国内流量 100% 原生直连无干扰
✅ 全协议与多客户端兼容：完美兼容 8317 聚合网关 (CLIProxy)、Antigravity、CherryStudio 等

一、总体架构与数据流向

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
【业务接入层】
   ├── Antigravity 客户端 ───────────┐ (直连 7890 端口)
   ├── 浏览器原生对话台 (8317 端口) ────┼──► 【8317 聚合网关 (CLIProxy)】 (OpenAI 标准格式 / 内置 Web UI)
   └── 第三方客户端 (CherryStudio等) ──┘           │ (统一出站挂载本地 7890 代理)
                                                    ▼
                                    【本地 Mihomo / Xray 智能分流网关】 (监听 7890, 7891)
                                                    │
                   ┌────────────────────────────────┴────────────────────────────────┐
                   ▼ (仅 *.google.com, *.googleapis.com, *.ai.google.dev)           ▼ (国内所有其他网站)
          【Cloudflare Pages 边缘节点 (EdgeTunnel)】                                   【国内网络 原生直连】
          (Anycast 优选 IP: 104.21.23.1 / 172.67.65.72)                             (100% 满速无任何干扰)
                   │ (加密 VLESS over WebSocket 隧道)
                   ▼
     【Google Gemini 官方服务器】
     (generativelanguage.googleapis.com)

二、核心部署步骤（5分钟极速交付）

第一步：Cloudflare Pages 边缘节点部署（免买域名）

生成专属 UUID 密钥：访问在线 UUID 生成器（如 uuidgenerator.net）或在终端运行 uuidgen 生成专属密钥（示例：7d4f9b23-6a10-4c88-b5e1-8a9d3e4f5012）。

准备 Pages 部署包 (edgetunnel.zip)：部署包由 _worker.js 和 index.html 组成。核心代码基于 Cloudflare 原生 TCP Socket API (cloudflare:sockets) 实现 VLESS-over-WebSocket 管道：

1
2
3
4
import { connect } from 'cloudflare:sockets';
let userID = '7d4f9b23-6a10-4c88-b5e1-8a9d3e4f5012'; // 替换为你生成的专属 UUID
let proxyIP = '';
// ... 标准 VLESS WS 协议解析与 TCP 管道转发

上传部署到 Cloudflare：
- 登录 Cloudflare 控制台 $\rightarrow$ 计算 (Workers & Pages) $\rightarrow$ 创建应用程序 $\rightarrow$ Pages $\rightarrow$ 上传资产 (Upload assets)；
- 项目名称自定义（例如：my-gemini-tunnel）；
- 将 edgetunnel.zip 拖入并点击 Save and Deploy；
- 部署完成后获得免费项目域名：https://<你的项目名>.pages.dev。

第二步：本地分流网关配置

1. 节点定义与通用链接

节点名称：CF-Gemini-Pages
服务器 (Server)：104.21.23.1（或优选 IP 172.67.65.72 / 项目域名 <你的项目名>.pages.dev）
端口 (Port)：443
UUID：<你的专属 UUID>
传输协议：ws
WebSocket 路径：/?ed=2048
Host / SNI：<你的项目名>.pages.dev
TLS 指纹：chrome

通用 VLESS 订阅链接示例：

1
vless://<你的UUID>@104.21.23.1:443?encryption=none&security=tls&sni=<你的项目名>.pages.dev&fp=chrome&type=ws&host=<你的项目名>.pages.dev&path=%2F%3Fed%3D2048#CF-Gemini-Pages

2. 本地 Mihomo / Clash 配置

在本地 config.yaml 中添加节点及精准白名单分流规则：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
proxies:
  - name: CF-Gemini-Pages
    type: vless
    server: 104.21.23.1                # Cloudflare 优选 IP / 域名
    port: 443
    uuid: <你的专属 UUID>
    cipher: auto
    udp: false
    tls: true
    skip-cert-verify: false
    servername: <你的项目名>.pages.dev
    client-fingerprint: chrome
    network: ws
    ws-opts:
      path: /?ed=2048
      headers:
        Host: <你的项目名>.pages.dev

# 精准白名单分流：
rules:
  - DOMAIN-SUFFIX,generativelanguage.googleapis.com,CF-Gemini-Pages
  - DOMAIN-SUFFIX,ai.google.dev,CF-Gemini-Pages
  - DOMAIN-SUFFIX,alkalimakersuite-pa.clients6.google.com,CF-Gemini-Pages
  - DOMAIN-SUFFIX,aistudio.google.com,CF-Gemini-Pages
  - DOMAIN-SUFFIX,googleapis.com,CF-Gemini-Pages
  - MATCH,DIRECT

3. 独立 Xray `config.json` 模板

如果使用独立的 Xray 核心：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
{
  "log": { "loglevel": "warning" },
  "inbounds": [
    { "tag": "http-7890", "port": 7890, "listen": "0.0.0.0", "protocol": "http" },
    { "tag": "http-10801", "port": 10801, "listen": "0.0.0.0", "protocol": "http" },
    { "tag": "socks-10800", "port": 10800, "listen": "0.0.0.0", "protocol": "socks" }
  ],
  "outbounds": [
    {
      "tag": "edgetunnel-cf",
      "protocol": "vless",
      "settings": {
        "vnext": [
          {
            "address": "104.21.23.1",
            "port": 443,
            "users": [
              {
                "id": "<你的专属 UUID>",
                "encryption": "none"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "ws",
        "security": "tls",
        "tlsSettings": {
          "serverName": "<你的项目名>.pages.dev",
          "fingerprint": "chrome",
          "allowInsecure": false
        },
        "wsSettings": {
          "path": "/?ed=2048",
          "headers": {
            "Host": "<你的项目名>.pages.dev"
          }
        }
      }
    },
    { "tag": "direct", "protocol": "freedom", "settings": {} }
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": [
          "domain:generativelanguage.googleapis.com",
          "domain:googleapis.com",
          "domain:accounts.google.com",
          "domain:ai.google.dev",
          "domain:gemini.google.com",
          "domain:google.com"
        ],
        "outboundTag": "edgetunnel-cf"
      },
      { "type": "field", "network": "tcp,udp", "outboundTag": "direct" }
    ]
  }
}

三、 8317 聚合网关 (CLIProxy) 接入

出站代理机制：
- 将聚合网关容器的出口代理环境变量指向本地分流端口：CLIPROXY_PROXY_URL=http://<宿主机IP>:7890；
- 本地分流网关根据白名单自动将 Gemini 请求通过 Cloudflare 边缘通道发送，其余流量直连。
业务端接入参数：
- Base URL：http://127.0.0.1:8317/v1 或 http://<局域网IP>:8317/v1
- API Key：sk-cpa-key（或自定义网关密钥）
- 支持模型：gemini-2.5-pro、gemini-2.5-flash、gemini-1.5-pro 等标准模型

四、核心原理解析与维护

为什么不需要购买独立域名？
- Cloudflare Pages 默认分配的 *.pages.dev 原生自带全球 Anycast TLS 边缘证书。通过 SNI 伪装和优选 IP 可以稳定握手，彻底省去域名购买和续费成本。
为什么调用 Gemini 不会触发地区不支持 (Region Not Supported)？
- Cloudflare Pages 边缘节点计算分布在美区 (LAX)、香港 (HKG)、欧洲等支持区域，出站网络原生具备 Gemini 访问权限。
日常连通性验证命令：
1
curl -x http://127.0.0.1:7890 -I https://generativelanguage.googleapis.com
返回 HTTP/2 (server: scaffolding on HTTPServer2) 即表示专线握手完全正常，延迟稳定在 ~140ms。

前言

一、 总体架构与数据流向

二、 核心部署步骤（5分钟极速交付）