Back to Blog

(保姆级教程)Gemini 免魔法方案二:部署到 Zeabur

林小卫很行

Hi,朋友们~

之前的如何搭建不需要魔法也能使用的Gemini(保姆级教程)教你在 Koyeb 平台上搭建项目对 Gemini CLI 的 API,最终实现不需要魔法也能访问 Gemini。

  • 之前为什么不用Render 而选择 Koyeb 是因为 Render 有时候会要求绑定信用卡。

  • 为什么今天再出这一期教程,是因为有朋友按照教程在 Koyeb 部署到最后面的时候收到了下面这个提醒:“We cannot offer you access to Koyeb 96c514f80f6c5a46e463f6a7f589eaa2.png

所以,今天再出一期教程,是在另外一个平台 - Zeabur。闲言少叙,让我们进入正题。

获取Google认证OAuth文件

如果你已经获得了 Google oAuth 文件,那么忽略这一步,直接跳到下一个步骤即可。

1. 确认你的Google账号中存在至少一个项目

打开链接: https://console.cloud.google.com/ 使用 Google 账号登录。最好你的Google 账号开启了两步验证,这样可以确保你的谷歌账号绝对安全。

关于如何开启 Google 账号 两步验证,可参考以下公众号的文章:(此处插入文章)

部分人的Google账号中没有项目,所以可以先检查一下或者创建一个项目。若没有项目,选择我左上角的项目选择器即可,点开,新建一个项目。 image.png

如果你之前的Google账号已经提取过API key,或者自己创建过项目,这里就直接忽略下方的创建项目内容,跳转到下一步 获取认证链接

2. 访问认证网站

我们通过sukaka老师搭建的认证网站来获取凭证。通过这个方法获取凭证,整个的操作步骤几乎被简化到极致。

访问认证网站: http://gcli-auth.sukaka.top:7861/

输入访问密码: pwd

即可进入Google OAuth认证页面。

image.png

3. 获取认证链接

在页面中,你可以直接点击 获取认证链接 按钮,来获取认证链接

也可以点击 高级选项 部分输入你的项目ID,如果你不知道这个是什么,就不要输入,让系统自己检测。

点击了获取认证链接后,会出现一个很长的链接,点击打开。如图: CleanShot 2025-10-30 at 15.39.30.png

4. Google账号认证

点击上一步获取到的那条很长的链接。点击后,会让你登录你的Google账号,请根据提示自行登录。

登录完成后会出现一个 错误页面CleanShot 2025-10-30 at 15.41.45.png

我们需要更改一下地址栏(浏览器中输入网址的地方)的链接。

将地址中的 localhost 更改为 gcli-auth.sukaka.top (直接复制下面的地址也行)

gcli-auth.sukaka.top

CleanShot 2025-10-30 at 15.43.56.png

注意:localhost 后方的冒号也需要保留,只需替换 localhost 即可。其他的任何地方都不要改

更改完成后,按回车访问这个地址。

会出现 OAuth authentication successful! (如果没出现的话,确定网址你没有改错,然后可以刷新几次试试)。如图:

image.png

5. 获取认证文件

返回到上一个标签页,点击页面中的获取认证文件,稍等片刻,会显示步骤二:认证成功

我们先点击 下载认证文件,将认证文件下载下来。

image.png

这个页面不用关闭,等下直接复制那一串认证的内容也可以的。

至此Google认证已经完成。

注册Zeabur

通过链接注册:https://zeabur.com/login。推荐使用 Google 登录,简便快捷。这个平台是有中文支持的,你可以选择中文进入,之后的界面都会显示为中文的语言了。

image.png

进入之后最终会进入下面这个界面。因为我之前部署过项目,所以我的界面是下图的样子。可能你是第一次进入的话,中间会有一些要你的问题或者步骤,自行判断完成即可。 image.png

创建和部署项目

此时,点击右上角的 new project 旁边的下拉箭头,免费用户只能看到两个区域可供选择:印尼雅加达和美国硅谷。建议选择美国硅谷。 image.png

选择完地区之后,会进入下面这个界面去 Add service。选择Docker Imageimage.png

接着会进入下面这一步,填入相关的信息:

  • Image:填入ghcr.io/gzzhongqi/geminicli2api:latest
  • Environment Variables(环境变量),这个地方需要点击Add Environment Variables去添加到 3 个框
    • GEMINI_CREDENTIALS:复制你刚刚在第一步获取的Google OAuth认证文件中的内容(花括号也要)。
    • PORT:填”8888“
    • GEMINI_AUTH_PASSWORD:请自行填写一个密码,这将是你调用API的密钥。 image.png

接着往下拉,下方会有一个Ports,将 Port 填写为“8888”;Port Type不变。 CleanShot 2025-11-04 at 16.00.16.png 确认以上信息都填写无误后,点击 Deploy。

获取公网访问地址

上面点击 Deploy 之后,会到如下这个界面。状态会显示“Queued”表示这个部署正在排队中,此时等待即可,有时候会很快就部署好,有时候可能需要等待几分钟。

image.png

部署成功后,Queued会变成RunningCleanShot 2025-11-04 at 16.24.28.png

与 Render 和 Koyeb 在部署完成后会自动分配公网地址不一样,Zeabur需要自己去生成公网地址。

点击去到Networking,点击 Domain 下方的“Generate Domain”,会弹出一个弹窗。在弹窗内,可以自己输入一个想要的前缀,系统会提示是否可用。显示 available 之后,就可以点击确认了。

CleanShot 2025-11-04 at 16.24.36.png

刚刚确认的时候,状态会变成“Provisioning”,此时等待即可。完成后会变成绿色的“Provisioned“。

最后面补充一点:在Zeabur 部署的服务不会陷入休眠,所以不需要像 Render 和 Koyeb 要进行保活操作。Zeabur每个月会赠送 5 美金的额度,如果在这个额度内就不会有什么问题,个人用户一个月 5 美金基本上够用了

Cherry studio配置

此处通过 Cherry studio 来演示在各种客户端中怎么添加模型。

打开 Cherry studio,点击设置->模型服务->添加。在下方的弹窗中

  • 提供商名称自己命名即可。
  • 提供商类型,选择 OpenAI image.png

接着在界面上,填入你在Zeabur 设置的参数和地址

  • API 密钥:填写你在 Zeabur 设置的环境变量中的GEMINI_AUTH_PASSWORD的值。
  • API 地址:填写你在 Zeabur 最后得到的公网地址。记得最后面不要有/. 注意:Cherry Studio 只需要填根地址,但别的客户端,比如 Rikkahub,可能需要你填入完整的 /v1 路径,请你根据你所用客户端的指引来操作。 CleanShot 2025-11-04 at 20.41.19.png

测试,最终成功对话。 image.png


Enjoy~

如果你在这个过程中有任何问题,可以加我微信“linauwawa”备注"Zeabur”进行交流,希望你一切顺利!