近日发现有人在 X 平台冒用本人身份，注册了帐号 @bclee0827 并用以发行虚拟货币。在此郑重声明，本人从不持有任何虚拟货币，且不会发行虚拟货币，该帐号并非由我本人注册或运营。对于任何该帐号发表的内容，本人概不负责。请广大用户提高警惕，避免受骗。
本人没有更多精力投入此项目，本仓库即将进入 Archived 状态，感谢大家对我的支持与理解！如有疑问，请通过 GitHub 和 Telegram 与我联系，联系方式已经在 Profile 中列出。
Recently, I discovered that someone on the X platform has impersonated me by creating the account @bclee0827 and using it to issue virtual currencies. I hereby solemnly declare that I do not own any virtual currencies and will never issue any virtual currencies. This account is not registered or operated by me. I am not responsible for any content posted by this account.
Please stay vigilant to avoid being misled or scammed.
I no longer have the capacity to devote to this project. This repository will soon be moved to an Archived state. Thank you for your support and understanding!
If you have any questions, please contact me via GitHub or Telegram. My contact information is listed in my profile.
最近、X プラットフォーム上で @bclee0827 というアカウントが私の名義を無断で使用し、仮想通貨の発行に利用していることを確認しました。ここに厳重に声明いたします。私は仮想通貨を一切保有しておらず、今後も発行することはありません。このアカウントは、私が登録・運営しているものではありません。このアカウントの投稿内容について、一切責任を負いません。
本プロジェクトにこれ以上の時間を割くことが難しくなりました。このリポジトリは近日中にアーカイブ状態に移行します。これまでのご支援とご理解に心より感謝申し上げます。
ご質問がある場合は、GitHub または Telegram を通じてご連絡ください。連絡先情報はプロフィールに記載されています。
ChatGemini 是一个基于 Google Gemini 的网页客户端，对标 ChatGPT 3.5，使用逻辑同 ChatGPT 3.5 一致，同时支持在聊天中上传图片，自动调用 Gemini-Pro-Vision 模型进行识图。
本项目还可自定义 Gemini API 服务器地址，用户可将本项目部署至支持 PHP 的服务器或虚拟主机上，或是自行配置 Nginx 反向代理，通过修改 Gemini API 路径，从而在中国大陆无障碍使用。
如果您对本项目感兴趣，欢迎 Star 和 Fork。
欢迎加入 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。
准备工作完成后，执行以下步骤：
- 将仓库 clone 至本地
$ git clone https://github.com/bclswl0827/ChatGemini- 进入项目目录
$ cd ChatGemini- 安装依赖
$ npm install- 修改配置
参考下方的 应用配置 章节
- 构建项目
$ npm run build- 部署项目
将
build目录下的文件部署至服务器或虚拟主机上
- 启动服务（可选）
若在本地运行，执行
$ npm run start确保服务器上已安装 Docker，然后执行以下步骤：
- 拉取镜像
$ docker pull ghcr.io/bclswl0827/chatgemini- 运行容器
$ 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__"参数
- 访问应用
访问
http://<IP>:8080即可
若使用手动部署，可透过以下步骤保持更新：
- 进入项目目录
$ cd ChatGemini- 拉取最新代码
$ git pull- 安装依赖
$ npm install- 重新构建项目
$ npm run build- 部署项目
- 重启服务
若是使用传统 docker run 指令部署的版本，可透过以下步骤保持更新：
- 删除旧容器
$ docker rm -f chatgemini- 拉取最新镜像
$ docker pull ghcr.io/bclswl0827/chatgemini- 运行新容器
$ docker run -d \
--name chatgemini \
--restart always \
--publish 8080:8080 \
--env REACT_APP_GEMINI_API_KEY="您的密钥" \
ghcr.io/bclswl0827/chatgemini若是使用 docker-compose 指令部署的版本，可透过以下步骤保持更新：
- 进入
docker-compose.yml所在目录 - 拉取最新镜像
$ docker-compose pull- 重启容器
$ docker-compose up -d --remove-orphans- 移除旧镜像（可选）
$ docker image prune使用 Vercel 部署的项目，平台会在用户 GitHub 仓库创建一个新仓库，而不是 Fork 本仓库，因此无法正确检测更新。请按照下列步骤手动更新：
- 删掉由 Vercel 创建的仓库
- 使用页面右上角的 Fork 按钮，Fork 本项目
- 在 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，请将 .env 中的 REACT_APP_GEMINI_API_URL 字段留空，即：
REACT_APP_GEMINI_API_URL=""若要使用 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/;
}若部署平台不允许修改 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，有关使用方法和部署链接，请前往 antergone/palm-netlify-proxy 查看。
部署好应用过后，分配的域名以 example.netlify.app 为例，即：
REACT_APP_GEMINI_API_URL="https://example.netlify.app"通过Cloudflare Worker也能快速反向代理Gemini API，快速 ，易用，安全。有关使用方法和部署链接，可以前往CattleZone/Gemini-Proxy查看。
部署好应用过后，分配的域名以example.workers.dev为例，即
REACT_APP_GEMINI_API_URL="https://example.workers.dev"通过 Cloudflare Workers 也能实现反向代理 Gemini API。有关使用方法和部署链接，可以前往 CattleZone/Gemini-Proxy 查看。
需要注意，由于 Cloudflare Workers 默认分配的域名（以 .dev 结尾）在中国大陆无法访问，因此需要另行绑定域名。
部署好应用并绑定好域名后，以 api.example.com 为例，即
REACT_APP_GEMINI_API_URL="https://api.example.com"本项目基于 MIT 协议开源，具体请参阅 LICENSE