ChatGemini

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

本项目还可自定义Gemini API服务器地址，用户可将本项目部署到支持PHP的服务器或虚拟主机上，或自行配置Nginx反向代理，通过修改Gemini API路径，从而在中国大陆无障碍使用。

如果您对本项目感兴趣，欢迎Star和Fork。

演示站点（需翻墙）

ChatGemini

讨论群组

欢迎加入Telegram群组，与其他用户交流，反馈问题或建议，也可以在群组中了解最新动态。

加入群组，请友善交流。

• ChatGemini@Telegram

功能特性

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

界面预览

点击展开网页效果

功能	预览
主界面
多轮聊天
附件识图
执行Python
逐字输出回应
聊天导出HTML
聊天导出PDF

应用部署

请确保您已经获得Gemini API密钥，有关Gemini API的申请，请前往Google AI Studio。

手动部署

确保已安装Node.js和Git。

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

1. 将仓库克隆至本地

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

2. 进入项目目录

$ cd ChatGemini

3. 安装依赖

$ npm install

4. 修改配置

参考下方的应用配置章节

5. 构建项目

$ npm run build

6. 部署项目

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

7. 启动服务（可选）

若在本地运行，执行

$ npm run start

Docker部署

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

1. 拉取镜像

$ docker pull ghcr.io/bclswl0827/chatgemini

2. 运行容器

$ 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__" 参数

3. 访问应用

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

Vercel 部署

本项目支持 Vercel 一键部署，点击下方按钮即可部署至 Vercel 平台。

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

保持更新

若使用手动部署

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

1. 进入项目目录

$ cd ChatGemini

2. 拉取最新代码

$ git pull

3. 安装依赖

$ npm install

4. 重新构建项目

$ npm run build

5. 部署项目
6. 重启服务

若使用 Docker 部署

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

1. 删除旧容器

$ docker rm -f chatgemini

2. 拉取最新镜像

$ docker pull ghcr.io/bclswl0827/chatgemini

3. 运行新容器

$ 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

3. 重启容器

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

4. 移除旧镜像（可选）

$ 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="您的密钥"

各配置项说明如下：

站点通行码

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

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

REACT_APP_PASSCODE_MD5="E10ADC3949BA59ABBE56E057F20F883E|C33367701511B4F6020EC61DED352059"

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

注意：本应用通行码为无盐值 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"

Cloudflare Worker 反向代理 Gemini API

通过Cloudflare Worker也能快速反向代理Gemini API，快速，易用，安全。有关使用方法和部署链接，可以前往CattleZone/Gemini-Proxy查看。 部署应用后，以分配的域名"example.workers.dev"为例，即

REACT_APP_GEMINI_API_URL="https://example.workers.dev"

使用Cloudflare Worker反向代理Gemini API

也可以通过Cloudflare Workers实现Gemini API的反向代理。关于使用方法和部署链接，可以访问CattleZone/Gemini-Proxy查看。

请注意，由于Cloudflare Workers默认分配的域名（以".dev"结尾）在中国大陆无法访问，因此需要另外绑定域名。

部署应用并绑定域名后，以"api.example.com"为例，即

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

开源许可

本项目根据MIT协议开源，详情请参阅LICENSE