一个好用的Google Gemini 的网页客户端

介绍

ChatGemini 是一个基于 Google Gemini 的网页客户端，对标 ChatGPT 3.5，操作逻辑同 ChatGPT 3.5 一致，同时支持在聊天中上传图片，应用会自动调用 Gemini-Pro-Vision 模型进行识图

github开源：https://github.com/bclswl0827/ChatGemini

预览页：https://ibcl.us/ChatGemini

功能特性

• 适配移动端
• 支持多 API 密钥分流
• 操作逻辑同 ChatGPT
• 仿 ChatGPT 3.5 界面
• 支持多轮聊天对话
• 支持上传图片进行识别
• 逐字输出（SSE）回应
• 集成 PHP 版反向代理
• 自定义 Gemini API 地址
• 可启用站点通行码防止滥用
• 聊天内容导出（HTML 和 PDF）
• 对话内容保存在 IndexedDB 中
• 在 AI 回应中运行 Python 代码

有关 Gemini API 的申请，请前往 Google AI Studio：(https://makersuite.google.com/app/apikey)

手动部署

确保已安装 Node.js 和 Git。

准备工作完成后，执行以下步骤：

1. 将仓库 clone 至本地

$ git clone https://github.com/bclswl0827/ChatGemini

1. 进入项目目录

$ cd ChatGemini

1. 安装依赖

$ npm install

1. 修改配置

参考下方的 应用配置 章节

1. 构建项目

$ npm run build

1. 部署项目

将 build 目录下的文件部署至服务器或虚拟主机上

1. 启动服务（可选）

若在本地运行，执行

$ npm run start

Docker 部署

确保服务器上已安装 Docker，然后执行以下步骤：

1. 拉取镜像

$ docker pull ghcr.io/bclswl0827/chatgemini

1. 运行容器

$ docker run -d \
    --name chatgemini \
    --restart always \
    --publish 8080:8080 \
    --env REACT_APP_GEMINI_API_KEY="您的密钥" \
    ghcr.io/bclswl0827/chatgemini

若要在 Docker 版本中启用自动设定的 Nginx 反向代理，请将 REACT_APP_GEMINI_API_URL 变量值设为 __use_nginx__，即在创建容器时加上 --env REACT_APP_GEMINI_API_URL="__use_nginx__" 参数

1. 访问应用

访问 http://<IP>:8080 即可

Vercel 部署

支持 Vercel 一键部署平台。

模板中仅留下了必填的 REACT_APP_GEMINI_API_KEY 变量， 在部署完成过后，若需修改或新增配置，请前往 Vercel 控制台，点击对应项目，再点击 Settings -> Environment Variables 进行修改。修改完成后，需要在 Vercel 控制台重新触发部署，以使新配置生效。

保持更新

若使用手动部署

若使用手动部署，可透过以下步骤保持更新：

1. 进入项目目录

$ cd ChatGemini

1. 拉取最新代码

$ git pull

1. 安装依赖

$ npm install

1. 重新构建项目

$ npm run build

1. 部署项目
2. 重启服务

若使用 Docker 部署

若是使用传统 docker run 指令部署的版本，可透过以下步骤保持更新：

1. 删除旧容器

$ docker rm -f chatgemini

1. 拉取最新镜像

$ docker pull ghcr.io/bclswl0827/chatgemini

1. 运行新容器

$ docker run -d \
    --name chatgemini \
    --restart always \
    --publish 8080:8080 \
    --env REACT_APP_GEMINI_API_KEY="您的密钥" \
    ghcr.io/bclswl0827/chatgemini

若是使用 docker-compose 指令部署的版本，可透过以下步骤保持更新：

1. 进入 docker-compose.yml 所在目录
2. 拉取最新镜像

$ docker-compose pull

1. 重启容器

$ docker-compose up -d --remove-orphans

1. 移除旧镜像（可选）

$ docker image prune

若使用 Vercel 部署

使用 Vercel 部署的项目，平台会在用户 GitHub 仓库创建一个新仓库，而不是 Fork 本仓库，因此无法正确检测更新。请按照下列步骤手动更新：

1. 删掉由 Vercel 创建的仓库
2. 使用页面右上角的 Fork 按钮，Fork 本项目
3. 在 Vercel 重新选择并部署 Fork 后的项目并完成部署

Fork 后的仓库，由于 GitHub 存在限制，需要手动去您 Fork 后仓库的 Actions 页面启用 Workflows，并启用 Upstream Sync Action，启用之后即可开启每小时定时自动同步上游代码。

应用配置

项目基础配置位于根目录下的 .env 文件中，手动部署时，请创建该文件并根据实际情况进行配置；若使用 Docker 方式部署，请在创建容器时传入 --env 参数进行配置。

配置格式均为 KEY="VALUE"，建议使用双引号包裹值，例如：

REACT_APP_GEMINI_API_KEY="您的密钥"

各配置项说明如下：

配置项	必填	可选值	默认值	说明	备注
REACT_APP_GEMINI_API_KEY	是	string	string[]	空	填入 Gemini API 密钥，多个以 `
REACT_APP_GEMINI_API_URL	否	string	空	自定义 Gemini API 地址，具体参考下方说明	无
REACT_APP_GEMINI_API_SSE	否	true	false	true	是否逐字输出 Gemini 回应，即是否使能 SSE
REACT_APP_TITLE_SITE	否	string	ChatGemini	站点标题，将显示在浏览器标签页上	无
REACT_APP_TITLE_HEADER	否	string	Gemini Pro	应用标题，显示在应用侧边栏和头部	无
REACT_APP_PASSCODE_MD5	否	string	string[]	空	MD5 格式通行码，多个以 `

站点通行码

启用通行码后，用户在每次访问应用时，需要先输入通行码，才能开始使用应用。

若要为您的站点启用通行码，可以在 .env 中的 REACT_APP_PASSCODE_MD5 字段填入 MD5 格式的通行码，多个以 | 分隔，例如：

REACT_APP_PASSCODE_MD5="E10ADC3949BA59ABBE56E057F20F883E|C33367701511B4F6020EC61DED352059"

要生成 MD5 格式的通行码，可以使用相关在线工具，例如 MD5 Hash Generator。

注意：本应用通行码为无盐值 MD5 格式，有一定概率被破解，因此请勿将您的重要密码作为通行码。

直连 Gemini API

若要直连 Gemini API，请将 .env 中的 REACT_APP_GEMINI_API_URL 字段留空，即：

REACT_APP_GEMINI_API_URL=""

Nginx 反向代理 Gemini API

若要使用 Nginx 反向代理，请将 .env 中的 REACT_APP_GEMINI_API_URL 修改为反向代理后的地址，例如 https://example.org/api，即：

REACT_APP_GEMINI_API_URL="https://example.org/api"

若反代同网站位于相同基础路径下，也可简写为 /api，跨域则须填写完整地址。

下面是一个 Nginx 反代配置示例供参考，路径以 /api 为例：

location /api {
    proxy_http_version 1.1;
    proxy_read_timeout 86400s;
    proxy_cache off; # 注意关闭缓存
    proxy_buffering off; # 注意关闭缓冲
    proxy_pass https://generativelanguage.googleapis.com/;
}

PHP 反向代理 Gemini API

若部署平台不允许修改 Nginx 配置，但是提供 PHP 环境，或是您有闲置的 PHP 虚拟主机，可以考虑使用项目集成的 PHP 反向代理，脚本位于 public/gemini.php。

要使用 PHP 反向代理，请修改 PHP 脚本中的 ACCESS_TOKEN 定义后，将 PHP 脚本上传到相应平台，再修改 .env 中的 REACT_APP_GEMINI_API_URL 为 https://example.org/gemini.php?token=<您定义的 Access Token>&path=。

Access Token 以 Nt6PRcQ2BZ8FY9y7Lnk35S 为例，即：

REACT_APP_GEMINI_API_URL="https://example.org/gemini.php?token=Nt6PRcQ2BZ8FY9y7Lnk35S&path="

若反代同网站位于相同基础路径下，也可简写为 /gemini.php?token=Nt6PRcQ2BZ8FY9y7Lnk35S&path=，跨域则须填写完整地址。

Netlify 反向代理 Gemini API

Netlify 亦可以用于反向代理 Gemini API，有关使用方法和部署链接，请前往 antergone/palm-netlify-proxy 查看。

部署好应用过后，分配的域名以 example.netlify.app 为例，即：

REACT_APP_GEMINI_API_URL="https://example.netlify.app"