xget 解决大陆 gemini 直连的地区限制问题

Xget 是一个基于 Cloudflare Workers 的一站式反代项目，支持 GitHub 下载、容器镜像拉取、大模型 API 请求等功能。

github.com

GitHub - xixu-me/xget: Ultra-high-performance, secure, all-in-one acceleration engine for developer resources

Ultra-high-performance, secure, all-in-one acceleration engine for developer resources - xixu-me/xget

https://github.com/xixu-me/Xget

准备工作

• 一个 github 账号
  • 注册地址：https://github.com/signup​​
• 一个 cloudflare 账号
  • 注册地址：https://dash.cloudflare.com/sign-up
  • 进入控制台后右上角可切换语言：

    

• 一个已托管在 cloudflare 的域名（在中国大陆使用时必须）。
  • 相关文章：《免费申请 dpdns.org 和 qzz.io 域名》

一键部署

1. 点击一键部署

2. 在 Git 帐户 下拉菜单中选择 GitHub 账号

3. 初次使用会跳转授权。选择 All repositories（所有仓库），点击 Save（保存） 按钮。

   

4. 勾选 创建专用 Git 存储库。（此处的官方中文是误译，实际意思是创建私有 Git 仓库。）

5. 点击 创建和部署，等待自动部署完成。完成后，页面将跳转至 Worker 管理界面。

   

6. 进入 Worker 管理页面的 设置 页面，找到 域和路由。

7. 根据请求发出的地区，选择对应的域名绑定方法。

   仅海外服务器使用

   直接启用默认提供的 .workers.dev 域名（记下这个域名，之后会经常使用）。

   

   全球（含中国大陆）

   点击 添加 按钮，选择 自定义域名，输入一个子域名（记下这个域名，之后会经常使用），然后点击 添加域。

   

   全球（含中国大陆）（优选域名）

   待续。

使用方法

Gemini API 请求

在 Cherry Studio 中使用

1. 新建一个服务或找到默认的 Gemini 服务。
2. 将 提供商类型 设置为 Gemini。
3. 在 API 密钥 中填入 Gemini API Key。
4. 将 API 地址 设置为 https://<绑定的域名>/ip/gemini。

在 SillyTavern 中使用

1. 点插头图标进入 API 连接配置 页面。
2. 按如下方式配置：
   • API: 聊天补全
   • 聊天补全来源: Google AI Studio
   • 反向代理: 展开此项
   • 代理名称: 任意名称
   • 代理服务器 URL: https://<绑定的域名>/ip/gemini（不加任何后缀）
   • 代理密码: 填入 Gemini API Key
   • Google AI Studio API 密钥: 忽略，别管显示什么
   • 提示词后处理: 严格（强制对话角色交替、用户最先）
   • 自动连接到上次的服务器: 勾选
3. 点击 连接 按钮，如有弹窗选择 是。连接按钮下方应显示 Valid 或 有效。
4. 确认连接成功后，点击 反向代理预设 右侧的 保存 按钮，再点击页面顶部右侧的 新建配置 按钮保存配置。

加速其他常用服务

OpenAI / Anthropic / Gemini

将 API 请求地址中的主机名替换为对应的加速地址。

• OpenAI: api.openai.com → <绑定的域名>/ip/openai
• Anthropic: api.anthropic.com → <绑定的域名>/ip/anthropic
• Gemini: generativelanguage.googleapis.com → <绑定的域名>/ip/gemini

示例 (以 OpenAI 为例):

- https://api.openai.com/v1/chat/completions
+ https://<绑定的域名>/ip/openai/v1/chat/completions

GitHub

对于所有 GitHub 请求（包括文件下载、clone/pull/push），将 URL 中的 github.com 替换为 <绑定的域名>/gh。

示例 1: wget 下载

- wget https://github.com/microsoft/vscode/archive/main.zip
+ wget https://<绑定的域名>/gh/microsoft/vscode/archive/main.zip

示例 2: Git 操作

• 克隆:

  - git clone https://github.com/user/repo.git
  + git clone https://<绑定的域名>/gh/user/repo.git

• 全局配置 (推荐): 执行以下命令后，所有 git 操作都会自动通过加速地址进行。

  git config --global url."https://<绑定的域名>/gh/".insteadOf "https://github.com/"

容器镜像

拉取镜像时，在原始镜像地址前加上 <绑定的域名>/cr/ 作为前缀。

• 直接拉取:

  docker pull <绑定的域名>/cr/ghcr/nginxinc/nginx-unprivileged

• 配置 Docker (/etc/docker/daemon.json): 将 registry-mirrors 配置为你的加速地址，可以加速特定仓库。

  {
    "registry-mirrors": ["https://<绑定的域名>/cr/ghcr"]
  }

npm

配置 npm 镜像源，高亮部分为你的加速地址。

npm config set registry https://<绑定的域名>/npm/

PyPI

配置 pip 镜像源，高亮部分为你的加速地址。

pip config set global.index-url https://<绑定的域名>/pypi/simple/

更多请查看项目文档：Xget/README.md at main · xixu-me/Xget