海外云服务器 docker 部署 gcli2api

一、前言

1. 简介

本文介绍如何用咕咕助手脚本一键 docker 部署 gcli2api，只需一个 google 账号即可免费使用最牛逼的 gemini-3-pro-preview 和 claude-4-5-opus 模型。

gcli2api 是聚合了 google cli 和 google 反重力两个渠道的 2api 项目，额度和 gemini api key 和 ais2api 等渠道是独立的，一个 google 账号可以同时拥有多渠道，多份额度。

对 gemini 各渠道有疑惑可查看相关文章： 新手酒馆速通攻略及入门扫盲

google cli 就是这个工具：

google 反重力即 google antigravity 就是这个工具：

此项目代替你和这两个工具对话并生成外接 API。

gcli2api 项目来自 github 作者 su-kaka，请给作者点一个免费的 star： https://github.com/su-kaka/gcli2api

一键部署使用的工具是我的免费开源项目 咕咕助手，请在 github 帮我点一个免费的 star 支持一下，谢谢： https://github.com/qingjue723/st-tools

2. 占用

占用极小，40M 左右。

3. 前提条件

1. 一台能正常 SSH 连接的云服务器（SSH 工具/1Panel 宝塔面板的终端均可）。
   • 相关文章： 《云服务器重装系统、查看 IP、放行端口与 SSH 连接》
2. 一个能正常使用的 Google 账号，需要创建过项目。
   • 相关文章： 注册 google 账号与申请 gemini 密钥

二、操作步骤

1. 运行脚本

在服务器终端中粘贴以下命令运行脚本（运行过一次后以后就不用复制命令了，输入 gugu 即可呼出菜单）:

bash <(curl -sL gugu.qjyg.de/vps)

2. 部署

1. 输入 2 回车（应用部署中心）。

2. 输入 4 回车（部署 gcli2api）。
3. 安装路径： 回车。
4. 访问端口： 10000-65535 之间任意输入。
5. 管理密码： 回车。
6. 部署成功： 记下访问地址和密码。
7. 放行端口： 如果使用面板防火墙，请去放行相应的 tcp 端口。ufw 防火墙不用管，因为 ufw 拦不了 docker 端口。

3.1 获取 GCLI 凭证

1. 浏览器新开窗口，打开刚刚记下的访问地址 ，即 http://服务器IP:端口 ，输入密码进入面板。

2. 点击 获取认证链接。（cli 的额度是按谷歌账号，而不是项目）

   

3. 下方会显示很长一串 认证链接，点击跳转到 Google 登录页面，登录自己的 Google 账号。

4. 登录后会显示 无法访问此网站，这是正常的。将此页面的地址完整复制下来。

5. 回到 gcli2api 面板，展开 无法回源？试试快捷方式，将复制的地址粘贴进去，点击 从回调 URL 获取凭证 按钮。

6. 显示 ✅ 认证成功！，就是成功了。凭证文件已经自动储存进去了。点击面板最上面的 文件管理 菜单可以看到储存的凭证，或者在 gcli2api 安装目录下的 data 文件夹中也可以看到。

3.2 获取反重力凭证

切到 Antigravity 认证 菜单，参考 获取 GCLI 凭证 ，同样方法获取凭证即可。

4. 连接与后续

1. 在酒馆中设置

2. 点击菜单栏 左二插头图标，打开 连接设置 标签页。

3. API: 选择 聊天补全。

4. 聊天补全来源: 选择 自定义（兼容 OpenAI）。

5. 自定义端点（GCLI 渠道基础 URL）: http://服务器IP:端口/v1。（注意是 http 不是 https）

6. 自定义端点（反重力渠道基础 URL）: http://服务器IP:端口/antigravity/v1。（注意是 http 不是 https）

7. 自定义 API 密钥: 填写密码。

8. 提示词后处理: 选择 严格。

9. 自动连接到上次的服务器：勾选。

10. 点击 连接 按钮。绿灯处显示 有效 或 Valid 就是连接成功，显示其他的都是连接失败，停下来排错。

11. 在 可用模型 列表中，选择需要的模型。

12. 点击右上 保存配置 按钮，下次就不用重新输了，需要勾选的内容看下图。

    

13. 如果选择的是假流式模型必须在预设中勾选 流式输出 按钮才有效哦，记得按 保存。

    

14. 在其他 AI 前端中设置

其他支持 OpenAI 接口的前端也是同样的，具体怎么填看前端要求。

• 要求填写完整路径的：
  http://服务器IP:端口/v1/chat/completions
• 要求加 /v1 后缀的：（即会自动补全 /chat/completions 的部分）
  http://服务器IP:端口/v1
• 完全自动补全的： （即会自动补全 /v1/chat/completions 的部分）
  http://服务器IP:端口

三、咕咕助手管理

1. 主菜单输入 3 回车（应用运维管理）。
2. 输入 2 回车（gcli2api 运维管理）。
3. 在这里可以重启、更新、看日志、卸载等。

   

四、1Panel 管理重启、更新、看日志

1. 在 容器 -> 容器 中可以看到 gcli2api 项目。
2. 更改了配置文件需要重启才能应用更改，或者出了问题也可能需要重启试试，点开状态按钮，点 重启。
3. 如果官方更新了新版本，点 更多 -> 升级 ，强制拉取镜像 勾上，然后确认，等待拉取镜像成功后就自动切换到新版本重启了。不会改变用户数据。
4. 日志 可以查看日志排查问题。