Gemini CLI

Gemini CLI 是 Google 的开源 AI 代码代理工具。此模板将 Gemini CLI 部署为 Zeabur 上的持久化云端工作站，并提供浏览器可访问的 Web 终端（ttyd）。

开始使用

1. 部署模板并等待服务启动。请等待健康检查变为绿色后再继续。
2. 在浏览器中打开服务网址（绑定到服务的域名）。
3. 登录，用户名为 user，密码请在 Zeabur 仪表板的 Instructions 页签查看。
4. 设置 API 密钥 — 在 Zeabur 仪表板设置 GEMINI_API_KEY，或执行 gemini 按照提示认证。可在 Google AI Studio 获取免费密钥。
5. 开始使用： gemini

常用命令

命令	说明
gemini	启动交互式 Gemini CLI 会话
gemini --version	查看已安装的版本
gemini -p "你的提示"	发送单次提示

持久化存储

/home/node/ 下的所有数据在重启和重新部署后都会保留。

建议资源配置

• 最低配置：1 vCPU / 4 GB RAM（轻度使用）
• 建议配置：2 vCPU / 16 GB RAM（重度使用、大型代码库）

已知问题

• 首次登录完成后终端可能会卡住，请刷新网页即可继续使用。

变更记录

2026-03-31 — 首次发布

• ttyd Web 终端（密码验证）
• Homebrew 及 npm 全局包持久化于卷
• 资源需求及域名绑定

链接

• Gemini CLI GitHub
• Google AI Studio