让你的Gemini CLI丝般顺滑！手把手教你用反向代理解决网络问题

大家好，我是Neo。

最近我们独立站圈子里，聊得最多的就是AI了。Google的Gemini，凭借其强大的能力，成了我们很多人的得力助手。尤其是它的命令行工具 gemini CLI，简单敲几行命令，就能快速获取灵感、生成脚本，简直是效率神器。

但理想很丰满，现实很骨感。很多朋友在国内的服务器或电脑上使用 gemini CLI 时，都会遇到一个头疼的问题：命令执行一半卡住，或者直接超时报错。 这感觉就像你的瑞士军刀突然钝了，关键时刻掉链子，你说气不气人？

$ gemini generate "写一段关于独立站夏季促销的邮件标题"
Error: Unable to connect to the server. Please check your network connection.

我自己也折腾了很久，踩了不少坑。今天，我就把我的独门秘籍分享出来——用反向代理，一劳永逸地解决 gemini CLI 的访问问题！

啥是反向代理？听起来很复杂？

别被“反向代理”这个名字吓到，说白了，它就是一个**“中间人”或者“传话筒”**。

想象一下，你的电脑（客户端），想跟远在海外的Gemini服务器（目标服务器）对话。但由于距离太远，中间还隔着“墙”，你的命令（API请求）很难直接、稳定地传达过去。

怎么办呢？你可以在海外租一台服务器（VPS），它能轻松地和Gemini对话。然后，你让这台海外服务器做你的“传话筒”：

  1. 你把命令，通过“传话筒”发出去。
  2. “传话筒”转身就把你的命令，原封不动地告诉Gemini。
  3. Gemini回复“传话筒”。
  4. “传话筒”再把Gemini的回复，传回给你的终端。

反向代理示意图

在这个过程中，你的 gemini CLI 始终只和你的“传话筒”对话，它在国内访问起来是畅通无阻的。这个“传话筒”，就是我们的反向代理服务器。

我们为啥要用它？

对于 gemini CLI 用户来说，好处非常直接：

  1. 稳定可靠：这是最重要的。你的终端在国内访问自己的海外服务器，线路是稳定可控的。海外服务器再去访问Google服务，网络也是畅通的。命令再也不会莫名其妙地失败了。
  2. 一次配置，永久有效：只需设置一次，你的 gemini CLI 就学会了“走代理”��之后所有命令都会自动通过这条稳定通道，无需每次都操心网络问题。
  3. 安全可控：API Key存储在本地，请求通过你自己的服务器中转，你甚至可以在服务器上记录所有CLI的调用日志，一切尽在掌握。

实战开始：用宝塔面板轻松搭建

理论说完了，我们直接上干货。对于不熟悉Linux命令行的朋友，我强烈推荐使用宝塔面板（BT Panel），图形化界面，点几下鼠标就能搞定。

第一步：准备一台海外服务器并安装宝塔

这步是基础，你需要有一台能自由访问Google的海外服务器。比如Vultr, DigitalOcean, Linode，或者阿里云、腾讯云的海外节点都可以。然后在服务器上安装宝塔面板，官网有详细的一键安装脚本。

第二步：在宝塔中设置反向代理

  1. 新建网站 登录宝塔面板，点击左侧的“网站”，然后点击“添加站点”。域名填写你准备好的域名，比如 gemini-proxy.yourdomain.com。数据库和PHP都不需要，纯静态即可。

    宝塔添加站点

  2. 申请SSL证书 网站建好后，点击它的“设置”，找到“SSL”选项卡，选择“Let’s Encrypt”，勾选你的域名，点击申请。宝塔会自动帮你完成证书的申请和部署。记得开启“强制HTTPS”。

    宝塔申请SSL

  3. 配置反向代理 这是最关键的一步。在网站“设置”里，找到“反向代理”选项卡，点击“添加反向代理”。

    • 代理名称：随便填，自己认识就行，比如 gemini-cli-proxy。
    • 目标URL：填写Gemini的官方API地址 https://generativelanguage.googleapis.com
    • 发送域名：同样填写 generativelanguage.googleapis.com

    宝塔配置反向代理

    保存之后，你的反向代理就正式生效了！

最后一步：让Gemini CLI用上我们的代理

现在，我们不需要修改任何代码或工具本身，只需要在使用 gemini CLI 的电脑或服务器上，设置一个环境变量，gemini CLI 就会自动读取并使用我们的代理。

什么是环境变量？ 你可以把它理解成一个全局的、系统级别的配置项。gemini CLI 启动时会检查这个配置项，如果存在，就用它作为API的访问地址。

如何设置？

  • 在Linux或macOS上: 打开你的终端（Terminal），输入以下命令：

    export GOOGLE_GEMINI_BASE_URL="gemini-proxy.yourdomain.com"

    注意：export命令只在当前终端窗口有效。如果想永久生效，需要把这行命令加到你的shell配置文件里（比如 ~/.bashrc 或 ~/.zshrc），然后执行 source ~/.bashrc 或 source ~/.zshrc。

  • 在Windows上: 打开命令提示符（CMD），输入：

    set GOOGLE_GEMINI_BASE_URL="gemini-proxy.yourdomain.com"

    同样，这只在当前窗口有效。如果想永久设置，可以右键“我的电脑” -> “属性” -> “高级系统设置” -> “环境变量”，在“系统变量”或“用户变量”里新建一个，变量名是 GOOGLE_GEMINI_BASE_URL，值是你的域名 gemini-proxy.yourdomain.com。

见证奇迹的时刻！

设置好之后，再打开一个新的终端窗口，试试之前的命令：

$ gemini generate "写一段关于独立站夏季促销的邮件标题"

- "火热一夏，清凉折扣！全场商品低至5折！"
- "夏季狂欢，限时开抢！为你的夏日增添一抹亮色！"
- "别让夏天溜走！抓住季末大促的尾巴！"

看到了吗？嗖的一下，结果就出来了！你的 gemini CLI 现在已经通过我们稳定可靠的代理服务器和Google对话了。

总结

好了，总结一下今天的超简单流程：

  1. 搞台海外服务器，装上宝塔。
  2. 宝塔里建个站，申个SSL，配个反向代理，全程鼠标点点点。
  3. 在使用 gemini CLI 的电脑上，设置一个 GOOGLE_API_ENDPOINT 环境变量。

三步搞定，从此告别网络错误，让 gemini CLI 成为你手中真正稳定、高效的利器。

希望这篇“懒人版”教程对你有用。赶紧动手试试吧！