深浅模式
Gemini-CLI反代搭建-Render版
教程来源
版权声明
该教程非本人完全创作，其中大量参考Discord→旅程社区
毛衣延长线老师的教程，增加了些更加详细的步骤说明。原贴地址：点击进入 （注：需要先加入Discord旅程服务器）
该教程项目来自Github @su-kaka 老师的 gcli2api 项目，和 gzzhongqi 老师的 geminicli2api项目
Github项目地址：su-kaka/gcli2api-点击进入
Github项目地址：gzzhongqi/geminicli2api-点击进入
部署说明
本教程的CLI反代基于Render部署。
个人比较推荐Render部署，因为部署过程简单方便，且可以脱离电脑使用（不需要电脑一直开着）。
如果你的Render之前已经部署了Hajimi轮询，你必须关闭掉Hajimi的项目，或者取消hajimi项目的保活。以免超出每月的免费时长（本教程中有关闭的方法）。
另外，因为我没有安卓手机，所以基于安卓的部署教程没法写，你可以在加入Discord的旅程社区后，查看原版的安卓部署教程（同一个帖子内也有电脑本地的部署教程，足够简单，不再写了）。地址为：点我打开
关于Google CLI
简单来说，Google CLI是基于终端的AI编程工具，这个你有兴趣可以自行了解。
对于酒馆使用而言，Google CLI每天1000次请求，每分钟60次，上下文100w左右。甲更薄、更不容易截断和空回（相比较API）。
对于个人用户而言，一个账户基本足够满足使用，2.5限额情况不定，根据毛衣延长线老师的说明，429时可以切换到0506、0605模型，会重定向到gemini-2.5-pro
进入教程。
一、获取Google认证OAuth文件
1，确认你的Google账号中存在至少一个项目
部分人的Google账号中没有项目，所以可以先检查一下或者创建一个项目。
如果你之前的Google账号已经提取过API key，或者自己创建过项目，这里就直接忽略下方的创建项目内容，跳转到下一步获取认证链接
检查项目或创建项目
打开：https://console.cloud.google.com/welcome
使用你的Google账号进行登录。
如下图，显示有项目ID，就是存在项目的，可以直接跳转到下一步，获取认证链接。
（图中的jiaocheng1是我自己创建的项目，你的和我显示不同是正常的。）
如果没有项目，则需要创建一个项目。
如果需要登录，就登录你的Google账号
项目名称随便写，然后直接点
创建
- 之后会弹出一个消息（右上角），提示项目已经创建，这就创建完成了。
如上图，我就创建了一个名字叫 jiaocheng9 的项目。
2，访问认证网站
我们通过sukaka老师搭建的认证网站来获取凭证。通过这个方法获取凭证，整个的操作步骤几乎被简化到极致。sukaka老师，伟大无需多言。
访问认证网站：http://gcli-auth.sukaka.top:7861/
输入访问密码：pwd
即可进入Google OAuth认证页面。
3，获取认证链接
在页面中，你可以直接点击获取认证链接按钮，来获取认证链接
也可以点击高级选项部分输入你的项目ID，如果你不知道这个是什么，就不要输入，让系统自己检测。我自己没有输入。
4，Google账号认证
点击了获取认证链接后，会出现一个很长的链接，点击打开。如图：
点击后，会让你登录你的Google账号，请根据提示自行登录。
登录完成后会出现一个错误页面。
我们需要更改一下地址栏（浏览器中输入网址的地方）的链接。
将地址中的localhost更改为gcli-auth.sukaka.top（直接复制下面的吧）
ts
gcli-auth.sukaka.top如图：
更改为：
易错操作
注意，只更改地址栏的localhost为gcli-auth.sukaka.top，不要更改后面的其他任何内容.
包括 : 后面的端口也不要改，冒号也要保留（我的端口是8084，不确定你的端口和我的是否一样，反正:以及后面的内容都不要改）
更改完成后，按回车访问这个地址。
会出现 OAuth authentication successful! （如果没出现的话，确定网址你没有改错，然后可以刷新几次试试）。如图：
然后这个页面就可以关掉了。
回到刚刚获取认证链接的页面继续。
5，获取认证文件
点击页面中的获取认证文件，稍等片刻，会显示步骤二：认证成功
我们先点击 下载认证文件，将认证文件下载下来。
这个页面不用关闭，等下直接复制那一串认证的内容也可以的。
至此Google认证已经完成啦。
二、注册Render账号
如果你已经注册过Render账号，可以直接从下一步开始。
1，注册/登录Render
注意
最好使用美国节点，根据反馈会降低需要绑卡的几率。
地址：https://dashboard.render.com/register
建议直接使用Github或者Google账号创建并登录Render。
根据提示登录或者完成认证。
在登录完成后，首次登录需要你创建一个workspace。
如果你不是初次登录，就不需要创建workspace。
记得选 Personal projects、Just me。然后点击 Next →
Tell us about what you're building，这个页面不需要任何设置。
直接点击 Next →
Personalize your exprience，这个页面也不需要任何设置。
直接点击 Next →
到这里就完成账号注册和创建workspace的操作了。
三、部署CLI反代
1，创建Web Service服务
点击页面中的 +New ，然后点击 Web Service
如果你之前创建过workspace
界面略有不同，登录后可以直接点击 + Add new创建
如图：
如果你之前创建过Render账号
如果你之前创建过Render账号的话，直接选 Web Service 相关的那个继续。
2，分支-sukaka老师项目部署
这里增加两条分支，教程中主要介绍的是sukaka老师的项目，后面会补充gzzhongqi老师的项目部署方式。
区别（引用自毛衣延长线老师的原文）：
Sukaka老师的项目：该项目具有假流式、429自动重试、轮询（但是注意额度上限按账号计算而非凭证）、流式防截断（该项还在测试当中）等强大功能。部署此项目则继续往下阅读即可。
Qi老师的项目个人推荐：简单，稳定，在一些插件需要填入api反代地址时适应良好。适合我这种没有太多功能需求，没bug就行的懒鬼。跳转地址：分支-gzzhongqi老师项目部署
2.1 填写基本参数
在New Web Service页面中，先点击Public Git Repository。
输入下方的地址：
https://github.com/su-kaka/gcli2api然后点击Connect，如图：
之后填写其他相关参数：
- Name：随便写，方便你记忆就行，例如
gcli2api - Language：保持默认的Docker，不要改
- Branch：不要改
- Region：这个是地区，你可以自由选择，美国（US）、新加坡（Singapore）都可以的
- Root Directory：不填
- Instance Type：一定要记得选择
Free $0/month
如图：
2.2 填写环境变量
在Environment Variables中，添加几个环境变量
每个环境变量由Key和Value组成，为了避免引起部分小白的误解，Key用Name替代。
怎么填写如图：
第一个环境变量：
Name填:
GCLI_CREDS_1Value：需要复制刚刚你获取的Google OAuth认证文件中的内容，如果你没有关闭刚刚的认证文件，可以直接复制填入。（花括号也要）
例如：
如果你关闭了这个网页，那就打开你刚刚下载的那个认证文件，json格式的，你可以右键，通过记事本打开，然后复制里面的所有内容，然后填入。
细心的你肯定发现了，这个Name是GCLI_CREDS_1，后面跟了个数字
1。这个项目是支持多个认证轮询的，如果你有多个不同的项目认证文件，可以继续创建
GCLI_CREDS_2、GCLI_CREDS_3等进行添加，每个对应一个认证文件中的内容。对于普通用户而言，没有必要添加多个。
第二个环境变量：
Name填：
AUTO_LOAD_ENV_CREDSValue填：
true第三个环境变量：
Name:
PASSWORDValue：请自行填写一个密码，这将是你调用API的密钥。
三个环境变量都填完了如图：
3，分支-gzzhongqi老师项目部署个人推荐
如果你选择部署sukaka老师的项目，可以跳过本部分。
3.1 填写基本参数
在New Web Service页面中，先点击Existing Image。
在 Image URL中输入下方的地址：
ghcr.io/gzzhongqi/geminicli2api:latest然后点击Connect，如图：
之后填写其他相关参数：
- Name：随便写，方便你记忆就行，例如
gcli2api - Region：这个是地区，你可以自由选择，美国（US）、新加坡（Singapore）都可以的
- Instance Type：一定要记得选择
Free $0/month
如图：
2.2 填写环境变量
在Environment Variables中，添加几个环境变量
每个环境变量由Key和Value组成，为了避免引起部分小白的误解，Key用Name替代。
怎么填写如图：
第一个环境变量：
Name填:
GEMINI_CREDENTIALSValue：需要复制刚刚你获取的Google OAuth认证文件中的内容，如果你没有关闭刚刚的认证文件，可以直接复制填入。（花括号也要）
例如：
如果你关闭了这个网页，那就打开你刚刚下载的那个认证文件，json格式的，你可以右键，通过记事本打开，然后复制里面的所有内容，然后填入。
第二个环境变量：
Name填：
PORTValue填：
8888第三个环境变量：
Name:
GEMINI_AUTH_PASSWORDValue：请自行填写一个密码，这将是你调用API的密钥。
三个环境变量都填完了如图：
4，部署
检查 2.1 和 2.2 部分是否填写正确，确认无误后，滑到页面最底部，点击Deploy Web Service
即可进行部署，如图：
会打开一个新的页面显示部署的过程，等待一会儿。过程中出现黄色的WARNING不用管。
直到出现下方的内容，就代表部署完成了：
4，补充：如果你的Render部署有其他的项目
如果你的Render部署有其他的项目，如通过我之前的教程部署了Hajimi轮询，你需要关闭之前的Hajimi或者其他的项目。（或者把它们两个都不做保活）
你也可以再注册一个Render账号，如果最后还是不需要绑卡的话，就可以hajimi和cli反代一起用了。
这是因为，免费账户，Render提供每个月750小时的免费使用时长。
750小时 ÷ 24小时 = 31.25天，刚好能满足一个项目持续运行（每月都有750小时）。如果是两个项目，时长就不够了，所以需要关闭一个。
重要提示
如果你就是想hajimi和cli反代一起用呢？
那就两个项目全部都不要做保活，之前hajimi轮询项目做了保活的话，请到对应网站中进行删除。
好处是两个项目可以已启用，坏处是15分钟不活动项目会休眠，下次调用时，首次调用会比较慢（要等待项目启动）
侧边栏点击Project
然后在Ungrouped Services中找到之前部署的其他项目，例如hajimi。
点击项目最右侧的三个竖点，然后点击Suspend，暂停hajimi（或其他）项目。
在弹出的窗口中，在输入框中输入上方提示的红色文字，然后点击Suspend Web Service。
四、如何使用
部署完成后，你需要获取CLI的面板地址
这个地址点击进去，输入密码，密码是你刚刚设置的环境变量中PASSWORD的值。（sukaka老师的项目）
至于这个面板怎么使用就不再额外介绍，很简单的，如果你不知道其中的选项是什么意思，那就建议不要随便更改。
注意
注意，gzzhongqi老师的项目无后台面板，更加简洁，你可能会看到一串代码，这并不是错误，直接在酒馆中调用使用就行了。
在酒馆中使用时，这个面板地址就是你的调用地址，即自定义端点，但是请注意：必须在地址末尾加/v1 其中v是小写。
同时，这个PASSWORD的值，调用CLI反代的密钥，即酒馆中的自定义API密钥。
当然，如果是gzzhongqi老师的项目，GEMINI_AUTH_PASSWORD的值是调用CLI反代的密钥，即酒馆中的自定义API密钥。
五、其他
如果你需要对CLI项目进行保活（即只使用CLI反代的话），如何保活的教程请参考这个教程：
↑ 如何更新、如何更新环境变量，同样参考这个教程
再次重申
如果你就是想hajimi和cli反代一起用，那就两个项目全部都不要做保活，之前hajimi轮询项目做了保活的话，请到对应网站中进行删除。
好处是两个项目可以已启用，坏处是15分钟不活动项目会休眠，下次调用时，首次调用会比较慢（要等待项目启动）
如果你需要删除保活：
之前我们的保活教程，是在uptimerobot中做的。
打开uptimerobot，地址：https://dashboard.uptimerobot.com/
登录后，选择之前创建的motion，将其删除即可。
教程结束。