ChatGPT Web

中文 | English

说明

[!IMPORTANT] 此项目 Fork 自 Chanzhaoyu/chatgpt-web

由于原项目作者不愿意引入对数据库的依赖 故制作该永久分叉独立开发 详见讨论

再次感谢 Chanzhaoyu 大佬对开源的贡献 🙏

新增了部分特色功能:

[✓] 注册 & 登录 & 重置密码 & 2FA (双重身份验证)

[✓] 同步历史会话

[✓] 前端页面设置 apikey (API 密钥)

[✓] 自定义敏感词

[✓] 每个会话设置独有 Prompt (提示词)

[✓] 用户管理

[✓] 多 Key 随机

[✓] 对话数量限制 & 设置不同用户对话数量 & 兑换数量

[✓] 通过 auth proxy (认证代理) 功能实现 sso (单点登录) 登录 (配合第三方身份验证反向代理 可实现支持 LDAP/OIDC/SAML 等协议登录)

[✓] Web Search 网络搜索功能 (基于 Tavily API 实现实时网络搜索)

[✓] VLLM API 模型支持 & 可选关闭深度思考模式

[✓] 上下文窗口控制

[!CAUTION] 声明：此项目只发布于 Github，基于 MIT 协议，免费且作为开源学习使用。并且不会有任何形式的卖号、付费服务、讨论群、讨论组等行为。谨防受骗。

截图

• ChatGPT Web
  • 介绍
  • 待实现路线
  • 前置要求
    • Node
    • PNPM
    • 填写密钥
  • 安装依赖
    • 后端
    • 前端
  • 测试环境运行
    • 后端服务
    • 前端网页
  • 环境变量
  • 打包
    • 使用 Docker
      • Docker 参数示例
      • Docker build & Run
      • Docker compose
      • 防止爬虫抓取
    • 使用 Railway 部署
      • Railway 环境变量
    • 手动打包
      • 后端服务
      • 前端网页
  • Auth Proxy Mode
  • Web Search 网络搜索功能
    • 功能特性
    • 配置方式
    • 使用方式
    • 技术实现
    • 注意事项
  • 常见问题
  • 参与贡献
  • 赞助
  • License

介绍

使用官方 OpenAI API (应用程序接口) 访问 ChatGPT：

ChatGPTAPI 使用 gpt-4.1 通过 OpenAI 官方 API 调用 ChatGPT（需要 API 密钥）。

警告：

1. 使用 API 时，如果网络不通，那是国内被墙了，你需要自建代理，绝对不要使用别人的公开代理，那是危险的。
2. 把项目发布到公共网络时，你应该设置 AUTH_SECRET_KEY 变量添加你的密码访问权限，你也应该修改 index.html 中的 title，防止被关键词搜索到。

设置方式：

1. 进入 service/.env.example 文件，复制内容到 service/.env 文件
2. 填写 OPENAI_API_KEY 字段 (获取 apiKey)

环境变量：

全部参数变量请查看或 这里

/service/.env.example

待实现路线

[✓] 双模型

[✓] 多会话储存和上下文逻辑

[✓] 对代码等消息类型的格式化美化处理

[✓] 支持用户登录注册

[✓] 前端页面设置 apikey 等信息

[✓] 数据导入、导出

[✓] 保存消息到本地图片

[✓] 界面多语言

[✓] 界面主题

[✓] VLLM API 模型支持

[✓] 深度思考模式开关

[✗] More...

前置要求

Node

node 需要 ^20 || ^22 || ^24 版本，使用 nvm 可管理本地多个 node 版本

node -v

PNPM

如果你没有安装过 pnpm

npm install pnpm -g

填写 API 密钥

获取 OpenAI API Key 并填写本地环境变量 跳转

# service/.env 文件

# OpenAI API Key - https://platform.openai.com/overview
OPENAI_API_KEY=

安装依赖

为了简便 后端开发人员 的了解负担，所以并没有采用前端 workspace 模式，而是分文件夹存放。如果只需要前端页面做二次开发，删除 service 文件夹即可。

后端

进入文件夹 /service 运行以下命令

pnpm install

前端

根目录下运行以下命令

pnpm bootstrap

测试环境运行

后端服务

进入文件夹 /service 运行以下命令

pnpm start

前端网页

根目录下运行以下命令

pnpm dev

环境变量

API 可用：

• OPENAI_API_KEY 必填
• OPENAI_API_BASE_URL 设置接口地址，可选，默认：https://api.openai.com
• OPENAI_API_DISABLE_DEBUG 设置接口关闭 debug 日志，可选，默认：empty 不关闭

通用：

• AUTH_SECRET_KEY 访问权限密钥，可选
• MAX_REQUEST_PER_HOUR 每小时最大请求次数，可选，默认无限
• TIMEOUT_MS 超时，单位毫秒，可选
• SOCKS_PROXY_HOST 和 SOCKS_PROXY_PORT 一起时生效，可选
• SOCKS_PROXY_PORT 和 SOCKS_PROXY_HOST 一起时生效，可选
• HTTPS_PROXY 支持 http，https, socks5，可选

打包

使用 Docker

Docker 参数示例

• OPENAI_API_KEY 必填
• OPENAI_API_BASE_URL 可选，设置接口地址，默认：https://api.openai.com
• OPENAI_API_MODEL 可选，指定使用的模型
• AUTH_SECRET_KEY 访问密码，可选
• TIMEOUT_MS 超时，单位毫秒，可选
• SOCKS_PROXY_HOST 可选，与 SOCKS_PROXY_PORT 一起使用
• SOCKS_PROXY_PORT 可选，与 SOCKS_PROXY_HOST 一起使用
• SOCKS_PROXY_USERNAME 可选，与 SOCKS_PROXY_HOST 和 SOCKS_PROXY_PORT 一起使用
• SOCKS_PROXY_PASSWORD 可选，与 SOCKS_PROXY_HOST 和 SOCKS_PROXY_PORT 一起使用
• HTTPS_PROXY 可选，支持 http，https, socks5

Docker build & Run

GIT_COMMIT_HASH=`git rev-parse HEAD`
RELEASE_VERSION=`git branch --show-current`
docker build --build-arg GIT_COMMIT_HASH=${GIT_COMMIT_HASH} --build-arg RELEASE_VERSION=${RELEASE_VERSION} -t chatgpt-web .

# 前台运行
# 如果在宿主机运行 mongodb 则使用 MONGODB_URL=mongodb://host.docker.internal:27017/chatgpt
docker run --name chatgpt-web --rm -it -p 3002:3002 --env OPENAI_API_KEY=your_api_key --env MONGODB_URL=your_mongodb_url chatgpt-web

# 后台运行
docker run --name chatgpt-web -d -p 127.0.0.1:3002:3002 --env OPENAI_API_KEY=your_api_key --env MONGODB_URL=your_mongodb_url chatgpt-web

# 运行地址
http://localhost:3002/

Docker compose

Hub 地址

version: '3'

services:
  app:
    image: chatgptweb/chatgpt-web # 总是使用 latest,更新时重新 pull 该 tag 镜像即可
    container_name: chatgptweb
    restart: unless-stopped
    ports:
      - 3002:3002
    depends_on:
      - database
    environment:
      TZ: Asia/Shanghai
      # 每小时最大请求次数，可选，默认无限
      MAX_REQUEST_PER_HOUR: 0
      # 访问 jwt 加密参数，可选 不为空则允许登录 同时需要设置 MONGODB_URL
      AUTH_SECRET_KEY: xxx
      # 网站名称
      SITE_TITLE: ChatGpt Web
      # mongodb 的连接字符串
      MONGODB_URL: 'mongodb://chatgpt:xxxx@database:27017'
      # 开启注册之后 密码加密的盐
      PASSWORD_MD5_SALT: xxx
      # 开启注册之后 超级管理邮箱
      ROOT_USER: me@example.com
      # 网站是否开启注册 必须开启，否则管理员都没法注册，可后续关闭
      REGISTER_ENABLED: true
      # 更多配置，在运行后，注册管理员，在管理员页面中设置
    links:
      - database

  database:
    image: mongo
    container_name: chatgptweb-database
    restart: unless-stopped
    ports:
      - '27017:27017'
    expose:
      - '27017'
    volumes:
      - mongodb:/data/db
    environment:
      MONGO_INITDB_ROOT_USERNAME: chatgpt
      MONGO_INITDB_ROOT_PASSWORD: xxxx
      MONGO_INITDB_DATABASE: chatgpt

volumes:
  mongodb: {}

• OPENAI_API_BASE_URL 可选，设置 OPENAI_API_KEY 时可用

防止爬虫抓取

nginx

将下面配置填入 nginx 配置文件中，可以参考 docker-compose/nginx/nginx.conf 文件中添加反爬虫的方法

    # 防止爬虫抓取
    if ($http_user_agent ~* "360Spider|JikeSpider|Spider|spider|bot|Bot|2345Explorer|curl|wget|webZIP|qihoobot|Baiduspider|Googlebot|Googlebot-Mobile|Googlebot-Image|Mediapartners-Google|Adsbot-Google|Feedfetcher-Google|Yahoo! Slurp|Yahoo! Slurp China|YoudaoBot|Sosospider|Sogou spider|Sogou web spider|MSNBot|ia_archiver|Tomato Bot|NSPlayer|bingbot"){
      return 403;
    }

使用 Railway 部署

参考这个 issue 详细教程 https://github.com/Kerwin1202/chatgpt-web/issues/266

注意：Railway 修改环境变量会重新 Deploy

手动打包

后端服务

如果你不需要本项目的 node 接口，可以省略如下操作

复制 service 文件夹到你有 node 服务环境的服务器上。

# 安装
pnpm install

# 打包
pnpm build

运行

pnpm prod

注：不进行打包，直接在服务器上运行 `pnpm start` 也可

#### 前端网页

1、修改根目录下 `.env` 文件中的 `VITE_GLOB_API_URL` 为你的实际后端接口地址

2、根目录下运行以下命令，然后将 `dist` 文件夹内的文件复制到你网站服务的根目录下

[参考信息](https://cn.vitejs.dev/guide/static-deploy.html#building-the-app)

```shell
pnpm build

认证代理模式 (Auth Proxy Mode)

[!WARNING] 该功能仅适用于有相关经验的运维人员在集成企业内部账号管理系统时部署 配置不当可能会导致安全风险

设置环境变量 AUTH_PROXY_ENABLED=true 即可开启认证代理 (Auth Proxy) 模式

在开启该功能后 需确保 chatgpt-web 只能通过反向代理访问

由反向代理进行进行身份验证 并再转发请求时携带请求头标识用户身份 默认请求头为 X-Email 并可以通过设置环境变量 AUTH_PROXY_HEADER_NAME 自定义配置

推荐当前身份提供商 (Idp) 使用 LDAP (轻量级目录访问协议) 协议的 可以选择使用 authelia

当前身份提供商 (Idp) 使用 OIDC (开放身份连接协议) 协议的 可以选择使用 oauth2-proxy

网络搜索功能 (Web Search)

[!TIP] Web Search 功能基于 Tavily API 实现，可以让 ChatGPT 获取最新的网络信息来回答问题。

功能特性

• 实时网络搜索: 基于 Tavily API 获取最新的网络信息
• 智能查询提取: 自动从用户问题中提取最相关的搜索关键词
• 搜索结果整合: 将搜索结果无缝整合到 AI 对话中
• 按会话控制: 每个对话可以独立开启或关闭搜索功能
• 搜索历史记录: 保存搜索查询和结果到数据库
• 可配置系统消息: 支持自定义搜索相关的系统提示消息

配置方式

1. 获取 Tavily API 密钥 (API Key)

1. 访问 Tavily 官网 注册账号
2. 获取 API 密钥 (API Key)

2. 管理员配置

1. 以管理员身份登录系统
2. 进入系统设置页面
3. 找到 "Web Search 配置" 选项
4. 填写以下配置：
   • 启用状态: 开启/关闭全局搜索功能
   • API 密钥 (API Key): 填入 Tavily API 密钥
   • 最大搜索结果数: 设置每次搜索返回的最大结果数量（1-20，默认 10）
   • 搜索查询系统消息: 用于提取搜索关键词的提示模板
   • 搜索结果系统消息: 用于处理搜索结果的提示模板

3. 系统消息模板

搜索查询提取模板 (用于从用户问题中提取搜索关键词):

You are a search query extraction assistant. Extract the most relevant search query from user's question and wrap it with <search_query></search_query> tags.
Current time: {current_time}

搜索结果处理模板 (用于处理包含搜索结果的对话):

You are a helpful assistant with access to real-time web search results. Use the provided search information to give accurate and up-to-date responses.
Current time: {current_time}

使用方式

用户端操作

1. 开启搜索功能:

   • 在对话界面中，找到搜索开关按钮
   • 点击开启当前会话的网络搜索功能

2. 提问获取实时信息:

   • 开启搜索后，直接向 ChatGPT 提问需要实时信息的问题
   • 系统会自动搜索相关信息并整合到回答中

3. 查看搜索历史:

   • 搜索查询和结果会保存在数据库中
   • 可以通过数据库查看具体的搜索记录

工作流程

1. 用户提问: 用户在开启搜索的会话中提问
2. 查询提取: 系统使用 AI 从问题中提取搜索关键词
3. 网络搜索: 调用 Tavily API 进行实时搜索
4. 结果整合: 将搜索结果作为上下文提供给 AI
5. 生成回答: AI 基于搜索结果生成更准确的回答

技术实现

• 搜索引擎: Tavily API
• 查询提取: 使用 OpenAI API 智能提取关键词
• 结果格式: JSON 格式存储完整搜索结果
• 数据存储: MongoDB 存储搜索查询和结果
• 超时设置: 搜索请求超时时间为 300 秒
• 结果数量控制: 支持配置每次搜索返回的最大结果数量（1-20）

注意事项

• Web Search 功能需要额外的 Tavily API 费用
• 搜索功能会增加响应时间
• 建议根据实际需求选择性开启
• 管理员可以控制全局搜索功能的开启状态
• 每个会话可以独立控制是否使用搜索功能
• 最大搜索结果数设置会影响搜索的详细程度和 API 费用

上下文窗口控制

[!TIP] 上下文窗口控制功能可以让用户灵活管理 AI 对话中的上下文信息，优化模型性能和对话效果。

功能特性

• 上下文管理: 控制模型可以参考的聊天记录数量
• 按对话控制: 每个对话可以独立开启或关闭上下文窗口
• 实时切换: 在对话过程中可以随时切换上下文模式
• 记忆管理: 灵活控制 AI 的记忆范围和连续性
• 可配置数量: 管理员可设置上下文消息的最大数量

工作原理

上下文窗口决定了在生成过程中，模型可以参考的当前会话下聊天记录的量：

• 合理的上下文窗口大小有助于模型生成连贯且相关的文本
• 避免因为参考过多的上下文而导致混乱或不相关的输出
• 关闭上下文窗口会导致会话失去记忆，每次提问之间将完全独立

使用方式

1. 启用/关闭上下文窗口

1. 进入对话界面: 在任何对话会话中都可以使用此功能
2. 找到控制开关: 在对话界面中找到"上下文窗口"开关按钮
3. 切换模式:
   • 开启: 模型会参考之前的聊天记录，保持对话连贯性
   • 关闭: 模型不会参考历史记录，每个问题独立处理

2. 使用场景

建议开启上下文窗口的情况：

• 需要连续对话和上下文关联
• 复杂主题的深入讨论
• 多轮问答和逐步解决问题
• 需要 AI 记住之前提到的信息

建议关闭上下文窗口的情况：

• 独立的简单问题
• 避免历史信息干扰新问题
• 处理不相关的多个主题
• 需要"重新开始"的场景

3. 管理员配置

管理员可以在系统设置中配置：

• 最大上下文数量: 设置会话中包含的上下文消息数量
• 默认状态: 设置新对话的默认上下文窗口状态

技术实现

• 上下文截取: 自动截取指定数量的历史消息
• 状态持久化: 每个对话独立保存上下文窗口开关状态
• 实时生效: 切换后立即对下一条消息生效
• 内存优化: 合理控制上下文长度，避免超出模型限制

注意事项

• 对话连贯性: 关闭上下文窗口会影响对话的连续性
• Token (令牌) 消耗: 更多的上下文会增加 Token 使用量
• 响应质量: 适当的上下文有助于提高回答质量
• 模型限制: 需要考虑不同模型的上下文长度限制

VLLM API 深度思考模式控制

[!TIP] 深度思考模式控制功能仅在后端配置为 VLLM API 时可用，可以让用户选择是否启用模型的深度思考功能。

功能特性

• VLLM API 专属功能: 仅在后端使用 VLLM API 时可用
• 按对话控制: 每个对话可以独立开启或关闭深度思考模式
• 实时切换: 在对话过程中可以随时切换深度思考模式
• 性能优化: 关闭深度思考可以提高响应速度，降低计算成本

工作原理

开启深度思考后，模型会用更多的计算资源以及消耗更长时间，模拟更复杂的思维链路进行逻辑推理：

• 适合复杂任务或高要求场景，比如数学题推导、项目规划
• 日常简单查询无需开启深度思考模式
• 关闭深度思考可以获得更快的响应速度

使用前提

必须满足以下条件才能使用此功能：

1. 后端配置: 后端必须配置为使用 VLLM API 接口
2. 模型支持: 使用的模型必须支持深度思考功能
3. API 兼容: VLLM API 版本需要支持思考模式控制参数

使用方式

1. 启用/关闭深度思考模式

1. 进入对话界面: 在支持 VLLM API 的对话会话中
2. 找到控制开关: 在对话界面中找到"深度思考"开关按钮
3. 切换模式:
   • 开启：模型将进行深度思考，提供更详细和深入的回答
   • 关闭：模型将直接回答，响应更快但可能较为简洁

2. 使用场景

建议开启深度思考的情况：

• 复杂问题需要深入分析
• 需要逻辑推理和多步骤思考
• 对回答质量要求较高的场景
• 时间不敏感的情况

建议关闭深度思考的情况：

• 简单问题快速回答
• 需要快速响应的场景
• 降低计算成本的需求
• 批量处理简单任务

3. 技术实现

• API 参数: 通过 VLLM API 的 disable_thinking 参数控制
• 状态保存: 每个对话会话独立保存深度思考开关状态
• 实时生效: 切换后立即对下一条消息生效

注意事项

• 仅限 VLLM API: 此功能仅在后端使用 VLLM API 时可用，其他 API（如 OpenAI API）不支持此功能
• 模型依赖: 不是所有模型都支持深度思考模式，请确认您使用的模型支持此功能
• 响应差异: 关闭深度思考可能会影响回答的详细程度和质量
• 成本考虑: 开启深度思考通常会增加计算成本和响应时间

常见问题

问：为什么 Git 提交总是报错？

答：因为有提交信息验证，请遵循 提交指南 (Commit Guidelines)

问：如果只使用前端页面，在哪里改请求接口？

答：根目录下 .env 文件中的 VITE_GLOB_API_URL 字段。

问：文件保存时全部爆红？

答：VS Code 请安装项目推荐插件，或手动安装 ESLint 插件。

问：前端没有打字机效果？

答：一种可能原因是经过 Nginx 反向代理，开启了 buffer，则 Nginx 会尝试从后端缓冲一定大小的数据再发送给浏览器。请尝试在反代参数后添加 proxy_buffering off;，然后重载 Nginx。其他 web server 配置同理。

参与贡献

贡献之前请先阅读 贡献指南

感谢所有做过贡献的人！

Star 历史

赞助

如果你觉得这个项目对你有帮助，请给我点个 Star。并且情况允许的话，可以给我一点点支持，总之非常感谢支持～

---

感谢 DigitalOcean 赞助提供开源积分用于运行基础设施服务器

许可证 (License)

MIT © github.com/chatgpt-web-dev Contributors

chatgpt-web 快速上手指南

简介

chatgpt-web 是一个基于 OpenAI API 的 ChatGPT 网页客户端。此版本为独立分叉版本，新增了数据库支持、用户登录注册、API Key 管理、Web 搜索及上下文控制等企业级功能。

环境准备

系统要求

• Node.js: 版本 ^20 || ^22 || ^24
• 包管理器: PNPM
• 数据库: MongoDB (Docker 部署可自动包含)

前置密钥

• OpenAI API Key: 获取地址
• Tavily API Key (可选): 用于 Web 搜索功能，获取地址

安装 PNPM

如未安装，请全局安装：

npm install pnpm -g

安装步骤

方式一：Docker Compose 部署（推荐）

此方式包含应用与数据库，适合生产环境或完整体验。

1. 创建配置文件 新建 docker-compose.yml，内容参考如下（请修改密码和密钥）：

   version: '3'
   services:
     app:
       image: chatgptweb/chatgpt-web
       container_name: chatgptweb
       restart: unless-stopped
       ports:
         - 3002:3002
       depends_on:
         - database
       environment:
         - TZ=Asia/Shanghai
         - OPENAI_API_KEY=your_api_key
         - MONGODB_URL=mongodb://chatgpt:xxxx@database:27017
         - AUTH_SECRET_KEY=your_secret_key
         - REGISTER_ENABLED=true
         - ROOT_USER=me@example.com
         - PASSWORD_MD5_SALT=your_salt
     database:
       image: mongo
       container_name: chatgptweb-database
       restart: unless-stopped
       volumes:
         - mongodb:/data/db
       environment:
         - MONGO_INITDB_ROOT_USERNAME=chatgpt
         - MONGO_INITDB_ROOT_PASSWORD=xxxx
         - MONGO_INITDB_DATABASE=chatgpt
   volumes:
     mongodb: {}
   

2. 启动服务

   docker compose up -d
   

3. 访问地址

   http://localhost:3002/
   

方式二：源码运行（开发环境）

适合需要二次开发或调试的用户。

1. 克隆项目

   git clone <项目地址>
   cd chatgpt-web
   

2. 安装依赖

   # 前端依赖
   pnpm bootstrap
   
   # 后端依赖
   cd service
   pnpm install
   

3. 配置环境变量 复制 service/.env.example 为 service/.env，填写关键配置：

   OPENAI_API_KEY=your_api_key
   MONGODB_URL=mongodb://localhost:27017/chatgpt
   AUTH_SECRET_KEY=your_secret_key
   

4. 启动服务

   # 终端 1：启动后端
   cd service
   pnpm start
   
   # 终端 2：启动前端
   cd ..
   pnpm dev
   

基本使用

1. 管理员注册

   • 访问首页，使用配置的 ROOT_USER 邮箱进行注册。
   • 注册后登录即可获得管理员权限。

2. 配置模型密钥

   • 登录后可在个人中心或管理员面板设置 OpenAI API Key。
   • 如需使用网络搜索，需在系统设置中配置 Tavily API Key。

3. 对话功能

   • 新建会话：点击侧边栏新建对话。
   • 上下文控制：在对话界面可开关“上下文窗口”，控制模型记忆长度。
   • 深度思考：若后端配置了 VLLM API，可开关“深度思考模式”以增强推理能力。
   • 网络搜索：开启搜索开关后，模型将自动联网获取最新信息回答问题。

4. 用户管理

   • 管理员可在后台管理用户、设置对话数量限制及生成兑换码。